Acesso Programático aos Dados do Looker: Autenticação e Consultas Via API

Em um mundo cada vez mais movido a dados, ter acesso rápido e seguro às informações é crucial. Embora a interface visual do Looker facilite a exploração e visualização de dados, profissionais que precisam de automação, integração em larga escala ou extração massiva de dados, muitas vezes buscam um caminho mais direto: o acesso programático.

É aí que entra a API do Looker. Utilizando a API RESTful, desenvolvedores e analistas podem se autenticar, executar consultas e extrair dados diretamente do Looker, sem a necessidade de abrir a interface web. Este guia vai detalhar todo o processo, desde a autenticação até a consulta de dados, com exemplos práticos, dicas de ouro e armadilhas comuns para você evitar.

Desvendando a API do Looker

A API do Looker é uma interface RESTful que permite interagir com sua instância Looker de forma programática. Com ela, você pode:

• Executar consultas e extrair dados
• Exportar dashboards e Looks salvos
• Gerenciar usuários, permissões e conteúdo
• Automatizar tarefas repetitivas, como relatórios agendados
• Integrar dados do Looker em aplicações customizadas

A API opera sobre HTTP(S) e utiliza JSON para a troca de informações. Você pode acessá-la via ferramentas como cURL, Postman ou SDKs de diversas linguagens de programação (Python, Node.js, Ruby, Java, etc.).

Por Que Usar a API Para Consultar Dados?

Existem diversos cenários onde consultar dados via API é a melhor pedida. Imagine a necessidade de rodar as mesmas consultas dos seus Explores do Looker, mas de forma automática e em grande escala. A API possibilita exatamente isso.

Autenticação na API do Looker: O Primeiro Passo

Antes de qualquer consulta, é essencial se autenticar e obter um token de acesso. O Looker utiliza um sistema de autenticação baseado em tokens, similar ao OAuth 2.0.

Passo 1: Gerando suas Credenciais de API

Como administrador do Looker:

• Acesse Admin → Usuários.
• Selecione o usuário que será usado para acesso via API.
• Na seção API3 Keys, clique em New API3 Key.
• Copie e armazene com segurança o Client ID e o Client Secret. Essas credenciais são únicas para o seu usuário de API.

Passo 2: Obtendo o Token de Acesso

Envie uma requisição POST para o endpoint /login com suas credenciais:

curl -X POST "https://seu.looker.instance:19999/api/4.0/login" \
  -d "client_id=SEU_CLIENT_ID&client_secret=SEU_CLIENT_SECRET"

A resposta conterá o access_token que você usará para autenticar requisições futuras:

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI...",
  "token_type": "bearer",
  "expires_in": 3600
}

Importante: Tokens geralmente expiram após uma hora. Seus scripts devem gerenciar a reautenticação automática.

Passo 3: Utilizando o Token de Acesso

Inclua o token no cabeçalho Authorization das suas chamadas de API:

curl -H "Authorization: token eyJhbGciOi..." \
  "https://seu.looker.instance:19999/api/4.0/user"

Uma resposta com os detalhes do usuário confirma que a autenticação foi bem-sucedida.

Consultando Dados Pela API

Com a autenticação em dia, você está pronto para criar e executar consultas.

As consultas no Looker são definidas por:

• Model: O modelo de dados (ex: sales_model).
• View: A base da tabela ou explore (ex: orders).
• Fields: As colunas ou métricas desejadas.
• Filters: Condições de filtro a serem aplicadas.
• Sorts e Limits: Ordenação e número de registros.

Passo 1: Criando uma Consulta

Envie uma requisição POST para o endpoint /queries para definir sua consulta:

curl -X POST "https://seu.looker.instance:19999/api/4.0/queries" \
  -H "Authorization: token SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{        "model": "sales_model",        "view": "orders",        "fields": ["orders.created_date", "orders.total_revenue"],
        "filters": {"orders.created_date": "30 days"},
        "sorts": ["orders.created_date desc"],
        "limit": 10      }'

A resposta retornará um id para a consulta, que pode ser usado para executá-la ou reutilizá-la:

{
  "id": 456
}

Passo 2: Executando a Consulta e Obtendo os Resultados

Utilize o endpoint /queries/run para executar a consulta e receber os resultados:

curl -H "Authorization: token SEU_TOKEN" \
  "https://seu.looker.instance:19999/api/4.0/queries/run/json?query_id=456"

Você pode especificar o formato dos resultados (json, csv, xlsx) alterando o parâmetro result_format.

Consultando Dados Via SDK (Exemplo em Python)

Para fluxos de trabalho mais complexos ou scripts de automação, usar o SDK do Looker simplifica bastante o processo.

Instalação

pip install looker_sdk

Arquivo de Configuração (looker.ini)

[Looker]
base_url=https://seu.looker.instance:19999
client_id=SEU_CLIENT_ID
client_secret=SEU_CLIENT_SECRET
verify_ssl=True

Exemplo de Código Python

from looker_sdk import init40
sdk = init40()

# Passo 1: Criar uma Consulta
query = sdk.create_query(
    body={
        "model": "sales_model",
        "view": "orders",
        "fields": ["orders.created_date", "orders.total_revenue"],
        "filters": {"orders.created_date": "30 days"},
        "sorts": ["orders.created_date desc"],
        "limit": 5
    }
)

# Passo 2: Executar a Consulta
results = sdk.run_query(query.id, result_format="json")
print(results)

Este exemplo demonstra a criação e execução de uma consulta no Looker inteiramente via Python, sem necessidade de configurações manuais adicionais.

Executando um Look Salvo

Se sua equipe já utiliza Looks (consultas salvas no Looker), você pode executá-los diretamente pela API sem precisar redefinir a consulta.

Exemplo de requisição:

curl -H "Authorization: token SEU_TOKEN" \
  "https://seu.looker.instance:19999/api/4.0/looks/102/run/json"

Isso retorna os resultados do Look com ID 102 em formato JSON, ideal para automação.

Automatizando a Extração de Dados

Combine lógica de autenticação e consulta para construir pipelines de ETL ou scripts agendados. Você pode configurar:

• Execução de consultas Looker diariamente.
• Exportação dos resultados em CSV.
• Armazenamento em nuvem (AWS S3, GCS).
• Notificações para equipes via Slack ou e-mail.

Isso possibilita atualizações de dados automáticas e entrega de análises sob demanda.

Melhores Práticas Para Consultas via API

• Use Contas de Serviço: Evite usar credenciais pessoais em scripts de produção.
• Renove Tokens Automaticamente: Tokens de acesso expiram; automatize a renovação.
• Armazene Segredos com Segurança: Utilize variáveis de ambiente ou gerenciadores de segredos.
• Prefira SDKs para Fluxos Grandes: Eles simplificam o gerenciamento de tokens e erros.
• Limite o Volume de Dados: Aplique filtros e paginação para evitar payloads excessivos.
• Monitore o Uso da API: Revise logs e métricas de desempenho para evitar sobrecargas.
• Respeite os Limites de Taxa: Evite consultas excessivas ou loops pesados.

Considerações de Segurança

Ao usar a API do Looker, lembre-se:

• Sempre utilize conexões HTTPS.
• Alterne as chaves de API periodicamente.
• Restrinja o acesso com Atributos de Usuário e Filtros de Acesso.
• Nunca exponha tokens ou segredos em URLs ou repositórios de código.

Seguir estas práticas garante que sua integração de dados permaneça segura e em conformidade.

Casos de Uso Avançados

Dominando a autenticação e as consultas básicas, você pode expandir seus fluxos de API para:

• Incorporar dashboards dinamicamente em aplicações.
• Disparar alertas ou relatórios baseados em resultados de consultas.
• Automatizar pipelines de CI/CD para projetos LookML.
• Integrar o Looker com ferramentas de IA para previsões em tempo real.

A API do Looker pode ser a base da sua estratégia de automação de dados.

Conclusão

Autenticar e consultar dados do Looker via API libera todo o potencial da análise programática. Seja para exportar dados para relatórios automatizados, integrar insights em outros sistemas ou construir aplicações customizadas, a API oferece um framework flexível e seguro para acessar as informações da sua organização.

Ao dominar a autenticação, as consultas via API e a integração com SDKs, você transforma o Looker em uma peça central do seu ecossistema de automação de dados, entregando insights de forma mais rápida, segura e escalável.