É com grande entusiasmo que anunciamos a disponibilidade geral da API Looker 4.0 no Looker 22.4. A API 4.0 disponível de forma geral (API 4.0 GA) tem várias alterações interruptivas e aditivas, e promove vários pontos finais da versão beta para a versão estável. Consulte a nossa referência da API para ver especificações detalhadas da API 4.0. Atualizámos os nossos SDKs suportados pelo Looker e pela comunidade para suportarem os endpoints da API Looker 4.0 GA. Para mais informações, consulte as políticas de apoio técnico de APIs e SDKs e a versão de APIs. O resto deste artigo descreve as alterações significativas, as mitigações e as funcionalidades que pode esperar quando migrar para a API 4.0 GA.
Quem deve ler isto?
Este documento destina-se a si se usar a API Looker através de SDKs suportados pelo Looker, SDKs suportados pela comunidade ou a própria API. Leia a secção seguinte que é mapeada para a versão da API Looker que usa.
Utilizadores da API 4.0 pré-DG
Se usar a API 4.0, leia esta secção. Abrange as alterações significativas e as mitigações disponíveis quando migra para a API 4.0 GA.
A versão 4.0 da API GA inclui a alteração de todos os campos de ID de entidades do tipo numérico integer para o tipo string. Por exemplo, GET /groups/{group_id} endpoint devolve id como tipo string em vez de tipo int64.
Leia a tabela seguinte para ver o impacto e as mitigações específicos da sua utilização do ponto final da API 4.0:
| Utilização | Potencial impacto1 | Prevenção |
| Apps para dispositivos móveis do Looker | As instalações desatualizadas das apps para dispositivos móveis do Looker deixam de funcionar | Peça aos utilizadores que façam a atualização para a versão mais recente das apps Looker para dispositivos móveis |
| SDKs2 suportados pelo Looker | ||
| SDK do TypeScript (API 4.0) | Nenhum impacto | Nenhuma ação necessária |
| SDK Python (API 4.0) | Nenhum impacto | Nenhuma ação necessária |
| SDK Ruby (API 4.0) | Nenhum impacto | Nenhuma ação necessária |
| SDKs com apoio técnico da comunidade2 | ||
| SDK Swift | Exceções de tempo de execução | Atualize o SDK para a versão 22.0 ou superior e, em seguida, resolva os erros de tipo resultantes, se existirem |
| SDK Kotlin | Nenhum impacto | Nenhuma ação necessária |
| LookR SDK | Nenhum impacto | Nenhuma ação necessária |
| SDK C# | Nenhum impacto | Nenhuma ação necessária |
| Go SDK | Exceções de tempo de execução | Atualize o SDK para a versão 22.0 ou superior e, em seguida, resolva os erros de tipo resultantes, se existirem |
| Outras | ||
| Usar a API 4.0 sem um SDK (ou com bibliotecas fornecidas externamente) | Possíveis erros de tempo de execução, dependendo da sensibilidade ao tipo do idioma | Reveja o código para verificar dependências no tipo de campos de ID e adicione suporte para campos de ID do tipo string. Reveja também estas orientações adicionais. |
1: Partindo do princípio de padrões de utilização comuns que podem incluir a utilização dos campos de ID do Looker, mas não padrões de utilização invulgares, como a aplicação de operações numéricas a IDs.
2: Apoio técnico da API e do SDK do Looker. As bibliotecas suportadas pela comunidade não são oficialmente suportadas pelo Looker.
Utilizadores da API 3.1
Se usar a API 3.1, leia esta secção. Abrange as funcionalidades e as alterações adicionais que a API 4.0 lhe disponibiliza. Tenha em atenção que todos os SDKs suportados pelo Looker e pela comunidade suportam principalmente a API 4.0. Consulte as políticas de apoio técnico de APIs e SDKs para ver mais informações.
Funcionalidades adicionais da API 4.0 GA
Para sua conveniência, apresentamos as alterações mais notáveis e úteis da API 4.0:
- Criação e gestão de quadros, itens de quadros e secções de quadros. Consulte a página de documentação do quadro para mais informações sobre os quadros.
- Consultar informações de associação adicionais, como bases de dados, esquemas, colunas e tabelas. Defina e atualize campos de associação adicionais.
- Criação e gestão de utilizadores e apps OAuth. Consulte a página de documentação do OAuth para mais informações sobre o OAuth.
- Pesquise grupos com hierarquia e funções.
- Pesquise funções com a contagem de utilizadores.
- Obter e definir as definições da instância do Looker. Consulte a página de documentação das definições para obter mais informações sobre as definições.
- Criação e gestão de alertas. Consulte a página de documentação de alertas para mais informações sobre alertas.
- Criação, gestão e testes de túneis SSH e servidores SSH. Consulte a página de documentação da SSH para obter mais informações sobre a SSH.
- Mova e copie painéis de controlo.
- Obtenha URLs relativos para novos painéis de controlo.
- Mover e copiar Looks.
- Incorporação assinada e incorporação não assinada secreta, URL e criação e gestão de utilizadores.
- Obtenha o token de atualização para atualizar o token de acesso de início de sessão.
- Limite e desvie os resultados da obtenção de todos os modelos do LookML e todos os utilizadores.
- Limitar e compensar os resultados de utilizadores que pesquisam.
- Obtenha a especificação da API da instância do Looker em JSON Swagger 2.x.
Alterações de descontinuação da DG da API 4.0
A versão GA da API 4.0 substitui vários pontos finais da API 3.1 descontinuados por funcionalidades melhoradas. Os seguintes pontos finais são afetados:
- Os pontos finais da página inicial descontinuados foram removidos. Em alternativa, use endpoints de placas em vez de páginas iniciais. Consulte o artigo Apresentar conteúdo com quadros.
- Os pontos finais do espaço descontinuados foram removidos. Use pontos finais de pastas em vez do espaço. Consulte o artigo Organizar e gerir o acesso ao conteúdo.
Utilizadores da API 3.0
A API 3.0 foi descontinuada, e recomendamos que migre para a API 4.0.
- Apenas a API 4.0 suporta todos os SDKs suportados pelo Looker e pela comunidade para facilitar o seu desenvolvimento. Consulte o nosso repositório do SDK.
- A API 4.0 introduz várias novas funcionalidades e melhorias, conforme indicado na secção Funcionalidades adicionais da API 4.0 GA nesta página.
Conclusão
Pode esperar novas funcionalidades e alterações adicionais na API 4.0. Além disso, pode sempre encontrar as alterações mais recentes na nossa referência da API. Para mais informações, consulte as políticas de apoio técnico de APIs e SDKs e a versão de APIs. Sabemos que as alterações interruptivas não são ideais. A menos que surja um problema extremo, não vamos fazer alterações significativas à nossa API 4.0 geralmente disponível. Esperamos que a nossa API Looker 4.0 geralmente disponível ajude a desenvolver de forma mais produtiva e fácil na plataforma Looker.