保存済みクエリの概要
このドキュメントでは、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 で必要な権限を付与します。
カスタムロールは自動的に更新されません。必要な権限を持つカスタムロールを更新するには、既存のカスタムロールを編集するをご覧ください。
次のステップ
- 保存済みクエリの作成方法を確認する。保存したクエリを作成するをご覧ください。
- 保存済みクエリの管理方法を確認する。保存済みクエリを管理するをご覧ください。