BigQuery API の依存関係を管理する

このドキュメントでは、BigQuery が依存する Google Cloud サービスと API について説明します。また、これらのサービスを無効にした場合の BigQuery の動作への影響についても説明します。プロジェクトでサービスを有効または無効にする前に、このドキュメントをご確認ください。

一部のサービスは、作成するすべての Google Cloud プロジェクトにおいてデフォルトで有効になっています。他の API は、BigQuery を使用するすべての Google Cloud プロジェクトで自動的に有効になります。残りのサービスを使用できるようにするには、前もって明示的に有効にする必要があります。詳細については、次のリソースをご覧ください。

このドキュメントは管理者を対象としています。

デフォルトで有効になるサービス

新しいGoogle Cloud プロジェクトごとに、次のサービスがデフォルトで有効になります。

サービス このサービスに依存する機能 このサービスを無効にした場合の影響
analyticshub.googleapis.com
  • データ エクスチェンジ、リスティング、データ クリーンルーム、サブスクリプションを作成または管理することはできません。
  • 他のプロバイダが作成したエクスチェンジやリスティングの検索や閲覧もできません。
  • 作成されたサブスクリプションは保持されますが、アクセスすることはできません。
  • リンクされたデータセットには、BigQuery API が有効になっている限りアクセスできます。
  • 新しいサブスクリプションを作成することはできません。
bigqueryconnection.googleapis.com
  • 外部接続を管理することはできません。
  • リモートモデルは作成できません。
  • リモート関数は作成できません。
  • BigLake テーブルとオブジェクト テーブルをクエリすることはできません。
bigquerymigration.googleapis.com
  • 移行タスクや評価を作成することはできません。
  • 既存のタスクや評価は使用できません。

注: 通常、このサービスはデータ移行の完了後に無効にできます。
bigquerydatapolicy.googleapis.com
  • データ マスキング ポリシーを管理することはできません。
  • データ マスキング ポリシーは削除されませんが、データ マスキングが適用されたテーブルに対するクエリは失敗します。
bigqueryreservation.googleapis.com
  • 容量コミットメント、予約、割り当ての作成や管理はできません。
  • スロットの使用状況をモニタリングすることはできません。
  • 障害復旧フェイルオーバーは使用できません。
  • スロットの自動スケーリングが停止します。
bigquerystorage.googleapis.com
dataform.googleapis.com
  • パイプライン、保存したクエリ、Colab ノートブック、データ キャンバス、データの準備、Dataform プロジェクトを作成することはできません。
  • 既存のスケジュール設定されたパイプライン、ノートブック、Dataform プロジェクトが停止します。
  • パイプライン、保存したクエリ、Colab ノートブック、データ キャンバス、データの準備、Dataform プロジェクトは、すべてアクセスできなくなります。
dataplex.googleapis.com
  • BigQuery データアセットの検索は使用できません。
  • 共有リスティングの検索は使用できません。
  • プロファイル分析情報、データ品質スキャン、クエリ候補については、新しく作成したり以前に作成したものにアクセスしたりすることができません。
  • リネージグラフではデータアセットの詳細は確認できません。
  • データ キャンバスでデータアセットを検索することはできません。

BigQuery API を無効にした場合の影響

BigQuery API を無効にすると、BigQuery API に依存する次のサービスも無効になります。

  • binaryauthorization.googleapis.com
  • container.googleapis.com
  • cloudapis.googleapis.com
  • dataprep.googleapis.com
  • servicebroker.googleapis.com
  • telecomdatafabric.googleapis.com

BigQuery Unified API によって有効にされるサービス

BigQuery Unified API（bigqueryunified.googleapis.com）には、さまざまな BigQuery 機能の機能に必要なサービスの厳選されたコレクションが含まれています。BigQuery Unified API を有効にすると、これらのサービスはすべて同時に有効になります。Google はこのコレクション内のサービスを更新できます。これらのサービスは、この API が有効になっているプロジェクトで自動的に有効になります。個々のサービスと API を無効にできます。

bigqueryunified.googleapis.com を有効にする手順については、サービスの有効化と無効化をご覧ください。

サービス このサービスに依存する機能 このサービスを無効にした場合の影響
aiplatform.googleapis.com
  • ノートブックを実行できなくなります。
  • 既存の BigQuery ML リモートモデルはすべて動作を停止します。
  • 既存のノートブックには引き続きアクセスして編集できます。
bigqueryunified.googleapis.com
  • このドキュメントに記載されている BigQuery 依存サービスをワンクリックで有効にできます（cloudaicompanion API、composer API、datalineage API を除く）。
  • プロジェクトで新しい BigQuery 依存関係が有効になっていることを確認します。
  • 将来の依存関係がプロジェクトで自動的に有効になることはありません。
compute.googleapis.com
  • Google Compute Engine には、Dataproc と Vertex AI が提供するすべての機能のランタイム環境が用意されています。
  • Colab ノートブック、リモート ML モデル、Apache Spark ジョブ、SparkSQL ジョブ、PySpark ジョブが停止します。
  • ソースコードは引き続き使用できます。
  • Dataproc API が無効になります。
dataproc.googleapis.com
  • オープンソースのデータ分析を実行する Dataproc クラスタを作成することはできません。
  • Dataproc Serverless ワークロードを実行することはできません。
  • BigQuery ワークロードで Spark を実行することはできません。
datastream.googleapis.com
  • すべてのデータ ストリームが一時停止され、アクセスできなくなります。

デフォルトで無効になっているサービス

対応する機能を使用できるようにするには、次のサービスを手動で有効にする必要があります。

サービス このサービスに依存する機能 このサービスを無効にした場合の影響
cloudaicompanion.googleapis.com
  • Gemini in BigQuery の機能
composer.googleapis.com
  • 既存の Cloud Composer DAG は [スケジュール設定] ページに表示されず、停止します。
  • 既存の Cloud Composer 環境が動作しなくなり、停止してエラー状態を返します。
datalineage.googleapis.com
  • プロジェクトのデータリネージはキャプチャされません。
  • リネージグラフは表示できません。

BigQuery コードアセットを手動で有効にする

BigQuery でノートブックや保存済みクエリなどのコードアセットを管理するには、次の API を有効にする必要があります。

  • Compute Engine API
  • Dataform API
  • Vertex AI API

2024 年 3 月より前は、これらの API はデフォルトで自動的に有効になっていませんでした。2024 年 3 月より前の自動化スクリプトで、これらの API のステータスに依存しているものは、更新が必要になる可能性があります。これらの API がすでに有効になっている場合は、BigQuery の [エクスプローラ] ペインに新しい [ノートブック] フォルダと [クエリ] フォルダが表示されます。

始める前に

コードアセット管理を手動で有効にするには、Identity and Access Management（IAM）のオーナー（roles/owner）ロールが必要です。

BigQuery コードアセットを手動で有効にする

コードアセットに必要な API 依存関係を有効にする手順は次のとおりです。

  1. [BigQuery] ページに移動します。

    BigQuery に移動

  2. Studio のエディタペインのタブバーで、+ 記号の横にある 矢印プルダウンをクリックし、[ノートブック] にポインタを合わせて、[BigQuery テンプレート] を選択します。

  3. エディタペインのタブバーの下に表示されるバナーで、[有効にする] をクリックします。

    バナーが表示されない場合は、必要な IAM オーナーロールがあるかどうかを確認してください。

  4. [機能を有効にする] ペインの [コア機能の API] セクションで、次の操作を行います。

    1. コードアセットのバージョン履歴と共有を有効にするには、[バージョン履歴と共有] セクションで [有効にする] をクリックします。
    2. ノートブックを有効にするには、[Python ノートブック] で [すべて有効にする] をクリックします。
    3. API が有効になったら、[次へ] をクリックします。

  5. 省略可: [権限] セクションでユーザー権限を設定します。

    • コードアセットを作成する権限と、作成したコードアセットに対する読み取り、編集、設定の権限をプリンシパルに付与するには、[作成者] フィールドにユーザー名またはグループ名を入力します。
    • 共有するすべてのコードアセットの読み取り、編集、設定の権限をプリンシパルに付与するには、[オーナー] フィールドにユーザーまたはグループの名前を入力します。

  6. [次へ] をクリックします。

  7. 省略可: [その他の API] セクションで、[すべて有効にする] をクリックし、BigQuery DataFrames を使用して BigQuery リモート プロシージャを作成するために必要な API を有効にします。

  8. 追加の API を有効にしない場合は、[閉じる] をクリックして [機能を有効にする] ペインを閉じます。

コードアセットへのアクセスを制限する

リソース サービスの使用を制限する組織のポリシーの制約を設定すると、追加の API を有効化しないようにできます。選択した API を無効にすることはいつでも可能です。

次のステップ