儲存及共用查詢

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

  • 共用的查詢僅會提供查詢的文字。您仍需擁有適當的存取權才可查詢資料。僅儲存查詢文字的一個優點是,查詢不完整仍可加以共用,即使查詢不是有效的查詢也可,讓您可以將該查詢做為範本使用,供其他使用者完成或自訂。

  • 已儲存的查詢唯一保留的查詢選項是「SQL Version」(SQL 版本),這個選項管理查詢要使用舊版 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. 在 Cloud Console 中開啟 BigQuery 網頁版 UI。
    前往 Cloud 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」(新查詢) 文字區域中輸入 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] (已儲存的查詢)。

    儲存的查詢清單

共用已儲存的查詢

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

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

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

建立專案層級的儲存查詢

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

主控台

  1. 在 Cloud Console 中開啟 BigQuery 網頁版 UI。
    前往 Cloud 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] (專案查詢)。

    [Project queries] (專案查詢) 分頁標籤

  7. 按一下已儲存查詢的名稱即可加以展開。

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

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

    查詢連結圖示

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

建立公開的已儲存查詢

如要與任何對象共用查詢:

主控台

目前無法使用 Cloud 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」(新查詢) 文字區域上方的連結圖示存取連結。

    公開查詢連結圖示

  9. 分享連結。

更新已儲存的查詢

如要更新已儲存的查詢:

主控台

  1. 在 Cloud Console 中開啟 BigQuery 網頁版 UI。
    前往 Cloud 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. 在 Cloud Console 中開啟 BigQuery 網頁版 UI。
    前往 Cloud 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] (確定) 加以確認。

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

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

這個網頁
需要協助嗎?請前往我們的支援網頁