Dataform リポジトリの作成

このドキュメントでは、リポジトリの作成、リポジトリのサービス アカウントの設定と編集、Dataform でのリポジトリの削除を行う方法について説明します。

Dataform リポジトリを作成する際は、次のリポジトリ設定を行う必要があります。

リポジトリ ID

リポジトリの一意の ID。ID には数字、英字、ハイフン、アンダースコアのみを使用できます。

リージョン

リポジトリとそのコンテンツを保存するための Dataform リージョン。

このストレージ リージョンは、Dataform がコードを処理して実行結果を保存する処理リージョンとは異なる場合があります。デフォルトでは、処理リージョンはデフォルトの BigQuery データセット リージョンに設定されています。リポジトリを作成した後、ワークフロー設定ファイルで処理リージョンを編集できます。詳細については、Dataform の設定を行うをご覧ください。

サービス アカウント

リポジトリに関連付けられたサービス アカウント。デフォルトの Dataform サービス アカウント、Google Cloud プロジェクトに関連付けられたサービス アカウントを選択することも、別のサービス アカウントを手動で入力することもできます。 デフォルトでは、Dataform はプロジェクト番号から派生した次の形式のサービス アカウントを使用します。

[e-mail]

Dataform は、すべてのリポジトリ オペレーションにデフォルトのサービス アカウントを使用します。別のサービス アカウントを使用してリポジトリでワークフローを実行することができますが、他のすべてのリポジトリ オペレーションにはデフォルトのサービス アカウントが引き続き使用されます。

暗号化

リポジトリの暗号化方式。デフォルトの暗号化、一意の顧客管理の Cloud KMS 暗号鍵、またはデフォルトの Dataform CMEK 鍵を使用できます。Dataform で顧客管理の暗号鍵（CMEK）を使用する方法については、顧客管理の暗号鍵を使用するをご覧ください。

リポジトリを作成したら、GitHub または GitLab に接続できます。

重要: dataform.restrictGitRemotes ポリシーで許可リストに登録されていないリモート Git リポジトリに接続する Dataform リポジトリを作成するには、まずリモート Git リポジトリをポリシーの allowedValues リストに追加してから、新しい Dataform リポジトリを作成して、リモート リポジトリに接続します。詳細については、リモート リポジトリの制限をご覧ください。

始める前に

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the BigQuery and Dataform APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the BigQuery and Dataform APIs.

   Enable the APIs

8. リポジトリに CMEK 暗号化を使用するには、Dataform リポジトリの CMEK 暗号化を有効にする。

重要: リモートの Git リポジトリに接続する Dataform リポジトリを作成する前に、組織またはプロジェクトが、dataform.restrictGitRemotes 組織のポリシーを使用してリモートの Git リポジトリを制限しているかどうかを確認します。ポリシーが設定されている場合は、Dataform リポジトリを作成してリモート リポジトリに接続する前に、リモート リポジトリが許可リストに登録されていることを確認してください。詳細については、リモート リポジトリを制限するをご覧ください。

必要なロール

リポジトリの作成と削除に必要な権限を取得するには、リポジトリに対する Dataform 管理者 （roles/dataform.admin）IAM ロールの付与を管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

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

デフォルトの Dataform サービス アカウント以外のサービス アカウントを使用するには、カスタム サービス アカウントへのアクセス権を付与します。

注: Dataform リポジトリに関連付けられたカスタム サービス アカウントは、そのリポジトリのワークフローを実行するためにのみ使用されます。他のすべてのリポジトリ オペレーションは、引き続きデフォルトの Dataform サービス アカウントによって実行されます。

リポジトリを作成する

Dataform リポジトリの作成手順は次のとおりです。

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

   Dataform に移動

2. [リポジトリを作成] をクリックします。

3. [リポジトリの作成] ページの [リポジトリ ID] フィールドに一意の ID を入力します。

   ID には数字、英字、ハイフン、アンダースコアのみを使用できます。

4. [リージョン] プルダウン リストで、リポジトリとそのコンテンツを保存する Dataform リージョンを選択します。自分の場所に最も近い Dataform リージョンを選択します。

   使用可能な Dataform リージョンの一覧については、ロケーションをご覧ください。リポジトリ リージョンは、BigQuery データセットのロケーションと一致する必要はありません。

   workflow_settings.yaml ファイルでは、Dataform がコードを処理し、実行の出力を保存する処理リージョンを設定できます。処理リージョンは、BigQuery データセットのロケーションと一致する必要がありますが、リポジトリ リージョンと一致する必要はありません。詳細については、 Dataform の設定を構成するをご覧ください。

5. [サービス アカウント] プルダウンから、リポジトリのサービス アカウントを選択します。

   プルダウンからは、デフォルトの Dataform サービス アカウント、またはアクセス可能な Google Cloud プロジェクトに関連付けられているサービス アカウントを選択できます。カスタム サービス アカウントはワークフローの実行にのみ使用されることに注意してください。他のすべてのリポジトリ オペレーションは、デフォルトの Dataform サービス アカウントによって引き続き実行されます。

   1. 省略可: プルダウンに表示されていないサービス アカウントを選択するには、[手動で入力] をクリックして、サービス アカウント ID を入力します。

6. 選択した暗号化メカニズムをリポジトリに構成します。

   注意: リポジトリの作成後に Dataform リポジトリの暗号化メカニズムを変更することはできません。詳細については、Dataform CMEK の制限事項をご覧ください

   デフォルトの CMEK 鍵

   Dataform には [デフォルトの KMS 鍵を使用する] チェックボックスが表示され、デフォルトでオンになっています。

   • デフォルトの Dataform CMEK 鍵でリポジトリを暗号化するには、[デフォルトの KMS 鍵を使用する] チェックボックスをオンのままにします。

   注意: [デフォルトの KMS 鍵を使用する] チェックボックスをオンにしても、プロジェクトにデフォルトの Dataform CMEK 鍵が設定されていない場合、Dataform はリポジトリに保存データの暗号化を適用します。顧客管理の暗号鍵を使用します。

   一意の CMEK 鍵

   一意の CMEK 鍵でリポジトリを暗号化するには、次の操作を行います。

   1. [デフォルトの KMS 鍵を使用する] チェックボックスがデフォルトでオンになっている場合は、チェックボックスをオフにします。
   2. [暗号化] セクションで、[顧客管理の暗号鍵（CMEK）] オプションを選択します。
   3. [顧客管理の暗号鍵を選択] プルダウンで、一意の CMEK 鍵を選択します。

   保存時の暗号化

   • デフォルトの暗号化を使用するには、[暗号化] セクションで [Google が管理する暗号鍵] オプションを選択します。

   注意: リポジトリのリージョンにデフォルトの Dataform CMEK 鍵が設定されている場合は、CMEK 暗号化を使用する必要があります。[Google が管理する暗号鍵] オプションは選択しないでください。詳細については、Dataform CMEK の制限事項をご覧ください。

7. [作成]、[完了] の順にクリックします。

サービス アカウントを編集する

ワークフローを実行するためにカスタム サービス アカウントを Dataform リポジトリに関連付けることができます。他のすべてのリポジトリ オペレーションは、デフォルトの Dataform サービス アカウントによって引き続き実行されます。

Dataform リポジトリのサービス アカウントを編集する手順は次のとおりです。

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

   Dataform に移動

2. リポジトリを選択し、[設定] をクリックします。

3. [サービス アカウント] フィールドで、 [サービス アカウントの編集] をクリックします。

4. [サービス アカウント] プルダウンから、リポジトリのサービス アカウントを選択します。

   プルダウンからは、デフォルトの Dataform サービス アカウント、またはアクセス可能な Google Cloud プロジェクトに関連付けられているサービス アカウントを選択できます。

   1. 省略可: プルダウンに表示されていないサービス アカウントを選択するには、[手動で入力] をクリックして、サービス アカウント ID を入力します。

5. [保存] をクリックします。

リポジトリを削除する

リポジトリとそのすべてのコンテンツを削除するには、次の手順を行います。

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

   Dataform に移動

2. 削除するリポジトリで、 [その他] メニューをクリックし、[削除] を選択します。

3. [リポジトリの削除] ウィンドウで、リポジトリの名前を入力して削除を確定します。

4. [削除] をクリックします。

次のステップ

• Dataform の処理設定の構成方法については、Dataform の設定を構成するをご覧ください。

• Dataform リポジトリをサードパーティの Git リポジトリにリンクする方法については、サードパーティの Git プロバイダに接続するをご覧ください。

• Dataform で CMEK を使用する方法については、顧客管理の暗号鍵の使用をご覧ください。

• 開発ワークスペースの作成方法については、ワークスペースを作成するをご覧ください。