保存済みクエリの概要
このドキュメントでは、BigQuery の保存したクエリと従来の保存したクエリの概要について説明します。
保存したクエリ
このドキュメントでは、BigQuery の保存したクエリの概要について説明します。保存済みクエリを使用して、SQL スクリプトを作成および管理できます。保存したクエリでは、次のオプションを使用してコラボレーションとクエリ管理が改善されます。
- Identity and Access Management（IAM）を使用して、特定のユーザーやグループとの間でクエリを共有する。
- クエリの変更履歴を確認する。
- クエリの以前のバージョンに戻す、またはバージョンを分岐させる。
保存済みクエリには、クエリテキストとクエリ設定の両方が保存されます。
保存されたクエリは、Dataform が提供する BigQuery Studio コードアセットです。また Notebooks もコードアセットです。すべてのコードアセットは、デフォルトのリージョンに保存されます。デフォルト リージョンを更新すると、それ以降に作成されるすべてのコードアセットのリージョンが変更されます。
保存したクエリ機能は、Google Cloud コンソールでのみ使用できます。
保存したクエリのセキュリティ
保存済みクエリへのアクセスを制御するには、Identity and Access Management（IAM）のロールを使用します。詳細については、保存済みクエリへのアクセス権を付与するをご覧ください。
サポートされているリージョン
BigQuery Studio では、保存済みクエリの保存、共有、管理を行うことができます。次の表に、BigQuery Studio が利用可能なリージョンを示します。
| リージョンの説明 | リージョン名 | 詳細 | |
|---|---|---|---|
| アフリカ | |||
| ヨハネスブルグ | africa-south1 |
||
| 南北アメリカ | |||
| コロンバス | us-east5 |
||
| ダラス | us-south1 |
 低 CO2 |
|
| アイオワ | us-central1 |
低 CO2 |
|
| ロサンゼルス | us-west2 |
||
| ラスベガス | us-west4 |
||
| モントリオール | northamerica-northeast1 |
低 CO2 |
|
| 北バージニア | us-east4 |
||
| オレゴン | us-west1 |
低 CO2 |
|
| サンパウロ | southamerica-east1 |
低 CO2
|
|
| サウス カロライナ | us-east1 |
||
| アジア太平洋 | |||
| 香港 | asia-east2 |
||
| ジャカルタ | asia-southeast2 |
||
| ムンバイ | asia-south1 |
||
| ソウル | asia-northeast3 |
||
| シンガポール | asia-southeast1 |
||
| シドニー | australia-southeast1 |
||
| 台湾 | asia-east1 |
||
| 東京 | asia-northeast1 |
||
| ヨーロッパ | |||
| ベルギー | europe-west1 |
低 CO2
|
|
| フランクフルト | europe-west3 |
低 CO2
|
|
| ロンドン | europe-west2 |
低 CO2
|
|
| マドリッド | europe-southwest1 |
低 CO2
|
|
| オランダ | europe-west4 |
低 CO2
|
|
| トリノ | europe-west12 |
||
| チューリッヒ | europe-west6 |
低 CO2
|
|
| 中東 | |||
| ドーハ | me-central1 |
||
| ダンマーム | me-central2 |
||
割り当てと上限
詳細については、保存したクエリの割り当てと上限をご覧ください。
制限事項
保存したクエリには次の制限があります。
- 保存したクエリへの一般公開アクセスを付与できるのは、
allAuthenticatedUsersプリンシパルのみです。保存したクエリへのアクセス権をallUsersプリンシパルに付与することはできません。 - Google Cloud プロジェクトに 2,500 を超える従来の保存したクエリが含まれている場合、一括移行（プレビュー）を使用して従来の保存したクエリを保存したクエリに移行することはできません。
従来の保存したクエリ
従来の保存済みクエリは、SQL クエリを保存して共有するための以前の方法です。従来の保存したクエリはクエリテキストを提供し、従来の保存クエリによって保持される唯一のクエリ設定は SQL バージョンです。この設定は、レガシー SQL と GoogleSQL のどちらをクエリで使用するかを制御します。データに対してクエリを実行するには、ユーザーに保存したクエリがアクセスするデータへのアクセス権を付与しておく必要があります。詳細については、保存済みクエリへのアクセス権を付与するをご覧ください。
従来の保存したクエリには 3 つのタイプがあります。
- 個人用従来の個人保存済みクエリは、作成したユーザーだけに表示されます。 アイコンでこれらを識別できます。
- プロジェクト レベル。プロジェクト レベルの保存したクエリは、必要な権限を持つプリンシパルに表示されます。 アイコンでこれらを識別できます。
- 一般公開。 一般公開の保存したクエリは、クエリへのリンクですべてのユーザーに表示されます。 アイコンでこれらを識別できます。
従来の保存済みクエリを保存済みクエリに移行して新しい機能を利用することも、従来の保存済みクエリとして 2025 年まで維持し続けることもできます。
従来の保存済みクエリの機能は、Google Cloud コンソールでのみ使用可能です。
従来の保存済みクエリのサポート終了
2025 年 3 月までに、BigQuery Studio の保存済みクエリ機能が従来の保存済みクエリに代わる予定です。2024 年以降に既存の従来の保存済みクエリを編集するには、BigQuery Studio の保存済みクエリに従来の保存済みクエリを移行する必要があります。
あなたを含むユーザーが、プロジェクト内のデータにアクセスできる他のユーザーに公開すべきでない個人情報を含むクエリを所有している場合、クエリのオーナーは 2025 年 3 月までに該当クエリまたは情報を削除する必要があります。
この移行をサポートするため、2024 年 2 月に次の BigQuery IAM ロールが更新されました。
BigQuery 管理者（
roles/bigquery.admin）は、Dataform 管理者（roles/dataform.admin）の権限を取得します。BigQuery ジョブユーザー（
roles/bigquery.jobUser）には、次の権限が付与されます。dataform.locations.getdataform.locations.listdataform.repositories.createdataform.repositories.list
BigQuery ユーザー（
roles/bigquery.user）には、次の権限が付与されます。dataform.locations.getdataform.locations.listdataform.repositories.createdataform.repositories.list
BigQuery 管理者、BigQuery ジョブユーザー、BigQuery ユーザーのロールを持たないユーザーが保存済みクエリを使用できるようにするには、IAM で必要な権限を付与します。
カスタムロールは自動的に更新されません。必要な権限を持つカスタムロールを更新するには、既存のカスタムロールを編集するをご覧ください。
次のステップ
- 保存したクエリを作成する方法については、保存したクエリを作成するをご覧ください。
- 保存したクエリを管理する方法については、保存したクエリを管理するをご覧ください。