O Looker oferece diversas versões de API e vários SDKs de linguagem que usam essas APIs. Neste documento, descrevemos o status e as políticas de suporte das versões da API Looker e dos SDKs de linguagem.
Níveis de suporte
As versões da API Looker e os SDKs têm diferentes níveis de suporte:
Os níveis de suporte são descritos nas seções a seguir.
Compatível com o Looker
O Looker é compatível com estas versões da API e SDKs de linguagem. Os tíquetes de suporte podem ser registrados com o suporte do Looker e estão em conformidade com as diretrizes de suporte do Looker.
Apoio da comunidade
Este nível se aplica somente aos SDKs da linguagem. Os problemas são registrados e gerenciados no repositório OpenSource usado por esse SDK.
Um SDK de linguagem pode estar no nível de suporte da comunidade por vários motivos:
- Ela não tem os recursos necessários para alcançar o nível com suporte ao Looker.
- Ela precisa de mais suporte e infraestrutura de automação (testes automatizados, empacotamento, documentação, exemplos etc.) para ser totalmente compatível com o Looker.
- Ele é baseado em uma tecnologia descontinuada.
- Ele não foi testado por usuários diferentes suficientes para ser considerado pronto para sair do status "Alfa".
Sem suporte
Não há suporte disponível. Atualmente, apenas a versão 3.0 da API não é compatível.
Versões da API
A tabela a seguir lista as três versões documentadas da API a partir do Looker 22.4 e mostra os níveis de suporte.
| Versão | Suporte | Status | Descrição |
|---|---|---|---|
| 3.0 | Sem suporte | Remoção concluída | Esta API foi removida do Looker. |
| 3.1 | Sem suporte | Remoção concluída | Esta API foi removida do Looker. |
| 4,0 | Looker | Estável | Versão atual. Novos endpoints, argumentos e propriedades de estrutura, além de mudanças nos tipos, ainda estão sendo criados.A maioria dos SDKs de linguagem do Looker usa a API 4.0, que é onde é feito o desenvolvimento de novas APIs. A versão 4.0 corrige tipos de propriedade que são codificados incorretamente pelos payloads da API 3.1. |
Todas as futuras versões da API vão ser introduzidas como Alfa e passar pelos ciclos de vida Beta, estáveis e descontinuados.
SDKs de linguagem
Os SDKs de linguagem do Looker evoluíram ao longo do ciclo de vida do Looker e são produzidos com uma variedade de ferramentas e técnicas. Todos os SDKs usam, direta ou indiretamente, os documentos de especificação da API do Looker. O status de suporte dos SDKs da linguagem é descrito na tabela a seguir.
| Idioma | Suporte | Ferramentas | Descrição |
|---|---|---|---|
| Ruby | Looker | Escrito à mão | O SDK do Ruby atual lê a especificação da API Looker para criar dinamicamente os métodos do SDK. |
| Python | Looker | codegen | O SDK do Python é usado sempre que o Python pode ser utilizado. Consulte o arquivo README do SDK do Python para saber as informações mais recentes sobre as versões compatíveis do Python. |
| TypeScript | Looker | codegen | O SDK do TypeScript é usado para aplicativos de nó e navegador. |
| Kotlin | Comunidade | codegen | O SDK do Kotlin é usado para aplicativos Android para dispositivos móveis e Java Virtual Machine (JVM). |
| Swift | Comunidade | codegen | O SDK Swift é usado para aplicativos para iOS e macOS. |
| R | Comunidade | Curvo | LookR é o SDK do Looker para a linguagem de programação R e funciona com o R Studio. |
| Outros | Comunidade | codegen | Outros SDKs de linguagem gerados pelo projeto codegen do Looker, como C# (Look#) e Go (GoLook), recebem suporte da Comunidade. Os problemas precisam ser registrados no repositório sdk-codegen. |
Legenda das ferramentas
- codegen: gerado pelo projeto codegen do SDK do Looker, usando uma biblioteca de tempo de execução escrita à mão para cada SDK.
- Swagger: gerado pela ferramenta OpenSource gerador de código Swagger. Para linguagens de programação sem suporte direto do gerador de código do Looker, oferecemos uma opção de gerador legado no repositório codegen que simplificará a geração personalizada. Esse gerador "legado" usa o gerador de código OpenAPI OpenSource, que substitui o gerador de código Swagger.
- Escrita à mão: todo o código-fonte é escrito à mão, sem a necessidade de gerar códigos.
Controle de versões do SDK
Recentemente, o Looker adotou um esquema de controle de versões que associa os SDKs de linguagem à versão do Looker usada para gerá-los. Por exemplo, isso significa que um SDK produzido usando as especificações do Looker 21.10 vai ter uma versão que começa com 21.10.*.
SDKs de linguagem
Os SDKs de linguagem mais recentes (produzidos pelo codegen do Looker) correspondem às versões de lançamento do Looker. Por exemplo, os SDKs para Python e TypeScript correspondem às respectivas versões de lançamento do Looker.
À medida que movemos nossos SDKs de linguagem mais antigos para o codegen ou publicamos SDKs de codegen nos gerenciadores de pacotes, a versão do SDK é definida de acordo com a versão de lançamento do Looker.
Versões de pacotes da biblioteca de ambiente de execução
O SDK do TypeScript depende de um pacote de biblioteca de ambiente de execução (RTL, na sigla em inglês) separado, escrito pelo Looker, que oferece suporte genérico às APIs REST. Como não é específico para nenhuma versão do Looker, a versão desse pacote é independente dos SDKs da linguagem que o utilizam.
Quando SDKs de outros idiomas são publicados em gerenciadores de pacotes, os RTLs podem se tornar um pacote separado. Qualquer pacote RTL separado vai usar o controle de versões semântico em vez de corresponder às versões de lançamento do Looker.