Looker proporciona varias versiones de API y varios SDK de lenguaje que usan esas APIs. En este documento, se describen el estado y las políticas de asistencia de las versiones de la API de Looker y los SDK de lenguaje.
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 API y SDK de lenguaje. Los tickets de asistencia se pueden enviar a la Asistencia de Looker y deben cumplir con los lineamientos de la Asistencia de Looker. Solo se admite la API 4.0 de Looker.
Con asistencia de la comunidad
Este nivel solo se aplica a los SDK de lenguaje. Los problemas se archivan 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:
- Le faltan las funciones necesarias para alcanzar el nivel compatible con 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 se probó en suficientes usuarios diferentes como para considerar que está listo para dejar el estado "alpha".
No compatible
No se proporciona asistencia. No se admiten las versiones 3.0 y 3.1 de la API.
Versiones de API
En la siguiente tabla, se enumeran las tres versiones documentadas de la API a partir de Looker 22.4 y se muestran sus niveles de compatibilidad.
| Versión | Asistencia | Estado | Descripción |
|---|---|---|---|
| 3.0 | No compatible | Quitado | Esta API se quitó de Looker. |
| 3.1 | No compatible | Quitado | 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. |
Todas las versiones futuras de la API se presentarán como alfa y, luego, pasarán por los ciclos de vida beta, estable y obsoleto.
SDKs de lenguajes
Los SDK de lenguaje de Looker evolucionaron a lo largo de su vida útil 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 | Escrito 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 para aplicaciones de 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 | Otros SDK de lenguaje que genera el proyecto codegen de Looker, como C# (Look#) y Go (GoLook), son compatibles con la comunidad. Los problemas se deben enviar al repositorio sdk-codegen. |
Leyenda de herramientas
- codegen: Se genera con 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 de código abierto Swagger Code Generator. 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 generador "heredado" usa el generador de código de OpenAPI de código abierto, que reemplaza al generador de código de 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 lanzamiento 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 lenguajes anteriores a codegen o publicamos los SDKs de codegen existentes en sus administradores de paquetes, la versión del SDK se establecerá para que coincida con la versión de lanzamiento de Looker.
Versiones de paquetes de bibliotecas 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 admite de forma genérica las 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.