Looker propose plusieurs versions d'API et plusieurs SDK de langage qui utilisent ces API. Ce document décrit l'état et les règles de prise en charge des versions de l'API Looker et des SDK de langage.
Niveaux de prise en charge
Les versions de l'API Looker et les SDK sont disponibles à différents niveaux d'assistance:
Les niveaux d'assistance sont décrits dans les sections suivantes.
Compatible avec Looker
Looker est compatible avec ces versions d'API et ces SDK de langage. Vous pouvez envoyer des demandes d'assistance à l'assistance Looker et respecter les consignes de l'assistance Looker. Seule l'API 4.0 est compatible avec Looker.
Pris en charge par la communauté
Ce niveau ne s'applique qu'aux SDK de langue. Les problèmes sont enregistrés et gérés dans le dépôt Open Source utilisé pour ce SDK.
Un SDK de langue peut être au niveau de l'assistance communautaire pour plusieurs raisons:
- Il ne dispose pas des fonctionnalités requises pour atteindre le niveau pris en charge par Looker.
- Il a besoin d'une infrastructure d'assistance et d'automatisation plus importante (tests automatisés, packaging, documentation, exemples, etc.) avant de pouvoir être entièrement pris en charge par Looker.
- Il est basé sur une technologie obsolète.
- Il n'a pas été testé par suffisamment d'utilisateurs différents pour être considéré comme prêt à passer de l'état "alpha".
Non compatible
Aucune assistance n'est fournie. Les versions 3.0 et 3.1 de l'API ne sont pas compatibles.
Versions d'API
Le tableau suivant liste les trois versions d'API documentées à partir de Looker 22.4 et indique leurs niveaux de compatibilité.
| Version | Assistance | État | Description |
|---|---|---|---|
| 3,0 | Non compatible | Supprimé | Cette API a été supprimée de Looker. |
| 3.1 | Non compatible | Supprimé | Cette API a été supprimée de Looker. |
| 4.0 | Looker | Stable | Version actuelle. Vous pouvez toujours ajouter de nouveaux points de terminaison, d'arguments et de propriétés de structure. Tous les SDK de langage Looker compatibles utilisent l'API 4.0. |
Les futures versions de l'API seront introduites en tant que versions alpha, puis passeront par les cycles de vie bêta, stable et obsolète.
SDK de langage
Les SDK de langage de Looker ont évolué au fil du temps et sont produits à l'aide de divers outils et techniques. Tous les SDK utilisent directement ou indirectement les documents de spécification de l'API de Looker. Le tableau suivant décrit l'état de compatibilité des SDK de langage.
| Langue | Assistance | Outils | Description |
|---|---|---|---|
| Ruby | Looker | Manuscrit | Le SDK Ruby actuel lit la spécification de l'API Looker pour construire dynamiquement les méthodes du SDK. |
| Python | Looker | codegen | Le SDK Python est utilisé partout où Python peut l'être. Pour obtenir les dernières informations sur les versions Python compatibles, consultez le fichier de documentation du SDK Python. |
| TypeScript | Looker | codegen | Le SDK TypeScript est utilisé à la fois pour les applications Node et navigateur. |
| Kotlin | Communauté | codegen | Le SDK Kotlin est utilisé pour les applications mobiles Android et les applications Java Virtual Machine (JVM). |
| Swift | Communauté | codegen | Le SDK Swift est utilisé pour les applications iOS et macOS. |
| R | Communauté | Swagger | LookR est le SDK Looker pour le langage de programmation R et fonctionne avec R Studio. |
| Autre | Communauté | codegen | Les autres SDK de langage générés par le projet de génération de code de Looker, tels que C# (Look#) et Go (GoLook), sont pris en charge par la communauté. Les problèmes doivent être signalés dans le dépôt sdk-codegen. |
Légende des outils
- codegen : généré par le projet de génération de code du SDK de Looker et utilise une bibliothèque d'exécution écrite à la main pour chaque SDK.
- Swagger : généré par l'outil Open Source Générateur de code Swagger. Pour les langages de programmation non directement compatibles avec le générateur de code de Looker, nous avons fourni une option de générateur obsolète dans le dépôt codegen, qui devrait simplifier la génération personnalisée. Ce générateur "ancien" utilise le générateur de code OpenAPI Open Source, qui remplace le générateur de code Swagger.
- Écrit à la main : tout le code source est écrit à la main, sans génération de code.
Gestion des versions du SDK
Looker a récemment adopté un schéma de gestion des versions qui fait correspondre les SDK de langage à la version de Looker utilisée pour les générer. Par exemple, cela signifie qu'un SDK créé à l'aide des spécifications de Looker 21.10 aura une version commençant par 21.10.*.
SDK de langage
Les SDK de langage les plus récents (produits par la génération de code Looker) correspondent aux versions de Looker. Par exemple, les SDK Python et TypeScript correspondent à leurs versions respectives de Looker.
Lorsque nous migrerons nos anciens SDK de langage vers codegen ou que nous publierons les SDK codegen existants dans leurs gestionnaires de paquets, la version du SDK sera définie pour correspondre à la version de Looker.
Versions des packages de bibliothèques d'exécution
Le SDK TypeScript dépend d'un package de bibliothèque d'exécution (RTL) distinct, écrit par Looker, qui est compatible de manière générique avec les API REST. Comme il n'est pas spécifique à une version de Looker, ce package est versionné indépendamment des SDK de langage qui l'utilisent.
Lorsque des SDK dans d'autres langues sont publiés dans des gestionnaires de paquets, leurs RTL peuvent devenir un package distinct. Tout package RTL distinct utilisera la gestion sémantique des versions plutôt que les versions de Looker correspondantes.