Dataform コア パッケージを更新する

このドキュメントでは、Dataform コアを最新バージョンに更新する方法について説明します。

Dataform コアは、SQLX と JavaScript を使用して SQL ワークフローを開発するためのオープンソースの Dataform フレームワークです。

リポジトリで最初のワークスペースを初期化すると、Dataform は Dataform コアを依存関係パッケージとして package.json ファイルに自動的にインストールします。

Dataform コア フレームワークの利用可能な最新バージョンは常に使用することをおすすめします。Dataform コア フレームワークのリリースについては、GitHub の Dataform リリースをご覧ください。

本番環境でのパッケージのインストールに関する問題を回避するには、次の手順を行うことをおすすめします。

  • package.json で Dataform コア パッケージ バージョンを明示的に指定します（例: 3.0.0）。package.json の他の dependencies オプション（>version など）は使用しないでください。

  • 新しいパッケージのバージョンを非本番環境でテストします。さまざまなコード ライフサイクル環境の構成の詳細については、コード ライフサイクルの管理をご覧ください。

始める前に

  1. リポジトリを作成する
  2. 開発ワークスペースを作成して初期化します。

必要なロール

Dataform の更新に必要な権限を取得するには、ワークスペースに対する Dataform 編集者 （roles/dataform.editor）IAM ロールの付与を管理者に依頼してください。ロールの付与の詳細については、アクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Dataform コアを更新する

  1. GitHub の Dataform リリースページで、@dataform/core の最新バージョンを調べます。

  2. Google Cloud コンソールの [Dataform] ページに移動します。

    [Dataform] ページに移動

  3. リポジトリを選択し、ワークスペースを選択します。

  4. [ファイル] ペインで package.json ファイルを開きます。

  5. @dataform/core の依存関係を最新の Dataform バージョンに更新します。

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

    VERSION は、3.0.0 など、最新バージョンの Dataform に置き換えます。

  6. [パッケージをインストール] をクリックします。

  7. 変更を commit します。

  8. 変更をリポジトリに push します。

次のコードサンプルは、package.json ファイル内の 3.0.0 バージョンに更新された @dataform/core 依存関係を示しています。

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

次のステップ