Looker API 現在會使用查詢 ID 的查詢別名值

注意：本頁面所述的變更將分階段發布：

• Looker 24.20 (2024 年 12 月 4 日)：美洲搶先體驗客戶
• Looker 25.0：美洲中型客戶
• Looker 25.2：正式發布 (GA)

下列 Looker 應用程式 API 方法不會使用數字 query_id 值，如果是 Query API，則不會使用數字 id 值。下列方法會改用查詢 Slug 值。

• Look API：

  • 複製 Look 圖表
  • 建立 Look
  • 取得 Look
  • 移動 Look
  • 搜尋外觀
  • 更新 Look 圖表
  • 取得所有 Look

• 資訊主頁 API：

  • 搜尋資訊主頁元素
  • 取得 DashboardElement
  • Update DashboardElement
  • 取得所有 DashboardElement
  • 建立 DashboardElement

• 算繪工作 API：

  • 建立 Look 算繪工作
  • 建立查詢顯示工作
  • 建立資訊主頁算繪工作
  • 取得算繪工作
  • 建立資訊主頁元素算繪工作

• 預定計畫 API：

  • 空間的排定計畫
  • 取得排定計畫
  • 更新排定計畫
  • Get All Scheduled Plans
  • 建立排定時間的方案
  • 預定 Look 的方案
  • 資訊主頁的排定計畫
  • LookML 資訊主頁的排定計畫

• 查詢 API：

  • 執行非同步查詢
  • 取得查詢
  • Get Query for Slug
  • 建立查詢
  • 執行查詢
  • 取得合併查詢
  • 建立合併查詢
  • Get All Running Queries

我需要做些什麼？

query_id 欄位 (如果是 Query API，則是 id 欄位) 是字串資料型別。query_id 或 id 欄位現在會在 API 回應中傳回查詢 Slug 值。然後，您可以在任何 API 要求中使用該查詢代碼值。

舉例來說，如果您要使用 Create Query API 建立查詢，則 id 會是回應中的查詢代碼。然後使用該 id 提出後續要求。

如果您為任何列出的 API 方法硬式編碼數值查詢 ID 值，請務必更新指令碼，改用查詢代碼值！

如何找出查詢的 slug 值？

您可以透過下列方式找出查詢的 slug 值：

• 如果是探索，您可以在探索的網址中找到 Slug，網址中 qid= 變數後方的部分就是 Slug。

• 您可以使用「系統活動」，找出與數值查詢 ID 相關聯的 slug 值。

  注意： 如要查看「系統活動」探索，您必須具備包含 see_system_activity 權限的角色。

  1. 在 Looker 的「探索」選單中，依序選取「系統活動」>「記錄」探索。

  2. 在「Query」檢視表中，選取「ID」和「Link」維度。

  3. 視需要新增「ID」維度的篩選條件，並在「查詢 ID」篩選條件欄位中輸入查詢的數值查詢 ID。

  4. 按一下「執行」。

     

  5. 在「探索」結果中，按一下數值查詢 ID 旁的 [Query] 連結，即可根據該數值查詢 ID 開啟「探索」。

  6. 然後您就可以在「探索」的網址中使用這個代碼，網址中的 qid= 變數會接在這個代碼後面。

如何判斷我們是否使用任何更新的 API 端點？

您可以使用 API 用量系統活動探索，查看對 Looker 執行個體發出的 API 呼叫清單。

1. 在 Looker 的「探索」選單中，選取「系統活動」探索，然後選取「API 使用量」檢視畫面。

2. 選取「建立日期」>「日期」和「端點」維度，以及「總用量」指標。

3. 在「端點」維度中新增篩選器，然後在篩選器欄位中，加入您要搜尋的任何更新端點 (如本文開頭所列)。

4. 按一下「執行」。Looker 會顯示這些端點的使用資訊。