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 gelten unterschiedliche Supportstufen:
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 entsprechen den Looker-Supportrichtlinien. 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 gemeldet und verwaltet, das für dieses SDK verwendet wird.
Ein Sprach-SDK kann aus mehreren Gründen auf der Supportstufe der Community sein:
- Es fehlen die Funktionen, die für die von Looker unterstützte Stufe erforderlich sind.
- Es benötigt mehr Support- und Automatisierungsinfrastruktur (automatisierte Tests, Verpackung, Dokumentation, Beispiele usw.), bevor es vollständig von Looker unterstützt werden kann.
- Es basiert auf einer veralteten Technologie.
- Es wurde nicht von genügend verschiedenen Nutzern getestet, um als bereit für den Wechsel aus dem Alphastatus zu gelten.
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 | Looker | Stabil | Aktueller Release. Neue Endpunkte, Argumente und Strukturattribute 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 Lebenszyklen Beta, Stabil und Veraltet.
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 Infodatei zum Python SDK. |
| 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 Java Virtual Machine-Anwendungen (JVM) 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 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 sdk-codegen-Repository gemeldet werden. |
Legende für Tools
- codegen : Wird vom SDK-Codegen-Projekt von Looker generiert und verwendet für jedes SDK eine handschriftliche Laufzeitbibliothek.
- 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 einen älteren Generator bereitgestellt, die die benutzerdefinierte Generierung vereinfachen soll. Dieser ältere Generator verwendet den Open-Source-Codegenerator OpenAPI, der den Swagger-Codegenerator ersetzt.
- Handschriftlich : Der gesamte Quellcode wird manuell geschrieben, ohne dass eine Codegenerierung erfolgt.
SDK-Versionierung
Looker hat vor Kurzem ein Versionierungsschema eingeführt, das Sprach-SDKs mit dem Looker-Release abgleicht, mit dem sie generiert wurden. Ein SDK, das mit den Spezifikationen von Looker 21.10 erstellt wurde, hat beispielsweise eine Version, die mit 21.10.* beginnt.
Sprach-SDKs
Die neuesten Sprach-SDKs (die von Looker Codegen erstellt wurden) entsprechen den Looker-Releaseversionen. Die Python- und TypeScript-SDKs entsprechen beispielsweise den jeweiligen Looker-Releaseversionen.
Wenn wir unsere älteren Sprach-SDKs zu Codegen migrieren 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 Laufzeitbibliotheks-Paket (Runtime Library, RTL) abhängig, das von Looker geschrieben wurde und REST APIs generisch unterstützt. Da es nicht spezifisch für ein Looker-Release ist, wird dieses Paket unabhängig von den Sprach-SDKs versioniert, die es verwenden.
Wenn andere Sprach-SDKs in Paketmanagern veröffentlicht werden, können ihre RTLs zu einem separaten Paket werden. Für separate RTL-Pakete wird die semantische Versionierung verwendet, anstatt die Looker-Releaseversionen abzugleichen.