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 (em 4 de dezembro de 2024): clientes iniciais das Américas
• Looker 25.0: clientes da América do Norte e da América Latina
• Looker 25.2: disponibilidade geral (GA)

Os métodos de API do aplicativo do 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 de slug da consulta.

• APIs Look:

  • Copiar visual
  • Criar look
  • Get Look (em inglês)
  • Move Look
  • Pesquisar looks
  • Atualizar visual
  • Acessar todos os Looks

• APIs do painel:

  • Pesquisar elementos do painel
  • Get DashboardElement
  • Atualizar o DashboardElement
  • Recuperar todos os elementos do painel
  • Criar um elemento de painel

• APIs de renderização de tarefas:

  • Criar tarefa de renderização de look
  • Criar tarefa de renderização de consulta
  • Criar tarefa de renderização do painel
  • Get Render Task
  • Criar tarefa de renderização de elementos do painel

• APIs do plano programado:

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

• APIs de consulta:

  • Executar consulta assíncrona
  • Consulta GET
  • Pegar consulta para o slug
  • Criar consulta
  • Executar consulta
  • Consulta de mesclagem
  • 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ê criar uma consulta com a API Create Query, o id será o slug da consulta na resposta. Você pode usar esse id para fazer uma solicitação subsequente.

Se você tiver valores de ID de consulta numérica codificados para qualquer um dos métodos de API listados, é necessário atualizar 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, você pode encontrar o slug no URL da Análise seguindo a variável qid= no URL.

• Você pode 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 um papel que inclua a permissão see_system_activity.

  1. No menu "Explore" do Looker, selecione System Activity > History.

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

  3. Opcionalmente, 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 atualizados da API?

É possível conferir uma lista das chamadas de API feitas na sua instância do Looker usando a Análise de atividade do sistema de uso da API.

1. No menu Explorar do Looker, selecione Atividade do sistema e, em seguida, selecione 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.