Salvataggio, condivisione ed esportazione di query SQL
È possibile salvare una query SQL in qualsiasi momento e continuare a utilizzarla in un secondo momento. È inoltre possibile salvare una query completata e condividerla come widget di ricerca per un uso futuro da parte dell'utente o di altri utenti.
Se il widget è stato creato in base a un intervallo di tempo fisso, ogni volta che si apre il widget verranno visualizzati i risultati per l'intervallo di tempo specificato nella ricerca. Per impostazione predefinita, se il widget è stato creato per un intervallo di tempo relativo (ad esempio gli ultimi 7 giorni), ogni volta che si apre il widget verranno visualizzati i risultati aggiornati in base al selettore ora (ultimi 7 giorni). Quando un dashboard fa riferimento al widget, questo riflette l'impostazione del selettore ora pagina.
Requisiti essenziali:
-
Per informazioni sui criteri del dashboard di gestione che assegnano le autorizzazioni necessarie per l'utilizzo dei dashboard, vedere Dettagli per il dashboard di gestione.
-
Per la documentazione relativa all'API del dashboard di gestione, vedere API del dashboard di gestione.
Il menu Azione di SQL Explorer consente di salvare e condividere le ricerche SQL con altre persone.
Salvare una ricerca completata e aggiungerla a un dashboard
Per salvare una query SQL e aggiungerla a un dashboard, effettuare le operazioni riportate di seguito.
- Nel menu Azioni, selezionare Salva. Viene visualizzata la finestra Salva ricerca.
- Selezionare un compartimento in cui salvare la ricerca.
Nota
Non esiste alcuna associazione tra il compartimento selezionato della ricerca salvata e i dati di base su cui viene eseguita la query. - Immettere un nome e una descrizione per il widget.
Facoltativamente, è possibile salvare il widget di ricerca e aggiungerlo a un dashboard.
- Fare clic sull'opzione Aggiungi al dashboard.
- Scegliere se aggiungere il widget a un dashboard esistente (selezionare il compartimento dashboard e il dashboard specifico) oppure creare un nuovo dashboard e fornire le informazioni richieste.
Nota
Ops Insights fornisce i seguenti dashboard integrati per Exadata:- Dashboard cella Exadata - Ogni ora
Dashboard di granularità oraria per le metriche del disco cella.
- Dashboard IORM Exadata - Ogni ora
Dashboard di granularità su base oraria per le metriche correlate a Exadata IORM.
- Dashboard cella Exadata - Ogni ora
- Fare clic suSalva.
Apri una ricerca salvata o predefinita in precedenza
- Dal menu Azioni, selezionare Apri. Verrà visualizzata la finestra di dialogo Apri ricerca.
- Scegliere una ricerca salvata in precedenza o uno dei widget di ricerca predefiniti forniti con SQL Explorer.
- Fare clic su Apri.
Elimina una ricerca salvata
- Dal menu Azioni selezionare Elimina. Viene visualizzata la finestra di dialogo Elimina ricerca.
- Scegliere una ricerca salvata in precedenza.
- Fare clic su Elimina.
Importante: se si elimina un widget di ricerca salvata a cui fa riferimento un dashboard esistente, tenere presente che non viene eliminato automaticamente dal dashboard. Si verificherà un errore durante l'accesso al dashboard.
Non è possibile eliminare una ricerca predefinita integrata.
Crea una query di ricerca salvata da una esistente
È possibile creare una ricerca personalizzata da una esistente utilizzando l'opzione Salva con nome.
- Dal menu Azioni, selezionare Apri. Verrà visualizzata la finestra di dialogo Apri ricerca.
- Scegliere una ricerca salvata o predefinita dall'elenco.
- Fare clic su Apri. I criteri di ricerca vengono visualizzati in SQL Explorer.
- Aggiornare i criteri di ricerca in base alle esigenze.
- Nel menu Azioni, selezionare Salva con nome.
- Inserire un nuovo nome per la ricerca aggiornata.
- Fare clic suSalva.
Aggiornare il nome e la descrizione di una ricerca esistente
Durante lo sviluppo di una query SQL, è possibile modificare il nome e le informazioni descrittive associate del widget di ricerca. Per apportare queste modifiche, è possibile utilizzare l'opzione Modifica.
- Nel menu Azioni, selezionare Apri se si sta aggiornando un widget di ricerca esistente. Verrà visualizzata la finestra di dialogo Apri ricerca.
- Selezionare un compartimento in cui risiede il widget di ricerca.
Nota
Non esiste alcuna associazione tra il compartimento selezionato della ricerca salvata e i dati di base su cui viene eseguita la query. - Selezionare un widget di ricerca e fare clic su Apri per visualizzare la ricerca in SQL Explorer.
- Dal menu Azioni, selezionare Modifica. Viene visualizzata la finestra di dialogo Modifica ricerca.
- Inserire un valore in Nome nuova ricerca e/o Descrizione nuova ricerca.
- Fare clic su Modifica per salvare le modifiche.
Crea una nuova ricerca
Per cancellare i criteri di ricerca esistenti e avviare una nuova ricerca, selezionare Crea nuovo dal menu Azioni.
Esporta dati
Per esportare i dati ottenuti da una ricerca, fare clic su Esporta in CSV nel menu Ricerca salvata. L'esportazione dei dati limita la possibilità di recuperare solo 10.000 righe al massimo per una singola query (utilizzando limit=1000 e pages=10). In alternativa, è possibile esportare i dati tramite CLI (interfaccia della riga di comando). Esportare tramite CLI è abbastanza potente e facile da usare, vedi l'esempio qui sotto su come ottenere i dati utilizzando la CLI:- Esempio di utilizzo di un file JSON:
oci opsi opsi-data-objects query-data-templatized-query --from-json file://./<file name> --compartment-id <compartment id> --limit 1000
Dove il file JSON contiene quanto segue:{ "dataObjectIdentifier":"opsidataobject.dbinsights.f0819908-5ae3-4cb5-8a81-80a4ba888881", "query":{ "queryType":"TEMPLATIZED_QUERY", "selectList":[ "DB_DISPLAY_NAME, CDB_NAME, EXADATA_DISPLAY_NAME, VMCLUSTER_NAME, CPU_UTILIZATION, ROLLUP_TIME_UTC" ], "whereConditionsList":[ ], "groupByList":[ ], "havingConditionsList":[ ], "orderByList":[ "ROLLUP_TIME_UTC ASC" ], "timeFilters":{ "timeStart":"2024-01-05T00:00:00.000Z", "timeEnd":"2024-01-12T00:00:00.000Z" } }, "resourceFilters":{ "compartmentIdInSubtree":false } }
- Esempio di chiamata della query direttamente all'interno del comando CLI:
oci opsi opsi-data-objects query-data-templatized-query --compartment-id <compartment id> --data-object-identifier <data object id> --query-select-list '["DB_DISPLAY_NAME, CDB_NAME,EXADATA_DISPLAY_NAME, VMCLUSTER_NAME, CPU_UTILIZATION, ROLLUP_TIME_UTC"]' --query-order-by-list '["ROLLUP_TIME_UTC ASC"]' --limit 1000