コードアセット管理を有効にする
ノートブックや保存済みクエリなどのコードアセットのバージョンを保存、共有、管理できます。このドキュメントでは、コードアセットを手動で有効にする方法、デフォルトのリージョンを設定して他のユーザーにアクセス権を付与する方法について説明します。
BigQuery API の自動有効化
BigQuery を使用するすべての Google Cloud プロジェクトで、次の API が自動的に有効になります。
- Analytics Hub
- BigQuery Connection
- BigQuery Data Policy
- BigQuery Reservation
- Compute Engine API
- Dataform
- Dataplex
- Vertex AI API
2024 年 3 月より前は、これらの API は自動的に有効になっていませんでした。2024 年 3 月より前の自動化スクリプトで、これらの API のステータスに依存しているものがある場合は、更新が必要になることがあります。
これらの API を使用する場合でも追加料金は発生しません。BigQuery の料金、Dataform の料金、Dataplex の料金に記載されているように、対応するリソースで有効なサービスを使用するための Identity and Access Management 権限を持つユーザーには料金が発生する可能性があります。
リソース サービスの使用を制限する組織のポリシーの制約を設定すると、追加の API を有効化しないようにできます。選択した API を無効にすることはいつでも可能です。
始める前に
コードアセット管理を手動で有効にするには、Identity and Access Management（IAM）のオーナー（roles/owner）ロールが必要です。
BigQuery コードアセットを手動で有効にする
次の API を有効にすると、BigQuery コードアセット管理を手動で有効にできます。
- Compute Engine API
- Dataform API
- Vertex AI API
コードアセットを有効にする手順は次のとおりです。
[BigQuery] ページに移動します。
エディタペインのタブバーで、+ 記号の横にある 矢印プルダウンをクリックし、[新しい Python ノートブックを作成] をクリックします。
エディタペインのタブバーの下に表示されるバナーで、[有効にする] をクリックします。
バナーが表示されない場合は、必要な IAM オーナーロールがあるかどうかを確認してください。
[Enable features] ペインの [コア機能の API] セクションで、次の操作を行います。
- コードアセットのバージョン履歴と共有を有効にするには、[バージョン履歴と共有] で [有効にする] をクリックします。
- ノートブックを有効にするには、[Python ノートブック] で [すべて有効にする] をクリックします。
- API が有効になったら、[次へ] をクリックします。
省略可: [権限] セクションでユーザー権限を設定します。
- コードアセットを作成する権限と、作成したコードアセットに対する読み取り、編集、設定の権限をプリンシパルに付与するには、[作成者] にユーザー名またはグループ名を入力します。
- 共有するすべてのコードアセットの読み取り、編集、設定の権限をプリンシパルに付与するには、[オーナー] にユーザーまたはグループの名前を入力します。
[次へ] をクリックします。
省略可: [その他の API] セクションの [すべて有効にする] をクリックして、BigQuery DataFrame を使用して BigQuery リモート プロシージャを作成するために必要な API を有効にします。
追加の API を有効にしない場合は、[閉じる] をクリックして [機能を有効にする] ペインを閉じます。
コードアセットにデフォルトのリージョンを設定する
すべてのコードアセットは同じデフォルト リージョンを使用します。コードアセットのデフォルト リージョンを設定する手順は次のとおりです。
[BigQuery] ページに移動します。
[エクスプローラ] ペインで、コードアセットを有効にしたプロジェクトを見つけます。
プロジェクトの横にある （アクションを表示）をクリックし、[デフォルトのコード リージョンを変更] をクリックします。
[リージョン] で、コードアセットに使用するリージョンを選択します。
[選択] をクリックします。
他のユーザーにアクセス権を付与する
コードアセット管理を有効にしたら、他のユーザーに適切な Identity and Access Management ロールを付与することで、コードアセットへのアクセス権を付与できます。詳細については、ノートブックへのアクセスを許可すると保存したクエリへのアクセス権を付与するをご覧ください。
次のステップ
- ノートブックの作成方法を学習する。
- 保存済みクエリの作成方法を学習する。