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 delle query in Dataform

Quando sviluppi una query in un file SQLX o JavaScript con Core Dataform, Dataform compila la query in SQL in tempo reale. per testare l'output del codice SQL compilato prima di eseguirla in BigQuery, puoi eseguire un'anteprima 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 destinazione temporanea e visualizzare i risultati della query nell'area di lavoro. Puoi esaminare l'output la query prima di attivare l'esecuzione per pubblicare la tabella in BigQuery. La tabella temporanea con la query visualizzata in anteprima viene può essere eliminato 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 BigQuery Prezzi.

Durante l'anteprima della query, Dataform utilizza le tue credenziali utente per eseguire i job in BigQuery. Tuttavia, durante l'esecuzione del flusso di lavoro, Dataform utilizza le credenziali dell'account di servizio per creare o aggiornare in BigQuery.

Dataform visualizza i risultati di tutte le query visualizzate in anteprima durante il periodo del browser nel riquadro Risultati delle query nell'area di lavoro. Nella sezione Query dei risultati, puoi visualizzare le seguenti informazioni su ogni query visualizzati in anteprima durante la sessione del browser corrente:

  • Informazioni job
    • ID job BigQuery
    • Utente che esegue l'anteprima
    • Località in cui viene eseguito il job, recuperato dal tuo 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
    • 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 delle query puoi accedere al file di origine ogni query visualizzata in anteprima e vai a BigQuery Studio per vederne l'anteprima. un lavoro.

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 query dalla 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 la ruoli o altri ruoli predefiniti ruoli.

Visualizzare l'anteprima di una query

Per esaminare i risultati della query in Dataform prima dell'esecuzione, esegui l'anteprima di un nell'area di lavoro. Se il file attualmente modificato 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 è un po' diversa per le tabelle con asserzioni. Per ulteriori informazioni vedi Visualizzare l'anteprima di una tabella con le asserzioni.

Per visualizzare l'anteprima di una query SQL e visualizzare i risultati in un Dataform Workspace, 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 l'opzione dall'elenco a discesa. della query di cui vuoi visualizzare l'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 sull'icona Menu Altro > Visualizza il job nell'area di lavoro SQL.

Visualizza l'anteprima di una tabella con le asserzioni

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

Dataform considera la query di definizione della tabella come query predefinita. A visualizzare l'anteprima della query di creazione della tabella e fare clic su Esegui nell'area di lavoro. Per visualizzare l'anteprima di un asserzione, devi selezionarla nel menu a discesa accanto 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 nell'area di lavoro Dataform:

  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 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 sull'icona Menu Altro > Visualizza il job nell'area di lavoro SQL.

Passaggi successivi