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.
Supportstufen
Für Looker API-Versionen und SDKs gibt es unterschiedliche Supportstufen:
Die Supportebenen werden in den folgenden Abschnitten beschrieben.
Looker wird unterstützt
Looker unterstützt diese 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. Looker unterstützt nur API 4.0.
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.
Es kann verschiedene Gründe dafür geben, dass ein Sprach-SDK auf Communityebene unterstützt wird:
- Es fehlen die Funktionen, die für die von Looker unterstützte Stufe erforderlich sind.
- Es ist noch mehr Unterstützung und Automatisierungsinfrastruktur (automatische Tests, Paketierung, Dokumentation, Beispiele usw.) erforderlich, bevor es von Looker vollständig unterstützt werden kann.
- Es basiert auf einer eingestellten Technologie.
- Es wurde nicht von genügend verschiedenen Nutzern getestet, um den Alpha-Status zu verlassen.
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 Supportebenen aufgeführt.
| Version | Support | Status | Beschreibung |
|---|---|---|---|
| 3,0 | 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 | Stabil | Aktuelle Version. 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 beschrieben.
| 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. Aktuelle Informationen zu unterstützten Python-Versionen finden Sie in der Python SDK-Readme. |
| 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-Mobilgeräte und JVM-Anwendungen (Java Virtual Machine) verwendet. |
| Swift | Community | codegen | Das Swift SDK wird für iOS- und macOS-Anwendungen verwendet. |
| R | Community | Swagger | 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 Repository sdk-codegen gemeldet werden. |
Legende für Tools
- codegen: Wird vom SDK-codegen-Projekt von Looker generiert und verwendet eine von Hand geschriebene Laufzeitbibliothek für jedes SDK.
- Swagger: Wird vom Open-Source-Tool Swagger Code Generator 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. Dieser „alte“ Generator verwendet den Open-Source-OpenAPI Code Generator, der den Swagger Code Generator ersetzt.
- Von Hand geschrieben: Der gesamte Quellcode wird von Hand geschrieben, ohne Codegenerierung.
SDK-Versionierung
Looker hat vor Kurzem ein Versionierungsschema eingeführt, das Sprach-SDKs mit der Looker-Version abgleicht, mit der sie generiert wurden. Das bedeutet beispielsweise, dass ein SDK, das mit den Looker 21.10-Spezifikationen erstellt wurde, eine Version hat, die mit 21.10.* beginnt.
Sprach-SDKs
Die neuesten Sprach-SDKs (von Looker codegen erstellt) entsprechen den Looker-Releaseversionen. So entsprechen beispielsweise die Python- und TypeScript-SDKs den jeweiligen Looker-Release-Versionen.
Wenn wir unsere älteren SDKs in codegen umwandeln oder vorhandene codegen-SDKs in ihren Paketmanagern veröffentlichen, wird die SDK-Version so festgelegt, dass sie der Looker-Releaseversion entspricht.
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 nicht für eine bestimmte Looker-Version spezifisch ist, wird dieses Paket unabhängig von den Sprach-SDKs versioniert, in denen es verwendet wird.
Wenn SDKs in anderen Sprachen in Paketmanagern veröffentlicht werden, werden ihre RTLs möglicherweise zu einem separaten Paket. Für jedes separate RTL-Paket wird die semantische Versionsverwaltung verwendet, anstatt die zugehörigen Looker-Release-Versionen abzugleichen.