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 haben unterschiedliche Supportstufen:
Die Supportstufen werden in den folgenden Abschnitten beschrieben.
Unterstützung von Looker
Looker unterstützt diese API-Versionen und Sprach-SDKs. Support-Tickets können beim Looker-Support eingereicht werden und entsprechen den Looker-Supportrichtlinien.
Von der Community unterstützt
Diese Stufe gilt nur für Sprach-SDKs. Probleme werden im OpenSource-Repository erfasst und verwaltet, das für dieses SDK verwendet wird.
Ein Sprach-SDK kann aus verschiedenen Gründen den Community-Support haben:
- Es fehlen die Funktionen, die erforderlich sind, um das von Looker unterstützte Level zu erreichen.
- Es benötigt mehr Support und Automatisierungsinfrastruktur (automatisierte Tests, Paketerstellung, Dokumentation, Beispiele usw.), bevor es vollständig von Looker unterstützt werden kann.
- Sie basiert auf veralteter Technologie.
- Sie wurde nicht von genügend verschiedenen Nutzern getestet, um den Status „Alpha“ zu beenden.
Nicht unterstützt
Es wird kein Support angeboten. Derzeit wird nur die API-Version 3.0 nicht unterstützt.
API-Versionen
In der folgenden Tabelle sind die drei dokumentierten API-Versionen ab Looker 22.4 mit ihren Supportstufen 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 | Aktueller Release. Neue Endpunkte, Argumente und Struktureigenschaften sowie Änderungen an Typen werden noch erstellt.Die meisten Looker-Sprach-SDKs verwenden API 4.0, wo neue API-Entwicklungen durchgeführt werden. 4.0 korrigiert Eigenschaftstypen, die von API 3.1-Nutzlasten nicht ordnungsgemäß codiert wurden. |
Alle zukünftigen API-Versionen werden als Alphaversion eingeführt und durchlaufen dann die Beta-, stabilen und eingestellten Lebenszyklen.
Sprach-SDKs
Die Sprach-SDKs von Looker haben sich über die gesamte Lebensdauer von Looker 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-Datei. |
| TypeScript | Looker | codegen | Das TypeScript-SDK wird sowohl für Knoten- als auch für Browseranwendungen verwendet. |
| Kotlin | Community | codegen | Das Kotlin SDK wird für Android-Apps und Java Virtual Machine-Anwendungen (JVM) 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 Sprach-SDKs, die im Codegen-Projekt von Looker generiert werden, wie C# (Look#) und Go (GoLook), werden von der Community unterstützt. Probleme sollten im Repository sdk-codegen gemeldet werden. |
Legende zu den Tools
- codegen: Wird vom SDK-Codegen-Projekt von Looker generiert und verwendet eine handschriftliche Laufzeitbibliothek für jedes SDK.
- Swagger: generiert vom OpenSource-Tool Swagger-Codegenerator. Für Programmiersprachen, die nicht direkt vom Codegenerator von Looker unterstützt werden, haben wir im Codegen-Repository eine Legacy-Generatoroption bereitgestellt, die die benutzerdefinierte Generierung vereinfachen sollte. Dieser „alte“ Generator verwendet den OpenAPI-Codegenerator, der den Swagger-Codegenerator ersetzt.
- Handschrift: Der gesamte Quellcode wird von Hand geschrieben, ohne dass Code generiert werden muss.
SDK-Versionsverwaltung
Looker hat vor Kurzem ein Versionsverwaltungsschema eingeführt, das Sprach-SDKs mit dem Looker-Release abgleicht, mit dem sie generiert wurden. Dies bedeutet zum Beispiel, dass ein SDK, das mit Spezifikationen von Looker 21.10 erstellt wurde, eine Version hat, die mit 21.10.* beginnt.
Sprach-SDKs
Die neuesten Sprach-SDKs (die vom Looker-Codegen erstellt wurden) entsprechen den Looker-Release-Versionen. Das Python SDK und das TypeScript SDK stimmen beispielsweise mit den jeweiligen Looker-Releaseversionen überein.
Wenn wir unsere älteren Sprach-SDKs auf Codegen umstellen oder vorhandene Codegen-SDKs für ihre Paketmanager veröffentlichen, wird die SDK-Version auf die Looker-Release-Version eingestellt.
Paketversionen der Laufzeitbibliothek
Das TypeScript-SDK hängt von einer separaten Laufzeitbibliothek (RTL-Paket) ab, das von Looker geschrieben wurde und allgemein REST APIs unterstützt. Da es nicht spezifisch für eine Looker-Version ist, wird dieses Paket unabhängig von den Sprach-SDKs versioniert, die es verwenden.
Wenn andere Sprach-SDKs für Paketmanager veröffentlicht werden, werden deren RTLs möglicherweise zu einem separaten Paket. Jedes separate RTL-Paket verwendet eine semantische Versionsverwaltung anstelle von übereinstimmenden Looker-Release-Versionen.