保存済みクエリの概要
このドキュメントでは、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 |
||
| ロンドン | 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 のどちらをクエリで使用するかを制御します。ユーザーがデータに対してクエリを実行するには、保存済みクエリでアクセスするデータへのアクセス権を持っている必要があります。
従来の保存済みクエリは、[従来のエクスプローラ] ペインの [（従来）クエリ] フォルダに表示されます。
![[エクスプローラ] ペインの [（従来）クエリ] フォルダ。](https://docs.cloud.google.com/static/bigquery/images/saved-query-comparison.png?authuser=8&hl=ja)
従来の保存済みクエリには次の 3 つのタイプがあります。
- 個人:個人の従来の保存済みクエリは、それを作成したユーザーにのみ表示されます。 アイコンでこれらを識別できます。
- プロジェクト レベル。プロジェクト レベルの保存済みクエリは、必要な権限を持つプリンシパルに表示されます。 アイコンでこれらを識別できます。
- 一般公開。 一般公開される従来の保存済みクエリは、クエリへのリンクを持つすべてのユーザーに表示されます。 アイコンでこれらを識別できます。
従来の保存済みクエリを保存済みクエリに移行して新しい機能を利用することも、従来の保存済みクエリとしてサポートの終了まで維持し続けることもできます。サポート終了のタイムラインは現在審査中です。
従来の保存済みクエリの機能は、Google Cloud コンソールでのみ使用可能です。
従来の保存済みクエリのサポート終了
BigQuery Studio の保存済みクエリ機能が従来の保存済みクエリに代わる予定です。サポート終了期限は現在審査中です。サポートの終了後に既存の従来の保存済みクエリを編集するには、BigQuery Studio の保存済みクエリに従来の保存済みクエリを移行する必要があります。
ご自身を含むユーザーが、プロジェクト内のデータにアクセスできる他のユーザーに公開すべきでない個人情報を含むクエリを所有している場合、クエリのオーナーは移行を完了する前に該当クエリまたは情報を削除する必要があります。
この移行をサポートするため、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 で必要な権限を付与します。
カスタムロールは自動的に更新されません。必要な権限を持つカスタムロールを更新するには、既存のカスタムロールを編集するをご覧ください。
次のステップ
- 保存済みクエリの作成方法を確認する。保存したクエリを作成するをご覧ください。
- 保存済みクエリの管理方法を確認する。保存済みクエリを管理するをご覧ください。