クエリの保存と共有

このページでは、クエリの保存と共有の方法について説明します。保存されるか共有されるクエリには、クエリ自体のみが含まれます。これは、以下のことを意味します。

  • 共有されるクエリには、クエリテキストのみが含まれます。データを照会するには、適切なアクセス権が必要です。クエリテキストのみを保存するメリットの 1 つは、有効なクエリではない場合でも未完成のクエリを共有し、他のユーザーが完成させるかカスタマイズできるテンプレートとして使用できることです。

  • 保存されたクエリによって保持される唯一のクエリ オプションは「SQL Version」で、このオプションは、クエリでレガシー SQL または標準 SQL のどちらを使用するかを制御します。

保存されたクエリには 3 つのタイプがあります。

  • 非公開: 非公開の保存クエリは、作成したユーザーだけが見ることができます。
  • プロジェクト レベル: プロジェクト レベルの保存クエリは、必要な権限を含む事前定義された BigQuery の IAM 役割のメンバーに表示されます。
  • 一般公開: 一般公開の保存クエリは、クエリリンクによりすべてのユーザーに表示されます。

権限

保存されたクエリを作成、表示、更新、削除するには、次の IAM 権限が必要です。

  • 非公開の保存クエリ:
    • 非公開の保存クエリを作成するために特別な権限は必要ありません。非公開クエリは任意のプロジェクトに保存できますが、このクエリを表示、更新、削除できるのは保存したユーザーのみです。
  • プロジェクト レベルの保存クエリ:
    • プロジェクト レベルの保存クエリを作成するには、bigquery.savedqueries.create 権限が必要です。事前定義されたプロジェクト レベルの IAM 役割のうち bigquery.savedqueries.create 権限を含むものは、bigquery.admin です。
    • プロジェクト レベルの保存クエリを表示するには、bigquery.savedqueries.get 権限と bigquery.savedqueries.list 権限が必要です。事前定義されたプロジェクト レベルの IAM 役割のうち bigquery.savedqueries.get 権限と bigquery.savedqueries.list 権限を含むものは、bigquery.adminbigquery.user です。
    • プロジェクト レベルの保存クエリを更新するには、bigquery.savedqueries.update 権限が必要です。事前定義されたプロジェクト レベルの IAM 役割のうち bigquery.savedqueries.update 権限を含むものは、bigquery.admin です。
    • プロジェクト レベルの保存クエリを削除するには、bigquery.savedqueries.delete 権限が必要です。事前定義されたプロジェクト レベルの IAM 役割のうち bigquery.savedqueries.delete 権限を含むものは、bigquery.admin です。
  • 一般公開の保存クエリ:
    • 一般公開のクエリを作成するために特別な権限は必要ありません。一般公開クエリは任意のプロジェクトに保存できますが、このクエリを更新または削除できるのは保存したユーザーのみです。リンクを知っていれば誰でも、一般公開の保存クエリを表示できます。

BigQuery での IAM 役割の詳細については、アクセス制御をご覧ください。

非公開の保存クエリの作成

クエリを保存して可視性を非公開に設定すると、そのクエリは、自分だけが表示、更新、削除できます。

未公開の共有クエリを作成するには:

Console

  1. GCP Console で BigQuery ウェブ UI を開きます。
    BigQuery ウェブ UI に移動

  2. [クエリを新規作成] をクリックします。

  3. クエリエディタのテキスト領域に、有効な BigQuery SQL クエリを入力します。たとえば、ウェブ UI クイックスタートのクエリを使用できます。

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. [クエリを保存] をクリックします。

  5. [クエリの保存] ダイアログ ボックスで、クエリの名前を入力します。[公開設定] を [個人用(本人のみが編集可能)] に設定して、[保存] をクリックします。

    個人用クエリの保存

  6. 保存したクエリを表示するには、[保存したクエリ] をクリックします。[個人用クエリ] ページがデフォルトで開くはずです。

  7. 保存したクエリの名前をクリックして展開します。

  8. [クエリ URL の共有] をクリックして共有可能なリンクにアクセスし、リンクをクリップボードにコピーします。または、クエリエディタのテキスト領域の上にある [リンク共有] ボタンを使用してリンクにアクセスすることもできます。

  9. チームの別のメンバーとリンクを共有します。

従来の UI

  1. BigQuery ウェブ UI に移動します。
    BigQuery ウェブ UI に移動

  2. [COMPOSE QUERY] をクリックします。

  3. [New Query] テキスト領域に SQL クエリを入力します。たとえば、従来のウェブ UI クイックスタートのクエリを使用できます。

    #standardSQL
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. [Save Query] をクリックして、[Save Query] ダイアログ ボックスを開きます。

  5. [Save Query] ダイアログ ボックスで、保存するクエリの名前を入力します。[Visibility] は [Private (Visible only to you)] のままにし、[OK] をクリックします。

    [Save Query] ダイアログ ボックス

  6. 保存したクエリを表示するには、左側のナビゲーションで [Query History] を選択して、[Queries] セクションで [Saved Queries] をクリックします。

    クエリのリストを保存する

保存クエリの共有

クエリを共有するには、クエリを保存する際に公開設定をプロジェクトまたは一般公開に設定します。プロジェクトの公開設定を指定すると、必要な権限を含む定義済み BigQuery IAM 役割のメンバーがクエリを表示、更新、削除できます。

一般公開の公開設定では、クエリリンクのあるすべての人がクエリを表示できますが、更新や削除はできません。クエリを実行するには、クエリによってアクセスされるデータにユーザーがアクセスできる必要があります。詳細については、データセットへのアクセスの制御をご覧ください。

クエリを共有する場合、次の例に示すように、クエリを説明するコメントを含めることを検討してください。

プロジェクトレベルの保存クエリの作成

プロジェクトの他のメンバーとクエリを共有するには:

Console

  1. GCP Console で BigQuery ウェブ UI を開きます。
    BigQuery ウェブ UI に移動

  2. [クエリを新規作成] をクリックします。

  3. クエリエディタのテキスト領域に、有効な BigQuery SQL クエリを入力します。たとえば、ウェブ UI クイックスタートのクエリを使用できます。

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. [クエリを保存] をクリックします。

  5. [クエリの保存] ダイアログ ボックスで、クエリの名前を入力します。[公開設定] を [プロジェクト(プロジェクト メンバーが編集可能] に設定して、[保存] をクリックします。

    プロジェクト クエリの保存

  6. 保存したクエリを表示するには、左側のナビゲーション ペインで [保存したクエリ] をクリックし、[プロジェクト クエリ] をクリックします。

    [プロジェクト クエリ] タブ

  7. 保存したクエリの名前をクリックして展開します。

  8. [クエリ URL の共有] をクリックして共有可能なリンクにアクセスし、リンクをクリップボードにコピーします。または、クエリエディタのテキスト領域の上にある [リンク共有] ボタンを使用してリンクにアクセスすることもできます。

  9. チームの別のメンバーとリンクを共有します。

従来の UI

  1. BigQuery ウェブ UI に移動します。
    BigQuery ウェブ UI に移動

  2. [COMPOSE QUERY] をクリックします。

  3. [New Query] テキスト領域に SQL クエリを入力します。たとえば、従来のウェブ UI クイックスタートのクエリを使用できます。

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. [Save Query] をクリックして、[Save Query] ダイアログ ボックスを開きます。

  5. [Save Query] ダイアログ ボックスで、保存するクエリの名前を入力します。[Visibility] を [Project (Project members can view and edit)] に設定して、[OK] をクリックします。

    クエリ プロジェクトを共有する

  6. 保存したクエリを表示するには、左側のナビゲーションで [Query History] を選択して、[Queries] セクションで [Project Queries] をクリックします。

    プロジェクト クエリのリスト

  7. 保存したクエリの名前をクリックして展開します。

    拡張されたプロジェクト クエリ

  8. [Share Link] をクリックして共有可能なリンクにアクセスし、リンクをクリップボードにコピーします。

    プロジェクト クエリの共有リンク

    あるいは、[New Query] テキスト領域の上にあるリンクアイコンからリンクにアクセスすることもできます。

    [Query Link] アイコン

  9. チームの別のメンバーとリンクを共有します。

一般公開の保存クエリの作成

クエリを誰とでも共有するには:

Console

現時点では、GCP Console を使用して一般公開保存クエリを作成することはできません。

従来の UI

  1. BigQuery ウェブ UI に移動します。
    BigQuery ウェブ UI に移動

  2. [COMPOSE QUERY] をクリックします。

  3. [New Query] テキスト領域に SQL クエリを入力します。たとえば、従来のウェブ UI クイックスタートのクエリを使用できます。

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. [Save Query] をクリックして、[Save Query] ダイアログ ボックスを開きます。

  5. [Save Query] ダイアログ ボックスで、保存するクエリの名前を入力します。[Visibility] を [Public (Anyone with the link can view, but not edit)] に設定して、[OK] をクリックします。

    クエリを一般公開する

  6. 保存したクエリを表示するには、左側のナビゲーションで [Query History] を選択して、[Queries] セクションで [Saved Queries] をクリックします。

    保存された一般公開クエリのリスト

  7. 保存した一般公開クエリの名前をクリックして展開します。

    拡張された一般公開クエリ

  8. [Share Link] をクリックして共有可能なリンクにアクセスし、リンクをクリップボードにコピーします。

    一般公開クエリの共有リンク

    あるいは、[New Query] テキスト領域の上にあるリンクアイコンからリンクにアクセスすることもできます。

    [Public Query Link] アイコン

  9. リンクを共有します。

保存クエリの更新

保存クエリを更新するには:

Console

  1. GCP Console で BigQuery ウェブ UI を開きます。
    BigQuery ウェブ UI に移動

  2. 左側のナビゲーションで [保存したクエリ] をクリックし、[個人用クエリ](個人用クエリを編集する場合)または [プロジェクト クエリ](プロジェクト レベルのクエリを編集する場合)をクリックします。クエリをクリックして展開します。

  3. クエリの右にある [クエリをエディタで開く] をクリックします。

    クエリの更新

  4. クエリを変更します。

  5. 名前を変更せずにクエリを更新する場合は、[クエリを保存] をクリックします。名前を変更する場合は、[クエリを保存] の横の下向き矢印をクリックして [名前を付けて保存] を選択し、必要に応じてダイアログ ボックスで更新します。

従来の UI

  1. BigQuery ウェブ UI に移動します。
    BigQuery ウェブ UI に移動

  2. 左側のナビゲーションで [Query History] をクリックし、[Queries] セクションの [Saved Queries](非公開クエリを編集する)または [Project Queries](プロジェクト レベルまたは一般公開クエリを編集する)をクリックします。

    プロジェクト クエリのリスト

  3. クエリの右側にある [Edit Query] をクリックします。

    [Edit query] ボタン

  4. クエリを変更します。

  5. [Save Query] をクリックして、[Save Query] ダイアログ ボックスを開きます。

  6. [Save Query] ダイアログ ボックスで、名前を変更しないままにして、[OK] をクリックします。

保存クエリの削除

保存クエリを削除するには:

Console

  1. GCP Console で BigQuery ウェブ UI を開きます。
    BigQuery ウェブ UI に移動

  2. 左側のナビゲーションで [保存したクエリ] をクリックし、[個人用クエリ](個人用クエリを削除する場合)または [プロジェクト クエリ](プロジェクト レベルのクエリを削除する場合)をクリックします。クエリをクリックして展開します。

  3. クエリの右にある [削除] をクリックします。

    クエリの削除

  4. プロンプトが表示されたら、[削除] をクリックして確定します。

従来の UI

  1. BigQuery ウェブ UI に移動します。
    BigQuery ウェブ UI に移動

  2. 左側のナビゲーションで [Query History] をクリックします。

  3. クエリの右側で、[Delete saved query] ボタン(X)をクリックします。

  4. プロンプトが表示されたら、[OK] をクリックして確定します。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。