保存したクエリを作成する
このドキュメントでは、保存したクエリと従来の保存したクエリを作成する方法について説明します。
保存したクエリ
プレビュー版のサポートについては、bigquery-notebooks-support@google.com までメールでお問い合わせください。
保存したクエリを作成する方法については、以降のセクションをご覧ください。保存されたクエリは、Dataform によって強化された BigQuery Studio コードアセットです。
保存したクエリの削除と保存したクエリの履歴の管理の詳細については、保存したクエリをご覧ください。
BigQuery Studio を有効にする
アセット管理に関する BigQuery Studio を有効にするの手順に沿って、コードアセット(保存したクエリなど)のバージョンを保存、共有、管理します。
必要な権限
保存したクエリを作成、編集、表示するための適切な権限を設定します。
Dataform 管理者(roles/dataform.admin
)ロールを持つすべてのユーザーは、プロジェクトで作成されたすべての保存クエリに対するオーナー アクセス権を持ちます。
BigQuery Identity and Access Management(IAM)の詳細については、IAM によるアクセス制御をご覧ください。
保存したクエリを作成する権限
保存したクエリを作成して実行するには、次の IAM 権限が必要です。
resourcemanager.projects.get
resourcemanager.projects.list
bigquery.config.get
bigquery.jobs.create
bigquery.readsessions.create
bigquery.readsessions.getData
bigquery.readsessions.update
resourcemanager.projects.get
resourcemanager.projects.list
dataform.locations.get
dataform.locations.list
dataform.repositories.create
dataform.repositories.list
dataform.collections.create
dataform.collections.list
これらの権限は、次の IAM ロールから取得できます。
保存したクエリを編集する権限
保存したクエリを編集して実行するには、次の IAM ロールが必要です。
- BigQuery ジョブユーザー(
roles/bigquery.jobUser
) - BigQuery 読み取りセッション ユーザー(
roles/bigquery.readSessionUser
) - コードエディタ(
roles/dataform.codeEditor
)
保存したクエリを表示する権限
保存したクエリを表示して実行するには、次の IAM ロールが必要です。
- BigQuery ジョブユーザー(
roles/bigquery.jobUser
) - BigQuery 読み取りセッション ユーザー(
roles/bigquery.readSessionUser
) - コード閲覧者(
roles/dataform.codeViewer
)
コードアセットにデフォルトのリージョンを設定する
コードアセットを初めて作成する場合は、コードアセットのデフォルト リージョンを設定します。コードアセットのリージョンを作成後に変更することはできません。
保存したクエリを作成する
保存したクエリを作成する手順は次のとおりです。
Google Cloud コンソールで [BigQuery] ページに移動します。
[
クエリを新規作成] をクリックします。クエリエディタで、有効な SQL クエリを入力します。たとえば、一般公開データセットに対してクエリを実行できます。
SELECT name, SUM(number) AS total FROM `bigquery-public-data.usa_names.usa_1910_2013` GROUP BY name ORDER BY total DESC LIMIT 10;
[クエリを保存] > [クエリを保存] をクリックします。
[クエリを保存] ダイアログで、保存したクエリの名前を入力します。
省略可: この保存したクエリと今後の他のすべてのコードアセットで使用されるリージョンを変更するには、[リージョン] で新しいリージョンを選択します。
[保存] をクリックします。
保存したクエリへのアクセス権を付与する
保存したクエリへのアクセス権を他のユーザーに付与するには、それらのユーザーを適切な IAM ロールに追加します。
- [エクスプローラ] ペインで [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。アクセスを許可する保存したクエリを見つけます。
- 保存したクエリの横にある > [権限を管理] をクリックします。 [アクションを表示] をクリックし、[共有]
- [プリンシパルを追加] をクリックします。
- [新しいプリンシパル] フィールドに、プリンシパルを入力します。
[ロールを選択] リストで [Dataform] を選択し、次のいずれかのロールを選択します。
[保存] をクリックします。
保存したクエリの情報に戻るには、[閉じる] をクリックします。
保存したクエリを共有する
保存したクエリを他のユーザーと共有するには、保存したクエリへのリンクを生成して共有します。共有されている保存したクエリがユーザーに対して表示されるようにするには、まず、保存したクエリへのアクセス権を付与する必要があります。
共有クエリを実行するには、クエリがアクセスするデータへのアクセス権が必要です。詳細については、データセットへのアクセス権を付与するをご覧ください。
保存したクエリを共有する予定の場合は、その目的を説明するコメントをクエリに含めることを検討してください。
- [エクスプローラ] ペインで [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。共有する保存したクエリを見つけます。
- クエリの横にある > [リンクを取得] をクリックします。 [アクションを表示] をクリックし、[共有]
- リンクを他のユーザーと共有します。
保存したクエリ バージョンを新しいクエリとして開く
既存の保存したクエリの任意のバージョンを新しいクエリとして開く手順は、次のとおりです。
- [エクスプローラ] ペインで [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。保存したクエリを選択します。
- [アクティビティ] ペインを選択します。
- 保存したクエリ バージョンの横にある (アクションを表示)をクリックし、[新規クエリとして開く] をクリックします。
保存したクエリを更新する
保存したクエリを更新すると、クエリの新しいバージョンに変更内容を保存できます。
- [エクスプローラ] ペインで [クエリ] フォルダを開き、必要に応じて [共有クエリ] フォルダを開きます。保存したクエリの名前をクリックして開きます。
- クエリを変更します。
変更したクエリを保存するには、 [クエリを保存] > [クエリを保存] をクリックします。
クエリの新しいバージョンが作成され、[アクティビティ] ペインに表示されます。
従来の保存したクエリ
以降のセクションでは、従来の保存したクエリを作成、更新する方法について説明します。従来の保存したクエリの共有、移行、削除の詳細については、従来の保存したクエリをご覧ください。
従来の保存したクエリに必要な権限
保存したクエリを作成、表示、更新、削除するには、次の IAM 権限が必要です。
- 非公開の従来の保存したクエリ:
- 非公開の従来の保存したクエリを作成するために特別な権限は必要ありません。非公開クエリはどのプロジェクトにも保存できますが、このクエリを表示、更新、削除できるのは保存したユーザーに限られます。
- プロジェクト レベルの従来の保存したクエリ:
- プロジェクトレベルの保存したクエリを作成するには、
bigquery.savedqueries.create
権限が必要です。bigquery.admin
事前定義ロールには、bigquery.savedqueries.create
権限が含まれています。 - プロジェクトレベルの従来の保存したクエリを表示するには、
bigquery.savedqueries.get
とbigquery.savedqueries.list
権限が必要です。bigquery.admin
およびbigquery.user
事前定義ロールには、bigquery.savedqueries.get
権限とbigquery.savedqueries.list
権限が含まれています。 - プロジェクトレベルの従来の保存したクエリを更新するには、
bigquery.savedqueries.update
権限が必要です。bigquery.admin
事前定義ロールには、bigquery.savedqueries.update
権限が含まれています。 - プロジェクトレベルの従来の保存したクエリを削除するには、
bigquery.savedqueries.delete
権限が必要です。bigquery.admin
事前定義ロールには、bigquery.savedqueries.delete
権限が含まれています。
- プロジェクトレベルの保存したクエリを作成するには、
- 一般公開の従来の保存したクエリ:
- 一般公開の従来の保存したクエリを作成するために特別な権限は必要ありません。一般公開の従来の保存したクエリは任意のプロジェクトに保存できますが、このクエリを更新または削除できるのは保存したユーザーのみです。リンクを知っていれば誰でも、一般公開の従来の保存したクエリを閲覧できます。
BigQuery での IAM のロールの詳細については、事前定義ロールと権限をご覧ください。
従来の保存したクエリを作成する
Google Cloud コンソールで [BigQuery] ページに移動します。
[
クエリを新規作成] をクリックします。クエリエディタで、有効な SQL クエリを入力します。たとえば、一般公開データセットに対してクエリを実行できます。
SELECT name, SUM(number) AS total FROM `bigquery-public-data.usa_names.usa_1910_2013` GROUP BY name ORDER BY total DESC LIMIT 10;
[クエリ(従来)を保存] > [クエリ(従来)を保存] をクリックします。
[クエリを保存] ダイアログで、クエリの名前を入力し、[公開設定] を次のいずれかのオプションに設定します。
- 個人用(本人のみが編集可能): 非公開の従来の共有クエリの場合。
- プロジェクト(適切な権限を持つプリンシパルが編集可能): プロジェクト レベルの従来の保存したクエリの場合。
- 一般公開: 一般公開の従来の保存したクエリの場合。
[保存] をクリックします。
従来の保存したクエリを共有する
共有できる従来の保存したクエリは、公開設定がプロジェクトまたは一般公開に設定されているクエリです。プロジェクトの公開設定を指定すると、必要な権限を持つプリンシパルがクエリを表示、更新、削除できます。一般公開の公開設定では、クエリリンクを知っているすべての人がクエリを表示できますが、更新や削除はできません。
従来の保存したクエリを他のユーザーと共有するには、このクエリへのリンクを生成して共有します。
従来の共有クエリを実行するには、クエリがアクセスするデータへのアクセス権が必要です。詳細については、データセットへのアクセス権を付与するをご覧ください。
従来の保存したクエリを共有する場合は、その目的を説明するコメントをクエリに含めることを検討してください。
- [エクスプローラ] ペインで、[(従来)クエリ] フォルダを開き、共有する従来の保存したクエリを見つけます。
- クエリの横にある (アクションを表示)をクリックし、[リンクを取得] をクリックします。
- クエリへのアクセスを許可するユーザーとリンクを共有します。
従来の保存したクエリを更新する
- [エクスプローラ] ペインで [(従来)クエリ] フォルダを開き、必要に応じて [プロジェクト クエリ] フォルダを開きます。
- 従来の保存したクエリの名前をクリックして開きます。
- クエリを変更します。
- 変更したクエリを保存するには、 [クエリ(従来)を保存] > [クエリ(従来)を保存] をクリックします。
次のステップ
- 保存したクエリを管理する方法を確認する。