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 da América do Norte
• Looker 25.0: clientes da América Central
• Looker 25.2: disponibilidade geral (GA)

Os seguintes métodos da API de aplicativo do Looker 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 de aparência:

  • Copiar aparência
  • Criar um Look
  • Receber Look
  • Mover um Look
  • Pesquisar aparências
  • Atualizar aparência
  • Receber todos os Looks

• APIs do painel:

  • Pesquisar elementos do painel
  • Get DashboardElement
  • Update DashboardElement
  • Get All DashboardElements
  • Create DashboardElement

• APIs de tarefas de renderização:

  • Criar tarefa de renderização de aparência
  • Criar tarefa de renderização de consulta
  • Criar tarefa de renderização do painel
  • Get Render Task
  • Criar tarefa de renderização de elemento do painel

• APIs do plano programado:

  • Planos programados para o espaço
  • Get Scheduled Plan
  • Atualizar plano programado
  • Get All Scheduled Plans
  • Criar plano programado
  • Planos programados para Look
  • Planos programados para o painel
  • Planos programados para o dashboard do LookML

• APIs de consulta:

  • Executar consulta assíncrona
  • Receber consulta
  • Get Query for Slug
  • Criar consulta
  • Executar consulta
  • Get Merge Query
  • Criar consulta de mesclagem
  • Receber 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ê criasse uma consulta com a API Create Query, o id seria o slug da consulta na resposta. Em seguida, use 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, atualize seus scripts para usar valores de slug de consulta.

Como encontro o valor do slug de uma consulta?

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

• Para uma análise detalhada, encontre o slug no URL dela após a variável qid=.

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

  Observação: para acessar as análises detalhadas da atividade do sistema, você precisa ter uma função que inclua a permissão see_system_activity.

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

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

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

  4. Clique em Executar.

     

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

  6. Em seguida, use o slug no URL da análise detalhada, que segue a variável qid= no URL.

Como posso 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 detalhada da atividade do sistema de uso da API.

1. No menu Analisar do Looker, selecione a análise Atividade do sistema e 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 à 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.