Ver categorias

Crie um usuário de banco de dados somente leitura para o Agente.

Configuração do conector · Todos os bancos de dados

Criar um somente leitura usuário do banco de dados para o Agente

O agente só lê. Atribua a ele um login que permita apenas leitura, para que nada que alguém faça no Query Streams possa alterar seus dados. Uma seção por banco de dados, com os comandos exatos para copiar.

Cerca de 10 minutos SQL Server, PostgreSQL, MySQL e muito mais Somente leitura
Teve alguma dúvida? É só perguntar. Aberto Suporte Em Fluxos de Consulta (menu no canto superior direito → Suporte) e envie-nos uma mensagem. Pessoas reais leem as mensagens, e "Não sei o que esta tela está pedindo" é uma pergunta perfeitamente válida.

O resultado final será o que você obterá.

Ícone de banco de dadosUm novo login de banco de dados, chamado leitor_qs Nos exemplos abaixo, com uma senha que você escolher, ele poderá fazer login e ler as tabelas que você permitir, e nada mais. Você digita esse nome de usuário e senha no campo indicado. Nome de usuário e Senha caixas quando você adiciona o conector em Agentes de dados.

Por que um login separado somente leitura?

O Agente já se recusa a executar qualquer coisa que não seja uma leitura. Todas as consultas que lhe são solicitadas, seja proveniente do Portal, do Excel, do Google Sheets, de um assistente de IA ou da API REST, são verificadas no seu computador antes de chegarem ao banco de dados. Qualquer coisa que comece com algo diferente de SELECIONAR (ou algumas outras palavras somente leitura, como) COM, MOSTRAR e EXPLICAR), ou que contenha INSERIR, ATUALIZAR, EXCLUIR, DERRUBAR, ALTERAR, CONCEDER e palavras semelhantes, é rejeitado com a mensagem Somente consultas SELECT são permitidas no modo somente leitura..

Um login somente leitura é a segunda camada de segurança. Essa verificação é um filtro de palavras do nosso lado; um login somente leitura é imposto pelo próprio banco de dados. Com ambos implementados, mesmo um erro do nosso lado não conseguiria alterar uma linha. Isso também mantém os logins poderosos (sa, postgres, raiz, sua conta WordPress ou de hospedagem) completamente fora dos fluxos de consulta.

Do que você precisa

Um login de administrador, uma vez

Para criar um usuário, você precisa de um login com permissão para criar usuários: o mesmo usado na instalação do banco de dados ou no seu painel de controle de hospedagem. Você só precisa dele durante esses dez minutos; o agente nunca o vê.

A ferramenta própria do banco de dados

SQL Server Management Studio para SQL Server, pgAdmin ou psql Para PostgreSQL, MySQL Workbench ou um painel de controle de hospedagem para MySQL. Cada seção especifica qual.

Uma nova senha, anotada.

Crie um agora e guarde-o em um lugar seguro. Evite aspas e espaços; eles dificultam a digitação dos comandos abaixo. Você irá colá-lo no Portal no final.

Escolha seu banco de dados

Em cada comando abaixo, substitua leitor_qs Se você quiser um nome diferente, substitua ChangeMe-2026! com sua própria senha e substitua Vendas com o nome do seu próprio banco de dados.

Microsoft SQL Server

O conector do Portal para o SQL Server faz login com uma conta do SQL Server (nome de usuário e senha), e não com sua conta do Windows. Muitas instalações do SQL Server e do SQL Express aceitam apenas contas do Windows até que você altere uma configuração; portanto, as duas primeiras etapas verificam isso. Em seguida, você cria o login, digitando ou clicando.

Não se sente confortável com isso? Pergunte a quem cuida do seu banco de dados (geralmente a empresa que forneceu seu software de contabilidade ou de caixa registradora), ou responder ao suporte E faremos isso com você.

  1. Abra o SQL Server Management Studio.

    No computador que executa o SQL Server (ou qualquer computador que tenha SQL Server Management Studio(SSMS para abreviar), clique Começar, tipo SSMS e abra-a. Uma caixa intitulada Conectar ao servidor aparece. Sair Autenticação sobre Autenticação do Windows e clique em Conectar.

    Um painel chamado Explorador de Objetos preenche o lado esquerdo, com o nome do seu servidor no topo e pastas como Bancos de dados e Segurança abaixo dele. Se, em vez disso, você vir um erro que menciona um cadeia de certificados ou não confiávelVolte à caixa Conectar e marque a caixa. Certificado de servidor confiávele clique Conectar de novo.

  2. Ativar logins do SQL Server (a armadilha exclusiva do Windows)

    No Explorador de Objetos, clique com o botão direito do mouse no nome do servidor, localizado na parte superior, e selecione PropriedadesNa lista à esquerda da janela que se abre, clique em Segurança. Sob Autenticação do servidor Existem duas opções.

    Se Modo de autenticação do SQL Server e do Windows Já está selecionado, clique Cancelar e vá para o passo 3. Se Modo de autenticação do Windows Se estiver selecionado, clique Modo de autenticação do SQL Server e do Windows, então OKUma mensagem informa que a alteração entrará em vigor após a reinicialização do SQL Server; clique em OKEm seguida, clique com o botão direito do mouse no nome do servidor novamente e escolha Reiniciare clique Sim Quando solicitado, o ícone ao lado do nome do servidor fica cinza e volta a ficar verde em menos de um minuto.

    Por que isso é importante: embora o servidor esteja executando apenas Windows, o teste do Agente falha com Falha na conexão: Falha no login do usuário 'qs_reader'. Essa é exatamente a mensagem que você receberia se a senha estivesse incorreta, por isso as pessoas digitam a senha repetidamente. Se você tem certeza da senha, essa configuração é o motivo.

  3. Abra uma janela de consulta

    Clique no botão Nova consulta botão na barra de ferramentas perto da parte superior. Uma página em branco se abre no meio. É aí que você cola. (Prefere clicar em vez de digitar? Pule para a versão clicável abaixo.)

  4. Cole os comandos e execute-os.

    Copie o bloco abaixo, cole-o na janela de consulta, altere a senha e o nome do banco de dados (Vendas (aparece duas vezes), depois clique Executar na barra de ferramentas ou pressione F5:

    Cole o texto na janela de consulta e pressione F5.
    CRIAR LOGIN qs_reader COM SENHA = 'ChangeMe-2026!', CHECK_EXPIRATION = OFF; IR USAR Vendas; IR CRIAR USUÁRIO qs_reader PARA LOGIN qs_reader; ALTERAR FUNÇÃO db_datareader ADICIONAR MEMBRO qs_reader; IR

    O Mensagens A aba na parte inferior diz Comandos executados com sucesso. Se estiver escrito "senha" não atende à política do sistema operacionalEscolha uma senha mais longa com uma combinação de letras, números e um símbolo e execute-a novamente. Se aparecer O banco de dados 'Vendas' não existe., expandir Bancos de dados No Explorador de Objetos, você pode ver o nome real e alterar ambos. Vendas linhas.

    Deseja que o Agente leia mais de um banco de dados? Execute as três últimas linhas novamente para cada um, substituindo o nome pelo nome. Vendas.

A versão interativa. Em vez dos passos 3 e 4: no Explorador de Objetos, expanda Segurança, clique com o botão direito do mouse Logins, escolher Novo login…. No Em geral tipo de página leitor_qs em Nome de login, escolher Autenticação do SQL Server, digite a senha em Senha e Confirme sua senha, e Desmarque a opção "O usuário deve alterar a senha no próximo login" (O agente não pode alterar a senha, portanto, com esta opção marcada, ele nunca conseguirá acessar). Em seguida, clique em Mapeamento de usuários à esquerda. Abaixo. Usuários associados a este loginMarque a caixa ao lado do seu banco de dados. Na caixa inferior, Associação de função de banco de dados para, marcação leitor_de_dados_banco_de_dados e sair público Marcado. Clique. OKO novo nome aparece em Segurança → Logins.

Agente em um computador diferente do SQL Server? Porto 1433 (ou a porta própria da instância, mais a porta UDP 1434 para uma instância nomeada como SQLEXPRESS) precisa estar aberta no computador do SQL Server: Abrir uma porta de firewall no Windows.

Se alguma dessas informações não corresponder ao que você vê, pare e Responda ao nosso e-mail de suporte. Com uma foto da tela. Vamos te guiar passo a passo.

PostgreSQL

Três etapas: crie o login e, em seguida, certifique-se de que o PostgreSQL aceite conexões do computador do Agente, o que não acontece por padrão. Se o Agente estiver sendo executado no mesmo computador que o PostgreSQL e você digitar localhost Como servidor, você só precisa da primeira parte.

Não se sente confortável com isso? Pergunte a quem cuida do seu banco de dados ou servidor, ou responder ao suporte E faremos isso com você.

  1. Abra uma janela de consulta como usuário postgres

    Com pgAdmin (instalado junto com o PostgreSQL no Windows): abrir pgAdmin, expandir Servidores à esquerda, entre no postgres Senha que você escolheu quando o PostgreSQL foi instalado, expanda Bancos de dadosClique uma vez no seu banco de dados e, em seguida, escolha Ferramentas → Ferramenta de consultaUm editor em branco é aberto.

    Em um servidor LinuxDigite isso e pressione Digitar; o prompt muda para vendas=#:

    Digite isso e pressione Enter.
    sudo -u postgres psql -d vendas
  2. Crie o login e conceda-lhe acesso de leitura.

    Cole o bloco abaixo, altere a senha e vendase execute-o (no pgAdmin, pressione F5; em psql pressione Digitar). Se suas tabelas não estiverem no público esquema, mudança público também, ou repita as três últimas linhas para cada esquema.

    Cole e depois execute.
    CRIAR FUNÇÃO qs_reader LOGIN SENHA 'ChangeMe-2026!'; CONCEDER CONEXÃO NO BANCO DE DADOS vendas PARA qs_reader; CONCEDER USO NO ESQUEMA público PARA qs_reader; CONCEDER SELEÇÃO EM TODAS AS TABELAS NO ESQUEMA público PARA qs_reader; ALTERAR PRIVILÉGIOS PADRÃO NO ESQUEMA público CONCEDER SELEÇÃO EM TABELAS PARA qs_reader;

    Você vê CRIAR FUNÇÃO, então CONCEDER três vezes e ALTERAR PRIVILÉGIOS PADRÃOA última linha torna as tabelas criadas posteriormente legíveis também, mas apenas as tabelas criadas pelo usuário que a executou; se o seu aplicativo cria tabelas como seu próprio usuário, execute essa linha enquanto estiver conectado como esse usuário. Se você vir O banco de dados "vendas" não existe.Use o nome exatamente como o pgAdmin o lista; se contiver letras maiúsculas, coloque-o entre aspas duplas, como em `@`. "Vendas".

  3. Encontre os dois arquivos de configuração do PostgreSQL.

    Ainda na janela de consulta, execute estas duas linhas uma de cada vez:

    Execute cada um e anote a resposta.
    EXIBIR arquivo_de_configuração; EXIBIR arquivo_hba;

    Cada resposta fornece o caminho completo. No Windows, geralmente estão em C:\Program Files\PostgreSQL\17\data\ (o número corresponde à sua versão); no Ubuntu ou Debian, /etc/postgresql/17/main/O primeiro arquivo é postgresql.conf, o segundo pg_hba.confAnote os dois caminhos.

  4. Permita que o PostgreSQL escute a rede.

    Aberto postgresql.conf Em um editor de texto. No Windows: clique Começar, tipo Bloco de notas, clique com o botão direito do mouse e escolha Executar como administrador, então Arquivo → AbrirCole o caminho e altere o tipo de arquivo na caixa no canto inferior direito para Todos os arquivosNo Linux: sudo nano seguido pelo caminho.

    Encontre a linha que começa endereços_de_escuta (Bloco de notas: pressione Ctrl e F juntos). Se estiver escrito listen_addresses = '*'Deixe assim. Se estiver escrito 'localhost' ou começa com um #Substitua a linha inteira por:

    A linha em postgresql.conf
    listen_addresses = '*'

    Salve o arquivo. Nada muda ainda; essa configuração só é lida quando o PostgreSQL é reiniciado (passo 6).

  5. Permita o acesso do computador do agente no arquivo pg_hba.conf.

    Primeiro, encontre o endereço do computador do Agente: nesse computador, clique Começar, tipo comando, abrir Prompt de comando, tipo ipconfig e pressione DigitarA linha Endereço IPv4 mostra algo como 192.168.1.25.

    Aberto pg_hba.conf da mesma forma que o último arquivo. Na parte inferior, há linhas começando hospedarObserve a última palavra nessas linhas, geralmente scram-sha-256 (servidores mais antigos dizem) md5), e adicione esta linha no final, usando a mesma última palavra e o endereço do agente com /32 depois disso:

    Adicione ao final do arquivo pg_hba.conf
    host all qs_reader 192.168.1.25/32 scram-sha-256

    Salve o arquivo. Para permitir o acesso a qualquer computador na rede do escritório, em vez de apenas um, escreva: 192.168.1.0/24.

  6. Reinicie o PostgreSQL

    Windows: clique Começar, tipo Serviços, abra o Serviços aplicativo, encontre a entrada cujo nome começa com postgresql-x64-, clique com o botão direito do mouse e escolha Reiniciar. Isso é Status A coluna pisca e mostra Correndo de novo. Linux: Digite a linha abaixo; quando funciona, nada será impresso.

    Linux: digite isto e pressione Enter.
    sudo systemctl restart postgresql

    Se o PostgreSQL não retornar (o status permanecer em branco ou o comando imprimir fracassado), um erro de digitação se infiltrou em um dos dois arquivos. Abra-os novamente, compare com as linhas acima, salve e reinicie. Porta 5432 Também precisa estar aberto no firewall do servidor: Abrir uma porta de firewall no Windows.

A caixa de seleção "Usar SSL". O conector PostgreSQL do Portal possui Usar SSL A opção está marcada por padrão e, com ela marcada, o Agente insiste em uma conexão criptografada. Um PostgreSQL instalado no Windows geralmente tem a criptografia desativada, portanto o teste falha. Falha na conexão: Conexão SSL solicitada. Nenhuma conexão SSL habilitada está configurada neste host. Essa mensagem significa: desmarque Usar SSL e teste novamente. Deixe marcado para qualquer banco de dados na nuvem.

Veja como é a aparência atual de uma linha ausente no arquivo pg_hba.conf. Você poderia esperar uma recusa clara. Em vez disso, o Portal mostra um sinal âmbar. Assinado com Nenhum banco de dados foi aberto ainda. Dê um nome a ele na próxima etapa. e a mensagem do Agente O login foi bem-sucedido, mas não foi possível abrir nenhum banco de dados (tentei com postgres e template1). Digite o nome do banco de dados. Se você digitar o nome do seu banco de dados, aparecerá a seguinte mensagem: Este login não tem permissão para abrir o banco de dados 'vendas'. Apesar da mensagem "Login bem-sucedido", quase sempre é o arquivo pg_hba.conf que está bloqueando o Agente: volte para passo 5Estamos corrigindo a mensagem para que fique assim.

Se alguma dessas informações não corresponder ao que você vê, pare e Responda ao nosso e-mail de suporte. Com uma foto da tela. Vamos te guiar passo a passo.

MySQL e MariaDB

MySQL e MariaDB usam os mesmos comandos. Uma coisa surpreende a todos: um usuário do MySQL pertence a um local. 'qs_reader'@'localhost' Só é possível fazer login a partir do próprio computador do banco de dados; o mesmo nome de usuário e senha do computador do Agente são recusados. A parte após o @ Tem que corresponder à localização do Agente.

Escreva depois do @Quem pode entrar?Use-o quando
'%'Qualquer computadorA opção mais simples. A senha ainda é necessária.
'192.168.1.%'Computadores naquela rede de escritórioO agente está na mesma rede que o banco de dados.
'192.168.1.25'Apenas esse endereçoVocê sabe o endereço do computador do Agente (ipconfig, como nos passos do PostgreSQL).
'localhost'Apenas o computador de banco de dadosO agente é executado no computador do banco de dados e você digita localhost como servidor.

Não se sente confortável com isso? Pergunte a quem cuida do seu banco de dados ou site, ou responder ao suporte E faremos isso com você. Em um serviço de hospedagem web, pule para a rota cPanel.

  1. Abra uma janela de consulta como administrador.

    Ambiente de trabalho MySQLAbra o arquivo e clique no seu servidor abaixo. Conexões MySQL, insira o raiz senha; uma aba de consulta é aberta. Em um servidor Linux: tipo sudo mysql e pressione Digitar; o prompt muda para mysql> ou MariaDB [(nenhum)]>.

  2. Crie o usuário e permita apenas a opção SELECT.

    Cole o bloco abaixo, altere a senha e o nome do banco de dados (comprar) e a parte depois do @ se você escolheu algo diferente de '%' (aparece duas vezes) e execute-o (Workbench: o botão de raio; linha de comando: Digitar):

    Cole e depois execute.
    CRIAR USUÁRIO 'qs_reader'@'%' IDENTIFICADO POR 'ChangeMe-2026!'; CONCEDER SELECT EM shop.* PARA 'qs_reader'@'%'; FLUSH PRIVILEGES;

    Cada linha responde Consulta OKPara permitir que ele leia todos os bancos de dados no servidor, escreva *.* em vez de comprar.*Se disser A operação CRIAR USUÁRIO falhou, já existe um usuário com esse nome e local: escolha outro nome ou pergunte a quem o configurou.

  3. Permita que o servidor escute a rede.

    No Ubuntu e no Debian, o MySQL e o MariaDB só escutam o próprio computador do banco de dados até que você altere as configurações. endereço de vinculaçãoAbra o arquivo de configurações (sudo nano e o caminho):

    MySQL no Ubuntu/Debian
    /etc/mysql/mysql.conf.d/mysqld.cnf
    MariaDB no Ubuntu/Debian
    /etc/mysql/mariadb.conf.d/50-server.cnf
    MySQL no Windows
    meu.ini em C:\ProgramData\MySQL\MySQL Server 8.0\ (A pasta ProgramData está oculta: cole o caminho na barra de endereços do Explorador de Arquivos)

    Encontre a linha endereço-de-vinculação = 127.0.0.1Altere para a linha abaixo e salve. No Windows, geralmente não existe essa linha, o que significa que o programa já está em modo de escuta; deixe o arquivo como está.

    A linha no arquivo de configurações
    endereço-de-vinculação = 0.0.0.0
  4. Reinicie o banco de dados

    Linux: tipo sudo systemctl restart mysql (ou sudo systemctl restart mariadb) e pressione Digitar; quando funciona, não imprime nada. Windows: no Serviços clique com o botão direito do mouse no aplicativo MySQL80 (ou MariaDB) e escolha Reiniciar. Porto 3306 Também precisa estar aberto no firewall do servidor: Abrir uma porta de firewall no Windows.

A caixa de seleção "Usar SSL" e a mensagem RSA. Os conectores MySQL e MariaDB do Portal têm Usar SSL marcado por padrão. Um MariaDB sem criptografia configurada falha com Falha na conexão: o servidor não suporta SSL.: desmarque Usar SSL e teste novamente. No MySQL 8 ou posterior, mantenha a opção marcada. O MySQL cria seu próprio certificado e desmarcá-la leva a... Falha na conexão: O método de autenticação 'caching_sha2_password' falhou. Use uma conexão segura, especifique a chave pública RSA do servidor com ServerRSAPublicKeyFile ou defina AllowPublicKeyRetrieval=True. O agente não pode fazer as duas últimas hoje, então a resposta é marcar a opção correta. Usar SSL novamente. (Alternando o usuário para a versão mais antiga) senha_nativa_mysql Este método também funciona no MySQL 8.0, mas o MySQL 8.4 desativa esse método por padrão e o MySQL 9 o removeu, portanto, não o recomendamos.

A opção cPanel (a maioria dos serviços de hospedagem web). No cPanel, a seção Bancos de Dados possui duas páginas que você precisa acessar. Versões mais antigas do cPanel as chamam de... Bancos de dados MySQL e MySQL remoto; O cPanel 120 e versões posteriores os chamam assim: Gerenciar meus bancos de dados e Acesso remoto ao banco de dados.

  1. Criar o usuário

    Aberto Gerenciar meus bancos de dados (ou Bancos de dados MySQL). Sob Adicionar um usuário, tipo leitor_qs em Nome de usuárioDigite a senha nos dois campos de senha e clique. Criar usuárioO cPanel coloca o nome da sua conta na frente, então o nome de usuário real fica algo como leitor_de_perguntas_da_minha_contaEscreva esse nome completo; é ele que vai no Portal.

  2. Execute o comando SELECT no seu banco de dados, nada mais.

    Sob Adicionar usuário ao banco de dadosSelecione o novo usuário e o seu banco de dados nos dois menus e clique em AdicionarUma página com caixas de seleção de privilégios é aberta (Manutenção de conta MySQL). Fazer não marcação TODOS OS PRIVILÉGIOSMarque apenas SELECIONAR, depois clique Fazer alterações.

  3. Permitir o endereço do agente

    No computador do agente, abra um navegador e pesquise por Qual é o meu endereço IP?Observe o endereço exibido (este é o endereço público do escritório, não o 192.168). No cPanel, abra Acesso remoto ao banco de dados (ou MySQL remoto), digite esse endereço em Hospedar, adicione um Comentário como Agente de fluxos de consultae clique Adicionar hostSe você não visualizar esta página, seu provedor de hospedagem a desativou; entre em contato com eles ou instale o Agente no servidor de hospedagem, caso seja permitido.

Sites WordPress. O nome do banco de dados, o servidor e o login estão no site. wp-config.php arquivo, nas linhas NOME_DO_BANCO_DE_DADOS, DB_HOST, USUÁRIO_DO_BANCO_DE_DADOS e SENHA_DO_BANCO_DE_DADOS. Usar NOME_DO_BANCO_DE_DADOS e DB_HOST a partir daí, mas não dê isso ao Agente. USUÁRIO_DO_BANCO_DE_DADOSÉ a conta que o próprio WordPress usa para escrever. Em vez disso, crie um usuário separado com permissões somente leitura, como mostrado acima.

Se alguma dessas informações não corresponder ao que você vê, pare e Responda ao nosso e-mail de suporte. Com uma foto da tela. Vamos te guiar passo a passo.

Oráculo

Execute isso como um DBA (por exemplo) SISTEMA) no SQL Developer ou SQL*Plus, conectado ao banco de dados plugável que contém suas tabelas (no Oracle XE, isso é XEPDB1, no Oracle Free FREEPDB1). Substituir VENDAS.PEDIDOS Para cada tabela que o Agente deve ler, uma linha GRANT por tabela.

Executar como DBA
CRIAR USUÁRIO qs_reader IDENTIFICADO POR "ChangeMe-2026!"; CONCEDER PERMISSÃO DE CRIAÇÃO DE SESSÃO A qs_reader; CONCEDER PERMISSÃO DE SELEÇÃO EM SALES.ORDERS A qs_reader;

Cada linha responde Criado pelo usuário ou Grant teve sucessoNo Portal, digite o proprietário das tabelas (aqui) VENDAS(em maiúsculas) em Esquema padrãoSe deixado em branco, ele usa QS_READER, que não possui mesas, e o teste diz O esquema `QS_READER` não existe ou este login não tem permissão para ler nenhuma de suas tabelas. Concedendo todas as mesas de uma só vez (LER QUALQUER TABELA) abrange todos os esquemas do banco de dados, incluindo os do sistema; consulte seu DBA antes de usá-lo.

Não tem certeza a qual banco de dados você está conectado? Responda ao nosso e-mail de suporte. com uma foto da tela.

Floco de neve

No Snowsight, abra uma nova planilha SQL como um usuário com o ADMINISTRADOR DE SEGURANÇA ou ADMINISTRADOR DE CONTAS Execute o bloco abaixo e substitua-o por: COMPUTE_WH, VENDAS e QS_USUÁRIO (o usuário do Snowflake com o qual o Agente faz login) com seus próprios nomes.

Folha de exercícios "Correr em um local com neve"
CRIAR FUNÇÃO QS_READER; CONCEDER USO NO ARMAZÉM COMPUTE_WH PARA A FUNÇÃO QS_READER; CONCEDER USO NO BANCO DE DADOS SALES PARA A FUNÇÃO QS_READER; CONCEDER USO EM TODOS OS ESQUEMAS NO BANCO DE DADOS SALES PARA A FUNÇÃO QS_READER; CONCEDER SELECT EM TODAS AS TABELAS NO BANCO DE DADOS SALES PARA A FUNÇÃO QS_READER; CONCEDER SELECT EM TABELAS FUTURAS NO BANCO DE DADOS SALES PARA A FUNÇÃO QS_READER; CONCEDER FUNÇÃO QS_READER AO USUÁRIO QS_USER;

Cada linha responde Declaração executada com sucesso. No Portal, digite QS_READER em Função e COMPUTE_WH em ArmazémSe um armazém ou função não tiver uma subvenção, o teste indica Armazém inválido ou Função inválidaA linha FUTURE precisa ADMINISTRADOR DE SEGURANÇA ou superior, e se um esquema tiver suas próprias concessões futuras, o Snowflake ignora esta para esse esquema.

Google BigQuery

O BigQuery não possui logins SQL. O agente faz login como usuário do Google Cloud. conta de serviçoE duas funções tornam o sistema somente leitura:

Visualizador de dados do BigQuery
Lê tabelas e visualizações. Disponibilize-a para o projeto todo ou apenas para os conjuntos de dados que deseja compartilhar.
Usuário de trabalho do BigQuery
Permite executar consultas. Inclua-o no projeto. Sem ele, o teste diz: Esta conta de serviço não pode executar consultas no projeto…

No console do Google Cloud, acesse IAM e Administração → IAM, encontre a conta de serviço (ou clique) Conceder acesso e cole o endereço de e-mail), e adicione ambas as funções. Não adicione Editor de dados do BigQuery, Administrador do BigQuery, Editor ou ProprietárioQualquer um deles pode alterar os dados. Em seguida, você cola a chave JSON da conta em Chave JSON da conta de serviço no Portal.

O que significa a mensagem

Depois de clicar Teste de conexão Em Agentes de Dados, a mensagem sob Falha na conexão (ou sob um âmbar) Assinado) são as próprias palavras do Agente. O teste de conexão é executado no computador do Agente, portanto, ele precisa estar online primeiro: O agente está online? Em seguida, encontre sua mensagem:

MensagemCausaConsertar
Falha na conexão: Falha no login do usuário 'qs_reader'. (SQL Server)Senha incorreta, login inexistente ou o servidor aceita apenas contas do Windows. A mensagem é a mesma em todos os três casos.Verificar Exclusivo para Windows Primeiro, se você tiver certeza da senha; depois Criar o login.
Não foi possível abrir o banco de dados... solicitado pelo login. Falha no login. (SQL Server)O login existe, mas não possui nenhum usuário nesse banco de dados.Execute as três últimas linhas de passo 4 para esse banco de dados.
Você está conectado, mas não é possível abrir o banco de dados padrão deste login. Digite o seu banco de dados. (SQL Server)O login funciona, mas não consegue abrir o banco de dados padrão.Na próxima etapa, selecione seu banco de dados e certifique-se de que... passo 4 foi disputado por isso.
Falha na conexão: 28P01: falha na autenticação por senha para o usuário "qs_reader" (PostgreSQL)Senha incorreta ou a função foi criada sem permissão. CONECTE-SE.Reprise passo 2ou reinicie-o com ALTER ROLE qs_reader SENHA '…';
O login foi bem-sucedido, mas não foi possível abrir nenhum banco de dados (tentei com postgres e template1). Digite o nome do banco de dados. (PostgreSQL)Geralmente não pg_hba.conf linha para o computador do Agente, apesar da redação.Adicione a linha pg_hba.conf e reiniciar; Por que está escrito isso?.
Este login não tem permissão para abrir o banco de dados 'vendas'. (PostgreSQL)Não CONECTAR GRANTOu seja, a linha pg_hba.conf nomeia outro banco de dados.Etapa 2, então passo 5.
Falha na conexão: Conexão SSL solicitada. Nenhuma conexão SSL habilitada está configurada neste host. (PostgreSQL)O servidor não possui criptografia; Usar SSL está marcado.Desmarque a opção "Usar SSL"..
Falha na conexão: Falha ao conectar-se a …:5432 (PostgreSQL)O PostgreSQL não está escutando na rede, um firewall está bloqueando a porta 5432 ou ele está parado.endereços_de_escuta, reiniciar, então o firewall.
Acesso negado para o usuário 'qs_reader'@'…' (usando senha: SIM) (MySQL/MariaDB)Senha incorreta ou o usuário existe apenas em outro local (por exemplo, @'localhost').Confira o parte depois do @; executar novamente passo 2.
O host '…' não tem permissão para se conectar a este servidor MySQL. (MySQL/MariaDB)Não existe nenhum usuário associado ao endereço do agente; em um servidor web, o endereço não está no MySQL remoto.Crie o usuário com '%', ou Adicione o endereço no cPanel..
Falha na conexão: Não foi possível conectar a nenhum dos hosts MySQL especificados. ou A conexão com o servidor MySQL expirou após 15 segundos.O servidor escuta apenas a si mesmo, um firewall bloqueia a porta 3306 ou ele é interrompido.endereço de vinculação, reiniciar, então o firewall.
Falha na conexão: o servidor não suporta SSL. (MySQL/MariaDB)Não há criptografia no servidor; Usar SSL está marcado.Desmarque a opção "Usar SSL"..
O método de autenticação 'caching_sha2_password' falhou… (MySQL)Usar SSL Essa opção foi desmarcada no MySQL 8 ou posterior.Marque a opção Usar SSL novamente..
Falha na conexão: Nome de usuário/senha inválidos – verifique as credenciais (Oráculo)Senha incorreta (as senhas do Oracle diferenciam maiúsculas de minúsculas) ou usuário incorreto.Recriar ou redefinir o usuário.
O esquema `…` não existe ou este login não tem permissão para ler nenhuma de suas tabelas. (Oráculo)Esquema padrão Está em branco, incorreto ou não possui permissão SELECT.Digite o proprietário no Esquema Padrão; adicione GRANT SELECT.
Conexão falhou: Função inválida ou Armazém inválido (Floco de neve)A função não foi atribuída ao usuário ou não possui USO no repositório.Gerir as subvenções; verifique os nomes em Função e Armazém.
Permissão negada para o projeto… ou Esta conta de serviço não pode executar consultas no projeto… (BigQuery)Ausente Usuário de trabalho do BigQuery.Adicione a função.
O conjunto de dados … não foi encontrado no projeto …, ou esta conta de serviço não tem permissão para lê-lo. (BigQuery)Ausente Visualizador de dados do BigQuery com base nesse conjunto de dados, ou um erro de digitação.Adicione a função.
Somente consultas SELECT são permitidas no modo somente leitura. (mais tarde, ao executar uma consulta)A consulta tentou alterar algo. O Agente a interrompeu antes que ela atingisse o banco de dados.Funcionando conforme o esperado; veja por que.

Em seguida: adicione a conexão

Aberto Agentes de dados, clique Adicionar conector No seu agente, selecione o banco de dados e digite o nome de usuário e a senha do novo usuário. Nome de usuário e SenhaEm seguida, siga o guia indicando onde você deseja que os dados sejam armazenados:

Ainda com dificuldades? Aberto Suporte Em Fluxos de Consulta, informe-nos em qual etapa você está e o que você vê. Nós o conectaremos.

Problemas com a configuração?

  • O agente está offline ou as opções Testar conexão e Navegar estão desativadas? Verifique se o agente está online → O agente está online?
Atualizado em novembro 9, 2026

Desenvolvido por BetterDocs