Crea ambienti di sviluppo

Crea ambienti di sviluppo

Questa guida rapida illustra i passaggi per creare singoli ambienti di sviluppo in Dataform, in modo che ogni sviluppatore possa lavorare nel proprio ambiente di sviluppo:

• Crea un repository Dataform.

• Concedi l'accesso Dataform a BigQuery.

  • Configura gli override di compilazione del workspace.

  Configura gli override di compilazione che Dataform applicherà a tutti i workspace nel repository, trasformandoli in ambienti di sviluppo isolati.

• Pulizia degli asset creati.

Prima di iniziare

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.

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

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

Enable the BigQuery and Dataform APIs.

Enable the APIs

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

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

Enable the BigQuery and Dataform APIs.

Enable the APIs

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire tutte le attività di questo tutorial, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

• Amministratore Dataform (roles/dataform.admin) - repository
• Editor Dataform (roles/dataform.editor): spazi di lavoro e chiamate di workflow

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un repository Dataform

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

   Vai a Dataform

2. Fai clic su Crea repository.

3. Nella pagina Crea repository:

   1. Nel campo ID repository, inserisci quickstart-dev.

   2. Nell'elenco Regione, seleziona europe-west4.

   3. Fai clic su Crea.

4. Fai clic su Fine.

Concedi l'accesso Dataform a BigQuery

Per eseguire i flussi di lavoro in BigQuery, il account di servizio Dataform o il tuo Account Google (anteprima) deve disporre dei seguenti ruoli richiesti:

• Editor dati BigQuery sui progetti a cui Dataform deve accedere in lettura e scrittura. Di solito includono il progetto che ospita il repository Dataform.
• Visualizzatore dati BigQuery sui progetti a cui Dataform deve accedere in sola lettura.
• Utente job BigQuery nel progetto che ospita il repository Dataform.

Per concedere questi ruoli, segui questi passaggi:

1. Nella console Google Cloud vai alla pagina IAM.

   Vai alla pagina IAM

2. Fai clic su Aggiungi.

3. Nel campo Nuove entità, inserisci l'ID account di servizio Dataform o l'email del tuo Account Google (anteprima).

4. Nel menu Seleziona un ruolo, seleziona il ruolo Utente job BigQuery.

5. Fai clic su Aggiungi un altro ruolo e poi seleziona il ruolo Editor dati BigQuery nel menu Seleziona un ruolo.

6. Fai clic su Aggiungi un altro ruolo e poi seleziona il ruolo Visualizzatore dati BigQuery nel menu Seleziona un ruolo.

7. Fai clic su Salva.

Configura gli override di compilazione dell'area di lavoro

Per creare ambienti di sviluppo isolati con override di compilazione del workspace Dataform:

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

   Vai a Dataform

2. Fai clic su quickstart-dev.

3. Fai clic su Impostazioni e poi su Modifica.

4. Nel riquadro Override di compilazione dell'area di lavoro, nel campo Suffisso schema, inserisci ${workspaceName}.

   Quando attivi l'esecuzione in un workspace, Dataform aggiunge il nome del workspace come suffisso allo schema predefinito impostato nelle impostazioni del workflow. Questa guida rapida utilizza le impostazioni predefinite di Dataform con lo schema predefinito dataform.

5. Fai clic su Salva.

Dataform applica override di compilazione del workspace a tutti gli workspace nel repository.

Con questa configurazione, quando esegui manualmente un workflow SQL in un workspace, Dataform lo esegue con gli override di compilazione del workspace. Di conseguenza, Dataform esegue il workflow SQL nello schema dataform_workspaceName in BigQuery, trasformando il workspace in un ambiente di sviluppo isolato.

Ad esempio, quando attivi manualmente l'esecuzione in un workspace sasha, Dataform esegue il workflow SQL nello schema dataform_sasha in BigQuery.

Se vuoi eseguire workflow SQL senza override di compilazione del workspace, ma vuoi mantenere questi override per gli ambienti di sviluppo, puoi creare configurazioni delle release per configurare altri ambienti di esecuzione, ad esempio staging e production.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Elimina i set di dati creati in BigQuery

Per evitare che ti vengano addebitati costi per gli asset BigQuery, elimina i set di dati i cui nomi iniziano con dataform, ad esempio dataform-sasha.

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

   Vai a BigQuery

2. Nel riquadro Spazio di esplorazione, espandi il progetto e seleziona un set di dati.

3. Fai clic sul menu Azioni e seleziona Elimina.

4. Nella finestra di dialogo Elimina set di dati, inserisci delete nel campo e fai clic su Elimina.

Elimina il repository Dataform

Non sono previsti costi per la creazione di repository di Dataform. Tuttavia, se vuoi eliminare un repository e tutti i relativi contenuti, segui questi passaggi:

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

   Vai a Dataform

2. Da quickstart-dev, fai clic sul menu Altro e seleziona Elimina.

   1. Nella finestra Elimina repository, inserisci il nome del repository per confermare l'eliminazione.

3. Per confermare, fai clic su Elimina.

Passaggi successivi

• Per scoprire di più sul ciclo di vita del codice in Dataform, consulta Introduzione al ciclo di vita del codice in Dataform.

• Per scoprire di più sulle best practice per il ciclo di vita del codice in Dataform, consulta la sezione Gestione del ciclo di vita del codice.

• Per scoprire di più sugli override di compilazione del workspace in Dataform, consulta Creare override di compilazione del workspace.

• Per scoprire come pianificare le esecuzioni di produzione in Dataform, consulta Pianificare le esecuzioni di produzione.