Creare uno spazio di lavoro di sviluppo Dataform

Questo documento illustra come:

Quando crei un'area di lavoro di sviluppo in un nuovo repository per la prima volta, Dataform ti chiede di inizializzarla con un insieme di file di configurazione necessari per il funzionamento di Dataform.

Uno spazio di lavoro di sviluppo inizializzato contiene le seguenti directory e file:

  • definitions/: una directory per le definizioni delle risorse, nel nucleo di Dataform o in JavaScript.

  • includes/: una directory vuota per script e variabili che puoi riutilizzare nel repository.

  • workflow_settings.yaml: il file di configurazione Dataform predefinito contenente l'ID progetto Google Cloud e lo schema BigQuery in cui pubblicare gli asset. Puoi sostituire le impostazioni predefinite per personalizzarle in base alle tue esigenze, ma non è un requisito per iniziare a utilizzare Dataform.

  • package.json: il file di configurazione delle dipendenze Dataform predefinite con la versione più recente di @dataform/core. Puoi utilizzare questo file per importare i pacchetti.

  • definitions/sample.sqlx: un file SQLX di esempio per aiutarti a iniziare.

Prima di iniziare

Se non l'hai ancora fatto, crea un repository Dataform.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare, inizializzare ed eliminare uno spazio di lavoro di sviluppo, chiedi all'amministratore di concederti il ruolo IAM Editor Dataform (roles/dataform.editor) per gli spazi di lavoro. 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.

Creare uno spazio di lavoro di sviluppo Dataform

Per creare una nuova area di lavoro di sviluppo Dataform:

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

    Vai a Dataform

  2. Seleziona il repository in cui vuoi creare il nuovo spazio di lavoro di sviluppo.

  3. Nella pagina del repository, fai clic su Crea area di lavoro di sviluppo.

  4. Nella finestra Crea area di lavoro di sviluppo:

    1. Nel campo ID area di lavoro, inserisci un ID univoco per l'area di lavoro di sviluppo.

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

    2. Fai clic su Crea.

Inizializzare la prima area di lavoro di sviluppo in un repository Dataform

Per inizializzare uno spazio di lavoro di sviluppo Dataform:

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

    Vai a Dataform

  2. Seleziona il repository in cui vuoi inizializzare lo spazio di lavoro vuoto.

  3. Nella scheda Aree di lavoro di sviluppo, fai clic sul nome dello spazio di lavoro vuoto che vuoi inizializzare.

  4. Nella pagina dello spazio di lavoro di sviluppo, fai clic su Inizializza area di lavoro.

Eliminare uno spazio di lavoro di sviluppo Dataform

Non sono previsti costi per la creazione di aree di lavoro di sviluppo di Dataform. Tuttavia, se vuoi eliminare uno spazio di lavoro di sviluppo:

  1. Nella pagina Dataform, fai clic sul repository contenente lo spazio di lavoro da eliminare.

  2. Per evitare di eliminare le modifiche non committate, esegui il commit e il push delle modifiche nel tuo repository Git.

  3. Nella scheda Aree di lavoro di sviluppo, seleziona lo spazio di lavoro di sviluppo che vuoi eliminare, quindi fai clic su Elimina spazi di lavoro selezionati.

    Puoi eliminare più spazi di lavoro contemporaneamente.

  4. Per confermare, fai clic su Elimina.

Passaggi successivi