Looker proporciona varias versiones de API y varios SDKs 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 soporte
Las versiones y los SDK de la API de Looker 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 SDK de lenguajes. Los tickets de asistencia se pueden enviar al equipo de asistencia de Looker y cumplen con los lineamientos de asistencia de Looker.
Con apoyo de la comunidad
Este nivel solo se aplica a los SDKs 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 alcanzar el nivel compatible con Looker.
- Necesita más asistencia y infraestructura de automatización (pruebas automatizadas, empaquetado, documentación, ejemplos, etc.) antes de que sea totalmente compatible con Looker.
- Se basa en una tecnología obsoleta.
- No ha sido probado por suficientes usuarios diferentes como para considerarlo listo para salir del estado "alfa".
No compatible
No se brinda asistencia. Actualmente, solo la versión 3.0 de la API no es compatible.
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 asistencia.
| Versión | Asistencia | Estado | Descripción |
|---|---|---|---|
| 3.0 | No compatible | Se completó la eliminación | Se quitó esta API de Looker. |
| 3.1 | No compatible | Se completó la eliminación | Se quitó esta API de Looker. |
| 4.0 | Looker | Estable | Versión actual. Aún se están creando nuevos extremos, argumentos y propiedades de estructura, así como cambios en los tipos.La mayoría de los SDK del lenguaje Looker usan la API 4.0, que es donde se realiza el desarrollo de la nueva API. La versión 4.0 corrige los tipos de propiedad que las cargas útiles de la API 3.1 codificaron de forma incorrecta. |
Cualquier versión futura de la API se introducirá como alfa y luego se moverá por los ciclos de vida beta, estable y obsoleto.
SDK de lenguaje
Los SDK de lenguaje de Looker evolucionaron a lo largo de su ciclo de vida y se producen con una variedad de herramientas y técnicas. Todos los SDK usan de manera directa o indirecta los documentos de especificación de la API de Looker. El estado de compatibilidad de los SDK de lenguaje se describe en la siguiente tabla.
| Lenguaje | Asistencia | Herramientas | Descripción |
|---|---|---|---|
| Ruby | Looker | Escritura 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 siempre que se pueda usar Python. Consulta el archivo 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 las aplicaciones de nodo y del navegador. |
| Kotlin | Comunidad | codegen | El SDK de Kotlin se usa en aplicaciones para dispositivos móviles Android y de máquina virtual Java (JVM). |
| Swift | Comunidad | codegen | El SDK de Swift se usa para aplicaciones de 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 | Otros SDKs de lenguaje generados por el proyecto Codegen de Looker, como C# (Look#) y Go (GoLook), son compatibles con la Comunidad. Los problemas se deben informar en el repositorio de sdk-codegen. |
Leyenda de las herramientas
- codegen: Lo genera el proyecto codegen del SDK de Looker y usa una biblioteca de tiempo de ejecución escrita a mano para cada SDK.
- Swagger: Generado por la herramienta de código abierto generador de código Swagger. En el caso de 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ódigos Swagger.
- Escrito a mano: Todo el código fuente se escribe a mano sin necesidad de generar código.
Control de versiones del SDK
Recientemente, Looker adoptó 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.*.
SDK de lenguaje
Los SDKs de lenguaje más recientes (producidos por Looker codegen) coinciden con las versiones de actualización de Looker. Por ejemplo, los SDK de Python y TypeScript coinciden con sus respectivas versiones de actualización de Looker.
A medida que trasladamos nuestros SDKs de lenguaje anteriores a codegen o publiquemos los existentes en sus administradores de paquetes, se establecerá la versión del SDK para que coincida con la versión de lanzamiento de Looker.
Versiones de paquetes de la biblioteca de 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 es compatible de forma genérica con las APIs de REST. Como no es específico de ninguna versión de Looker, la versión de este paquete se basa independientemente de los SDKs de lenguaje que lo usan.
Cuando se publican SDK de otros lenguajes para administradores de paquetes, sus RTL pueden convertirse en un paquete independiente. Cualquier paquete RTL separado usará el control de versiones semántico en lugar de las versiones de actualización de Looker que coincidan.