O Looker oferece diversas versões de API e diversos SDKs de linguagem que usam essas APIs. Este documento descreve o status e as políticas de suporte para as versões da API Looker e os SDKs de linguagem.
Níveis de suporte
As versões da API e os SDKs do Looker têm níveis variados de suporte:
Os níveis de suporte são descritos nas seções a seguir.
Compatível com o Looker
O Looker oferece suporte a estas versões de 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. Somente a API 4.0 é compatível com o Looker.
Apoio da comunidade
Esse nível se aplica apenas a SDKs de linguagem. Os problemas são registrados e gerenciados no repositório de código aberto usado para esse SDK.
Um SDK de linguagem pode estar no nível de suporte da comunidade por diversos motivos:
- Ele não tem os recursos necessários para alcançar o nível de suporte do Looker.
- Ele precisa de mais suporte e infraestrutura de automação (testes automatizados, empacotamento, documentação, exemplos etc.) para ter suporte total do Looker.
- Ela é baseada em uma tecnologia descontinuada.
- Ele não foi testado por usuários diferentes o suficiente para ser considerado pronto para sair da versão "Alfa" o status atual da conta.
Sem suporte
Nenhum suporte é fornecido. As versões 3.0 e 3.1 da API não são compatíveis.
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 delas.
| Versão | Suporte | Status | Descrição |
|---|---|---|---|
| 3.0 | Sem suporte | Removido | Essa API foi removida do Looker. |
| 3.1 | Sem suporte | Removido | Esta API foi removida do Looker. |
| 4.0 | Looker | Estável | Versão atual. Ainda é possível adicionar novos endpoints, argumentos e propriedades de estrutura. Todos os SDKs de linguagem do Looker com suporte usam a API 4.0. |
Todas as versões futuras da API serão lançadas como Alfa e depois passarão pelos ciclos de vida Beta, estável e suspenso.
SDKs de linguagem
Os SDKs da 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 Ruby atual lê a especificação da API Looker para construir dinamicamente os métodos do SDK. |
| Python | Looker | codegen | O SDK do Python é usado em qualquer lugar onde o Python possa ser usado. Consulte o README do SDK do Python para conferir 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 (em inglês) | O SDK do Kotlin é usado para apps para dispositivos móveis Android e de máquina virtual Java (JVM). |
| Swift | Comunidade | codegen | O SDK do Swift é usado para aplicativos iOS e macOS. |
| R | Comunidade | Swagger | O LookR é o SDK do Looker para a linguagem de programação R e funciona com o R Studio. |
| Outro | Comunidade | codegen | Outros SDKs de linguagem gerados pelo projeto codegen do Looker, como C# (Look#) e Go (GoLook), têm suporte da comunidade. Os problemas precisam ser registrados no repositório sdk-codegen. |
Legenda das ferramentas
- codegen: gerado pelo projeto de geração de código do SDK do Looker e usa uma biblioteca 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, fornecemos uma opção de gerador legado no repositório codegen, que deve simplificar a geração personalizada. Esse "legado" usa o gerador de código OpenAPI de código aberto, que substitui o gerador de código Swagger.
- Escrito à mão: todo o código-fonte é escrito à mão, sem geração de código.
Versão do SDK
Recentemente, o Looker adotou um esquema de controle de versões que combina SDKs de linguagem com a versão do Looker usada para gerá-los. Por exemplo, isso significa que um SDK produzido usando as especificações do Looker 21.10 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 do Python e do TypeScript correspondem às respectivas versões de lançamento do Looker.
À medida que migramos nossos SDKs de linguagem mais antigos para Codegen ou publicamos SDKs atuais para os gerenciadores de pacotes, a versão do SDK vai ser definida para corresponder à versão de lançamento do Looker.
Versões de pacote 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 ele não é específico de nenhuma versão do Looker, a versão desse pacote é independente dos SDKs da linguagem que o utilizam.
Quando outros SDKs de idioma são publicados em gerenciadores de pacotes, os RTLs deles 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.