Looker API 和 SDK 支持政策

Looker 提供多个 API 版本和多个使用这些 API 的语言 SDK。本文档介绍了 Looker API 版本和语言 SDK 的状态和支持政策。

支持级别

Looker API 版本和 SDK 提供不同级别的支持：

以下各部分介绍了支持级别。

支持 Looker

Looker 支持下列 API 版本和语言 SDK。您可以向 Looker 支持团队提交支持请求，并且符合 Looker 支持准则。

由社区提供支持

此级别仅适用于语言 SDK。问题会在用于该 SDK 的 OpenSource 代码库中提交和管理问题。

出于多种原因，语言 SDK 可能处于社区支持级别：

  • 它缺少达到 Looker 支持的级别所需的功能。
  • 它需要更多的支持和自动化基础架构（自动化测试、打包、文档、示例等），才能得到 Looker 的全面支持。
  • 它基于已弃用的技术。
  • 此应用尚未经过足够多的用户测试，无法被视为已准备好退出“Alpha 版”状态。

不支持

我们不提供支持服务。目前，仅支持 API 版本 3.0。

API 版本

下表列出了自 Looker 22.4 起记录的三个 API 版本，并显示了它们的支持级别。

版本 支持 状态 说明
3.0 不支持 已移除 此 API 已从 Looker 中移除。
3.1 不支持 已移除 此 API 已从 Looker 中移除。
4.0 Looker 稳定 当前版本。仍在创建新的端点、参数和结构属性，以及对类型的更改。

大多数 Looker 语言 SDK 都使用 API 4.0，这是新 API 开发工作的地方。4.0 更正了 API 3.1 载荷未正确编码的属性类型。

未来的所有 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 社区 摇摆 LookR 是适用于 R 编程语言的 Looker SDK，可与 R Studio 搭配使用。
其他 社区 codegen Looker 的代码生成项目生成的其他语言 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，或将现有代码生成 SDK 发布到其软件包管理器时，SDK 版本将设置为与 Looker 发布版本匹配。

运行时库软件包版本

TypeScript SDK 依赖于由 Looker 编写的单独运行时库 (RTL) 软件包，该软件包通常支持 REST API。由于此软件包不是特定于任何 Looker 版本，因此此软件包的版本与使用它的语言 SDK 无关。

当其他语言 SDK 发布到软件包管理器时，它们的 RTL 可能会成为一个单独的软件包。任何单独的 RTL 软件包都将使用语义版本控制，而不是匹配的 Looker 发布版本。