Nous sommes heureux d'annoncer que l'API Looker 4.0 est en disponibilité générale dans Looker 22.4. L'API 4.0 en disponibilité générale (API 4.0 en disponibilité générale) comporte plusieurs modifications destructives et additives et promeut plusieurs points de terminaison de la version bêta à la version stable. Consultez la documentation de référence de l'API pour connaître les spécifications détaillées de l'API 4.0. Nous avons mis à jour nos SDK pris en charge par Looker et la communauté pour prendre en charge les points de terminaison en DG de l'API Looker 4.0. Pour en savoir plus, consultez Règles de compatibilité avec les API et les SDK et Gestion des versions d'API. Le reste de cet article décrit les modifications destructives, les mesures d'atténuation et les fonctionnalités que vous pouvez attendre lors de la migration vers l'API 4.0 en disponibilité générale.
À qui s'adresse ce message ?
Ce document vous concerne si vous utilisez l'API Looker via les SDK pris en charge par Looker, les SDK pris en charge par la communauté ou l'API elle-même. Lisez la section suivante pour en savoir plus sur la version de l'API Looker que vous utilisez.
Utilisateurs de l'API 4.0 pré-DG
Si vous utilisez l'API 4.0, lisez cette section. Il présente les modifications destructives et les mesures d'atténuation disponibles lorsque vous passez à l'API 4.0 en disponibilité générale.
La disponibilité générale de l'API 4.0 inclut la modification de tous les champs d'ID d'entité, du type integer
numérique au type string
. Par exemple, le point de terminaison GET /groups/{group_id}
renvoie id
comme type string
au lieu du type int64
.
Veuillez lire le tableau suivant pour connaître l'impact et les mesures d'atténuation spécifiques à votre utilisation de points de terminaison avec l'API 4.0:
Utilisation | Impact potentiel1 | Prévention |
Applications mobiles Looker | Les installations obsolètes des applications mobiles Looker cessent de fonctionner | Demandez aux utilisateurs d'installer la dernière version des applications mobiles Looker |
SDK pris en charge par Looker2 | ||
SDK TypeScript (API 4.0) | Aucun impact | Aucune action requise |
SDK Python (API 4.0) | Aucun impact | Aucune action requise |
SDK Ruby (API 4.0) | Aucun impact | Aucune action requise |
SDK acceptés par la communauté2 | ||
SDK Swift | Exceptions d'exécution | Mettez à jour le SDK vers la version 22.0 ou ultérieure, puis corrigez les erreurs de type qui en résultent, le cas échéant. |
SDK Kotlin | Aucun impact | Aucune action requise |
SDK LookR | Aucun impact | Aucune action requise |
SDK C# | Aucun impact | Aucune action requise |
SDK Go | Exceptions d'exécution | Mettez à jour le SDK vers la version 22.0 ou ultérieure, puis corrigez les erreurs de type qui en résultent, le cas échéant. |
Other | ||
Utiliser l'API 4.0 sans SDK (ou avec des bibliothèques fournies en externe) | Erreurs d'exécution possibles, en fonction de la sensibilité au type du langage | Examinez le code afin d'identifier les dépendances sur le type des champs d'ID et ajoutez la prise en charge des champs d'ID de type chaîne. Consultez également ces consignes supplémentaires. |
1: Prenons des schémas d'utilisation courants pouvant inclure l'utilisation des champs d'ID de Looker, mais pas de schémas d'utilisation inhabituels tels que l'application d'opérations numériques aux ID.
2: Compatibilité avec les SDK et API Looker Les bibliothèques soutenues par la communauté ne sont pas officiellement prises en charge par Looker.
Utilisateurs de l'API 3.1
Si vous utilisez l'API 3.1, lisez cette section. Il décrit les fonctionnalités et modifications supplémentaires mises à votre disposition par l'API 4.0. N'oubliez pas que tous nos SDK pris en charge par Looker et la communauté sont compatibles avec l'API 4.0. Pour en savoir plus, consultez les Règles de compatibilité avec les SDK et les API.
Fonctionnalités supplémentaires de l'API 4.0 GA
Pour vous faciliter la tâche, nous avons répertorié ci-dessous les modifications additives les plus importantes et utiles apportées à l'API 4.0:
- Création et gestion d'un tableau, d'un élément du tableau et d'une section du tableau. Consultez la page de documentation des tableaux pour en savoir plus.
- Interrogez des informations de connexion supplémentaires telles que les bases de données, les schémas, les colonnes et les tables. Définissez et mettez à jour des champs de connexion supplémentaires.
- Création et gestion des applications OAuth et des utilisateurs Pour en savoir plus, consultez la page de documentation OAuth.
- Recherchez des groupes comportant une hiérarchie et des rôles.
- Recherchez des rôles avec le nombre d'utilisateurs.
- Obtenir et définir les paramètres des instances Looker Consultez la page de documentation sur les paramètres pour en savoir plus.
- Création et gestion des alertes Pour en savoir plus sur les alertes, consultez la page de documentation sur les alertes.
- Création, gestion et test de tunnels SSH et de serveurs SSH. Pour en savoir plus sur SSH, consultez la page de documentation SSH.
- Déplacer et copier des tableaux de bord
- Obtenez des URL relatives pour les nouveaux tableaux de bord.
- Déplacer et copier des Looks.
- Intégration signée et clé secrète d'intégration non signée, URL, et création et gestion des utilisateurs
- Obtenir un jeton d'actualisation pour actualiser le jeton d'accès à la connexion
- Limitez et annulez les résultats obtenus en récupérant tous les modèles LookML et tous les utilisateurs.
- Limiter et décaler les résultats issus de la recherche d'utilisateurs
- Obtenez la spécification de l'API de l'instance Looker dans Swagger 2.x JSON.
Modifications apportées à l'abandon de l'API 4.0 en disponibilité générale
L'API 4.0 en disponibilité générale remplace plusieurs points de terminaison obsolètes de l'API 3.1 par des fonctionnalités améliorées. Vous trouverez ci-dessous la liste des points de terminaison concernés:
- Suppression des points de terminaison obsolètes de la page d'accueil. Veuillez utiliser les points de terminaison du tableau plutôt que les pages d'accueil. Consultez Présenter du contenu à l'aide de tableaux.
- Les points de terminaison Space obsolètes ont été supprimés. Utilisez des points de terminaison de dossier au lieu de l'espace. Consultez Organiser et gérer l'accès au contenu.
Utilisateurs de l'API 3.0
L'API 3.0 est obsolète. Nous vous recommandons de migrer vers l'API 4.0.
- Pour faciliter le développement, seule l'API 4.0 prend en charge tous les SDK pris en charge par Looker et la communauté. Consultez notre dépôt de SDK.
- L'API 4.0 introduit plusieurs nouvelles fonctionnalités et améliorations, comme indiqué dans la section Fonctionnalités supplémentaires de l'API 4.0 GA sur cette page.
Conclusion
De nouvelles fonctionnalités et des modifications complémentaires vont être ajoutées à l'API 4.0. Vous trouverez les dernières modifications dans notre documentation de référence sur les API. Pour en savoir plus, consultez Règles de compatibilité avec les API et les SDK et Gestion des versions d'API. Nous savons que les modifications destructives ne sont pas idéales. Sauf en cas de problème extrême, nous n'apporterons aucune modification destructive à notre API 4.0 en disponibilité générale. Nous espérons que notre API Looker 4.0 en disponibilité générale vous aidera à développer de manière plus productive et plus simple sur la plateforme Looker.