Looker bietet mehrere API-Versionen und mehrere Sprach-SDKs, die diese APIs verwenden. In diesem Dokument werden der Status und die Supportrichtlinien für die Looker API-Versionen und Sprach-SDKs beschrieben.
Stufen der Unterstützung
Looker API-Versionen und SDKs werden unterschiedlich unterstützt:
Die Supportstufen werden in den folgenden Abschnitten beschrieben.
Von Looker unterstützt
Looker unterstützt die folgenden API-Versionen und Sprach-SDKs. Support-Tickets können beim Looker-Support eingereicht werden und müssen den Richtlinien für den Looker-Support entsprechen. Nur API 4.0 wird von Looker unterstützt.
Von der Community unterstützt
Diese Stufe gilt nur für Sprach-SDKs. Probleme werden im Open-Source-Repository eingereicht und verwaltet, das für das jeweilige SDK verwendet wird.
Ein Sprach-SDK kann aus verschiedenen Gründen auf Community-Supportebene verfügbar sein:
- Es fehlen die Funktionen, die erforderlich sind, um das von Looker unterstützte Level zu erreichen.
- Es ist noch mehr Unterstützung und Automatisierungsinfrastruktur (automatische Tests, Paketierung, Dokumentation, Beispiele usw.) erforderlich, bevor es vollständig von Looker unterstützt werden kann.
- Es basiert auf veralteter Technologie.
- Sie wurde nicht von genügend verschiedenen Nutzern getestet, sodass sie nicht mehr als bereit für den Übergang von der Alphaversion gilt. Status.
Nicht unterstützt
Es wird kein Support angeboten. Die API-Versionen 3.0 und 3.1 werden nicht unterstützt.
API-Versionen
In der folgenden Tabelle sind die drei dokumentierten API-Versionen ab Looker 22.4 und ihre Supportstufen aufgeführt.
| Version | Support | Status | Beschreibung |
|---|---|---|---|
| 3 | Nicht unterstützt | Entfernt | Diese API wurde aus Looker entfernt. |
| 3.1 | Nicht unterstützt | Entfernt | Diese API wurde aus Looker entfernt. |
| 4,0 | Looker | Stabile Version | Aktueller Release. Neue Endpunkte, Argumente und Struktureigenschaften können weiterhin hinzugefügt werden. Alle unterstützten Looker-Sprach-SDKs verwenden API 4.0. |
Alle zukünftigen API-Versionen werden als Alpha eingeführt und durchlaufen dann die Lebenszyklusphasen „Beta“, „Stable“ und „Verworfen“.
Sprach-SDKs
Die Sprach-SDKs von Looker haben sich im Laufe der Zeit weiterentwickelt und werden mit einer Vielzahl von Tools und Techniken erstellt. Alle SDKs verwenden direkt oder indirekt die API-Spezifikationsdokumente von Looker. Der Supportstatus der Sprach-SDKs ist in der folgenden Tabelle aufgeführt.
| Sprache | Support | Tools | Beschreibung |
|---|---|---|---|
| Ruby | Looker | Handschriftlich | Das aktuelle Ruby SDK liest die Looker API-Spezifikation, um die SDK-Methoden dynamisch zu erstellen. |
| Python | Looker | codegen | Das Python SDK wird überall dort verwendet, wo Python verwendet werden kann. In der Python SDK-Readme-Datei finden Sie aktuelle Informationen zu unterstützten Python-Versionen. |
| TypeScript | Looker | codegen | Das TypeScript SDK wird sowohl für Node- als auch für Browseranwendungen verwendet. |
| Kotlin | Community | Codegen | Das Kotlin SDK wird für Android Mobile- und Java Virtual Machine (JVM)-Anwendungen verwendet. |
| Swift | Community | codegen | Das Swift SDK wird für iOS- und macOS-Anwendungen verwendet. |
| R | Community | Stolz | LookR ist das Looker SDK für die Programmiersprache R und funktioniert mit R Studio. |
| Sonstiges | Community | codegen | Andere SDKs in anderen Sprachen, die vom codegen-Projekt von Looker generiert werden, z. B. C# (Look#) und Go (GoLook), werden von der Community unterstützt. Probleme sollten im sdk-codegen-Repository gemeldet werden. |
Toollegende
- codegen: Wird vom SDK-codegen-Projekt von Looker generiert und verwendet eine von Hand geschriebene Runtime-Bibliothek für jedes SDK.
- Swagger – Wird vom OpenSource-Tool Swagger-Codegenerator generiert. Für Programmiersprachen, die vom Codegenerator von Looker nicht direkt unterstützt werden, haben wir im codegen-Repository eine Option für den alten Generator bereitgestellt, die die benutzerdefinierte Generierung vereinfachen sollte. Dieses „Legacy“ verwendet den OpenSource-OpenAPI-Codegenerator, der den Swagger-Codegenerator ersetzt.
- Manuell geschrieben – Der gesamte Quellcode wird manuell geschrieben, ohne dass Code generiert werden muss.
SDK-Versionierung
Looker hat vor Kurzem ein Versionsverwaltungsschema übernommen, das Sprach-SDKs mit dem Looker-Release abgleicht, mit dem sie generiert wurden. Das bedeutet beispielsweise, dass ein SDK, das mit Looker 21.10-Spezifikationen erstellt wurde, eine Version hat, die mit 21.10.* beginnt.
Sprach-SDKs
Die neuesten Sprach-SDKs (von Looker Codegen produziert) entsprechen den Looker-Release-Versionen. Beispielsweise entsprechen die Python und TypeScript SDKs der jeweiligen Looker-Release-Version.
Wenn wir unsere älteren Sprach-SDKs auf Codegen umstellen oder vorhandene Codegen-SDKs an ihre Paketmanager veröffentlichen, wird die SDK-Version auf die Looker-Release-Version eingestellt.
Paketversionen der Laufzeitbibliothek
Das TypeScript SDK ist von einem separaten RTL-Paket (Runtime Library) von Looker abhängig, das REST APIs allgemein unterstützt. Da es für keine Looker-Version spezifisch ist, wird dieses Paket unabhängig von den Sprach-SDKs, die es verwenden, versioniert.
Wenn andere Sprach-SDKs für Paketmanager veröffentlicht werden, werden deren RTLs möglicherweise zu einem separaten Paket. Für jedes separate RTL-Paket wird die semantische Versionsverwaltung verwendet, anstatt die zugehörigen Looker-Releaseversionen abzugleichen.