Looker proporciona varias versiones de la API y múltiples SDKs de lenguaje que usan esas APIs. En este documento, se describen el estado y las políticas de compatibilidad de las versiones de la API de Looker y los SDKs de lenguajes.
Niveles de asistencia
Las versiones de la API de Looker y los SDKs tienen diferentes niveles de compatibilidad:
Los niveles de asistencia se describen en las siguientes secciones.
Compatible con Looker
Looker admite estas versiones de la API y estos SDKs de lenguajes. Los tickets de asistencia se pueden enviar al equipo de asistencia de Looker y deben cumplir con los lineamientos de la asistencia de Looker. Solo la API 4.0 es compatible con Looker.
Con apoyo de la comunidad
Este nivel solo se aplica a los SDKs de idiomas. Los problemas se presentan y administran en el repositorio de código abierto que se usa para ese SDK.
Un SDK de idioma puede estar en el nivel de asistencia de la comunidad por varios motivos:
- Carece de las funciones necesarias para lograr el nivel de asistencia de Looker.
- Necesita más infraestructura de automatización y asistencia (pruebas automatizadas, paquetes, documentación, ejemplos, etc.) para que Looker sea compatible por completo.
- Se basa en tecnología obsoleta.
- No ha sido probado por suficientes usuarios diferentes como para que se considere listo para salir de "alfa". estado.
No compatible
No se brinda asistencia. Las versiones 3.0 y 3.1 de la API no son compatibles.
Versiones de API
En la siguiente tabla, se enumeran las tres versiones documentadas de las APIs a partir de Looker 22.4 y se muestran sus niveles de compatibilidad.
| Versión | Asistencia | Estado | Descripción |
|---|---|---|---|
| 3.0 | No compatible | Eliminado | Se quitó esta API de Looker. |
| 3.1 | No compatible | Eliminado | Se quitó esta API de Looker. |
| 4.0 | Looker | Estable | Versión actual. Aún se pueden agregar extremos, argumentos y propiedades de estructura nuevos. Todos los SDKs de lenguaje de Looker compatibles usan la API 4.0. |
Cualquier versión futura de la API se presentará como alfa y, luego, avanzará por los ciclos de vida beta, estables y obsoletos.
SDKs de lenguajes
Los SDKs de lenguaje de Looker han evolucionado a lo largo de su ciclo de vida y se producen con una variedad de herramientas y técnicas. Todos los SDKs usan directa o indirectamente los documentos de especificaciones de la API de Looker. El estado de compatibilidad de los SDK de lenguaje se describe en la siguiente tabla.
| Idioma | Asistencia | Herramientas | Descripción |
|---|---|---|---|
| Ruby | Looker | Escritas a mano | El SDK de Ruby actual lee la especificación de la API de Looker para construir de forma dinámica los métodos del SDK. |
| Python | Looker | codegen | El SDK de Python se usa en todos los casos en que se puede emplear Python. Consulta el archivo readme del SDK de Python para obtener la información más reciente sobre las versiones compatibles de Python. |
| TypeScript | Looker | codegen | El SDK de TypeScript se usa para aplicaciones de nodos y navegador. |
| Kotlin | Comunidad | codegen | El SDK de Kotlin se usa para aplicaciones de dispositivos móviles Android y de máquina virtual Java (JVM). |
| Swift | Comunidad | codegen | El SDK de Swift se usa en aplicaciones para iOS y macOS. |
| R | Comunidad | Swagger: pasión por la cancha | LookR es el SDK de Looker para el lenguaje de programación R y funciona con R Studio. |
| Otro | Comunidad | codegen | La comunidad admite otros SDKs de lenguaje que genera el proyecto de codegen de Looker, como C# (Look#) y Go (GoLook). Los problemas se deben registrar en el repositorio sdk-codegen. |
Leyenda de las herramientas
- codegen: Lo genera el proyecto de codegen del SDK de Looker y usa una biblioteca de tiempo de ejecución escrita a mano para cada SDK.
- Swagger: Se genera con la herramienta OpenSource generador de código Swagger. Para los lenguajes de programación que no son compatibles directamente con el generador de código de Looker, proporcionamos una opción de generador heredado en el repositorio de codegen que debería simplificar la generación personalizada. Este elemento "heredado" usa el generador de código de OpenAPI de código abierto, que reemplaza al generador de código Swagger.
- Escritura a mano: Todo el código fuente se escribe a mano sin generar código.
Control de versiones del SDK
Looker adoptó recientemente un esquema de control de versiones que hace coincidir los SDKs de lenguaje con la versión de Looker que se usó para generarlos. Por ejemplo, esto significa que un SDK que se produjo con las especificaciones de Looker 21.10 tendrá una versión que comienza con 21.10.*.
SDKs de lenguajes
Los SDKs de lenguaje más recientes (producidos por codegen de Looker) coinciden con las versiones de actualización de Looker. Por ejemplo, los SDKs de Python y TypeScript coinciden con sus respectivas versiones de actualización de Looker.
A medida que trasladamos nuestros SDK de lenguaje anteriores a codegen o publicamos los existentes en sus administradores de paquetes, se configurará la versión del SDK para que coincida con la versión de actualización de Looker.
Versiones del paquete de la biblioteca del entorno de ejecución
El SDK de TypeScript depende de un paquete de biblioteca de entorno de ejecución (RTL) independiente, escrito por Looker, que por lo general admite APIs de REST. Debido a que no es específico para ninguna versión de Looker, este paquete cuenta con versiones independientes de los SDKs de lenguaje que lo usan.
Cuando se publican SDKs de otros lenguajes para administradores de paquetes, sus RTL pueden convertirse en un paquete independiente. Cualquier paquete de derecha a izquierda independiente usará el control de versiones semántico en lugar de hacer coincidir las versiones de actualización de Looker.