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 versions de l'API Looker et les SDK offrent différents niveaux de prise en charge :
Les niveaux de prise en charge sont décrits dans les sections suivantes.
Prise en charge par 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 doivent être conformes aux consignes de l'assistance Looker. Seule l'API 4.0 est prise en charge par Looker.
Prise 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 prise en charge de la communauté pour plusieurs raisons :
- Il ne dispose pas des fonctionnalités requises pour atteindre le niveau de prise en charge par Looker.
- Il a besoin de plus d'assistance 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 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 à quitter 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é | 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 peuvent toujours être ajoutés. Tous les SDK de langage Looker compatibles utilisent l'API 4.0. |
Toutes les futures versions de l'API seront introduites en tant qu'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é tout au long de la durée de vie de Looker et sont produits avec divers outils et techniques. Tous les SDK utilisent directement ou indirectement les documents de spécification de l'API Looker. L'état de prise en charge des SDK de langage est décrit dans le tableau suivant.
| Langue | Assistance | Outils | Description |
|---|---|---|---|
| Ruby | Looker | Écrit à la main | 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 être utilisé. Pour obtenir les dernières informations sur les versions de Python compatibles, consultez le fichier Lisez-moi du SDK Python. |
| TypeScript | Looker | codegen | Le SDK TypeScript est utilisé pour les applications de nœud et de navigateur. |
| Kotlin | Communauté | codegen | Le SDK Kotlin est utilisé pour les applications mobiles Android et 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 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 du 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 hérité dans le dépôt codegen qui devrait simplifier la génération personnalisée. Ce générateur "hérité" utilise le générateur de code Open Source OpenAPI, qui remplace le générateur de code Swagger.
- Écrit à la main : tout le 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 associe 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 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 Looker codegen) 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 que nous publions des SDK codegen existants dans leurs gestionnaires de packages, la version du SDK est définie pour correspondre à la version de Looker.
Versions des packages 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 est compatible de manière générique avec les API REST. Comme il n'est spécifique à aucune version de Looker, ce package est géré indépendamment des SDK de langage qui l'utilisent.
Lorsque d'autres SDK de langage sont publiés dans des gestionnaires de packages, leurs RTL peuvent devenir un package distinct. Tout package RTL distinct utilisera la gestion sémantique des versions plutôt que de correspondre aux versions de Looker.