Anteprima delle query SQL

Questo documento mostra come visualizzare l'output di un'query SQL in un workspace Dataform prima di eseguire la query in BigQuery.

Informazioni sull'anteprima delle query in Dataform

Quando sviluppi una query in un file SQLX o JavaScript con Dataform Core, Dataform compila la query in SQL in tempo reale. Per testare l'output della query SQL compilata prima di eseguirla in BigQuery, puoi eseguire l'anteprima della query nel tuo workspace Dataform.

Quando esegui l'anteprima di una query, Dataform esegue un job in BigQuery per eseguire la query compilata in una tabella di destinazione temporanea e visualizzare i risultati della query nel tuo workspace. Puoi esaminare l'output della query prima di attivare l'esecuzione per pubblicare la tabella in BigQuery. La tabella temporanea con la query visualizzata in anteprima viene eliminata automaticamente entro 24 ore. Per saperne di più sui job BigQuery, consulta Gestire i job.

L'esecuzione dell'anteprima della query in Dataform comporta la fatturazione in BigQuery. Per ulteriori informazioni sui prezzi di BigQuery, consulta la pagina Prezzi di BigQuery.

Durante l'anteprima della query, Dataform utilizza le credenziali utente per eseguire i job in BigQuery. Tuttavia, durante l'esecuzione del workflow, Dataform utilizza le credenziali delaccount di serviziot per creare o aggiornare gli asset in BigQuery.

Dataform mostra i risultati di tutte le query visualizzate in anteprima durante la sessione del browser corrente nel riquadro Risultati query del workspace. Nel riquadro Risultati query, puoi visualizzare le seguenti informazioni su ogni query visualizzata in anteprima durante la sessione del browser corrente:

  • Informazioni job
    • ID job BigQuery
    • Utente che esegue l'anteprima
    • Posizione in cui viene eseguito il job, ricavata dal file delle impostazioni del workflow
    • Ora di creazione, inizio e fine del job BigQuery
    • Durata del job BigQuery
    • Byte elaborati
    • Byte fatturati in BigQuery
    • Priorità job
    • Utilizzo di SQL precedente nella query
    • Tabella di destinazione temporanea della query
  • Risultati della query
  • Rappresentazione JSON dell'output della query

Inoltre, nel riquadro Risultati query, puoi andare al file di origine di ogni query visualizzata in anteprima e a BigQuery Studio per visualizzare il job di anteprima.

Prima di iniziare

  1. Nella console Google Cloud , vai alla pagina Dataform.

    Vai alla pagina Dataform

  2. Seleziona o crea un repository.

  3. Seleziona o crea un workspace di sviluppo.

  4. Crea una query SQL, ad esempio, create a table.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare l'anteprima delle query, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

  • Editor Dataform (roles/dataform.editor) - spazi di lavoro
  • BigQuery Job User (roles/bigquery.jobUser) - il progetto

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.

Visualizzare l'anteprima di una query

Per esaminare i risultati della query in Dataform prima dell'esecuzione, esegui l'anteprima di una query nel tuo workspace. Se il file in fase di modifica contiene più query, seleziona la query di cui vuoi visualizzare l'anteprima. Puoi visualizzare l'anteprima di una query alla volta.

L'esecuzione dell'anteprima è leggermente diversa per le tabelle con asserzioni. Per ulteriori informazioni, vedi Visualizzare l'anteprima di una tabella con asserzioni.

Per visualizzare l'anteprima di una query SQL e visualizzare i risultati della query in uno spazio di lavoro Dataform:

  1. Nel riquadro File, espandi definitions/.
  2. Seleziona un file SQLX o JavaScript.
  3. Fai clic su Esegui.
    1. Se il file contiene più query, seleziona quella che vuoi visualizzare in anteprima nel menu a discesa.
  4. Esamina i risultati dell'anteprima nel riquadro Risultati query.
    1. Per esaminare i dettagli del job, seleziona la scheda Informazioni sul job.
    2. Per esaminare i risultati della query, seleziona la scheda Risultati.
    3. Per visualizzare l'output JSON della query, seleziona la scheda JSON.
    4. Per visualizzare il job di anteprima nell'area di lavoro SQL, fai clic sul menu Altro > Visualizza job nell'area di lavoro SQL.

Visualizzare l'anteprima di una tabella con asserzioni

In un file di definizione della tabella SQLX con asserzioni, puoi visualizzare l'anteprima della query di creazione della tabella e delle query di asserzione definite.

Dataform considera la query di definizione della tabella come query predefinita. Per visualizzare l'anteprima della query di creazione della tabella, fai clic su Esegui nell'area di lavoro. Per visualizzare l'anteprima di una query di asserzione, devi selezionarla in un menu a discesa accanto al pulsante Esegui. Puoi visualizzare l'anteprima di una query alla volta.

Per visualizzare l'anteprima di una query in un file di definizione della tabella con asserzioni in uno spazio di lavoro Dataform:

  1. Nel riquadro File, espandi definitions/.
  2. Seleziona un file di definizione di una tabella con asserzioni.
  3. Esegui anteprima:
    • Per visualizzare l'anteprima della query di creazione della tabella, fai clic su Esegui.
    • Per visualizzare l'anteprima di una query di asserzione, fai clic sull'icona del menu a discesa accanto a Esegui e poi seleziona la query di cui vuoi visualizzare l'anteprima.
  4. Esamina i risultati dell'anteprima nel riquadro Risultati query.
    1. Per esaminare i dettagli del job, seleziona la scheda Informazioni sul job.
    2. Per esaminare i risultati della query, seleziona la scheda Risultati.
    3. Per visualizzare l'output JSON della query, seleziona la scheda JSON.
    4. Per visualizzare il job di anteprima nell'area di lavoro SQL, fai clic sul menu Altro > Visualizza job nell'area di lavoro SQL.

Passaggi successivi