Looker fournit plusieurs versions d'API et plusieurs SDK linguistiques qui utilisent ces API. Ce document décrit les règles d'état et 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 et les SDK Looker offrent différents niveaux de prise en charge:
Les niveaux d'assistance sont décrits dans les sections suivantes.
Compatibilité avec Looker
Looker est compatible avec ces versions d'API et ces SDK de langages. Les demandes d'assistance peuvent être envoyées à l'assistance Looker et conformes aux consignes d'assistance Looker.
Soutien de la communauté
Ce niveau ne s'applique qu'aux SDK de langage. Les problèmes sont classés et gérés dans le dépôt OpenSource utilisé pour ce SDK.
Un SDK de langage peut se trouver au niveau de l'assistance de la communauté pour plusieurs raisons:
- Il ne dispose pas des fonctionnalités nécessaires pour atteindre le niveau pris en charge par Looker.
- Elle nécessite davantage d'assistance et d'infrastructure d'automatisation (tests automatisés, packaging, documentation, exemples, etc.) avant de pouvoir être entièrement prise en charge par Looker.
- Il est basé sur une technologie obsolète.
- Elle n'a pas été testée par suffisamment d'utilisateurs différents pour être considérée comme prête à sortir de l'état "alpha".
Non compatible
Aucune assistance n'est fournie. Actuellement, seule la version 3.0 de l'API n'est pas compatible.
Versions d'API
Le tableau suivant répertorie les trois versions d'API documentées à partir de Looker 22.4 et indique leur niveau 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. De nouveaux points de terminaison, arguments et propriétés de structure, ainsi que des modifications apportées aux types, sont toujours en cours de création.La plupart des SDK de langage Looker utilisent l'API 4.0, qui est l'étape du développement de nouvelles API. La version 4.0 corrige les types de propriétés qui ne sont pas encodés correctement par les charges utiles de l'API 3.1. |
Toutes les futures versions de l'API seront introduites en version alpha, puis passeront par les cycles de vie bêta, stables et obsolètes.
SDK de langage
Les SDK de Looker ont évolué tout au long de sa durée de vie et sont produits avec divers outils et techniques. Tous les SDK utilisent directement ou indirectement les documents de spécification de l'API de Looker. L'état de compatibilité des SDK de langage est décrit dans le tableau suivant.
| Langue | Assistance | Outils | Description |
|---|---|---|---|
| Ruby | Looker | Écriture manuscrite | Le SDK Ruby actuel lit la spécification de l'API Looker pour construire les méthodes du SDK de manière dynamique. |
| Python | Looker | codegen | Le SDK Python peut être utilisé partout où Python peut être utilisé. Consultez le fichier README du SDK Python pour obtenir les dernières informations sur les versions de Python compatibles. |
| TypeScript | Looker | codegen | Le SDK TypeScript est utilisé à la fois pour les applications de nœud et de navigateur. |
| Kotlin | Communauté | codegen | Le SDK Kotlin est utilisé pour les applications mobiles Android et les applications de machine virtuelle Java (JVM). |
| Swift | Communauté | codegen | Le SDK Swift est utilisé pour les applications iOS et macOS. |
| R | Communauté | Votre audace | LookR est le SDK Looker pour le langage de programmation R et fonctionne avec R Studio. |
| Autre | Communauté | codegen | D'autres langages de programmation générés par le projet de génération de code de Looker, tels que C# (Look#) et Go (GoLook), sont compatibles avec la communauté. Les problèmes doivent être enregistré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, qui utilise une bibliothèque d'exécution manuscrite pour chaque SDK.
- Swagger : généré par l'outil Open Source du générateur de code Swagger. Pour les langages de programmation qui ne sont pas directement compatibles avec le générateur de code de Looker, nous avons fourni une option héritée de générateur dans le dépôt de codegen qui devrait simplifier la génération personnalisée. Cet "ancien" générateur utilise le générateur de code OpenAPI Open Source, qui remplace le générateur de code Swagger.
- Écriture manuscrite : l'ensemble du code source est écrit à la main, sans aucune 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 produit à l'aide des spécifications Looker 21.10 aura une version commençant par 21.10*.
SDK de langage
Les SDK de langage les plus récents (générés par le générateur de code Looker) correspondent aux versions de Looker. Par exemple, les SDK Python et TypeScript correspondent à leurs versions respectives de Looker.
À mesure que nous transférons nos SDK dans d'anciens langages vers Codegen ou que nous publions des SDK de génération de code existants dans leurs gestionnaires de packages, la version du SDK est définie de manière à correspondre à la version de Looker.
Versions du package de bibliothèque d'exécution
Le SDK TypeScript dépend d'un package de bibliothèque d'exécution (RTL) distinct, écrit par Looker, compatible de manière générique avec les API REST. Comme il n'est spécifique à aucune version de Looker, les versions de ce package sont indépendantes des SDK linguistiques qui l'utilisent.
Lorsque des SDK dans d'autres langages sont publiés auprès des gestionnaires de packages, les langues qui se lisent de droite à gauche peuvent devenir un package distinct. Tout package d'orientation de droite à gauche utilise la gestion sémantique des versions plutôt que les versions correspondantes de Looker.