O Looker oferece várias versões de API e vários SDKs de linguagem que usam essas APIs. Este documento descreve o estado e as políticas de apoio técnico para as versões da API Looker e os SDKs de linguagem.
Níveis de apoio técnico
As versões da API Looker e os SDKs têm diferentes níveis de apoio técnico:
Os níveis de apoio técnico estão descritos nas secções seguintes.
Looker suportado
O Looker suporta estas versões da API e SDKs de idiomas. Os pedidos de apoio técnico podem ser apresentados ao apoio técnico do Looker e estão em conformidade com as diretrizes do apoio técnico do Looker. Apenas a API 4.0 é suportada pelo Looker.
Apoiado pela comunidade
Este nível aplica-se apenas aos SDKs de idiomas. Os problemas são registados e geridos no repositório de código aberto usado para esse SDK.
Um SDK de idioma pode estar ao nível de apoio técnico da comunidade por vários motivos:
- Não tem as funcionalidades necessárias para atingir o nível suportado pelo Looker.
- Precisa de mais apoio técnico e infraestrutura de automatização (testes automatizados, embalagem, documentação, exemplos, etc.) antes de poder ser totalmente suportada pelo Looker.
- Baseia-se numa tecnologia descontinuada.
- Não foi testada por um número suficiente de utilizadores diferentes para ser considerada pronta a sair do estado "alfa".
Não suportado
Não é fornecido apoio técnico. As versões 3.0 e 3.1 da API não são suportadas.
Versões da API
A tabela seguinte apresenta as três versões da API documentadas a partir do Looker 22.4 e mostra os respetivos níveis de suporte.
| Versão | Apoio técnico | Estado | Descrição |
|---|---|---|---|
| 3,0 | Não suportado | Removido | Esta API foi removida do Looker. |
| 3.1 | Não suportado | Removido | Esta API foi removida do Looker. |
| 4,0 | Looker | Estável | Lançamento atual. Continuam a poder ser adicionados novos pontos finais, argumentos e propriedades de estrutura. Todos os SDKs de idiomas do Looker suportados usam a API 4.0. |
Todas as versões futuras da API vão ser introduzidas como alfa e, em seguida, passar pelos ciclos de vida beta, estável e descontinuado.
SDKs de idiomas
Os SDKs de linguagem do Looker evoluíram ao longo da existência do Looker 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 estado de suporte dos SDKs de idiomas está descrito na tabela seguinte.
| Idioma | Apoio técnico | Ferramentas | Descrição |
|---|---|---|---|
| Ruby | Looker | Escrita manual | O SDK Ruby atual lê a especificação da API Looker para criar dinamicamente os métodos do SDK. |
| Python | Looker | codegen | O SDK Python é usado sempre que o Python pode ser usado. Consulte o ficheiro Readme do SDK Python para ver as informações mais recentes sobre as versões do Python suportadas. |
| TypeScript | Looker | codegen | O SDK TypeScript é usado para aplicações node e browser. |
| Kotlin | Comunidade | codegen | O SDK de Kotlin é usado para aplicações para dispositivos móveis Android e Java Virtual Machine (JVM). |
| Swift | Comunidade | codegen | O SDK Swift é usado para aplicações 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 idiomas gerados pelo projeto de geração de código do Looker, como C# (Look#) e Go (GoLook), são suportados pela comunidade. Os problemas devem ser apresentados no repositório sdk-codegen. |
Legenda de ferramentas
- codegen: gerado pelo projeto codegen do SDK do Looker e usa uma biblioteca de tempo de execução escrita manualmente para cada SDK.
- Swagger: gerado pela ferramenta de código aberto Swagger code generator. Para linguagens de programação não suportadas diretamente pelo gerador de código do Looker, disponibilizámos uma opção de gerador legado no repositório codegen que deve simplificar a geração personalizada. Este gerador "antigo" usa o gerador de código OpenAPI de código aberto, que substitui o gerador de código Swagger.
- Escrito manualmente: todo o código fonte é escrito manualmente sem geração de código envolvida.
Controlo de versões do SDK
Recentemente, o Looker adotou um esquema de controlo de versões que faz corresponder os SDKs de idiomas à versão do Looker que foi usada para os gerar. Por exemplo, isto significa que um SDK produzido com as especificações do Looker 21.10 terá uma versão que começa com 21.10.*.
SDKs de idiomas
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 respetivas versões de lançamento do Looker.
À medida que movemos os nossos SDKs de linguagem mais antigos para a geração de código ou publicamos SDKs de geração de código existentes nos respetivos gestores de pacotes, a versão do SDK é definida para corresponder à versão de lançamento do Looker.
Versões do pacote da biblioteca de tempo de execução
O SDK TypeScript depende de um pacote de biblioteca de tempo de execução (RTL) separado, escrito pela Looker, que suporta genericamente APIs REST. Uma vez que não é específico de nenhuma versão do Looker, este pacote tem versões independentes dos SDKs de linguagem que o usam.
Quando os SDKs de outros idiomas são publicados nos gestores de pacotes, os respetivos RTLs podem tornar-se um pacote separado. Qualquer pacote RTL separado usa a versão semântica em vez de corresponder às versões de lançamento do Looker.