Esecuzione di query SQL con DB Query Client

Per eseguire query SQL con DB Query Client, completare la seguente procedura:

1. Avviare DB Query Client utilizzando il seguente URL:

   https://<hostname:port>/smcfs/yfshttpdbi/sterlingdbqueryclient.jsp

2. Immettere ID utente e Password. L'autenticazione utente è valida fino alla scadenza della sessione corrente o fino alla chiusura della sessione corrente. Se la sessione del browser corrente scade, è possibile immettere le proprie credenziali di accesso ed eseguire query sulla stessa pagina.
3. Immettere una query SQL in Immetti query SQLe fare clic su Esegui query.

   Specificare nel campo Numero di righe il numero di righe da visualizzare per pagina. Per default, il valore è impostato su 100. Se si immette un valore maggiore, l'impaginazione viene abilitata automaticamente. È possibile specificare un massimo di 10000 righe da visualizzare per pagina.

   • Ordinare il risultato della query in base alla colonna ogni volta che DISTINCT viene utilizzato con la clausola SELECT .
   • DISTINCT consente di eseguire la seguente query:
     select distinct <organization_code> from yfs_item where 1=1;
     Nota: per la query DISTINCT con la colonna della chiave primaria non selezionata, l'impaginazione non è supportata. Per default, il valore è impostato su 100. Tuttavia, se si desidera visualizzare più record, aumentare la dimensione della pagina. È possibile visualizzare un massimo di 10000 record.
   • Le query che contengono funzioni di aggregazione come le clausole UNION, INTERSECTo WITH non sono supportate dalla paginazione. Tali query vengono eseguite in modalità non impaginata. Tuttavia, se si desidera visualizzare più record, aumentare la dimensione della pagina ad un limite massimo di 10000 record.

   Nota:

   • Non è possibile interrogare le tabelle che contengono dati sensibili o irrilevanti o che non contengono dati aziendali.
   • Non è possibile eseguire query che modificano le tabelle.
   Di seguito sono riportate alcune query di esempio:

   
   select * from yfs_resource fetch first 10 rows only;
   select * from yfs_resource_permission fetch first 10 rows only;
   select * from yfs_user fetch first 10 rows only;

   • Interrogare le tabelle per ordinare il risultato per colonna non primaria. Ad esempio:

     select * from yfs_user order by loginid fetch first 10 rows only;

   • Creare le unioni utilizzando le query secondarie. Ad esempio:

     
     select u.user_key, ug.USERGROUP_KEY, u.loginid, ug. USERGROUP_NAME from (SELECT * FROM
     omdb.YFS_USER)  as u RIGHT OUTER JOIN (SELECT * FROM omdb.YFS_USER_GROUP) as ug ON
     u.USERGROUP_KEY = ug.USERGROUP_KEY fetch first 10 rows only;

   • Utilizzo della query degli alias di colonna. Ad esempio, select order_no as Docket from yfs_order_header;

   • Richiamare le informazioni di indice dalle tabelle utilizzando istruzioni describe . Ad esempio, describe table YFS_USER;. Questa query restituisce solo i dettagli dello schema della tabella di base come il tipo di dati, null o non null e non le informazioni sull'indice. Tuttavia, è possibile eseguire describe indexes for table YFS_USER per recuperare i dettagli dell'indice della tabella.

   • Query di tabelle dallo schema SYSCAT. È possibile interrogare le tabelle seguenti dallo schema SYSCAT:
     • SCHEMATA
     • TABELLE - Durante la query di questa tabella, si consiglia di aggiungere una clausola WHERE con tabschema = 'OMDB'
     • VIEWS - Durante la query di questa tabella, si consiglia di aggiungere una clausola WHERE con viewschema = 'OMDB'
     • COLUMNS - Durante la query di questa tabella, si consiglia di aggiungere una clausola WHERE con tabschema = 'OMDB'
     • INDEXES - Durante l'interrogazione di questa tabella, si consiglia di aggiungere una clausola WHERE con tabschema = 'OMDB'
     • TABCONST - Durante la query di questa tabella, si consiglia di aggiungere una clausola WHERE con tabschema = 'OMDB'

     Per impostazione predefinita, in modalità non impaginata vengono visualizzati solo i primi 100 record. Se si desidera visualizzare più record, in DB Query Client, specificare il numero totale di record da visualizzare.

   Metodi alternativi per eseguire le query

   • Fare clic su Query ultima esecuzione per visualizzare tutte le query eseguite precedentemente. Le ultime 100 query precedentemente eseguite vengono salvate e vengono visualizzate 10 query per pagina. È possibile eseguire una query dall'elenco.
   • Nel campo Cerca query , immettere i termini appropriati come parole chiave di query o nomi tabella per trovare la query e fare clic su Esegui query. Ad esempio, i termini di ricerca possono essere YFS_USER, SELECT. In alternativa, è possibile scorrere l'elenco e fare clic su Avanti o Indietro per trovare la query.
   • Importare ed eseguire una interrogazione.
   Nota:

   • Se non si termina una query con un punto e virgola, viene accodata internamente.
   • Per impostazione predefinita, la paginazione è abilitata. Se si verifica un problema per determinate query, l'impaginazione viene automaticamente disabilitata e il risultato della query viene visualizzato in base al numero di righe immesse.
   • Se si verificano problemi di connettività momentanei del database, lo strumento ritenta tre volte la connessione al database. Se l'operazione ha esito negativo, viene visualizzato un messaggio appropriato.
   • Il timeout della query è di 2 minuti.
   Risultati:

   • Per garantire prestazioni ottimali nell'ambiente di produzione, vengono visualizzate solo le prime 100 righe per le query con colonne CLOB.
   • Per le query SQL con colonne CLOB, viene visualizzato un massimo di 100 record che possono essere esportati.
   • Le colonne BLOB vengono visualizzate nell'output come --BLOB Data-- invece di mostrare un valore stringa dell'oggetto binario nella pagina dei risultati.
   • Lo strumento restituisce i codici di errore SQL esatti in modo che gli utenti possano capire cosa non va in un'interrogazione. Ad esempio, quando si esegue select * from YFS_USER_DETAILS, lo strumento restituisce il seguente messaggio di errore:

     Eccezione durante l'esecuzione della query. Controllare la sintassi della query / log del server.
     "OMDB.YFS_USER_DETAILS" è un nome non definito .. SQLCODE=-204, SQLSTATE=42704, DRIVER=3.69.49

4. Facoltativo: per default, la casella di spunta Esporta numeri come testo (solo per la visualizzazione in Microsoft Excel) è selezionata. Per esportare il risultato della query in file CSV, deselezionare la casella di controllo e fare clic su Esporta. I risultati della query vengono esportati in un .csv. Ad esempio, queryResult--2020-8-5-13-19-19.csv.

   Nel file CSV, i numeri lunghi vengono visualizzati in formato esponenziale. Ad esempio, 12345678901234567890 è rappresentato come 1.23457E+19.

   Per esportare i risultati della query in un file CSV di sola lettura , selezionare la casella di spunta Esporta numeri come testo (solo per la visualizzazione in Microsoft Excel) . Ad esempio, queryResult--2020-8-5-13-19-19_view-only-on-ms-excel.csv.

   Il file CSV può essere aperto solo in Microsoft Excel. Nel file CSV esportato, un apostrofo (') è preceduto da un prefisso per i numeri maggiori di 11 cifre, in modo che i numeri interi vengano visualizzati come testo in Microsoft Excel. Tuttavia, i numeri con meno di 11 cifre vengono visualizzati come numeri interi e non contengono apostrofo. Per i numeri che contengono zeri iniziali, Microsoft Excel tronca gli zeri e visualizza solo numeri. Ad esempio, "0001" viene visualizzato come "1".