Looker fournit plusieurs versions d'API et plusieurs SDK de langage qui utilisent ces API. Ce document décrit l'état et les règles d'assistance pour les versions de l'API Looker et les SDK de langage.
Niveaux de prise en charge
Les niveaux d'assistance des versions de l'API Looker et des SDK varient :
Les niveaux d'assistance sont décrits dans les sections suivantes.
Prise en charge de Looker
Looker est compatible avec ces versions d'API et ces SDK de langage. Vous pouvez envoyer des demandes d'assistance à l'assistance Looker, qui respecte 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 langage. Les problèmes sont signalés et gérés dans le dépôt Open Source utilisé pour ce SDK.
Un SDK de langage peut être au niveau de l'assistance de la communauté pour plusieurs raisons :
- Il ne dispose pas des fonctionnalités requises pour atteindre le niveau compatible avec Looker.
- Il a besoin de plus d'infrastructures d'assistance et d'automatisation (tests automatisés, packaging, documentation, exemples, etc.) avant de pouvoir être entièrement pris en charge par Looker.
- Elle est basée sur une technologie obsolète.
- Il n'a pas été testé par suffisamment d'utilisateurs différents pour être considéré comme prêt à sortir 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 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. Vous pouvez toujours ajouter de nouveaux points de terminaison, arguments et propriétés de structure. Tous les SDK de langage Looker compatibles utilisent l'API 4.0. |
Les futures versions de l'API seront d'abord introduites en version 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. 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 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 README du SDK Python. |
| TypeScript | Looker | codegen | Le SDK TypeScript est utilisé à la fois pour les applications node et browser. |
| 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é | Votre audace | LookR est le SDK Looker pour le langage de programmation R et fonctionne avec R Studio. |
| Autre | Communauté | codegen | Les autres kits SDK linguistiques générés par le projet codegen 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 codegen du SDK Looker et utilise une bibliothèque d'exécution écrite à la main pour chaque SDK.
- Swagger : généré par l'outil Open Source Swagger code generator. Pour les langages de programmation qui ne sont pas directement compatibles avec le générateur de code de Looker, nous avons fourni une ancienne option de générateur 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 système de gestion des versions qui associe les SDK de langage à la version de Looker utilisée pour les générer. Par exemple, 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 (produits par Looker codegen) correspondent aux versions de Looker. Par exemple, les SDK Python et TypeScript correspondent à leurs versions Looker respectives.
À mesure que nous migrons nos anciens SDK de langage vers la génération de code ou que nous publions les SDK de génération de code existants sur leurs gestionnaires de packages, la version du SDK sera définie pour correspondre à la version de Looker.
Versions du package de la bibliothèque d'exécution
Le SDK TypeScript dépend d'un package de bibliothèque d'exécution (RTL) distinct, écrit par Looker, qui prend en charge de manière générique 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 packages, leurs fichiers RTL peuvent devenir un package distinct. Tout package RTL distinct utilisera la gestion sémantique des versions au lieu de correspondre aux versions de Looker.