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 langages de programmation SDK.
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. Les demandes d'assistance peuvent être envoyées à l'assistance Looker et conformes aux consignes d'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 enregistrés et gérés dans le dépôt Open Source 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 requises pour atteindre le niveau pris en charge par Looker.
- Il a besoin de plus de support et d'une infrastructure d'automatisation (tests automatisés, packaging, documentation, exemples, etc.) avant de pouvoir être entièrement pris en charge par Looker.
- Il repose 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 répertorie les trois versions d'API documentées à partir de Looker 22.4 et indique leurs niveaux de prise en charge.
| Version | Assistance | État | Description |
|---|---|---|---|
| 3,0 | Non compatible | Supprimée | Cette API a été supprimée de Looker. |
| 3.1 | Non compatible | Supprimée | 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 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 d'API de Looker. L'état de compatibilité des SDK des langages 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. Consultez le fichier README du SDK Python pour obtenir les dernières informations sur les versions Python compatibles. |
| TypeScript | Looker | codegen | Le SDK TypeScript est utilisé pour les applications de nœud et de navigateur. |
| Kotlin | Communauté | générateur de code | Le SDK Kotlin est utilisé pour les applications mobiles Android et de machines virtuelles 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é | générateur de code | D'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 du générateur de code Swagger. Pour les langages de programmation qui ne sont pas directement pris en charge par le générateur de code de Looker, nous avons fourni une option de générateur hérité dans le dépôt de génération de code afin de simplifier la génération personnalisée. Cet "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éé selon les 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 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 transférons nos anciens SDK de langage vers codegen ou publions les SDK codegen existants dans leurs gestionnaires de paquets, la version du SDK est 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.