O Looker oferece várias versões de API e vários SDKs de linguagem que usam essas APIs. Este documento descreve 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 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 é compatível com essas versões da API e SDKs de linguagem. Os tíquetes de suporte podem ser enviados ao suporte do Looker e obedecer às diretrizes de suporte do Looker. Somente a API 4.0 tem suporte do Looker.
Suporte da comunidade
Esse nível se aplica apenas aos 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 vários motivos:
- Ele não tem os recursos necessários para atingir o nível de suporte do Looker.
- Ele precisa de mais suporte e infraestrutura de automação (testes automatizados, pacotes, documentação, exemplos etc.) antes de ser totalmente compatível com o Looker.
- Ela é baseada em uma tecnologia descontinuada.
- Ele não foi testado por usuários diferentes o suficiente para ser considerado pronto para sair do status "alfa".
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 no 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 | Essa API foi removida do Looker. |
| 4.0 | Looker | Estável | Versão atual. Novos endpoints, argumentos e propriedades de estrutura ainda podem ser adicionados. Todos os SDKs de linguagem do Looker compatíveis usam a API 4.0. |
Todas as versões futuras da API serão lançadas como alfa e passarão pelos ciclos de vida beta, estável e descontinuado.
SDKs de linguagem
Os SDKs de linguagem do Looker evoluíram ao longo da vida útil do produto e são produzidos com várias 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 de linguagem está descrito na tabela a seguir.
| Idioma | Suporte | Ferramentas | Descrição |
|---|---|---|---|
| Ruby | Looker | Escrita à mão | O SDK do 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 em que o Python pode ser usado. Consulte o readme do SDK para 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 node e browser. |
| Kotlin | Comunidade | codegen | O SDK Kotlin é usado em aplicativos para dispositivos móveis Android e Java Virtual Machine (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 devem 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 tempo de execução escrita à mão para cada SDK.
- Swagger: gerado pela ferramenta de código aberto gerador de código do Swagger. Para linguagens de programação não compatíveis diretamente com o gerador de código do Looker, oferecemos uma opção de gerador legada no repositório codegen que simplifica a geração personalizada. Esse gerador "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.
Controle de versões do SDK
O Looker adotou recentemente um esquema de controle de versões que corresponde aos 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 pela geração de código do Looker) correspondem às versões de lançamento do Looker. Por exemplo, os SDKs Python e TypeScript correspondem às respectivas versões de lançamento do Looker.
À medida que movemos nossos SDKs de linguagem mais antigos para a geração de código ou publicamos SDKs de geração de código atuais nos gerenciadores de pacotes, a versão do SDK é definida para corresponder à versão de lançamento do Looker.
Versões do pacote da biblioteca de ambiente de execução
O SDK do TypeScript depende de um pacote de biblioteca de tempo de execução (RTL, na sigla em inglês) separado, escrito pelo Looker, que oferece suporte genérico a APIs REST. Como não é específico de nenhuma versão do Looker, esse pacote tem controle de versão independente dos SDKs de linguagem que o usam.
Quando outros SDKs de linguagem são publicados em gerenciadores de pacotes, os RTLs podem se tornar um pacote separado. Qualquer pacote RTL separado vai usar o controle semântico de versões em vez de corresponder às versões de lançamento do Looker.