Looker API 和 SDK 支援政策

Looker 提供多個 API 版本，以及多個使用這些 API 的 語言 SDK。本文件說明 Looker API 版本和語言 SDK 的狀態和支援政策。

支援級別

Looker API 版本和 SDK 支援的程度各有不同：

以下各節將說明支援等級。

支援 Looker

Looker 支援下列 API 版本和語言 SDK。您可以向 Looker 支援團隊提交支援單，並遵守 Looker 支援團隊指南。Looker 僅支援 API 4.0。

社群支援

這項層級僅適用於語言 SDK。問題會在該 SDK 使用的開放原始碼存放區中提出及管理。

語言 SDK 可能會處於社群支援層級，原因如下：

  • 缺少 Looker 支援層級所需的功能。
  • 需要更多支援和自動化基礎架構 (自動化測試、封裝、文件、範例等)，才能獲得 Looker 的完整支援。
  • 這個 API 以已淘汰的技術為基礎。
  • 尚未經過足夠多使用者的測試，因此無法判定是否已準備好從「alpha」狀態移出。

不支援

我們不會提供任何支援服務。不支援 API 3.0 和 3.1 版。

API 版本

下表列出 Looker 22.4 的三個已記錄 API 版本，並顯示其支援等級。

版本 支援 狀態 說明
3.0 不支援 已移除 這個 API 已從 Looker 中移除。
3.1 不支援 已移除 這個 API 已從 Looker 中移除。
4.0 Looker 穩定 目前版本。您仍可新增新的端點、引數和結構體屬性。所有支援的 Looker 語言 SDK 都使用 API 4.0。

任何未來的 API 版本都會以 Alpha 版推出，然後經歷 Beta 版、穩定版和已淘汰的生命週期。

語言 SDK

Looker 的語言 SDK 在 Looker 的生命週期中不斷演進，並使用各種工具和技術製作。所有 SDK 都會直接或間接使用 Looker 的 API 規格文件。下表說明語言 SDK 的支援狀態。

語言 支援 工具 說明
Ruby Looker 手寫 目前的 Ruby SDK 會讀取 Looker API 規格，以動態建構 SDK 方法。
Python Looker codegen 只要可以使用 Python，就可以使用 Python SDK。如要瞭解支援的 Python 版本最新資訊，請參閱 Python SDK 說明檔。
TypeScript Looker codegen TypeScript SDK 可用於 節點和瀏覽器應用程式。
Kotlin 社群 codegen Kotlin SDK 適用於 Android 行動和 Java 虛擬機器 (JVM) 應用程式。
Swift 社群 codegen Swift SDK 適用於 iOS 和 macOS 應用程式。
R 社群 Swagger LookR 是適用於 R 程式設計語言的 Looker SDK，可與 R Studio 搭配使用。
其他 社群 codegen 由 Looker 的 codegen 專案產生的其他語言 SDK (例如 C# (Look#) 和 Go (GoLook)) 則由社群支援。請將問題提交至 sdk-codegen 存放區。

工具圖例

SDK 版本

Looker 最近採用了版本命名方案，將語言 SDK 與用於產生 SDK 的 Looker 版本進行比對。舉例來說，這表示使用 Looker 21.10 規格產生的 SDK 版本會以 21.10.* 開頭。

語言 SDK

最新的語言 SDK (由 Looker codegen 產生) 與 Looker 版本相符。舉例來說，Python 和 TypeScript SDK 會與各自的 Looker 版本相符。

當我們將舊版語言 SDK 移至 codegen，或將現有的 codegen SDK 發布至其套件管理工具時，SDK 版本會設為與 Looker 發布版本相符。

執行階段程式庫套件版本

TypeScript SDK 會依賴由 Looker 編寫的獨立執行階段程式庫 (RTL) 套件，後者可一般支援 REST API。由於這個套件並非特定 Looker 版本，因此其版本與使用該套件的語言 SDK 無關。

當其他語言的 SDK 發布至套件管理員時，其 RTL 可能會成為個別套件。任何個別的 RTL 套件都會使用語意版本管理，而非 Looker 發布版本。