A API Looker agora usa valores de slug de consulta para IDs de consulta

Observação:a mudança descrita nesta página será lançada em fases:

• Looker 24.20 (4 de dezembro de 2024): clientes iniciais das Américas
• Looker 25.0: clientes intermediários das Américas
• Looker 25.2: disponibilidade geral (GA)

Os métodos de API do aplicativo Looker a seguir não usam um valor numérico query_id ou, no caso das APIs de consulta, um valor numérico id. Os métodos a seguir usam o valor do slug da consulta.

• APIs do Look:

  • Copiar Look
  • Criar Look
  • Gerar Look
  • Mover Look
  • Pesquisar Looks
  • Atualizar Look
  • Gerar todos os Looks

• APIs do painel:

  • Pesquisar elementos do painel
  • Gerar DashboardElement
  • Atualizar DashboardElement
  • Gerar todos os DashboardElements
  • Criar DashboardElement

• APIs de tarefa de renderização:

  • Criar tarefa de renderização do Look
  • Criar tarefa de renderização de consulta
  • Criar tarefa de renderização do painel
  • Gerar tarefa de renderização
  • Criar tarefa de renderização de elementos do painel

• APIs de plano programado:

  • Planos programados para espaço
  • Gerar plano programado
  • Atualizar plano programado
  • Gerar todos os planos programados
  • Criar plano programado
  • Planos programados para Look
  • Planos programados para painel
  • Planos programados para painel do LookML

• APIs de consulta:

  • Executar consulta de forma assíncrona
  • Gerar consulta
  • Gerar consulta para slug
  • Criar consulta
  • Executar consulta
  • Gerar consulta de mesclagem
  • Criar consulta de mesclagem
  • Gerar todas as consultas em execução

O que eu preciso fazer?

O campo query_id ou, no caso das APIs de consulta, o campo id, é um tipo de dados de string. Os campos query_id ou id agora retornam um valor de slug de consulta na resposta da API. Esse valor de slug de consulta pode ser usado em qualquer solicitação de API.

Por exemplo, se você criar uma consulta com a API Criar consulta, o id será o slug da consulta na resposta. Em seguida, você pode usar esse id para fazer uma solicitação subsequente.

Se você tiver valores de ID de consulta numéricos codificados para qualquer um dos métodos de API listados, será necessário atualizar seus scripts para usar valores de slug de consulta.

Como encontrar o valor do slug de uma consulta?

É possível encontrar o valor do slug de uma consulta das seguintes maneiras:

• Para uma análise, você pode encontrar o slug no URL da análise após a variável qid= no URL.

• É possível encontrar o valor do slug associado a um ID de consulta numérico usando atividade do sistema.

  **Observação** :para visualizar as análises de atividade do sistema, é necessário ter um papel que inclua a see_system_activity permissão.

  1. No menu Análise do Looker, selecione a análise Atividade do sistema > Histórico.

  2. Na visualização Consulta, selecione as dimensões ID e Link.

  3. Opcionalmente, adicione um filtro na dimensão ID e insira o ID de consulta numérico no campo de filtro ID da consulta.

  4. Clique em Executar.

     

  5. Clique no link [Query] ao lado do ID de consulta numérico nos resultados da análise para abrir uma análise com base nesse ID de consulta numérico.

  6. Em seguida, você pode usar o slug no URL da análise, que segue a variável qid= no URL.

Como saber se usamos algum dos endpoints de API atualizados?

É possível conferir uma lista das chamadas de API feitas à sua instância do Looker usando a análise de atividade do sistema de uso da API API Usage System Activity Explore.

1. No menu Análise do Looker, selecione a análise Atividade do sistema e, em seguida, a visualização Uso da API.

2. Selecione as dimensões Data de criação > Data e Endpoint e a métrica Uso total.

3. Adicione um filtro na dimensão Endpoint e, no campo de filtro, inclua qualquer um dos endpoints atualizados listados no início deste documento que você quer pesquisar.

4. Clique em Executar. O Looker vai mostrar informações de uso desses endpoints.