Crea un'area di lavoro di sviluppo Dataform

Questo documento spiega come:

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

Un'area di lavoro di sviluppo inizializzata contiene le directory e i file seguenti:

  • definitions/: una directory per le definizioni degli asset, in Dataform core o JavaScript.

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

  • dataform.json: il file di configurazione Dataform predefinito contenente l'ID progetto Google Cloud e lo schema BigQuery in cui pubblicare gli asset. Puoi eseguire l'override delle impostazioni predefinite per personalizzarle in base alle tue esigenze, ma non è obbligatorio iniziare a utilizzare Dataform.

  • package.json: il file di configurazione delle dipendenze Dataform predefinito 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 un'area di lavoro di sviluppo, chiedi all'amministratore di concederti il ruolo IAM Editor Dataform (roles/dataform.editor) per le aree di lavoro. 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.

Crea un'area 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 la nuova area 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, segui questi passaggi:

    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.

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

Per inizializzare un'area di lavoro di sviluppo Dataform, segui questi passaggi:

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

    Vai a Dataform

  2. Seleziona il repository in cui vuoi inizializzare l'area di lavoro vuota.

  3. Nella scheda Aree di lavoro di sviluppo, fai clic sul nome dell'area di lavoro vuota da inizializzare.

  4. Nella pagina dell'area di lavoro di sviluppo, fai clic su Inizializza area di lavoro.

Elimina un'area di lavoro di sviluppo Dataform

Non sono previsti costi per la creazione di aree di lavoro di sviluppo di Dataform. Tuttavia, se vuoi eliminare un'area di lavoro di sviluppo, segui questi passaggi:

  1. Nella pagina Dataform, fai clic sul repository che contiene l'area di lavoro da eliminare.

  2. Per evitare di eliminare le modifiche di cui non è stato eseguito il commit, esegui il commit delle modifiche ed eseguine il push nel repository Git.

  3. Nella scheda Aree di lavoro di sviluppo, seleziona l'area di lavoro di sviluppo che vuoi eliminare, quindi fai clic su Elimina aree di lavoro selezionate.

    Puoi eliminare più aree di lavoro contemporaneamente.

  4. Per confermare, fai clic su Elimina.

Passaggi successivi