Looker proporciona varias versiones de la API y varios 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.
Compatibilidad 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 SDK de lenguaje. Los problemas se presentan y administran en el repositorio de código abierto que se usa para ese SDK.
Un SDK de lenguaje 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 asistencia y una infraestructura de automatización (pruebas automatizadas, empaquetado, documentación, ejemplos, etc.) para que Looker pueda admitirlo 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 proporciona 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 | Esta API se quitó de Looker. |
| 3.1 | No compatible | Eliminado | Esta API se quitó de Looker. |
| 4.0 | Looker | Estable | Versión actual. Aún se pueden agregar nuevos extremos, argumentos y propiedades de estructura. Todos los SDKs de lenguaje de Looker compatibles usan la API 4.0. |
Las versiones futuras de las APIs se presentarán como alfa y, luego, pasarán por los ciclos de vida beta, estables y obsoletos.
SDKs de lenguajes
Los SDKs de lenguaje de Looker han evolucionado a lo largo del ciclo de vida de Looker y se producen con una variedad de herramientas y técnicas. Todos los SDKs usan directamente o indirectamente los documentos de especificación de la API de Looker. En la siguiente tabla, se describe el estado de compatibilidad de los SDK de lenguaje.
| Idioma | Asistencia | Herramientas | Descripción |
|---|---|---|---|
| Ruby | Looker | Escrita 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 donde se puede usar Python. Consulta el readme del SDK de Python para obtener la información más reciente sobre las versiones de Python compatibles. |
| TypeScript | Looker | codegen | El SDK de TypeScript se usa para aplicaciones de nodos y navegadores. |
| Kotlin | Comunidad | codegen | El SDK de Kotlin se usa para aplicaciones para dispositivos móviles de Android y máquina virtual Java (JVM). |
| Swift | Comunidad | codegen | El SDK de Swift se usa en aplicaciones para iOS y macOS. |
| R | Comunidad | Swagger | 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 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.
- Escrito a mano: Todo el código fuente se escribe a mano sin generar código.
Control de versiones del SDK
Recientemente, Looker adoptó un esquema de control de versiones que hace coincidir los SDK 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 SDK de Python y TypeScript coinciden con sus respectivas versiones de lanzamiento de Looker.
A medida que trasladamos nuestros SDKs 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. Como no es específico de ninguna versión de Looker, este paquete tiene control de versiones independientemente de los SDKs de lenguaje que lo usan.
Cuando se publican SDKs de otros idiomas en los administradores de paquetes, sus RTL pueden convertirse en un paquete independiente. Cualquier paquete de RTL independiente usará el control de versiones semántico en lugar de coincidir con las versiones de lanzamiento de Looker.