Crea una configurazione della release

Questo documento mostra come creare una configurazione della release in Dataform per configurare modelli di impostazioni di compilazione che puoi eseguire in base a una programmazione. Puoi usare le configurazioni della release per e configurare ambienti di esecuzione, ad esempio gestione temporanea e produzione.

Informazioni sulle configurazioni delle release Dataform

Per eseguire flussi di lavoro SQL in BigQuery, Dataform compila il codice SQL del flusso di lavoro in un risultato della compilazione. Questo processo avviene automaticamente quando sviluppi un flusso di lavoro SQL in un'area di lavoro Dataform.

Le configurazioni della release consentono di personalizzare i risultati della compilazione. Puoi utilizzarle per creare ambienti di esecuzione, come la gestione temporanea.

Impostazioni di configurazione della release

In una configurazione di release, puoi configurare override delle compilazioni impostazioni del flusso di lavoro, imposta le variabili di compilazione e la frequenza della creazione dei risultati delle compilazioni.

Una configurazione di release Dataform contiene quanto segue impostazioni di compilazione:

Impostazioni di release
ID della release, commitish Git per i risultati della compilazione e la frequenza di creazione dei risultati della compilazione. La frequenza è un'impostazione facoltativa. Se impostata, la frequenza minima è 1 ora.
Override delle compilazioni
Override di Google Cloud progetto, prefisso della tabella, suffisso dello schema e variabili di compilazione definiti nelle impostazioni del flusso di lavoro.

Come funziona la configurazione di una release

Dataform crea i risultati della compilazione da una configurazione di release in la frequenza specificata o quando si attiva la compilazione. La frequenza è un'impostazione facoltativa e non è obbligatoria. per creare una configurazione di release. Se impostata, la frequenza minima è 1 ora. Puoi attivare manualmente la compilazione nella pagina Dettagli configurazione della release, o attivare la compilazione con l'API Dataform releaseConfigs.

Durante la compilazione, Dataform estrae il codice dall'oggetto Commitish Git del tuo repository. Quindi, Dataform compila il codice con gli override di compilazione applicati (se presenti) e crea il risultato della compilazione. Il risultato dell'ultima compilazione creato per la release è il risultato della compilazione in tempo reale.

Puoi pianificare l'esecuzione dei risultati della compilazione dalle configurazioni della release nelle configurazioni del flusso di lavoro. Puoi anche eseguire una configurazione di release selezionata al di fuori di qualsiasi pianificazione. Durante l'esecuzione di configurazione di un flusso di lavoro, Dataform esegue il risultato della compilazione live dalla configurazione della release selezionata.

Prima di iniziare

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

    Vai alla pagina Dataform

  2. Seleziona o crea un repository.

  3. (Facoltativo) Per eseguire l'override del progetto Google Cloud predefinito nel configurazione della release, concedere all'account di servizio Dataform l'accesso al progetto Google Cloud che intendi utilizzare.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare una configurazione di release, chiedi all'amministratore di concederti Ruolo IAM Editor Dataform (roles/dataform.editor) nei repository. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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

Crea una configurazione della release

Per creare una configurazione di release Dataform:

  1. Nel tuo repository, vai a Release e Programmazione.
  2. Nella sezione Configurazioni della release, fai clic su Crea.

  3. Nel riquadro Crea configurazione release, configura le impostazioni di release.

    1. Nel campo ID release, inserisci un ID univoco per la configurazione della release.

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

    2. Nel campo Git commitish, inserisci il ramo Git o il commit Git SHA per la release.

    In un repository Dataform non connesso a un repository remoto, il valore è sempre main.

    1. (Facoltativo) Nel menu a discesa Frequenza, seleziona la la frequenza di creazione dei risultati della compilazione.

      Se impostata, la frequenza minima è 1 ora.

  4. (Facoltativo) Nella sezione Override compilation, configura le impostazioni di compilazione.

    1. Nel campo ID progetto Google Cloud, inserisci l'ID del progetto in cui archiviare il risultato della compilazione.
    2. Nel campo Suffisso schema, inserisci un suffisso da aggiungere al schema configurato nelle impostazioni del flusso di lavoro.
    3. Nel campo Prefisso tabella, inserisci un prefisso per tutti i nomi delle tabelle.

  5. (Facoltativo) Nella sezione Variabili compilation, imposta le variabili di compilazione.

    1. Fai clic su Aggiungi variabile.
    2. Nel campo Chiave, inserisci la variabile di compilazione.
    3. Nel campo Valore, inserisci il valore per la variabile di compilazione.
    4. Per aggiungere un'altra variabile di compilazione, fai clic su Aggiungi variabile.

  6. Fai clic su Crea.

Se esegui l'override del progetto Google Cloud predefinito, assicurati che il tuo account di servizio Dataform abbia accesso al progetto Google Cloud impostato nella configurazione della release.



Ad esempio, la seguente configurazione della release crea un production il risultato della compilazione dalla filiale main ogni ora, senza override delle compilazioni:

  • ID release: production
  • Commitish Git: main
  • Frequenza: oraria
  • nessun override della compilazione

Visualizzare i dettagli di una configurazione di release

Puoi visualizzare i seguenti dettagli della configurazione di una release:

  • Impostazioni di release
    • Commitish Git
    • Timestamp ultima compilazione
    • Pianificazione cron
    • Override delle compilazioni
    • Variabili di compilazione
  • Risultato della compilazione live
    • Timestamp creazione
    • Commitish Git
    • SHA di commit
  • Risultati delle compilazioni precedenti

Per visualizzare i dettagli della configurazione di una release:

  1. Nel tuo repository, vai a Release e Programmazione.
  2. Seleziona una configurazione della release.
  3. Nella pagina Dettagli configurazione della release, esamina i dettagli della configurazione della release.

La tabella Risultati delle compilazioni pianificate mostra i risultati delle compilazioni precedenti vengono creati automaticamente dalla configurazione della release.

La tabella Risultati della compilazione manuale/API mostra i risultati della compilazione creati manualmente o tramite chiamate all'API Dataform dal più recente la risposta 1000 avrà i risultati nel repository.

Attiva manualmente la compilazione

Per creare manualmente il risultato di una compilazione da una configurazione di release selezionata: segui questi passaggi:

  1. Nel tuo repository, vai a Release e Programmazione.
  2. Seleziona una configurazione della release.
  3. Nella pagina Dettagli configurazione della release, fai clic su Nuova compilazione.

Il risultato della compilazione appena creato diventa il risultato in tempo reale per la configurazione della release.

I risultati della compilazione manuale vengono visualizzati nella Tabella Risultati della compilazione manuale/API nella Pagina Dettagli di configurazione della release.

Attivare l'esecuzione di una configurazione di release

Per attivare l'esecuzione del risultato della compilazione in tempo reale in un di release in BigQuery, segui questi passaggi:

  1. Nel tuo repository, vai a Release e Programmazione.
  2. Nella sezione Configurazioni della release, fai clic su Avvia esecuzione.
  3. Nel riquadro Esegui flusso di lavoro manuale, nella sezione Configurazione della release seleziona una configurazione della release.
  4. Seleziona le azioni del flusso di lavoro SQL da eseguire:
    1. Per eseguire l'intero flusso di lavoro SQL, fai clic su Tutte le azioni.
    2. Per eseguire azioni selezionate nel flusso di lavoro SQL, fai clic su Selezione di azioni e poi seleziona le azioni.
    3. Per eseguire azioni con i tag selezionati, fai clic su Selezione dei tag, quindi seleziona i tag.
  5. (Facoltativo) Per eseguire le azioni o i tag selezionati e le rispettive dipendenze, seleziona l'opzione Includi dipendenze.
  6. (Facoltativo) Per eseguire le azioni o i tag selezionati e i relativi dipendenti, seleziona l'opzione Includi i dipendenti.

  7. (Facoltativo) Per ricreare tutte le tabelle da zero, seleziona Esegui con aggiornamento completo.

    Senza questa opzione, Dataform aggiorna le tabelle incrementali senza a ricrearli da zero.

  8. Fai clic su Avvia esecuzione.

Modifica la configurazione di una release

Per modificare la configurazione di una release:

  1. Nel tuo repository, vai a Release e Programmazione.
  2. Accanto alla configurazione della release che vuoi modificare, fai clic sul Menu Altro e poi fai clic su Modifica.
  3. Nel riquadro Modifica configurazione release, modifica la configurazione della release impostazioni e fai clic su Salva.

Elimina una configurazione di release

Per eliminare la configurazione di una release:

  1. Nel tuo repository, vai a Release e Programmazione.
  2. In corrispondenza della configurazione della release che vuoi eliminare, fai clic sull'icona Menu Altro, quindi fai clic su Elimina.
  3. Nella finestra di dialogo Elimina configurazione release, fai clic su Elimina.

Passaggi successivi