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 a Dataform l'accesso a BigQuery.

  • Configura gli override della compilazione dell'area di lavoro.

  Configura gli override della compilazione che Dataform applicherà a tutte le estensioni nel tuo repository, trasformandole in ambienti di sviluppo indipendenti.

• Elimina gli asset creati.

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 and Dataform 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 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:

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

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.

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 workflow in BigQuery, l'account di servizio Dataform deve disporre dei seguenti ruoli obbligatori:

• Editor dati BigQuery nei progetti a cui Dataform deve avere accesso in lettura e scrittura. Generalmente includono il progetto che ospita il tuo repository Dataform.
• Visualizzatore dati BigQuery nei progetti a cui Dataform deve avere accesso di sola lettura.
• Utente job BigQuery nel progetto che ospita il tuo repository Dataform.

Per concedere questi ruoli:

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.

4. Nell'elenco a discesa Seleziona un ruolo, seleziona il ruolo Utente job BigQuery.

5. Fai clic su Aggiungi un altro ruolo e nell'elenco a discesa Seleziona un ruolo, seleziona il ruolo Editor dati BigQuery.

6. Fai clic su Aggiungi un altro ruolo e nell'elenco a discesa Seleziona un ruolo, seleziona il ruolo Visualizzatore dati BigQuery.

7. Fai clic su Salva.

Configura gli override di compilazione dell'area di lavoro

Per creare ambienti di sviluppo isolati con override di compilazione dell'area di lavoro 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'area di lavoro, Dataform aggiunge il nome dell'area di lavoro come suffisso allo schema predefinito impostato nelle impostazioni del flusso di lavoro. Questa guida rapida utilizza le impostazioni predefinite di Dataform con lo schema predefinito dataform.

5. Fai clic su Salva.

Dataform applica override di compilazione dell'area di lavoro a tutte le aree di lavoro nel tuo repository.

Con questa configurazione, quando esegui manualmente un flusso di lavoro SQL in un'area di lavoro, Dataform lo esegue con gli override di compilazione dell'area di lavoro. Di conseguenza, Dataform esegue il flusso di lavoro SQL nello schema dataform_workspaceName in BigQuery, trasformando l'area di lavoro in un ambiente di sviluppo isolato.

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

Per eseguire flussi di lavoro SQL senza override di compilazione dell'area di lavoro, ma 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 su questa pagina, segui questi passaggi.

Eliminare 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:

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 saperne di più sul ciclo di vita del codice in Dataform, consulta la sezione 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 Gestire il ciclo di vita del codice.

• Per scoprire di più sugli override della compilazione dell'area di lavoro in Dataform, consulta Creare override della compilazione dell'area di lavoro.

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