Aggiorna il pacchetto principale Dataform

Questo documento mostra come aggiornare Dataform Core all'ultima versione.

Dataform core è il framework Dataform open source per lo sviluppo di flussi di lavoro SQL con SQLX e JavaScript.

Quando inizializza la prima area di lavoro in un repository, Dataform installa automaticamente il core Dataform come pacchetto di dipendenze nel file package.json.

Ti consigliamo di usare sempre l'ultima versione disponibile del framework di base Dataform. Per informazioni sulle release del framework di base di Dataform, consulta Release di Dataform su GitHub.

Per evitare problemi con l'installazione dei pacchetti nell'ambiente di produzione, ti consigliamo di procedere come segue:

  • Specifica in modo esplicito la versione del pacchetto principale Dataform in package.json, ad esempio 3.0.0. Non utilizzare altre opzioni dependencies di package.json, ad esempio >version.

  • Testa le nuove versioni del pacchetto in un ambiente non di produzione. Per ulteriori informazioni sulla configurazione di diversi ambienti del ciclo di vita del codice, consulta Gestire il ciclo di vita del codice.

Prima di iniziare

  1. Crea un repository.
  2. Crea e inizializza un'area di lavoro di sviluppo.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per aggiornare Dataform, chiedi all'amministratore di concederti il ruolo IAM Editor Dataform (roles/dataform.editor) nelle aree di lavoro. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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

Aggiorna core Dataform

  1. Cerca l'ultima versione di @dataform/core nella pagina delle release di Dataform su GitHub.

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

    Vai alla pagina Dataform

  3. Seleziona un repository, quindi seleziona un'area di lavoro.

  4. Nel riquadro File, apri il file package.json.

  5. Aggiorna la dipendenza @dataform/core con la versione Dataform più recente nel seguente formato:

    {
    "dependencies": {
        "@dataform/core": "VERSION"
    }
}

    Sostituisci VERSION con la versione più recente di Dataform, ad esempio 3.0.0.

  6. Fai clic su Installa pacchetti.

  7. Esegui il commit delle modifiche.

  8. Esegui il push delle modifiche al repository.

Il seguente esempio di codice mostra la dipendenza @dataform/core aggiornata alla versione 3.0.0 nel file package.json:

{
    "dependencies": {
        "@dataform/core": "3.0.0"
    }
}

Passaggi successivi