儲存及共用查詢

本頁說明如何儲存並共用查詢。儲存或共用的查詢僅會包含查詢本身,這代表說:

  • 共用的查詢僅會提供查詢文字。您仍需擁有適當的存取權才可查詢資料。僅儲存查詢文字的優點在於即便非完整的查詢並非有效的查詢,您仍可加以共用,並作為其他使用者可完成或自訂的範本。

  • 儲存的查詢唯一保留的查詢選項是「SQL Version」,主要管理查詢要使用舊版 SQL 還是標準 SQL。

儲存的查詢可分為 3 種類型:

  • 不公開:只有建立這些查詢的使用者可以看到不公開的儲存查詢。
  • 專案層級:凡是預先定義的 BigQuery Cloud IAM 角色且具備必要權限的成員,都能看到專案層級的儲存查詢。
  • 公開:擁有查詢連結的每個人都可看到公開的儲存查詢。

權限

您必須具備下列 Cloud IAM 權限,才能建立、查看、更新及刪除儲存的查詢:

  • 不公開的儲存查詢:
    • 建立不公開的儲存查詢無需任何特殊權限。您可以在任何專案中儲存不公開的查詢,但只有您可以查看、更新或刪除查詢。
  • 專案層級的儲存查詢:
    • 建立專案層級的儲存查詢需要擁有 bigquery.savedqueries.create 權限。bigquery.admin 預先定義的角色具備 bigquery.savedqueries.create 權限。
    • 檢視專案層級的儲存查詢需要擁有 bigquery.savedqueries.getbigquery.savedqueries.list 權限。bigquery.adminbigquery.user 預先定義的角色具備 bigquery.savedqueries.getbigquery.savedqueries.list 權限。
    • 更新專案層級的儲存查詢需要擁有 bigquery.savedqueries.update 權限。bigquery.admin 預先定義的角色具備 bigquery.savedqueries.update 權限。
    • 刪除專案層級的儲存查詢需要擁有 bigquery.savedqueries.delete 權限。bigquery.admin 預先定義的角色具備 bigquery.savedqueries.delete 權限。
  • 公開的儲存查詢:
    • 建立公開的儲存查詢無需任何特殊權限。您可以在任何專案中儲存公開查詢,但只有您可以查看、更新或刪除查詢。擁有連結的任何人都可檢視公開的儲存查詢。

如需 BigQuery 中 IAM 角色的詳細資訊,請參閱存取權控管

建立不公開的儲存查詢

儲存查詢並將瀏覽權限設為不公開,只有您可以檢視、更新或刪除該查詢。

建立不公開的共享查詢:

主控台

  1. 在 GCP Console 中開啟 BigQuery 網頁版 UI。
    前往 GCP Console

  2. 按一下 [Compose new query] (撰寫新查詢)

  3. 在「Query editor」(查詢編輯器) 文字區域中輸入有效的 SQL 查詢。例如,您可以透過網頁版 UI 快速入門導覽課程使用查詢。

    # 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] (儲存查詢)

  5. 在「Save query」(儲存查詢) 對話方塊中,輸入查詢的名稱,將「Visibility」(瀏覽權限) 設定為 [Personal (editable only by you)] (個人 (只能由您編輯)),然後按一下 [Save] (儲存)

    儲存不公開查詢

  6. 如要查看您已儲存的查詢,請按一下 [Saved queries] (已儲存的查詢)。根據預設,「Personal queries」(個人查詢) 頁面應會開啟。

  7. 按一下您儲存的查詢加以展開。

  8. 按一下 [Share query URL] (分享查詢網址),存取可分享的連結並將連結複製到剪貼簿。您也可以透過「Query editor」(查詢編輯器) 文字區域上方的 [Link sharing] (連結共用設定) 按鈕圖示存取此連結。

  9. 將連結分享給團隊中的其他成員。

傳統版 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] (確定)

    「儲存查詢」對話方塊

  6. 若要檢視您儲存的查詢,請確認已在左側導覽列中選取 [Query History] (查詢記錄) ,然後按一下「Queries」(查詢) 部分中的 [Saved Queries] (已儲存查詢)

    儲存的查詢清單

共用儲存的查詢

若要共用查詢,請在儲存查詢時將瀏覽權限設為 [Project] (專案層級) 或 [Public] (公開)。專案層級瀏覽權限可讓具備必要權限的預先定義 BigQuery Cloud IAM 角色成員檢視、更新或刪除查詢。

公開瀏覽權限可讓擁有查詢連結的所有人都能檢視查詢,但無法更新或刪除查詢。若要執行查詢,使用者必須能存取查詢所存取的資料。詳情請參閱控管資料集存取權

共用查詢時,請考慮包含說明查詢的評論,如下方範例所示。

建立專案層級的儲存查詢

若要與其他專案成員共用查詢:

主控台

  1. 在 GCP Console 中開啟 BigQuery 網頁版 UI。
    前往 GCP Console

  2. 按一下 [Compose new query] (撰寫新查詢)

  3. 在「Query editor」(查詢編輯器) 文字區域中輸入有效的 BigQuery SQL 查詢。例如,您可以透過網頁版 UI 快速入門導覽課程使用查詢。

    # 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] (儲存查詢)

  5. 在「Save query」(儲存查詢) 對話方塊中,輸入查詢的名稱,將「Visibility」(瀏覽權限) 設定為 [Project (editable by project members] (專案 (可由專案成員編輯) ),然後按一下 [Save] (儲存)

    儲存查詢專案

  6. 如要查看您已儲存的查詢,請按一下左側導覽面板中的 [Saved queries] (已儲存的查詢) 並按一下 [Project queries] (專案查詢)

    專案查詢分頁

  7. 按一下您儲存的查詢加以展開。

  8. 按一下 [Share query URL] (分享查詢網址),存取可分享的連結並將連結複製到剪貼簿。您也可以透過「Query editor」(查詢編輯器) 文字區域上方的 [Link sharing] (連結共用設定) 按鈕圖示存取此連結。

  9. 將連結分享給團隊中的其他成員。

傳統版 UI

  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」(新增查詢) 文字區域上方的連結圖示存取連結。

    查詢連結圖示

  9. 將連結分享給團隊中的其他成員。

建立公開的儲存查詢

若要與所有人共用查詢:

主控台

目前無法使用 GCP Console 建立公開的儲存查詢。

傳統版 UI

  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」(新增查詢) 文字區域上方的連結圖示存取連結。

    公開查詢連結圖示

  9. 分享連結。

更新儲存的查詢

若要更新儲存的查詢:

主控台

  1. 在 GCP Console 中開啟 BigQuery 網頁版 UI。
    前往 GCP Console

  2. 按一下左側導覽中的 [Saved queries] (已儲存的查詢),然後按一下 [Personal queries] (個人查詢) (以編輯不公開的查詢) 或 [Project Queries] (專案查詢) (以編輯專案層級查詢)。按一下您的查詢加以展開。

  3. 在查詢的右側,按一下 [Open query in editor] (在編輯器中開啟查詢)

    更新查詢

  4. 修改查詢。

  5. 按一下 [Save query] (儲存查詢),更新查詢而不變更名稱。如果您想要變更名稱,請按一下「Save query」(儲存查詢) 旁的向下箭號並選取 [Save as] (另存查詢),視需要在對話方塊中進行更新。

傳統版 UI

  1. 前往 BigQuery 網頁版 UI。
    前往 BigQuery 網頁版 UI

  2. 按一下左側導覽中的 [Query History] (查詢記錄),然後在「Queries」(查詢) 部分中,按一下 [Saved Queries] (已儲存查詢) (以編輯不公開查詢) 或 [Project Queries] (專案查詢) (以編輯專案層級或公開查詢)。

    專案查詢清單

  3. 按一下查詢右側的 [Edit Query] (編輯查詢)。

    編輯查詢按鈕

  4. 修改查詢。

  5. 按一下 [Save Query] (儲存查詢) 以開啟「Save Query」(儲存查詢) 對話方塊。

  6. 在「Save Query」(儲存查詢) 對話方塊中,保留原有名稱並按一下 [OK] (確認)

刪除儲存的查詢

若要刪除儲存的查詢:

主控台

  1. 在 GCP Console 中開啟 BigQuery 網頁版 UI。
    前往 GCP Console

  2. 按一下左側導覽中的 [Saved queries] (已儲存的查詢),然後按一下 [Personal queries] (個人查詢) (以刪除不公開的查詢) 或 [Project Queries] (專案查詢) (以刪除專案層級查詢)。按一下您的查詢加以展開。

  3. 按一下查詢右側的 [Delete] (刪除)

    刪除查詢

  4. 出現提示時,按一下 [Delete] (刪除) 加以確認。

傳統版 UI

  1. 前往 BigQuery 網頁版 UI。
    前往 BigQuery 網頁版 UI

  2. 按一下左側導覽中的 [Query History] (查詢記錄)

  3. 按一下查詢右側的 [Delete saved query] (刪除儲存的查詢) 按鈕 (X)。

  4. 系統提示時,按一下 [OK] (確定) 確認操作。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁