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

Nota: a alteração descrita nesta página vai ser lançada em fases:

• Looker 24.20 (a 4 de dezembro de 2024): clientes antecipados das Américas
• Looker 25.0: clientes da América do Norte e do Sul
• Looker 25.2: disponibilidade geral (GA)

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

• APIs Look:

  • Copiar aspeto
  • Criar visual
  • Get Look
  • Mover olhar
  • Pesquise visuais
  • Atualize o visual
  • Get All Looks

• APIs do painel de controlo:

  • Pesquise elementos do painel de controlo
  • Get DashboardElement
  • Update DashboardElement
  • Get All DashboardElements
  • Create DashboardElement

• APIs Render Task:

  • Crie uma tarefa de renderização de visualização
  • Create Query Render Task
  • Criar tarefa de renderização do painel de controlo
  • Get Render Task
  • Create Dashboard Element Render Task

• APIs de planos agendados:

  • Planos agendados para o espaço
  • Get Scheduled Plan
  • Atualizar plano agendado
  • Get All Scheduled Plans
  • Crie um plano agendado
  • Planos agendados para o Look
  • Planos agendados para o painel de controlo
  • Planos agendados para o painel de controlo do LookML

• APIs de consulta:

  • Run Query Async
  • Get Query
  • GetQueryForSlug
  • Criar consulta
  • Executar consulta
  • Get Merge Query
  • Criar consulta de união
  • Get All Running Queries

O que necessito de fazer?

O campo query_id ou, no caso das APIs Query, o campo id, é um tipo de dados de string. Os campos query_id ou id devolvem agora um valor de slug de consulta na resposta da API. Em seguida, pode usar esse valor de slug de consulta em quaisquer pedidos da API.

Por exemplo, se criasse uma consulta com a API Create Query, o id seria o slug da consulta na resposta. Em seguida, pode usar esse id para fazer um pedido subsequente.

Se tiver valores de ID de consulta numéricos codificados para qualquer um dos métodos de API apresentados, tem de atualizar os seus scripts para usar valores de slug de consulta!

Como posso encontrar o valor do slug de uma consulta?

Pode encontrar o valor do slug de uma consulta das seguintes formas:

• Para uma exploração, pode encontrar o slug no URL da exploração após a variável qid= no URL.

• Pode encontrar o valor do slug associado a um ID de consulta numérico através da Atividade do sistema.

  Nota: para ver as explorações da atividade do sistema, tem de ter uma função que inclua a autorizaçãosee_system_activity.

  1. No menu Explorar do Looker, selecione Atividade do sistema > Histórico Explorar.

  2. Na vista Consulta, selecione as dimensões ID e Associação.

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

  4. Clique em Executar.

     

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

  6. Em seguida, pode usar o slug no URL do Explore, que segue a variável qid= no URL.

Como posso saber se usamos algum dos pontos finais da API atualizados?

Pode ver uma lista das chamadas API feitas à sua instância do Looker através da atividade do sistema de utilização da API Explore.

1. No menu Explorar do Looker, selecione o conteúdo de Explorar Atividade do sistema e, de seguida, selecione a vista Utilização da API.

2. Selecione as dimensões Data de criação > Data e Ponto final, bem como a medida Utilização total.

3. Adicione um filtro na dimensão Ponto final e, no campo de filtro, inclua qualquer um dos pontos finais atualizados indicados no início deste documento que quer pesquisar.

4. Clique em Executar. O Looker apresenta informações de utilização desses pontos finais.