クエリの保存と共有

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

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

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

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

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

権限

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

  • 非公開の保存クエリ:
    • 非公開の保存クエリを作成するために特別な権限は必要ありません。非公開クエリは BigQuery ウェブ UI を使用して任意のプロジェクトに保存できますが、このクエリを表示、更新、削除できるのは保存したユーザーのみです。
  • プロジェクト レベルの保存クエリ:
    • プロジェクト レベルの保存クエリを作成するには、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 ウェブ UI を使用して任意のプロジェクトに保存できますが、このクエリを更新または削除できるのは保存したユーザーのみです。リンクを知っていれば誰でも、一般公開の保存クエリを表示できます。

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

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

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

BigQuery ウェブ UI で、非公開クエリを保存するには:

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

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

  3. [New Query] テキスト領域に BigQuery 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 役割のメンバーがクエリを表示、更新、削除できます。

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

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

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

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

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

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

  3. [New Query] テキスト領域に 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. [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. チームの別のメンバーとリンクを共有します。

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

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

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

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

  3. [New Query] テキスト領域に 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. [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. リンクを共有します。

保存クエリの更新

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

  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] をクリックします。

保存クエリの削除

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

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

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

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

  4. メッセージが表示されたら、[OK] をクリックして確認します。

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

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

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