Logotipo do Google Cloud SQL

Gerenciado · multi-motor Fala PostgreSQL / MySQL / Microsoft SQL Server

Conectar Google Cloud SQL para Excel, Planilhas Google, IA e REST

Google Cloud SQL — PostgreSQL, MySQL ou SQL Server. O agente se conecta através do endereço IP que você já expõe para si mesmo.

Uma conexão, todas as superfícies

Para onde seus dados do Cloud SQL podem ir?

O Query Streams lê dados do Google Cloud SQL a partir 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. Um único cartão abrange PostgreSQL, MySQL e SQL Server. O Agente de Rede é executado em uma VM dentro da sua VPC e se conecta através do IP privado da instância, discando apenas para fora — portanto, a instância não precisa de IP público nem de entradas de rede autorizadas.

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

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

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

    Guia do PostgreSQL
  3. Cloud SQL para Planilhas Google Suplemento de planilhas

    Execute uma consulta Cloud SQL 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 Cloud SQL. Nova AI · texto para SQL

    Faça uma pergunta em linguagem simples. O Nova já conhece suas tabelas do Cloud SQL, 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. Visualizador de dados do Cloud SQL Compartilhamento de resultados · equipe, fornecedores, parceiros · celular, tablet, computador

    Compartilhe um resultado do Cloud SQL 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 Cloud SQL endpoint HTTP

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

    Guia do PostgreSQL
  8. Cloud SQL 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 Cloud SQL em tempo real via HTTPS — sem driver ODBC, sem porta de banco de dados aberta.

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

    Sincronize linhas do Cloud SQL 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. Cloud SQL para linha base Plataforma de automação

    Alimente uma tabela do Baserow a partir do Cloud SQL através do endpoint REST — hospedado localmente ou na nuvem do Baserow.

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

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

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

    Integre os resultados do Cloud SQL 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. Cloud SQL para Anvil Anvil Works · Plataforma de aplicativos

    Faça backup de um aplicativo Python do Anvil com o Cloud SQL 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 Cloud SQL MCP Clientes Claude, Cursor e MCP

    Conceda a um assistente de IA acesso somente leitura ao Cloud SQL 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 Cloud SQL Slack · Discord · E-mail · Webhook

    Programe uma consulta Cloud SQL para ser entregue no Slack, Discord, por e-mail ou por um 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

Instale o Agente de Rede em uma VM dentro da VPC do Google Cloud. Ele só faz conexões de saída, então a instância pode manter seu IP público desativado e suas redes autorizadas vazias.

02

Escolha o mecanismo de banco de dados — PostgreSQL, MySQL ou SQL Server. O restante do formulário será preenchido de acordo com a sua escolha.

03

Atribua o endereço IP privado da instância. Um endereço IP público funciona se você já estiver acessando a instância dessa forma, e 127.0.0.1 funciona se você estiver usando o Cloud SQL Auth Proxy.

04

Adicione um usuário de banco de dados com a instrução SELECT para selecionar o que você deseja ler e o nome do banco de dados.

05

Salvar. Microsoft Excel, Google Sheets, Power BI, MCP e REST leem essa instância por meio de uma única conexão ou a combinam com suas outras fontes em uma única instrução.

Análise detalhada do recurso

O que o Cloud SQL oferece

O IP privado é o caminho recomendado e também o mais fácil.

A conectividade com o Cloud SQL geralmente é a parte mais difícil de levar esses dados a qualquer lugar. Isso deixa de ser difícil quando o mecanismo que realiza a leitura já está dentro da VPC.

  • O agente realiza apenas conexões de saída, portanto, colocá-lo em uma VM na sua VPC não requer nenhuma regra de entrada.
  • A instância não mantém nenhum IP público e a lista de redes autorizadas permanece vazia. — Nada a atualizar quando o endereço do escritório muda.
  • Como não há um nome de host para apontar, o Cloud SQL é acessado por endereço IP. Essa é uma característica do serviço, e não uma limitação neste caso.
  • Um IP público ainda funciona se essa for a sua configuração atual. O agente não se importa em qual lado da fronteira ele está.

O proxy de autenticação é compreendido.

Muitas equipes acessam o Cloud SQL por meio do Cloud SQL Auth Proxy em vez de diretamente por um endereço IP, e o cartão detecta quando isso acontece.

  • Digitar 127.0.0.1 ou localhost é reconhecido como proxy, e o cartão indica isso, em vez de deixar você na dúvida se é compatível.
  • O proxy criptografa o próprio túnel, portanto a opção SSL deve estar desativada para esse caminho. — o cartão informa isso no momento em que um erro SSL poderia causar confusão.
  • Para conexões IP diretas, a opção SSL deve estar ativada, e está ativada por padrão.
  • O proxy é um processo que você executa e gerencia; nada relacionado a ele está incluído no agente.

Três motores e uma proteção contra a escolha do motor errado.

Uma placa de rede com suporte a múltiplos motores de computador permite um erro específico: colar uma porta que pertence a um motor diferente daquele selecionado. Essa combinação falha na conexão sem nenhuma informação útil, sendo assim detectada no formulário.

  • PostgreSQL na porta 5432, MySQL na porta 3306, SQL Server na porta 1433. — pré-preenchido para o motor que você escolheu.
  • Digite 3306 com PostgreSQL selecionado e o cartão informará que a porta pertence ao MySQL e pedirá que você verifique o mecanismo, em vez de repassá-lo.
  • Senhas com espaços em branco no início ou no final também são sinalizadas, pois quase sempre são resquícios da área de transferência e resultam em um erro de autenticação não transparente.
  • Independentemente do mecanismo de busca escolhido, é nele que a conexão será salva. — O Cloud SQL é exibido como um selo no cartão, não como um tipo de conexão.
-- Mesma leitura, independentemente do mecanismo que a instância execute SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM customers AS c JOIN orders AS o ON o.customer_id = c.id 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 Cloud SQL ao restante dos seus dados.

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

3 conexões · 3 agentes

Google Cloud SQL Gerenciado · multi-motor
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     vendas_gcp.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 Cloud SQL precisa

Motores
PostgreSQL, MySQL e SQL Server em uma única placa.
Endereço
O endereço IP privado ou público da instância, ou 127.0.0.1 por meio do Cloud SQL Auth Proxy — o Cloud SQL não possui um nome de host para apontar.
Portos
5432 PostgreSQL, 3306 MySQL, 1433 SQL Server — preenchidos previamente por mecanismo e verificados em relação ao mecanismo escolhido.
TLS
Ativado por padrão para conexões IP diretas; desativado é o correto através do Proxy de Autenticação, que criptografa seu próprio túnel.
Salvo como
O mecanismo que você escolheu, com Cloud SQL mantido como um selo — não existe um tipo de conexão chamado Cloud SQL.
Reconhecimento
Como não há nome de host, o indicador é gerado pela conexão criada neste cartão; uma conexão simples feita anteriormente à mesma instância não o exibirá retroativamente.
Permissões
Um usuário de banco de dados com SELECT no que você deseja ler
Rede
Somente saída do agente. Sem IP público, sem entradas de rede autorizadas, sem regra de entrada.

O Cloud SQL é o único serviço hospedado desta família que não possui nenhum identificador oculto. Todos os outros provedores gerenciados fornecem um nome de host com um sufixo reconhecível; o Cloud SQL fornece um endereço IP ou um endereço de loopback se você estiver usando o Proxy de Autenticação. Isso tem uma consequência importante que vale a pena mencionar: o identificador do Cloud SQL vem da criação da conexão neste cartão, portanto, uma conexão que você configurou anteriormente como PostgreSQL puro apontando para a mesma instância continuará sendo exibida como PostgreSQL puro. O funcionamento é idêntico em ambos os casos — apenas o rótulo difere.

Vale a pena optar pelo IP privado, mesmo que o IP público esteja disponível. Um agente em uma VM dentro da VPC elimina completamente a questão da conectividade: sem IP público na instância, sem redes autorizadas para manter, sem regra de entrada e sem endereço estático que alguém precise lembrar de atualizar. O agente se conecta; o Cloud SQL nunca precisa ser encontrado.

Para uma consulta entre fontes diferentes, o qualificador segue o mecanismo de busca, pois é assim que a conexão é salva. Uma conexão PostgreSQL no Cloud SQL chamada gcp_sales é escrita como gcp_sales.public.orders, e a mesma instância no SQL Server seria gcp_sales.dbo.orders — unindo-se a uma pasta de arquivos CSV, a um sistema de registro local ou a uma API de faturamento em uma única instrução somente leitura.

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

Perguntas frequentes

Perguntas sobre o Google Cloud SQL

Quais ferramentas conseguem ler dados do Google Cloud SQL 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 de firewall para meu banco de dados do Google Cloud SQL?

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 alterar dados com o Query Streams no Google Cloud SQL?

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 Cloud SQL?

Um host acessível, uma função e sua senha — o agente carrega o driver, portanto, nada é instalado no banco de dados. Mecanismos: PostgreSQL, MySQL e SQL Server em uma única placa. Endereço: o IP privado ou público da instância, ou 127.0.0.1 por meio do Cloud SQL Auth Proxy — o Cloud SQL não possui um nome de host para apontar. Portas: 5432 PostgreSQL, 3306 MySQL, 1433 SQL Server — preenchidas previamente por mecanismo e verificadas em relação ao mecanismo selecionado. TLS: ativado por padrão para conexões IP diretas; desativado é o correto por meio do Auth Proxy, que criptografa seu próprio túnel.

Posso combinar o Google Cloud SQL com outro banco de dados na mesma consulta?

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar o Google Cloud SQL 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 exibe os limites atuais de origem e tamanho.

Conectar-se ao Google Cloud SQL é diferente de conectar-se ao PostgreSQL?

Apenas a string de conexão. O Google Cloud SQL 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 do Cloud SQL preenche automaticamente as configurações de host, porta e SSL esperadas pelo provedor.

Existe algum guia de como migrar do Cloud SQL para o Excel?

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

Coloque o Cloud SQL 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.