Visualizza l'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 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 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 esaminare l'output della query prima di attivare l'esecuzione per pubblicare la tabella in BigQuery. La tabella temporanea con la query in anteprima viene eliminata automaticamente entro 24 ore. Per ulteriori informazioni sui job BigQuery, consulta Introduzione ai job BigQuery.

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

Durante l'anteprima delle 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 query dell'area di lavoro. Nel riquadro Risultati delle query puoi visualizzare le seguenti informazioni su ogni query visualizzata in anteprima durante la sessione del browser corrente:

  • Informazioni sull'offerta di lavoro
    • ID job BigQuery
    • Utente che esegue l'anteprima
    • Località in cui viene eseguito il job, recuperata dal file dataform.json
    • Creazione, ora di inizio e di fine del job BigQuery
    • Durata del job BigQuery
    • Byte elaborati
    • Byte fatturati in BigQuery
    • Priorità job
    • Utilizzo dell'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 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 in un'area di lavoro Dataform, chiedi all'amministratore di concederti i ruoli IAM seguenti:

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

Potresti anche essere in grado di 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 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 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 nel menu a discesa la query di cui vuoi visualizzare l'anteprima.
  4. Controlla i risultati dell'anteprima nel riquadro Risultati query.
    1. Per esaminare i dettagli del job, seleziona la scheda Informazioni 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.

Visualizza l'anteprima di una tabella con asserzioni

In un file di definizione di tabella SQLX con asserzioni, puoi visualizzare l'anteprima della query di creazione della tabella e delle query di asserzioni 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 sull'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 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 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 di cui vuoi visualizzare l'anteprima.
  4. Controlla i risultati dell'anteprima nel riquadro Risultati query.
    1. Per esaminare i dettagli del job, seleziona la scheda Informazioni 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