Looker ofrece 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 de 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 distintos niveles de asistencia:
Los niveles de asistencia se describen en las siguientes secciones.
Looker admitido
Looker admite estas versiones de la API y SDKs de idiomas. Las incidencias se pueden registrar en el equipo de Asistencia de Looker y deben cumplir las directrices de Asistencia de Looker. Looker solo admite la API 4.0.
Asistencia de la comunidad
Este nivel solo se aplica a los SDKs de idiomas. Los problemas se registran y gestionan 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:
- No tiene 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.) para que Looker pueda ofrecer asistencia completa.
- Se basa en una tecnología obsoleta.
- No se ha probado con suficientes usuarios diferentes como para considerarse lista para dejar la fase alfa.
No compatible
No se ofrece asistencia. Las versiones 3.0 y 3.1 de la API no son compatibles.
Versiones de la API
En la siguiente tabla se muestran las tres versiones de la API documentadas a partir de Looker 22.4 y sus niveles de asistencia.
| Versión | Asistencia | Estado | Descripción |
|---|---|---|---|
| 3,0 | No compatible | Retirado | Esta API se ha retirado de Looker. |
| 3.1 | No compatible | Retirado | Esta API se ha retirado de Looker. |
| 4.0 | Looker | Estable | Versión actual. Se pueden seguir añadiendo nuevos endpoints, argumentos y propiedades de estructura. Todos los SDKs de lenguaje de Looker admitidos usan la API 4.0. |
Las versiones futuras de la API se lanzarán como alfa y, después, pasarán por las fases beta, estable y obsoleta.
SDKs de idiomas
Los SDKs de lenguaje de Looker han evolucionado a lo largo de la vida de Looker y se han creado con diversas 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 asistencia de los SDKs de idiomas.
| 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 crear dinámicamente 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 tanto en aplicaciones Node como en aplicaciones de navegador. |
| Kotlin | Comunidad | codegen | El SDK de Kotlin se usa en aplicaciones móviles Android y de Java Virtual Machine (JVM). |
| Swift | Comunidad | codegen | El SDK de Swift se usa en aplicaciones 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 idiomas generados por el proyecto de generación de código de Looker, como C# (Look#) y Go (GoLook), cuentan con la asistencia de la comunidad. Los problemas deben registrarse en el repositorio sdk-codegen. |
Leyenda de las herramientas
- codegen: generado por 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, hemos proporcionado una opción de generador antiguo en el repositorio de codegen que debería simplificar la generación personalizada. Este generador antiguo usa el generador de código OpenAPI de código abierto, que sustituye al generador de código 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 ha adoptado un sistema de control de versiones que asocia los SDKs de lenguaje con la versión de Looker que se usó para generarlos. Por ejemplo, un SDK que se haya creado con las especificaciones de Looker 21.10 tendrá una versión que empiece por 21.10.*.
SDKs de idiomas
Los SDKs de lenguaje más recientes (producidos por Looker codegen) 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 idiomas antiguos a codegen o publiquemos los SDKs de codegen en sus gestores de paquetes, la versión del SDK se establecerá para que coincida con la versión de lanzamiento de Looker.
Versiones del paquete de 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 REST. Como no es específico de ninguna versión de Looker, este paquete tiene una versión independiente de los SDKs de lenguaje que lo usan.
Cuando se publican SDKs en otros idiomas en gestores de paquetes, sus RTLs pueden convertirse en un paquete independiente. Cualquier paquete RTL independiente usará el control de versiones semántico en lugar de coincidir con las versiones de lanzamiento de Looker.