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 eseguirla in BigQuery.

Informazioni sull'anteprima delle query in Dataform

Quando sviluppi una query in un file SQLX o JavaScript con il core Dataform, 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 nell'area 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 temporanea e visualizzare i risultati della query nell'area di lavoro. Puoi controllare l'output della query prima di attivare l'esecuzione per pubblicare la tabella su 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 Prezzi di BigQuery.

Durante l'anteprima della query, Dataform utilizza le tue credenziali utente per eseguire job in BigQuery. Tuttavia, durante l'esecuzione del flusso di lavoro, Dataform utilizza le credenziali dell'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 delle query nell'area di lavoro. Nel riquadro Risultati query puoi visualizzare le seguenti informazioni su ogni query visualizzata in anteprima durante la sessione del browser corrente:

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

Inoltre, nel riquadro Risultati delle query puoi accedere al file di origine di ciascuna query visualizzata in anteprima e passare 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 sul tuo progetto:

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

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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 nell'area di lavoro. Se il file attualmente modificato contiene più query, seleziona quella di cui vuoi visualizzare l'anteprima. Puoi visualizzare l'anteprima di una query alla volta.

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

Per visualizzare l'anteprima di una query SQL e visualizzare i risultati in un'area di lavoro Dataform, segui questi passaggi:

  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 da visualizzare in anteprima nel menu a discesa.
  4. Controlla i risultati dell'anteprima nel riquadro Risultati delle query.
    1. Per esaminare i dettagli del lavoro, seleziona la scheda Informazioni sul lavoro.
    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.

Visualizza l'anteprima di una tabella con le asserzioni

In un file di definizione di tabelle 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 di tabella con le asserzioni in un'area di lavoro Dataform, segui questi passaggi:

  1. Nel riquadro File, espandi definitions/.
  2. Seleziona un file di definizione di una tabella con le 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, quindi seleziona la query da visualizzare in anteprima.
  4. Controlla i risultati dell'anteprima nel riquadro Risultati delle query.
    1. Per esaminare i dettagli del lavoro, seleziona la scheda Informazioni sul lavoro.
    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