Anteprima delle query SQL

Questo documento mostra come visualizzare l'anteprima dell'output di una query SQL in un'area di lavoro Dataform prima di eseguire la query in BigQuery.

Informazioni sull'anteprima della 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 nello spazio di lavoro Dataform.

Quando esegui l'anteprima di una query, Dataform esegue un job in BigQuery per eseguire la query compilata in una tabella di destinazione provvisoria e visualizzare i risultati della query nello spazio di lavoro. 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 ulteriori informazioni sui job BigQuery, consulta Introduzione ai job BigQuery.

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

Durante l'anteprima della query, Dataform utilizza le tue credenziali utente per eseguire job in BigQuery. Tuttavia, durante l'esecuzione del workflow, Dataform utilizza le credenziali del tuo account di servizio 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 della tua area di lavoro. Nel riquadro Risultati della 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, presa dal file delle impostazioni del flusso di lavoro
    • Ore 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 accedere al file di origine di ogni query visualizzata in anteprima e andare 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'area di lavoro di sviluppo.

  4. Crea una query SQL, ad esempio definisci una tabella.

Ruoli obbligatori

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

  • Dataform Editor (roles/dataform.editor) - spazi di lavoro
  • Utente job BigQuery (roles/bigquery.jobUser): il progetto

Per saperne di più sulla concessione dei ruoli, consulta Gestire 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 ispezionare i risultati delle query in Dataform prima dell'esecuzione, esegui l'anteprima di una query nello spazio di lavoro. Se il file attualmente modificato contiene più query, seleziona quella di cui vuoi visualizzare l'anteprima. Puoi visualizzare l'anteprima di una sola query alla volta.

L'anteprima di esecuzione è leggermente diversa per le tabelle con asserzioni. Per ulteriori informazioni, consulta Anteprima di una tabella con asserzioni.

Per visualizzare l'anteprima di una query SQL e 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 la query di cui vuoi visualizzare l'anteprima nel menu a discesa.
  4. Controlla i risultati dell'anteprima nel riquadro Risultati query.
    1. Per controllare 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 nello spazio di lavoro SQL, fai clic sul menu Altro > Visualizza job nello spazio di lavoro SQL.

Visualizza 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 tratta la query di definizione della tabella come query predefinita. Per visualizzare l'anteprima della query di creazione della tabella, fai clic su Esegui nella tua area di lavoro. Per visualizzare l'anteprima di una query di affermazione, devi selezionarla in un menu a discesa accanto al pulsante Esegui. Puoi visualizzare l'anteprima di una sola 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 seleziona la query di cui vuoi visualizzare l'anteprima.
  4. Controlla i risultati dell'anteprima nel riquadro Risultati query.
    1. Per controllare 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 nello spazio di lavoro SQL, fai clic sul menu Altro > Visualizza job nello spazio di lavoro SQL.

Passaggi successivi