保存済みクエリの概要

このドキュメントでは、BigQuery の保存済みクエリと従来の保存済みクエリの概要を説明します。

保存済みクエリ

このドキュメントでは、BigQuery の保存済みクエリの概要を説明します。保存済みクエリを使用して、SQL スクリプトを作成および管理できます。保存済みクエリでは、次のオプションを使用することでコラボレーションとクエリ管理が改善されます。

Identity and Access Management（IAM）を使用して、特定のユーザーやグループとの間でクエリを共有する。
クエリの変更履歴を確認する。
以前のクエリバージョンに戻す、または以前のバージョンから分岐させる。

保存済みクエリには、クエリテキストとクエリ設定の両方が保存されます。

保存済みクエリは、Dataform によって強化された BigQuery Studio コードアセットです。また Notebooks もコードアセットです。すべてのコードアセットは、デフォルトのリージョンに保存されます。デフォルトリージョンを更新すると、それ以降に作成されるすべてのコードアセットのリージョンが変更されます。

保存済みクエリ機能は、Google Cloud コンソールでのみ使用可能です。

保存済みクエリのセキュリティ

保存済みクエリへのアクセスを制御するには、Identity and Access Management（IAM）のロールを使用します。詳細については、保存済みクエリへのアクセス権を付与するをご覧ください。

サポートされているリージョン

BigQuery Studio では、保存済みクエリの保存、共有、管理を行うことができます。次の表に、BigQuery Studio が利用可能なリージョンを示します。

	リージョンの説明	リージョン名	詳細モデル
南北アメリカ
	アイオワ	`us-central1`	低 CO₂
	オレゴン	`us-west1`	低 CO₂
	サンパウロ	`southamerica-east1`	低 CO₂
	サウスカロライナ	`us-east1`
アジア太平洋
	ムンバイ	`asia-south1`
	シンガポール	`asia-southeast1`
	台湾	`asia-east1`
	東京	`asia-northeast1`
ヨーロッパ
	ベルギー	`europe-west1`	低 CO₂
	フランクフルト	`europe-west3`	低 CO₂
	ロンドン	`europe-west2`	低 CO₂
	オランダ	`europe-west4`
	チューリッヒ	`europe-west6`	低 CO₂

割り当てと上限

詳細については、保存済みクエリの割り当てと上限をご覧ください。

従来の保存済みクエリ

従来の保存済みクエリは、SQL クエリを保存して共有するための以前の方法です。従来の保存済みクエリはクエリテキストを提供し、従来の保存済みクエリによって保持される唯一のクエリ設定は SQL バージョンです。この設定は、レガシー SQL と GoogleSQL のどちらをクエリで使用するかを制御します。ユーザーがデータに対してクエリを実行するには、保存済みクエリでアクセスするデータへのアクセス権を持っている必要があります。詳細については、保存済みクエリへのアクセス権を付与するをご覧ください。

従来の保存済みクエリには次の 3 つのタイプがあります。

非公開 非公開になる従来の保存済みクエリは、それを作成したユーザーだけに表示されます。アイコンでこれらを識別できます。
プロジェクトレベル プロジェクトレベルの保存済みクエリは、必要な権限を持つプリンシパルに表示されます。アイコンでこれらを識別できます。
一般公開 一般公開される従来の保存済みクエリは、クエリへのリンクを持つすべてのユーザーに表示されます。アイコンでこれらを識別できます。

従来の保存済みクエリを保存済みクエリに移行して新しい機能を利用することも、従来の保存済みクエリとして 2025 年まで維持し続けることもできます。

従来の保存済みクエリの機能は、Google Cloud コンソールでのみ使用可能です。

従来の保存済みクエリのサポート終了

2025 年 3 月までに、BigQuery Studio の保存済みクエリ機能が従来の保存済みクエリに代わる予定です。2024 年以降に既存の従来の保存済みクエリを編集するには、保存済みクエリに従来の保存済みクエリを移行する必要があります。

あなたを含むユーザーが、プロジェクト内のデータにアクセスできる他のユーザーに公開すべきでない個人情報を含むクエリを所有している場合、クエリのオーナーは 2025 年 3 月までに該当クエリまたは情報を削除する必要があります。

この移行をサポートするため、2024 年 2 月に次の BigQuery IAM ロールが更新されます。

BigQuery 管理者（roles/bigquery.admin）は、Dataform 管理者（roles/dataform.admin）の権限を取得します。
BigQuery ジョブユーザー（roles/bigquery.jobUser）には、次の権限が付与されます。
- dataform.locations.get
- dataform.locations.list
- dataform.repositories.create
- dataform.repositories.list
BigQuery ユーザー（roles/bigquery.user）には、次の権限が付与されます。
- dataform.locations.get
- dataform.locations.list
- dataform.repositories.create
- dataform.repositories.list

BigQuery 管理者、BigQuery ジョブユーザー、BigQuery ユーザーのロールを持たないユーザーが保存済みクエリを使用できるようにするには、IAM で必要な権限を付与します。

カスタムロールは自動的に更新されません。必要な権限を持つカスタムロールを更新するには、既存のカスタムロールを編集するをご覧ください。

次のステップ

保存済みクエリの作成方法を学習する。
保存済みクエリを管理する方法を確認する。