Creare flussi di lavoro

Anteprima

Questo prodotto è soggetto ai "Termini delle offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per richiedere assistenza o fornire feedback su questa funzionalità, invia un'email all'indirizzo [e-mail].

Questo documento descrive come creare flussi di lavoro in BigQuery. Workflows sono basati su Dataform.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the BigQuery, Dataform, and Vertex AI APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the BigQuery, Dataform, and Vertex AI APIs.

   Enable the APIs

8. Segui le istruzioni riportate in Attivare la gestione degli asset di codice per salvare, condividere e gestire le versioni degli asset di codice, come i flussi di lavoro.
9. Se è la prima volta che crei un asset di codice, imposta la regione predefinita per l'archiviazione degli asset di codice. Non puoi modificare la regione di una risorsa di codice dopo averlo creata.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare i workflow, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

• Per creare flussi di lavoro: Code Creator (roles/dataform.codeCreator)
• Per modificare ed eseguire i flussi di lavoro: Editor Dataform (roles/dataform.editor)

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.

Per ulteriori informazioni su Dataform IAM, consulta Controllo dell'accesso con IAM.

Nota: quando crei un workflow, BigQuery ti concede il ruolo Dataform Admin (roles/dataform.admin) appositamente per quel workflow. In questo modo avrai accesso come proprietario per gestirla e modificarla. Chiunque abbia ricevuto il ruolo Amministratore Dataform a livello di progetto Google Cloud avrà accesso come proprietario a tutti i flussi di lavoro all'interno del progetto.

Crea un flusso di lavoro

Per creare un flusso di lavoro:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

2. Nella barra delle schede del riquadro dell'editor, fai clic sul menu a discesa con la freccia accanto al segno + e poi su Flusso di lavoro.

3. (Facoltativo) Per rinominare il flusso di lavoro, fai clic sul nome del flusso di lavoro e poi digita un nuovo nome.

4. Fai clic su Inizia, poi vai alla scheda Impostazioni.

5. Nel campo Account di servizio, seleziona un account di servizio Dataform.

6. Nella sezione Località, seleziona una regione di elaborazione per il flusso di lavoro.

   1. Per selezionare una regione specifica, seleziona Regione e poi seleziona una regione nel menu a discesa Regione.
   2. Per selezionare più regioni, seleziona Più regioni e poi seleziona una più regioni nel menu a discesa Più regioni.

   La regione di elaborazione del flusso di lavoro non deve corrispondere alla regione di archiviazione predefinita per gli asset di codice.

7. Se prevedi di aggiungere un notebook al tuo flusso di lavoro:

   1. Nel campo Bucket Cloud Storage, fai clic su Sfoglia e seleziona o crea un bucket Cloud Storage per archiviare l'output dei notebook nel tuo flusso di lavoro.

   2. Segui la procedura descritta in Aggiungere un'entità a un criterio a livello di bucket per aggiungere il tuo account di servizio Dataform personalizzato come entità al bucket Cloud Storage che prevedi di utilizzare per archiviare l'output delle esecuzioni pianificate del flusso di lavoro e concedi a questa entità il ruolo Amministratore dello spazio di archiviazione (roles/storage.admin).

      All'account di servizio Dataform personalizzato selezionato deve essere concesso il ruolo IAM Storage Admin per il bucket selezionato.

Aggiungere un'attività di flusso di lavoro

Per aggiungere un'attività a un flusso di lavoro:

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Workflow, quindi seleziona un flusso di lavoro.

3. Per aggiungere una query SQL o un notebook:

   Query SQL

   1. Fai clic su Aggiungi attività e poi seleziona Query.

   2. (Facoltativo) Nel riquadro Dettagli attività di query, seleziona un'attività che precederà la query nel menu a discesa Esegui dopo.

      La query dipenderà dall'attività precedente.

   3. Per creare la query, fai clic su Crea query.

   4. Nella nuova query, aggiungi la sintassi della query e poi fai clic su Salva query.

   5. (Facoltativo) Per rinominare la query, fai clic sul nome della query e digita un nuovo nome.

   Blocco note

   1. Fai clic su Aggiungi attività e seleziona Notebook.

   2. (Facoltativo) Nel riquadro Dettagli attività del notebook, nel menu a discesa Esegui dopo, seleziona un'attività che precederà il tuo blocco note.

      Il tuo blocco note dipenderà dall'attività precedente.

   3. Per creare il blocco note, fai clic su Crea blocco note.

   4. Nel nuovo blocco note, aggiungi i contenuti e poi fai clic su Salva.

   5. (Facoltativo) Per rinominare il blocco note, fai clic sul nome del blocco note e digita un nuovo nome.

Modificare un'attività del flusso di lavoro

Per modificare un'attività del flusso di lavoro:

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Workflow, quindi seleziona un flusso di lavoro.

3. Fai clic sull'attività selezionata.

4. Per modificare l'attività precedente, nel menu a discesa Esegui dopo, seleziona un'attività che precederà il blocco note.

5. Per modificare i contenuti dell'attività selezionata, fai clic su Modifica.

6. Nella nuova scheda che si apre, modifica i contenuti dell'attività e poi salva le modifiche apportate.

Eliminare un'attività del flusso di lavoro

Per eliminare un'attività da un flusso di lavoro:

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Workflow, quindi seleziona un flusso di lavoro.

3. Fai clic sull'attività selezionata.

4. Nel riquadro Dettagli attività, fai clic sull'icona EliminaElimina.

Esegui un flusso di lavoro

Per eseguire manualmente la versione corrente di un flusso di lavoro:

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Workflow, quindi seleziona un flusso di lavoro.

3. Fai clic su Esegui.

4. (Facoltativo) Per ispezionare l'esecuzione, visualizza le esecuzioni manuali precedenti.

Passaggi successivi

• Scopri di più sulle workflow in BigQuery.
• Scopri come gestire i flussi di lavoro.