管理員設定 - 自助式探索

透過自助式探索功能，Looker 使用者可以將 CSV、XLS 和 XLSX 檔案上傳至 Looker，然後在 Looker 探索中查詢及以圖表呈現資料，不必設定 LookML 模型或設定 Git 版本管控。

Looker 管理員可以從 Looker 的「管理」選單中選取「自助式探索」選項，設定「自助式探索」功能，並查看執行個體上的資料上傳作業。

事前準備

如要使用自助式探索，Looker 執行個體必須符合下列需求：

• 針對 BigQuery 連線執行 Looker 25.20 以上版本，或針對 Snowflake 連線執行 Looker 26.8 以上版本。
• 已連線至 BigQuery 或 Snowflake 資料庫，且連線必須透過下列方式設定：
  • 連線必須設定為「所有專案」範圍。如要驗證連線的範圍，請前往 Looker 管理選單的「連線」頁面，然後查看「資料庫」分頁中的「範圍」欄。連線建立後，即無法編輯連線的「專案範圍」值。
  • 必須啟用永久衍生資料表 (PDT) 的連線。如要確認連線已啟用 PDT，請開啟 Looker 的「連線」頁面，按一下連線的「編輯」按鈕，然後按一下開啟「選用設定」分頁，並確認「啟用 PDT」切換按鈕已開啟。
  • 如果是 Snowflake 連線，資料庫管理員必須將 CREATE STAGE 授予 Looker 角色。詳情請參閱建立 Looker 與 Snowflake 連線的說明文件頁面。
• 如要讓使用者建立自助式探索，他們的 Looker 使用者帳戶必須具備 upload_data 權限，才能將 CSV 檔案上傳至執行個體。

從 Google 試算表上傳資料時，請注意下列限制：

• 使用 Private Service Connect 的 Looker (Google Cloud Core) 執行個體不支援 Google 試算表上傳的 OAuth 流程。這些執行個體必須使用手動網址流程，才能上傳 Google 試算表的資料。
• 使用 VPC Service Controls 的 Looker (Google Cloud Core) 執行個體不支援上傳 Google 試算表。

啟用自助式探索

重要事項：

• 為支援自助式探索功能，升級至 Looker 25.20 後，Looker 執行個體會將 upload_data 權限新增至包含 explore 權限的任何角色或權限集，包括自訂權限集。如果您在 Looker 執行個體上啟用資料上傳功能，任何具備 upload_data 權限的使用者都能上傳資料，在執行個體上建立自助式探索。
• 如果執行個體已有自助式探索，請注意在「自助式探索」管理頁面變更設定時，可能會造成下列影響：
  • 停用資料上傳功能後，使用者將無法再透過「探索」選單存取現有的自助式探索，且任何依賴該資料的 Look 或資訊主頁都可能受到影響。
  • 如果您變更自助式探索的預設連線，執行個體上現有的自助式探索可能會受到影響，連帶影響任何依賴這些資料的 Look 或資訊主頁。

使用者必須先完成下列步驟，Looker 管理員才能設定這項功能，讓使用者建立自助式探索：

1. 在 Looker「管理」選單的「一般」部分，選取「自助式探索」管理頁面。
2. 在「自助式探索」管理頁面中，從「預設連線」下拉式選單選取 BigQuery 或 Snowflake 連線，用於儲存自助式探索的資料。Looker 會將資料儲存至這個資料庫，供執行個體上的自助式探索使用。
3. 按一下「資料上傳」切換按鈕旁的「測試」按鈕，確認預設連線有效，且連線已啟用持續性衍生資料表 (PDT) (如需連線規定，請參閱「事前準備」一節)。如果測試失敗，您就無法啟用資料上傳功能。前往「連線」管理頁面，排解連線問題。
4. 如果測試通過，請開啟「資料上傳」切換鈕，啟用自助式探索功能。
5. 如要讓 Looker 執行個體支援從 Google 試算表上傳資料：
   • 確認您已設定 BigQuery 連線，以便使用自助式探索功能 (只有 BigQuery 連線支援 Google 試算表上傳功能)。
   • 使用 Google Cloud 控制台啟用必要 API，支援上傳 Google 試算表。
   • 如要讓使用者透過 Google 雲端硬碟導覽選取 Google 試算表檔案來上傳資料，請視需要啟用 Google 試算表上傳的 OAuth。
   • 按一下「Google 試算表資料匯入」切換按鈕旁的「測試」按鈕，即可執行 Google 試算表上傳專屬測試。
   • 開啟「Google 試算表資料匯入」切換鈕。(如要從 Google 試算表上傳資料，必須同時啟用「資料上傳」切換鈕和「Google 試算表資料匯入」切換鈕)。

啟用 API，支援上傳至 Google 試算表

如要讓 Looker 支援從 Google 試算表上傳資料以建立 BigQuery 連線，IAM 使用者必須在 Google Cloud 控制台中啟用下列 API，並具備 IAM roles/serviceusage.serviceUsageAdmin 權限：

• 您必須在 Google Cloud 專案中啟用這個 API，該專案包含自助式探索管理頁面「預設連線」下拉式選單中指定的 BigQuery 連線：

  • BigQuery API：所有 BigQuery 作業都必須使用

• 您必須在與用於上傳資料的服務帳戶相關聯的 Google Cloud 專案中啟用這些 API (用於 BigQuery 連線的 PDT 程序的服務帳戶，可能與 Google Cloud 「自助式探索」管理頁面「預設連線」下拉式選單中指定的專案相同)：

  • BigQuery API：所有 BigQuery 作業都必須使用
  • Google Sheets API：用於擷取 Google 試算表文件中每個工作表的名稱
  • Google 雲端硬碟 API：BigQuery 必須使用這項 API，才能從雲端硬碟讀取檔案

請按照下列步驟啟用 API：

1. 在 Google Cloud 控制台中開啟專案挑選器，然後選取包含 BigQuery 連線的專案。該連線位於「自助式探索」管理頁面的「預設連線」下拉式選單中。

2. 在 Google Cloud 控制台的導覽選單中，依序前往「API 和服務」>「程式庫」，然後開啟 BigQuery API。

   前往 BigQuery API

3. 在 BigQuery API 頁面中，如果 API 尚未啟用，請點選「啟用」。

4. 在 BigQuery API 頁面上，從 Google Cloud 控制台開啟專案挑選器，然後選取與用於上傳資料的服務帳戶相關聯的專案 (用於 BigQuery 連線的 PDT 程序)。 Google Cloud

5. 在 BigQuery API 頁面中，如果 API 尚未啟用，請點選「啟用」。

6. 在 Google Cloud 控制台的導覽選單中，依序前往「API 和服務」>「程式庫」，然後開啟 Google Sheets API。

   前往 Google Sheets API

7. 在 Google Sheets API 頁面中，如果 API 尚未啟用，請點選「啟用」。

8. 在 Google Cloud 控制台的導覽選單中，依序前往「API 和服務」>「程式庫」，然後開啟 Google Drive API。

   前往 Google Drive API

9. 在 Google Drive API 頁面中，如果 API 尚未啟用，請點選「啟用」。

Private Service Connect 執行個體的設定

如果 Looker (Google Cloud Core) 執行個體使用 Private Service Connect (PSC)，您必須執行額外步驟，才能支援 Google 試算表上傳作業。

如要允許 Looker 存取 Google Sheets API，您必須使用 Private Service Connect 將 Google Sheets 發布為服務，然後在 Looker (Google Cloud Core) 設定中，將 Google Sheets 新增至「本機 FQDN」設定。設定本機 FQDN 時，請在「本機 FQDN」欄位中使用 sheets.googleapis.com，並在「目標服務附件 URI」欄位中使用已發布服務的服務附件 URI。如需操作說明，請參閱「使用本機 FQDN 連線至已發布的服務」文件。

啟用 Google 試算表上傳的 OAuth

重要事項：使用 Private Service Connect 的 Looker (Google Cloud Core) 執行個體不支援 Google 試算表上傳的 OAuth 流程。這些執行個體必須使用手動網址流程，才能上傳 Google 試算表的資料。

啟用自助式探索、啟用 API 以支援 Google 試算表上傳，並啟用「匯入 Google 試算表資料」切換鈕後，您也可以允許使用者透過 Google 雲端硬碟導覽選取 Google 試算表文件，以上傳資料。

如要在 Looker 執行個體上啟用 Google 雲端硬碟導覽功能，具備必要角色的 IAM 使用者必須在 Google Cloud 控制台中建立 OAuth 用戶端，然後按照本節程序所述，在 Looker 執行個體的「自助式探索」管理頁面中輸入 OAuth 憑證。

注意： 您必須先設定 OAuth 同意畫面，讓使用者選擇如何授予私人資料的存取權，才能產生 OAuth 憑證。如果您尚未為所選 Google Cloud 控制台專案設定 OAuth 同意畫面，控制台 Google Cloud 會顯示通知和「設定同意畫面」按鈕。按一下按鈕，然後按照「設定 OAuth 同意畫面並選擇範圍」Workspace 文件頁面的程序操作，接著返回這個程序。

如要建立 OAuth 用戶端並在 Looker 執行個體中輸入憑證，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，使用 Google Cloud 控制台的「Open project picker」(開啟專案挑選器)，選取與用於上傳資料的服務帳戶相關聯的 Google Cloud 專案 (用於 BigQuery 連線的 PDT 程序的服務帳戶)。

   前往 Google Cloud 控制台

2. 使用 Google Cloud 控制台主選單，依序前往「API 和服務」>「憑證」。

3. 在「憑證」頁面中，按一下「建立憑證」下拉式選單，然後選取「OAuth 用戶端 ID」。

4. 在「應用程式類型」下拉式選單中，選取「網頁應用程式」。

5. 在「Name」(名稱) 欄位中，輸入 OAuth 用戶端的名稱，例如 Looker upload data from Sheets。

6. 在「已授權的 JavaScript 來源」部分，按一下「新增 URI」按鈕。輸入 Looker 執行個體網址：

   https://LOOKER_INSTANCE_URL
   

7. 點選「建立」。

8. 按一下「建立」後，系統會顯示「已建立 OAuth 用戶端」視窗。這個視窗會顯示 Google Cloud 控制台為 OAuth 用戶端建立的用戶端 ID 和用戶端密鑰。複製並記下這些值。

9. 在 Looker 執行個體中，從「管理」面板的「一般」部分選取「自助式探索」。

10. 在「自助式探索」頁面的「用戶端 ID」和「用戶端密鑰」欄位中，貼上您在 Google Cloud 控制台中建立 OAuth 用戶端時，從 Google Cloud 控制台複製的值。

11. 按一下 [儲存]。

12. 按一下「Google 試算表資料匯入」切換按鈕旁的「測試」按鈕，測試 OAuth 設定和 Google 試算表上傳設定。(您也可以點選「資料上傳」切換按鈕旁的「測試」按鈕，驗證連線和 Google 試算表設定。)

現在，使用者透過「從雲端匯入」選項上傳資料時，Looker 會顯示 Google 雲端硬碟導覽畫面，供使用者選取 Google 試算表文件。

在 Looker 執行個體中查看資料上傳作業

如果執行個體已啟用自助式探索，Looker 管理員可以使用「自助式探索」管理頁面上的「資料上傳」表格，查看使用者在執行個體上傳的資料。

「資料上傳」表格會顯示執行個體資料上傳的下列資訊：

• 自助式探索的名稱，也是開啟自助式探索的超連結
• 資料上傳作業的擁有者
• 資料上傳日期
• 「刪除」按鈕，可供 Looker 管理員刪除檔案上傳內容和相關聯的自助式探索

Looker 管理員可以使用「資料上傳」表格中的連結，開啟執行個體上的任何自助式探索。不過，Looker「探索」選單的「自助式探索」部分只會列出您擁有的自助式探索，或是擁有者特別與您共用的自助式探索。「探索」選單不會列出 Looker 管理員執行個體上的所有自助式探索，因為這樣會讓「探索」選單變得笨重。

移除資料上傳作業

資料上傳擁有者可以從「編輯自助式探索」頁面移除上傳的資料。此外，Looker 管理員可以按照下列步驟，從「自助式探索」管理頁面移除資料上傳：

1. 在 Looker「管理」選單的「一般」部分，選取「自助式探索」管理頁面。
2. 在「資料上傳」表格中，按一下要移除的資料上傳項目的「刪除」按鈕。
3. 在確認對話方塊中按一下「刪除」。