Salvare o condividere query SQL

Questo documento descrive come salvare e condividere le query create in Log Analytics.

Per informazioni su come rappresentare graficamente le query e su esempi di query, consulta i documenti elencati nella sezione Passaggi successivi di questo documento.

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Abilita l'API Observability.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

Abilitare l'API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Abilita l'API Observability.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

Abilitare l'API

1. Per ottenere le autorizzazioni necessarie per caricare la pagina Log Analytics, scrivere, eseguire e salvare query private, chiedi all'amministratore di concederti i seguenti ruoli IAM:

   • Observability View Accessor (roles/observability.viewAccessor) sulle visualizzazioni di osservabilità che vuoi interrogare. Questo ruolo supporta le condizioni IAM, che ti consentono di limitare la concessione a una visualizzazione specifica. Se non colleghi una condizione alla concessione del ruolo, l'entità può accedere a tutte le visualizzazioni di osservabilità. Le visualizzazioni di osservabilità sono in Anteprima pubblica.
   • Observability Analytics User (roles/observability.analyticsUser) sul tuo progetto. Questo ruolo contiene le autorizzazioni necessarie per salvare ed eseguire query private ed eseguire query condivise.
   • Visualizzatore log (roles/logging.viewer) sul tuo progetto.
   • Logs View Accessor (roles/logging.viewAccessor) sul progetto che memorizza le visualizzazioni log su cui vuoi eseguire query.

   Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

   Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

   Nota: se vuoi creare e gestire query condivise, i ruoli IAM precedenti non sono sufficienti. Per creare e gestire query condivise, i tuoi ruoli IAM devono includere le autorizzazioni logging.queries.{share, updateShared, deleteShared}.

Salva una query

Tutte le query che esegui vengono salvate automaticamente per 30 giorni e sono accessibili selezionando la scheda Recenti nella pagina Analisi dei log. Puoi cercare, visualizzare, eseguire e condividere le query elencate nella scheda Recenti.

Se vuoi mantenere una query disponibile per un utilizzo futuro, annotala con informazioni utili o consenti ai colleghi di visualizzarla ed eseguirla, quindi salvala. Puoi cercare e ordinare le query salvate in base a nome, descrizione ed etichetta di visibilità. Puoi anche modificare ed eliminare queste query. Le query salvate vengono conservate finché non le elimini.

Puoi salvare 10.000 query per Google Cloud progetto.

Console

Per salvare una query:

1. Nella console Google Cloud , vai alla pagina Analisi dei log:

   Vai ad Analisi dei log

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

2. Compila il riquadro Query con una query.

   Puoi compilare il riquadro Query inserendo una nuova query, selezionandone una dalla scheda Recenti o selezionandone una dalla scheda Salvate.

   La query può includere qualsiasi vista valida, più viste e viste Analytics.

   Quando la query nel riquadro Query è valida, l'opzione Salva Salva è attivata.

3. Fai clic su Salva Salva, seleziona Salva query e compila i campi Nome e Descrizione. I valori impostati per questi campi vengono visualizzati nella scheda Salvati.

4. (Facoltativo) Per consentire a tutti gli utenti con accesso alla pagina Analisi dei log per la visualizzazione del progetto Google Cloud di eseguire la query salvata, attiva il pulsante di attivazione/disattivazione Condividi con il progetto.

   Per impostazione predefinita, questo pulsante è disattivato e la visibilità è limitata a te.

5. Fai clic su Salva query.

6. (Facoltativo) Per visualizzare, ordinare ed eseguire le query salvate visibili, seleziona la scheda Salvate.

   Puoi ordinare e filtrare le query salvate in base a nome, descrizione ed etichetta di visibilità. Puoi anche filtrare in base ai contenuti della query.

Puoi modificare ed eliminare le query che hai creato utilizzando le opzioni nella scheda Salvate:

• Per modificare una query, fai clic su Altre opzioni e seleziona Modifica. Puoi modificare i valori dei campi Nome e Descrizione, ma la query stessa non può essere modificata.

• Per eliminare una query salvata, fai clic su Altre opzioni e seleziona Elimina.

Condividere una query

Puoi condividere una query salvata con tutti gli utenti che hanno accesso al tuo progetto Google Cloud . Tuttavia, i ruoli IAM dell'entità determinano se la query può essere eseguita e i dati restituiti.

Console

Quando risolvi un problema o quando visualizzi risultati anomali, potresti voler condividere una query e i relativi risultati con un collega. Quando visualizzi i risultati della query nella pagina Log Analytics, puoi copiare un URL che, una volta aperto, mostra la query eseguita e i relativi risultati.

Per condividere una query e i risultati con un collega:

1. Nella console Google Cloud , vai alla pagina Analisi dei log:

   Vai ad Analisi dei log

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

2. Compila il riquadro Query con una query e poi fai clic su Esegui query.

   Puoi compilare il riquadro Query inserendo una nuova query, selezionandone una dalla scheda Recenti o selezionandone una dalla scheda Salvate.

3. Fai clic su Condividi link.

4. Invia il link al tuo compagno di squadra.

   Quando il tuo collega apre il link, viene visualizzata la pagina Log Analytics, ma la query non viene eseguita. Il tuo compagno di squadra deve eseguire manualmente la query.

   La pagina Analisi dei log mostra una finestra di dialogo di avviso quando la query viene eseguita sul motore BigQuery e le risorse sottoposte a query non si trovano nello stesso limite di proprietà. I limiti di proprietà sono determinati da diversi fattori, uno dei quali è la gerarchia delle risorse utilizzate dalla query.

   Per aprire correttamente l'URL, il ruolo IAM del tuo collega nel progetto Google Cloud deve includere le autorizzazioni necessarie per visualizzare la pagina Analisi dei log.

Visualizzare ed eseguire query recenti o salvate

Per visualizzare o eseguire di nuovo una query, seleziona la scheda Recenti nella pagina Analisi dei log e trova la query:

• Per eseguire la query, fai clic su Esegui.
• Per visualizzare la query, utilizza le opzioni nel menu Altre opzioni.

Per visualizzare, modificare o eseguire una query salvata, seleziona la scheda Salvate nella pagina Analisi dei log e trova la query:

• Per eseguire la query, fai clic su Esegui.
• Per modificare, visualizzare o eliminare la query, utilizza le opzioni nel menu Altre opzioni.

Passaggi successivi

• Grafici dei risultati delle query SQL.
• Query SQL di esempio.