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 asistencia para las versiones de la API de Looker y los SDKs de lenguaje.
Niveles de asistencia
Las versiones de la API de Looker y los SDKs tienen diferentes niveles de asistencia:
Los niveles de asistencia se describen en las siguientes secciones.
Compatible con Looker
Looker admite estas versiones de la API y los SDKs de lenguaje. Los tickets de asistencia se pueden presentar ante el equipo de asistencia de Looker y deben cumplir con los lineamientos de asistencia de Looker. Solo se admite la API 4.0 de Looker.
Con asistencia de la comunidad
Este nivel solo se aplica a los SDKs de idiomas. Los problemas se registran 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 admitido por Looker.
- Necesita más infraestructura de asistencia y automatización (pruebas automatizadas, empaquetado, documentación, ejemplos, etcétera) antes de que Looker pueda admitirla por completo.
- Se basa en tecnología obsoleta.
- No se probó con suficientes usuarios diferentes como para considerarse lista para salir del estado "alfa".
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 de la API documentadas a partir de Looker 22.4 y se muestran sus niveles de compatibilidad.
| Versión | Asistencia | Estado | Descripción |
|---|---|---|---|
| 3.0 | No compatible | Quitado | Se quitó esta API de Looker. |
| 3.1 | No compatible | Quitado | Se quitó esta API de Looker. |
| 4.0 | Looker | Estable | Es la 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 la API se lanzarán como alfa y, luego, pasarán por los ciclos de vida beta, estable y obsoleta.
SDKs de lenguajes
Los SDKs de lenguaje de Looker evolucionaron a lo largo de la vida útil de Looker y se producen con una variedad de herramientas y técnicas. Todos los SDKs usan directa o indirectamente los documentos de especificación de la API de Looker. En la siguiente tabla, se describe el estado de compatibilidad de los SDKs de lenguajes.
| 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 en cualquier lugar donde 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 aplicaciones de node y de navegador. |
| Kotlin | Comunidad | codegen | El SDK de Kotlin se usa para aplicaciones para dispositivos móviles Android y la 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 SDKs de lenguajes que se generan con el proyecto de codegen de Looker, como C# (Look#) y Go (GoLook), cuentan con asistencia de la comunidad. Los problemas se deben registrar en el repositorio sdk-codegen. |
Leyenda de herramientas
- codegen: Se genera con el proyecto 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 que se genere código.
Control de versiones del SDK
Recientemente, Looker adoptó un esquema de versiones que coincide con los SDKs de lenguaje y 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 comience 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 SDKs de Python y TypeScript coinciden con sus respectivas versiones de lanzamiento de Looker.
A medida que migremos nuestros SDKs de lenguajes más antiguos a la generación de código o publiquemos los SDKs de generación de código 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 la biblioteca de tiempo de ejecución
El SDK de TypeScript depende de un paquete de biblioteca de tiempo de ejecución (RTL) independiente, escrito por Looker, que admite de forma genérica las APIs de REST. Dado que no es específico de ninguna versión de Looker, este paquete se versiona de forma independiente de los SDKs de lenguaje que lo usan.
Cuando se publican otros SDKs de idiomas en los administradores de paquetes, sus RTL pueden convertirse en un paquete independiente. Cualquier paquete independiente de RTL usará el control de versiones semántico en lugar de coincidir con las versiones de Looker.