Logotipo do Google AlloyDB

Compatível com Postgres fala PostgreSQL

Conectar Google AlloyDB para Excel, Planilhas Google, IA e REST

AlloyDB para PostgreSQL em um IP privado dentro da sua VPC ou através do AlloyDB Auth Proxy. Sem IP público, sem regra de entrada.

Uma conexão, todas as superfícies

Para onde seus dados do AlloyDB podem ir

O Query Streams lê dados do AlloyDB do Microsoft Excel, Google Sheets, Power BI, assistentes de IA via MCP e um endpoint REST por meio de uma única conexão somente leitura. O AlloyDB não possui um nome de host público para conexão — você acessa por um IP privado dentro da sua VPC do Google Cloud ou através do AlloyDB Auth Proxy no localhost. Coloque o Network Agent em uma pequena VM na mesma VPC e ele acessará a instância de forma privada, fazendo apenas conexões de saída. Assim, o AlloyDB não precisa de um IP público e sua VPC não precisa de nenhuma regra de entrada.

O Google AlloyDB é o PostgreSQL na rede. — o driver padrão, portanto, todas as orientações abaixo se aplicam sem alterações. A única parte específica do AlloyDB é a string de conexão, abordada em detalhes de conexão.

  1. Para sua equipe, fornecedores e parceiros.
  2. AlloyDB para Excel Microsoft Excel · Suplemento do Excel

    Extraia resultados do AlloyDB em tempo real diretamente para uma planilha e atualize-os sob demanda — Excel para desktop, Excel Online, Microsoft 365.

    Guia do PostgreSQL
  3. AlloyDB para Planilhas Google Suplemento de planilhas

    Execute uma consulta AlloyDB salva na barra lateral e arraste as linhas para a planilha. Os colaboradores que compartilharam a planilha podem atualizá-la por conta própria.

    Guia do PostgreSQL
  4. Pergunte à Nova sobre o AlloyDB. Nova AI · texto para SQL

    Faça uma pergunta em linguagem simples. O Nova já conhece suas tabelas AlloyDB, escreve e executa o SQL, explica a resposta e a exibe em um gráfico — sem necessidade de escrever consultas ou fornecer credenciais.

    Como funciona o Nova
  5. AlloyDB para Visualizador de Dados Compartilhamento de resultados · equipe, fornecedores, parceiros · celular, tablet, computador

    Compartilhe um resultado AlloyDB em tempo real com qualquer pessoa — um colega, um fornecedor, um parceiro — como uma tabela que pode ser adicionada aos favoritos e que é atualizada automaticamente ao ser aberta em um celular, tablet ou computador. Eles veem os resultados, nunca o SQL ou as credenciais.

    Como funciona o Visualizador de Dados
  6. Para aplicativos e sistemas
  7. API REST do AlloyDB endpoint HTTP

    Publique uma consulta AlloyDB como um endpoint JSON autenticado que qualquer aplicativo pode chamar, com uma especificação OpenAPI 3.1 e coleções prontas para Postman, Insomnia e Hoppscotch. Nenhuma porta de banco de dados é aberta.

    Guia do PostgreSQL
  8. AlloyDB para Power BI Power Query M

    Cole o arquivo M do Power Query gerado no Editor Avançado do Power BI e o relatório lerá os resultados do AlloyDB em tempo real via HTTPS — sem driver ODBC, sem porta de banco de dados aberta.

    Como funciona o Power BI
  9. AlloyDB para Airtable Plataforma de automação

    Sincronize linhas do AlloyDB com uma base do Airtable de acordo com uma programação ou busque-as dentro de um script de automação do Airtable.

    Guia do PostgreSQL
  10. AlloyDB para Baserow Plataforma de automação

    Alimente uma tabela Baserow do AlloyDB através do endpoint REST — hospedado localmente ou na nuvem Baserow.

    Guia do PostgreSQL
  11. AlloyDB para SeaTable Plataforma de automação

    Mantenha uma base SeaTable atualizada com dados AlloyDB sem exportar um arquivo ou expor o banco de dados.

    Guia do PostgreSQL
  12. AlloyDB para Smartsheet Plataforma de automação

    Integre os resultados do AlloyDB a uma grade do Smartsheet para que os planos e relatórios sejam lidos do sistema de origem, e não da exportação da semana passada.

    Guia do PostgreSQL
  13. AlloyDB para Anvil Anvil Works · Plataforma de aplicativos

    Faça backup de um aplicativo Anvil Python com AlloyDB por meio do endpoint REST, em vez de incorporar as credenciais do banco de dados no aplicativo.

    Guia do PostgreSQL
  14. Para ferramentas de IA
  15. Servidor AlloyDB MCP Clientes Claude, Cursor e MCP

    Conceda a um assistente de IA acesso somente leitura ao AlloyDB com o esquema necessário para escrever SQL correto — sem credenciais no chat.

    Guia do PostgreSQL
  16. Entregue às pessoas
  17. Alertas e relatórios do AlloyDB Slack · Discord · E-mail · Webhook

    Programe uma consulta AlloyDB para ser entregue via Slack, Discord, e-mail ou webhook assinado — ou retenha a mensagem até que a contagem de linhas, um limite ou uma variação percentual ultrapasse o valor definido.

    Como funcionam os alertas e relatórios

Como funciona

5 etapas, sem alteração no firewall de entrada

01

Coloque o Agente de Rede em uma VM dentro da mesma VPC do Google Cloud que a instância do AlloyDB. Essa é a configuração inicial prevista em todo o projeto.

02

Insira o endereço IP privado da instância. Não existe um nome de host para o AlloyDB — o endereço é o que você tem.

03

Ou execute o AlloyDB Auth Proxy na VM do agente e aponte o cartão para 127.0.0.1. O cartão reconhece o localhost e oferece a orientação correta para ele.

04

Preencha o nome de usuário e a senha do banco de dados. O AlloyDB utiliza por padrão um banco de dados chamado postgres, que é preenchido automaticamente no cartão.

05

Salve. Microsoft Excel, Google Sheets, Power BI, MCP e REST leem os dados por meio dessa única conexão, ou você pode combiná-la com suas outras fontes em uma única instrução somente leitura.

Análise detalhada do recurso

O que o AlloyDB oferece

Um agente na VPC é o projeto completo.

O AlloyDB foi projetado para ser privado, e o Agente de Rede foi projetado para fazer apenas conexões de saída. Esses dois fatos se encaixam tão bem que o caminho privado é o padrão, em vez da opção reforçada.

  • Execute o agente em uma VM na mesma VPC e ele se conectará à instância por meio de seu IP privado. Nenhuma informação sobre o AlloyDB é publicada e nenhum IP público é necessário.
  • O agente disca e nunca escuta, portanto não há regra de entrada para adicionar e nada que alguém fora da VPC possa acessar.
  • Como o AlloyDB é acessado por IP em vez de nome de host, não há nada no endereço que o Query Streams possa reconhecer. O selo do AlloyDB é obtido ao escolher este cartão, e não ao interceptar o endereço. — portanto, uma conexão Postgres simples com o mesmo IP permanece rotulada como Postgres simples.
  • O AlloyDB é compatível apenas com PostgreSQL. Ao contrário do Cloud SQL, que também oferece MySQL e SQL Server, aqui existe apenas um mecanismo de busca, sem opção de seleção.

Por meio do Proxy de Autenticação, desative o SSL.

A outra opção compatível é o AlloyDB Auth Proxy do Google, que altera uma resposta no formulário.

  • Execute o proxy na máquina do agente e aponte a placa para 127.0.0.1. A placa reconhece o localhost e indica o que fazer em seguida.
  • O proxy criptografa o próprio túnel. Solicitar ao driver do Postgres que negocie seu próprio TLS além disso é o que gera o erro SSL que as pessoas encontram aqui, portanto, desmarque a caixa de seleção para conexão via proxy.
  • Em uma conexão direta com IP privado, deixe a caixa de seleção marcada. O AlloyDB é a exceção entre os provedores de hospedagem. — a caixa de seleção controla de fato se o TLS será usado, em vez de ser anulada pelo agente.
  • Quando o TLS está ativado, o tráfego é criptografado, mas a cadeia de certificados não é verificada.

Postgres comum, uma vez conectado

Não há nenhuma infraestrutura específica do AlloyDB além do endereço e do proxy. O que chega é o Postgres.

  • A conexão é salva como PostgreSQL com AlloyDB mantido como o identificador. Não existe um tipo de conexão chamado AlloyDB.
  • A autenticação é feita por meio de um nome de usuário e senha do banco de dados. A autenticação do banco de dados Google Cloud IAM não é compatível com este cartão.
  • Não há configuração de pooling nem endpoint de pooling para escolher. O agente se conecta diretamente.
  • "public" é o esquema padrão e é o que uma referência entre fontes diferentes carrega.
-- Postgres comum, somente leitura, sobre o IP privado SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM public.customers AS c JOIN public.orders AS o ON o.customer_id = c.id WHERE o.placed_at >= now() - interval '30 days' GROUP BY c.name ORDER BY revenue DESC;

Compartilhado por todos os conectores de banco de dados

Verdadeiro para todos os conectores de banco de dados.

  • Apenas envio — o agente abre uma conexão criptografada para o Query Streams. Nenhuma porta de entrada para encaminhar, nenhuma VPN, nenhuma lista de permissões de IP, nada sobre seu banco de dados exposto à internet.
  • As credenciais permanecem no mesmo lugar. — O nome de usuário e a senha do banco de dados ficam armazenados na máquina onde você instalou o agente. O Query Streams nunca os recebe e não consegue acessar seu banco de dados por conta própria.
  • Somente leitura, obrigatório — uma instrução por vez, apenas SELECT e similares. Uma operação de escrita é rejeitada em sua própria máquina antes mesmo de ser enviada ao servidor, em vez de depender de uma permissão que alguém se lembrou de definir.
  • Implante quantos agentes desejar. — uma por site, região ou nuvem. Todas as fontes de dados que eles podem visualizar aparecem em um único menu suspenso, para que ninguém precise saber qual agente hospeda o quê.

O que você obtém depois de salvar uma consulta.

  • Compartilhe a capacidade, não o SQL. — um colega ou um parceiro externo pode executar sua consulta e alterar seus filtros sem nunca ver a declaração por trás dela.
  • Filtros de ambas as direções — declare-as você mesmo como @variáveis ou deixe o conector identificar os valores literais já presentes na sua cláusula WHERE e oferecê-los como listas suspensas.
  • Leia de qualquer lugar — Microsoft Excel, Google Sheets, Power BI, a API REST, assistentes de IA via MCP, o Construtor de Consultas e o Nova leem a mesma consulta salva.
  • Execute várias ao mesmo tempo — cinco consultas salvas em cinco abas de planilha, transmitidas simultaneamente, independentemente do tamanho dos resultados.
  • Conecte-o a qualquer outro dispositivo que você já tenha utilizado. — outro banco de dados, uma API de negócios ou uma pasta de arquivos, em uma única instrução somente leitura.

SQL entre fontes diferentes

Integre o AlloyDB ao restante dos seus dados.

Uma única instrução pode abranger o AlloyDB e suas outras conexões simultaneamente. Cada fonte executa apenas a parte que consegue, transmite o resultado de volta e a junção ocorre de forma centralizada — as fontes nunca se comunicam entre si e nada é copiado para nenhum lugar.

3 conexões · 3 agentes

Google AlloyDB Compatível com Postgres
Microsoft SQL Server Motor relacional
Listrado Pagamentos e faturamento

Uma declaração

-- nada copiado, nada mesclado, nada agendado
SELECIONAR   c.região, COUNT(*) AS pedidos, SUM(i.valor_devido) AS faturado
DE     núcleo de liga.ordens.públicas1 f
JUNTAR     erp_sql.dbo.clientes2    c LIGADO c.id = f.id_do_cliente
JUNTAR     cobrança.stripe.faturas3  i LIGADO i.cliente = c.stripe_id
GRUPO POR c.região
ORDER BY faturado DESC;

As três partes são conexão, esquema e tabela — e o nome da conexão é o que você escolheu. Colunas ilustrativas; suas tabelas serão suas tabelas. O acesso somente leitura se aplica a cada componente: apenas SELECT, WITH e EXPLAIN, com um limite máximo de dados que uma única fonte pode fornecer para uma consulta. Como funcionam as consultas federadas

Detalhes da conexão

O que o AlloyDB precisa

Endereço
O endereço IP privado da instância. O AlloyDB não possui um nome de host público — ou 127.0.0.1 ao usar o Proxy de Autenticação.
Porto
5432
Motorista
O Npgsql é fornecido pelo agente — nada precisa ser instalado no AlloyDB.
Colocação de agentes
Uma VM na mesma VPC. Somente saída, portanto, sem regra de entrada e sem exposição pública.
Banco de dados
O PostgreSQL é usado por padrão e preenchido automaticamente dessa forma.
Autenticação
Nome de usuário e senha do banco de dados. A autenticação de banco de dados IAM não é suportada.
TLS
Controlado pela caixa de seleção e ativado por padrão. Criptografado; a cadeia de certificados não é verificada. Desative-o ao usar o Proxy de Autenticação, que criptografa o próprio túnel.
Agrupamento
Nenhuma configuração necessária — o agente se conecta diretamente.
Motores
Apenas PostgreSQL. Ao contrário do Cloud SQL, não há opção para MySQL ou SQL Server.
Esquema padrão
público, que é o que uma referência federada carrega.

O AlloyDB é o caso mais claro neste catálogo de como o perfil do agente se adequa ao do banco de dados. O AlloyDB precisa estar em um IP privado, sem nenhuma superfície pública; o agente só faz conexões de saída e nunca escuta em nenhuma rede. Coloque um dentro da mesma VPC que o outro e não haverá concessões a serem negociadas — nenhum IP público para habilitar, nenhuma lista de redes autorizadas para manter, nenhuma regra de entrada para alguém auditar posteriormente. Acessar um banco de dados privado geralmente tem um custo em termos de rede. Aqui, o custo é uma pequena máquina virtual.

Vale a pena ler a nota de rodapé sobre o Proxy de Autenticação antes de se deparar com o erro, e não depois. O proxy do Google já criptografa o túnel, então, quando o driver do Postgres tenta negociar TLS dentro dele também, o teste de conexão falha com um erro SSL que parece ser um problema de certificado, mas não é. Desmarcar a caixa de seleção SSL para uma conexão com proxy é a solução, e o cartão indica isso assim que detecta um endereço localhost. Em uma conexão direta com um IP privado, a caixa de seleção deve permanecer marcada — e, diferentemente da maioria dos provedores de hospedagem, no AlloyDB é a caixa de seleção que decide, e não o agente.

Para uma consulta entre fontes diferentes, o AlloyDB utiliza o Postgres padrão. Uma conexão chamada `ally_core` é escrita como `ally_core.public.orders` e realiza uma junção com uma pasta de arquivos CSV, um sistema de registro local ou uma API de faturamento em uma única instrução somente leitura — sem nenhuma cópia ou agendamento. A junção é executada de onde o agente estiver, o que para o AlloyDB significa dentro da sua VPC.

Documentação do fornecedor: cloud.google.com

Perguntas frequentes

Perguntas sobre o Google AlloyDB

Quais ferramentas conseguem ler dados do Google AlloyDB por meio de fluxos de consulta?

Tudo isso, a partir de uma única conexão: Excel, Planilhas Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, alertas e relatórios agendados. Conecte o banco de dados uma única vez e todas as plataformas lerão a mesma conexão somente leitura — não há configuração por ferramenta nem necessidade de uma segunda cópia dos dados.

Preciso abrir uma porta no firewall para meu banco de dados Google AlloyDB?

Não. O Agente de Rede do Query Streams é executado dentro da sua rede e abre uma única conexão criptografada de saída. Nada fica à escuta do tráfego de entrada, nenhuma VPN é necessária e o banco de dados mantém suas regras de firewall existentes.

É possível que os fluxos de consulta alterem dados no Google AlloyDB?

Não. O agente impõe o modo somente leitura no ponto de execução — uma instrução por vez, apenas SELECT e similares. As credenciais permanecem no agente e nunca são enviadas para o Query Streams.

O que o Query Streams precisa para se conectar ao Google AlloyDB?

Um host acessível, uma função e sua senha — o agente carrega o driver, portanto, nada é instalado no banco de dados. Endereço: IP privado da instância. O AlloyDB não possui um nome de host público — ou 127.0.0.1 ao usar o Proxy de Autenticação. Porta: 5432. Driver: Npgsql, carregado pelo agente — nada para instalar no AlloyDB. Posicionamento do agente: Uma VM na mesma VPC. Somente saída, portanto, sem regra de entrada e sem exposição pública.

Posso unir o Google AlloyDB a outro banco de dados na mesma consulta?

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar o Google AlloyDB e suas outras conexões simultaneamente, escritas como conexão.esquema.tabela. Cada origem executa apenas a parte que consegue e transmite o resultado de volta; a junção ocorre centralmente, portanto as origens nunca se conectam entre si e nada é copiado ou agendado. O modo somente leitura se aplica a cada parte — apenas SELECT, WITH e EXPLAIN — e há um limite para a quantidade de dados que uma origem pode fornecer para uma única consulta. Consultas federadas são um recurso do plano; a página de consultas federadas contém os limites atuais de origem e tamanho.

Conectar-se ao Google AlloyDB é diferente de conectar-se ao PostgreSQL?

Apenas a string de conexão. O Google AlloyDB utiliza o protocolo de comunicação do PostgreSQL, portanto, filtros, agendamento, compartilhamento, os complementos do Excel e do Google Sheets e o servidor MCP funcionam de maneira idêntica. O cartão AlloyDB preenche automaticamente as configurações de host, porta e SSL que o provedor espera.

Existe algum guia de conversão de AlloyDB para Excel?

Sim, é o guia do PostgreSQL e está correto para o Google AlloyDB, conforme descrito. O AlloyDB utiliza o protocolo de comunicação do PostgreSQL, portanto, a conexão do AlloyDB com o Excel, do AlloyDB com o Google Sheets e qualquer outro destino segue os mesmos passos. A única parte específica do AlloyDB é a string de conexão, e o guia do AlloyDB a preenche automaticamente.

Instale o AlloyDB onde o trabalho acontece.

Instale o agente, aponte-o para seu banco de dados e escolha um destino.

Somente leitura Apenas envio As credenciais permanecem com o agente.