Athena

Integre o AWS Athena aos fluxos. Execute consultas SQL em dados do S3, acompanhe o status e as estatísticas de execução das consultas, obtenha resultados, gerencie consultas salvas e instruções preparadas e inspecione catálogos de dados, bancos de dados, tabelas e grupos de trabalho. Exige uma chave de acesso da AWS e a respectiva chave de acesso secreta.

Quando usar: Use quando o seu fluxo precisar executar consultas SQL sobre dados armazenados no Amazon S3 por meio do AWS Athena.

Exemplo de situação: Consultar indicadores e usar o resultado em uma decisão do fluxo.

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

1. Adicione Athena ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
3. Escolha a operação. O painel mostra só os campos que essa operação usa.
4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
6. Só publique depois de conferir o resultado da execução de teste.

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <athena.queryExecutionId>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Objetivo: Consultar indicadores e usar o resultado em uma decisão do fluxo.

Operação

Iniciar consulta

Região da AWS

us-east-1

Consulta SQL

SELECT * FROM clientes WHERE status = 'ativo'

Banco de dados

nome_do_banco

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

O bloco não executa

Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.

Aparece “Validação do fluxo” no terminal

Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.

Um campo chega vazio na etapa seguinte

Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <athena.queryExecutionId>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

O campo que eu procuro não aparece

Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.

Credencial ausente ou recusada

Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.

O serviço recusou a chamada ou devolveu erro

Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

• Consulta personalizada (GAQL) · Google AdsConsulta personalizada (GAQL) usando a conexão Google Ads deste workspace.
• Google AdsConsultar campanhas, grupos de anúncios e métricas de desempenho do Google Ads.
• Listar campanhas · Google AdsListar campanhas usando a conexão Google Ads deste workspace.
• Listar clientes · Google AdsListar clientes usando a conexão Google Ads deste workspace.
• Listar grupos de anúncios · Google AdsListar grupos de anúncios usando a conexão Google Ads deste workspace.
• Meta AdsConsultar contas, campanhas e desempenho de anúncios Meta e cruzar IDs com a origem registrada no CRM.