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
Für Looker-API-Versionen und SDKs sind unterschiedliche Supportstufen verfügbar:
Die Supportstufen werden in den folgenden Abschnitten beschrieben.
Von Looker 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. 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 OpenSource-Repository gemeldet und verwaltet, das für das jeweilige SDK verwendet wird.
Ein Sprach-SDK kann aus verschiedenen Gründen auf Community-Support-Ebene sein:
- Es fehlen die Funktionen, die für die von Looker unterstützte Ebene erforderlich sind.
- Es sind mehr Support- und Automatisierungsinfrastruktur (automatisierte Tests, Verpackung, Dokumentation, Beispiele usw.) erforderlich, bevor es vollständig von Looker unterstützt werden kann.
- Sie basiert auf einer veralteten Technologie.
- Es wurde nicht von genügend verschiedenen Nutzern getestet, um den Alphastatus 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 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 | Stabil | Aktueller Release Es können weiterhin neue Endpunkte, Argumente und Struktureigenschaften hinzugefügt werden. Alle unterstützten Looker-Sprach-SDKs verwenden API 4.0. |
Zukünftige API-Versionen werden als Alphaversion eingeführt und durchlaufen dann die Lebenszyklen „Beta“, „Stabil“ und „Eingestellt“.
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. Die neuesten Informationen zu unterstützten Python-Versionen finden Sie in der Python SDK-Readme-Datei. |
| TypeScript | Looker | codegen | Das TypeScript SDK wird sowohl für node- als auch für browser-Anwendungen verwendet. |
| Kotlin | Community | codegen | Das Kotlin SDK wird für mobile Android- und JVM-Anwendungen (Java Virtual Machine) 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 RStudio. |
| Sonstiges | Community | codegen | Andere Sprach-SDKs, 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-Codegenerierungsprojekt von Looker generiert und verwendet eine manuell geschriebene Laufzeitbibliothek für jedes SDK.
- Swagger: Wird vom Open-Source-Tool Swagger-Codegenerator generiert. 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 soll. Dieser „Legacy“-Generator verwendet den Open-Source-OpenAPI-Codegenerator, der den Swagger-Codegenerator ersetzt.
- Manuell geschrieben: Der gesamte Quellcode wurde manuell geschrieben und es wurde kein Code generiert.
SDK-Versionsverwaltung
Looker hat vor Kurzem ein Versionsschema eingeführt, bei dem Sprach-SDKs mit dem Looker-Release übereinstimmen, das zum Generieren der SDKs verwendet wurde. Ein SDK, das mit Looker 21.10-Spezifikationen erstellt wurde, hat also eine Version, die mit 21.10.* beginnt.
Sprach-SDKs
Die neuesten Sprach-SDKs (die von Looker-Codegenerierung erstellt wurden) entsprechen den Looker-Releaseversionen. Die Python- und TypeScript-SDKs entsprechen beispielsweise den jeweiligen Looker-Release-Versionen.
Wenn wir unsere älteren Sprach-SDKs auf Codegen umstellen oder vorhandene Codegen-SDKs in ihren Paketmanagern veröffentlichen, wird die SDK-Version auf die Looker-Release-Version festgelegt.
Versionen von Laufzeitbibliothekenpaketen
Das TypeScript SDK hängt von einem separaten Laufzeitbibliotheks-Paket (Runtime Library, RTL) ab, das von Looker geschrieben wurde und REST-APIs generisch unterstützt. Da es nicht spezifisch für eine bestimmte Looker-Version ist, wird dieses Paket unabhängig von den Sprach-SDKs, die es verwenden, versioniert.
Wenn andere Sprach-SDKs in Paketmanager hochgeladen werden, können ihre RTLs ein separates Paket werden. Für alle separaten RTL-Pakete wird die semantische Versionierung verwendet und nicht die Looker-Release-Versionen.