Crea un repository Dataform

Questo documento mostra come creare un repository, impostare e modificare l'account di servizio del repository ed eliminare un repository in Dataform.

Quando crei un repository Dataform, devi configurare le seguenti impostazioni per il repository:

ID repository

Un ID univoco del repository. Gli ID possono includere solo numeri, lettere, trattini e trattini bassi.

Regione

Regione Dataform per l'archiviazione del repository e dei suoi contenuti.

Questa regione di archiviazione può essere diversa da quella di elaborazione in cui Dataform elabora il codice e archivia l'output delle esecuzioni. Per impostazione predefinita, la regione di elaborazione è impostata sulla regione predefinita del set di dati BigQuery. Puoi modificare la regione di elaborazione nel file dataform.json dopo aver creato il repository. Per ulteriori informazioni, consulta Configurare le impostazioni di Dataform.

Account di servizio

Account di servizio associato al repository. Puoi selezionare l'account di servizio Dataform predefinito, un account di servizio associato al progetto Google Cloud o inserire manualmente un account di servizio diverso. Per impostazione predefinita, Dataform utilizza un account di servizio derivato dal numero del progetto nel seguente formato:

[e-mail]

Dataform utilizza l'account di servizio predefinito per tutte le operazioni del repository. Puoi utilizzare un account di servizio diverso per eseguire i flussi di lavoro nel repository, ma l'account di servizio predefinito viene ancora utilizzato per tutte le altre operazioni sul repository.

Crittografia

Metodo di crittografia per il repository. Puoi utilizzare la crittografia predefinita o applicare una chiave di crittografia Cloud KMS gestita dal cliente. Per saperne di più sull'utilizzo delle chiavi di crittografia gestite dal cliente (CMEK) in Dataform, consulta Utilizzare le chiavi di crittografia gestite dal cliente.

Dopo aver creato un repository, puoi connetterlo a GitHub o GitLab.

Importante: per creare un repository Dataform connesso a un repository Git remoto non incluso nella lista consentita nel criterio dataform.restrictGitRemotes, aggiungi prima il repository Git remoto all'elenco allowedValues nel criterio, quindi crea un nuovo repository Dataform e connettilo al repository remoto. Per maggiori informazioni, consulta Limitare i repository remoti.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Abilita le API BigQuery and Dataform.

   Abilita le API

5. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

7. Abilita le API BigQuery and Dataform.

   Abilita le API

8. Per utilizzare la crittografia CMEK per il repository, abilita la crittografia CMEK dei repository Dataform.

Importante: prima di creare un repository Dataform che vuoi connetterti a un repository Git remoto, verifica se la tua organizzazione o il tuo progetto limita i repository Git remoti con il dataform.restrictGitRemotes criterio dell'organizzazione. Se il criterio è attivo, assicurati che il repository remoto sia incluso nella lista consentita prima di creare il repository Dataform e connetterlo al repository remoto. Per maggiori informazioni, consulta Limitare i repository remoti

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare ed eliminare un repository, chiedi all'amministratore di concederti il ruolo IAM Amministratore Dataform (roles/dataform.admin) per i repository. 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.

Per utilizzare un account di servizio diverso da quello predefinito di Dataform, concedi l'accesso all'account di servizio personalizzato.

Nota: un account di servizio personalizzato associato a un repository Dataform viene utilizzato solo per eseguire i flussi di lavoro di quel repository. Tutte le altre operazioni sul repository vengono comunque eseguite dall'account di servizio Dataform predefinito.

Crea un repository

Per creare 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, inserisci un ID univoco nel campo ID repository.

   Gli ID possono includere solo numeri, lettere, trattini e trattini bassi.

4. Nell'elenco a discesa Regione, seleziona una regione Dataform per archiviare il repository e i suoi contenuti. Seleziona la regione Dataform più vicina alla tua sede.

   Per un elenco delle regioni Dataform disponibili, consulta Località. La regione del repository non deve necessariamente corrispondere alla località dei set di dati BigQuery.

   Nel file dataform.json, puoi impostare la regione di elaborazione in cui Dataform elabora il codice e archivia l'output delle esecuzioni. La regione di elaborazione deve corrispondere alla località dei set di dati BigQuery, ma non deve necessariamente corrispondere a quella del repository. Per maggiori informazioni, consulta Configurare le impostazioni di Dataform.

5. Nel menu a discesa Account di servizio, seleziona un account di servizio per il repository.

   Nel menu a discesa, puoi selezionare l'account di servizio Dataform predefinito o qualsiasi account di servizio associato al progetto Google Cloud a cui hai accesso. Gli account di servizio personalizzati vengono utilizzati solo per l'esecuzione del flusso di lavoro. Tutte le altre operazioni sul repository vengono comunque eseguite dall'account di servizio Dataform predefinito.

   1. (Facoltativo) Per selezionare un account di servizio non visualizzato nel menu a discesa, fai clic su Inserisci manualmente e inserisci un ID account di servizio.

6. Nella sezione Crittografia, seleziona il metodo di crittografia per il repository.

   1. Per utilizzare la crittografia predefinita, seleziona l'opzione Chiave di crittografia gestita da Google.

   2. Per utilizzare CMEK, seleziona l'opzione Chiavi di crittografia gestite dal cliente (CMEK).

      1. Nel menu a discesa Seleziona una chiave gestita dal cliente, seleziona una chiave CMEK per il repository.
   Nota: non puoi modificare il meccanismo di crittografia di un repository Dataform dopo la creazione del repository.

   Per saperne di più, consulta Limitazioni CMEK di Dataform.

7. Fai clic su Crea e poi su Fine.

Modifica l'account di servizio

Puoi associare un account di servizio personalizzato a un repository Dataform per l'esecuzione del flusso di lavoro. Tutte le altre operazioni sul repository vengono comunque eseguite dall'account di servizio Dataform predefinito.

Per modificare l'account di servizio per un repository Dataform:

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

   Vai a Dataform

2. Seleziona un repository e fai clic su Impostazioni.

3. Nel campo Account di servizio, fai clic su Modifica account di servizio.

4. Nel menu a discesa Account di servizio, seleziona un account di servizio per il repository.

   Nel menu a discesa, puoi selezionare l'account di servizio Dataform predefinito o qualsiasi account di servizio associato al progetto Google Cloud a cui hai accesso.

   1. (Facoltativo) Per selezionare un account di servizio non visualizzato nel menu a discesa, fai clic su Inserisci manualmente e inserisci un ID account di servizio.

5. Fai clic su Salva.

Elimina un repository

Per eliminare un repository e tutti i suoi contenuti:

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

   Vai a Dataform

2. In corrispondenza del repository che vuoi eliminare, fai clic sul menu Altro, quindi seleziona Elimina.

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

4. Fai clic su Elimina.

Passaggi successivi

• Per scoprire come configurare le impostazioni di elaborazione di Dataform, consulta Configurare le impostazioni di Dataform.

• Per scoprire come collegare un repository Dataform a un provider Git di terze parti, consulta Connettersi a un repository Git di terze parti.

• Per scoprire di più sull'utilizzo di CMEK in Dataform, vedi Utilizzare chiavi di crittografia gestite dal cliente.

• Per scoprire come creare un'area di lavoro di sviluppo, consulta Creare un'area di lavoro.