Aggiorna il pacchetto principale Dataform

Questo documento mostra come aggiornare il core Dataform all'ultima versione.

Il core Dataform è il framework Dataform open source per sviluppare 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 utilizzare sempre l'ultima versione disponibile del framework di base Dataform. Per informazioni sulle release dei il framework di base Dataform, consulta le Release di Dataform su GitHub.

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

  • Specifica esplicitamente la versione del pacchetto principale Dataform in package.json, ad esempio 3.0.0. Non utilizzare altro dependencies opzioni 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 Gestione del 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 Ruolo IAM dell'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 la ruoli o altri ruoli predefiniti ruoli.

Aggiorna core Dataform

  1. Cerca l'ultima versione di @dataform/core sul 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 l'ultima versione di Dataform nel formato seguente:

    {
        "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 in la versione 3.0.0 nel file package.json:

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

Passaggi successivi