保存済みクエリの概要

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

保存したクエリ

プレビュー版のサポートについては、bigquery-notebooks-support@google.com までメールでお問い合わせください。

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

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

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

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

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

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

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

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

次の表は、保存済みクエリを利用できるリージョンを示しています。

南北アメリカ

リージョンの説明 リージョン名 詳細
アイオワ us-central1 リーフアイコン 低 CO2
オレゴン us-west1 リーフアイコン 低 CO2
サンパウロ southamerica-east1 リーフアイコン 低 CO2

アジア太平洋

リージョンの説明 リージョン名 詳細
ムンバイ asia-south1
シンガポール asia-southeast1
台湾 asia-east1
東京 asia-northeast1

ヨーロッパ

リージョンの説明 リージョン名 詳細
ベルギー europe-west1 リーフアイコン 低 CO2
フランクフルト europe-west3 リーフアイコン 低 CO2
ロンドン europe-west2 リーフアイコン 低 CO2
オランダ europe-west4
チューリッヒ europe-west6 リーフアイコン 低 CO2

割り当てと上限

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

従来の保存済みクエリ

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

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

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

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

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

次のステップ