Looker proporciona varias versiones de la API y varios SDKs de lenguajes 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 lenguajes.
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.
Asistencia de Looker
Looker admite estas versiones de la API y SDKs de lenguajes. Los tickets de asistencia se pueden enviar a la asistencia de Looker y cumplir con los lineamientos de la asistencia de Looker. Solo la API 4.0 es compatible con Looker.
Asistencia de la comunidad
Este nivel solo se aplica a los SDKs de lenguajes. Los problemas se registran y administran en el repositorio de código abierto que se usa para ese SDK.
Un SDK de lenguajes puede estar en el nivel de asistencia de la comunidad por varios motivos:
- No tiene las funciones necesarias para alcanzar el nivel de asistencia de Looker.
- Necesita más infraestructura de asistencia y automatización (pruebas automatizadas, empaquetado, documentación, ejemplos, etcétera) antes de que Looker pueda admitirlo por completo.
- Se basa en tecnología obsoleta.
- No se probó con suficientes usuarios diferentes para considerarse listo 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 asistencia.
| 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 | Versión actual. Aún se pueden agregar extremos, argumentos y propiedades de estructura nuevos. Todos los SDKs de lenguajes de Looker compatibles usan la API 4.0. |
Las versiones futuras de la API se introducirán como alfa y luego pasarán por los ciclos de vida beta, estable y obsoleta.
SDKs de lenguajes
Los SDKs de lenguajes 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. El estado de asistencia de los SDKs de lenguajes se describe en la siguiente tabla.
| 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 archivo Léame 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 Android y Java Virtual Machine (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 genera el proyecto codegen de Looker, como C# (Look#) y Go (GoLook), son compatibles con la comunidad. Los problemas deben registrarse en el sdk-codegen repositorio. |
Leyenda de 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 del generador de código de 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 codegen que debería simplificar la generación personalizada. Este generador "heredado" usa el generador de código de código abierto OpenAPI, que es el reemplazo del 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
Looker adoptó recientemente un esquema de control de versiones que hace coincidir los SDKs de lenguajes 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 comience con 21.10.*.
SDKs de lenguajes
Los SDKs de lenguajes más recientes (producidos por codegen de Looker) coinciden con las versiones de Looker. Por ejemplo, los SDKs de Python y TypeScript coinciden con sus respectivas versiones de Looker.
A medida que movemos nuestros SDKs de lenguajes más antiguos 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 Looker.
Versiones de paquetes de bibliotecas 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. Como no es específico para ninguna versión de Looker, este paquete tiene versiones independientes de los SDKs de lenguajes que lo usan.
Cuando se publican otros SDKs de lenguajes en los administradores de paquetes, sus RTLs pueden convertirse en un paquete independiente. Cualquier paquete RTL independiente usará el control de versiones semántico en lugar de hacer coincidir las versiones de Looker.