Consultar dados corporativos
A etapa Consultar dados corporativos lê dados do Infinite Data de dentro de um fluxo — um saldo, um histórico, uma lista de clientes — sem exportar nada e sem duplicar a base.
É determinística e somente leitura: nenhuma consulta desta etapa altera dados.
O formulário
| Campo | Uso |
|---|---|
| Ação | Executar consulta, ou explorar o catálogo |
| Consulta | O SQL, quando a ação é executar consulta |
As ações de exploração respondem o que existe: listar catálogos, listar esquemas, listar tabelas, descrever uma tabela. Elas são úteis para montar a consulta e para agentes que precisam se orientar antes de perguntar.
Produz: as linhas, as colunas, a contagem de linhas, se o resultado foi truncado e o identificador da consulta.
Quem enxerga o quê
A consulta roda com a identidade de quem acionou a execução — não com uma conta de serviço, não com a identidade de quem construiu o agente.
Isso tem uma consequência direta: o agente não amplia o acesso de ninguém. Quem não pode ver uma tabela no Infinite Data continua sem poder vê-la através de um agente. Duas pessoas rodando o mesmo agente podem receber resultados diferentes, e isso é o comportamento correto — cada uma vê o que tem direito de ver.
A governança do Infinite Data continua valendo por inteiro: máscaras, filtros por linha e registro de auditoria. A consulta feita por um agente aparece no Audit Center como qualquer outra.
Um agente que a use não funciona acionado por agendamento nem por endpoint. Nesses casos não existe pessoa por trás da execução, e a etapa falha em vez de escolher uma identidade por conta própria.
Se você precisa de dados corporativos em um agente automático, o caminho é publicar a leitura como uma automação com identidade própria e governança declarada, e usar Executar automação.
Quando o resultado vem truncado
Consultas grandes são cortadas e o resultado vem marcado como truncado. O corte nunca é silencioso: um resultado parcial não deve se parecer com um completo.
Se aparecer truncado, restrinja a consulta — filtre, agregue ou pagine. Trazer tudo para dentro do fluxo raramente é o que você quer: o agente decide melhor com dez linhas relevantes do que com dez mil.
Erros comuns
| Sintoma | Causa | O que fazer |
|---|---|---|
| A etapa falha dizendo que não há pessoa | O agente foi acionado por agendamento ou endpoint | Acione por pessoa, ou mova a leitura para uma automação |
| "Acesso negado" para uma pessoa e não para outra | As permissões são as do Infinite Data, por pessoa | Ver Entender acesso negado |
| Uma tabela não aparece no catálogo | A pessoa não tem acesso a ela | Ver Problemas de acesso |
| Resultado truncado | A consulta traz mais linhas que o limite | Filtre ou agregue |
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.