Logotipo do PlanetScale Postgres

Postgres gerenciado fala PostgreSQL

Conectar PlanetScale Postgres para Excel, Planilhas Google, IA e REST

PlanetScale Postgres, diretamente na porta 5432 ou através do PSBouncer na porta 6432. Este é o produto Postgres, não o Vitess.

Comece gratuitamente 13 destinos

Uma conexão, todas as superfícies

Para onde seus dados do PlanetScale podem ir.

PlanetScale Postgres mesas ao vivo · somente leitura
Consultas federadas + qualquer outro conector · um SQL de todas as fontes · todos os planos
Agente de rede
  • 1 conexão de saída
  • 0 portas de entrada
  • Somente leitura · credenciais permanecem inalteradas

funciona em

O Query Streams lê dados do PlanetScale Postgres a partir do Microsoft Excel, Google Sheets, Power BI, assistentes de IA via MCP e um endpoint REST através de uma única conexão somente leitura. Este cartão é específico para o PlanetScale Postgres — o produto mais recente em .horizon.psdb.cloud — e não para o serviço MySQL com suporte do Vitess, pelo qual o PlanetScale é mais conhecido. O cartão utiliza por padrão o PSBouncer na porta 6432, que é a porta esperada para a maioria dos bancos de dados PlanetScale Postgres, e o agente desativa instruções preparadas para se adequar a essa configuração.

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

  1. Para sua equipe, fornecedores e parceiros.

  2. PlanetScale para Excel Microsoft Excel · Suplemento do Excel

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

    Guia do PostgreSQL

  3. PlanetScale para Planilhas Google Suplemento de planilhas

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

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

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

    Publique uma consulta PlanetScale 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. PlanetScale 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 exibirá os resultados do PlanetScale em tempo real via HTTPS — sem driver ODBC, sem porta de banco de dados aberta.

    Como funciona o Power BI

  9. PlanetScale para Airtable Plataforma de automação

    Sincronize as linhas do PlanetScale 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. PlanetScale para Baserow Plataforma de automação

    Forneça dados de uma tabela Baserow do PlanetScale através do endpoint REST — hospedado localmente ou na nuvem Baserow.

    Guia do PostgreSQL

  11. PlanetScale para SeaTable Plataforma de automação

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

    Guia do PostgreSQL

  12. PlanetScale para Smartsheet Plataforma de automação

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

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

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

    Guia do PostgreSQL
  16. Entregue às pessoas

  17. Alertas e relatórios do PlanetScale Slack · Discord · E-mail · Webhook

    Programe uma consulta no PlanetScale para que os resultados sejam entregues 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 onde for mais conveniente. Ele abre uma conexão de saída e nunca fica em modo de escuta, portanto o PlanetScale vê apenas um cliente comum e sua rede não precisa de nenhuma regra de entrada.

02

Copie a string do banco de dados e, em seguida, conecte-se no console do PlanetScale e cole-a. Tanto o formato postgresql:// quanto o formato com a palavra-chave host= são lidos.

03

Deixe o modo PSBouncer Pool ativado, a menos que tenha um motivo para não fazê-lo — porta 6432 no mesmo host, que é para onde o PlanetScale aponta por padrão.

04

Verifique se o nome de usuário manteve o ponto. Os nomes de usuário do PlanetScale têm o formato postgres.<id-do-banco-de-dados>, e a parte após o ponto é o que direciona você para o banco de dados correto.

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 PlanetScale oferece

Este é o PlanetScale Postgres, não o PlanetScale MySQL.

A PlanetScale passou anos como a empresa Vitess, então vale a pena ser franco sobre a qual produto esta placa se conecta.

  • Este conector é para o PlanetScale Postgres. — o serviço Postgres gerenciado em .horizon.psdb.cloud. Ele utiliza o protocolo de comunicação Postgres e o agente se conecta a ele com o Npgsql.
  • Não é compatível com o serviço MySQL baseado em Vitess. Não existe uma configuração predefinida para isso, e uma string de conexão MySQL do PlanetScale não funcionará nesta placa.
  • A conexão é salva como PostgreSQL com PlanetScale como identificador. Não existe um tipo de conexão chamado PlanetScale. — o que também significa que uma conexão Postgres simples que você tenha feito anteriormente com um host .horizon.psdb.cloud exibirá a marca automaticamente.
  • Tudo o que vem depois é Postgres comum: esquemas, tipos e `public` como o esquema padrão em uma referência cruzada de código-fonte.

O PSBouncer é o padrão, e a porta é o que decide.

O PlanetScale executa seu servidor de pooling no mesmo hostname do endpoint direto, apenas na porta seguinte. A placa de rede direciona você para o servidor de pooling por padrão, pois é para lá que o PlanetScale aponta.

  • A porta direta é a 5432. PSBouncer — O pool de transações do PlanetScale — está na porta 6432 no mesmo host. Nada mais muda entre eles.
  • Na versão 6432, o agente desativa as instruções preparadas e para de reiniciar a sessão ao fechar. Um pool de transações pode fornecer um backend diferente entre as instruções, e um driver que assume o contrário falha de maneiras aparentemente aleatórias.
  • É a porta que causa isso, não o menu suspenso. O menu suspenso existe para que a placa possa impedir que as duas configurações entrem em conflito: selecionar "agrupado" com a porta errada ou "direto na porta 6432", e ela avisa antes de você salvar, em vez de depois da primeira falha inesperada.
  • Não há um nome de host separado para memorizar nem um segundo conjunto de credenciais. Altere a porta e pronto, a troca de portas está concluída.

O nome de usuário tem um ponto, e isso importa.

Dois dos quatro campos são fáceis de serem preenchidos com erros sutis, então o cartão verifica ambos.

  • Os nomes de usuário do PlanetScale têm o formato postgres.<id-do-banco-de-dados>. Se você colar um sem o ponto, o cartão irá impedi-lo, pois a parte após o ponto é o que seleciona o banco de dados.
  • Senhas com espaços em branco no início ou no final são sinalizadas. Trata-se de um artefato da área de transferência e é considerada um erro de autenticação comum, o que leva as pessoas a procurarem o problema errado.
  • Qualquer coisa que não seja uma string de conexão do Postgres é rejeitada com uma mensagem indicando onde a string correta está localizada, em vez de ser parcialmente interpretada e inserida em campos incorretos.
  • A sequência colada nunca é armazenada. Ela é lida uma única vez para preencher o formulário e depois descartada, portanto a senha fica armazenada em um único local, em vez de dois.
-- Postgres comum, somente leitura, via PSBouncer ou diretamente 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 PlanetScale ao restante dos seus dados.

Uma única instrução pode abranger o PlanetScale 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

PlanetScale Postgres Postgres gerenciado
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     aplicativo ps.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

Do que a PlanetScale precisa

Hospedar
<nome>.<região>.horizon.psdb.cloud
Porto
6432 para PSBouncer, 5432 direto. Mesmo host em ambos os casos — a placa usa 6432 por padrão.
Motorista
O Npgsql é fornecido pelo agente — nada precisa ser instalado no PlanetScale.
Nome de usuário
Pontilhado, como postgres.<id-do-banco-de-dados>. O cartão verifica se o ponto está presente.
TLS
Obrigatório e imposto pelo agente para cada host .horizon.psdb.cloud. Criptografado; a cadeia de certificados não é verificada.
Agrupamento
Na versão 6432, o agente desativa as instruções preparadas e ignora a reinicialização da sessão, que é o que um pool de transações precisa.
Salvo como
PostgreSQL, com PlanetScale mantido como um selo — não existe um tipo de conexão chamado PlanetScale.
Não este cartão
Serviço MySQL da PlanetScale com suporte do Vitess. Esta configuração predefinida é exclusiva para o produto Postgres.
Esquema padrão
público, que é o que uma referência federada carrega.

O detalhe do pool de transações é o que realmente importa. O PlanetScale coloca o PSBouncer em modo transacional, o que significa que a conexão que você mantém não está vinculada a um único backend — entre duas instruções, você pode ser redirecionado. Um driver do Postgres com suas configurações padrão assume o oposto: ele prepara as instruções uma vez e espera que elas ainda estejam lá na próxima vez, e redefine a sessão ao fechar. Contra um pool de transações, ambas as premissas falham, e falham intermitentemente, o que é a pior maneira possível de algo falhar. O agente desativa ambos quando detecta a porta 6432, então você não precisa se preocupar com nada disso.

Definir o limite do produto também não é pedantismo. A PlanetScale é famosa pelo Vitess, então alguém que chega aqui com uma string de conexão da PlanetScale em mãos pode muito bem ter uma do MySQL. Dizer claramente que este cartão é o serviço Postgres — e que o produto Vitess não possui nenhuma configuração predefinida — custa apenas uma frase e evita uma conversa com o suporte.

Para uma consulta entre fontes diferentes, o PlanetScale usa o Postgres comum. Uma conexão que você chamou de ps_app é escrita como ps_app.public.orders e se conecta 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 — sem nada copiado e nada agendado.

Documentação do fornecedor: planetscale.com

Perguntas frequentes

Perguntas sobre o PlanetScale Postgres

Quais ferramentas conseguem ler dados do PlanetScale Postgres 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 Postgres do PlanetScale?

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 recurso Query Streams no PlanetScale Postgres?

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 PlanetScale Postgres?

Um host acessível, uma função e sua senha — o agente carrega o driver, portanto, nada é instalado no banco de dados. Host: <nome>.<região>.horizon.psdb.cloud. Porta: 6432 para PSBouncer, 5432 direta. O host é o mesmo em ambos os casos — o cartão usa a porta 6432 por padrão. Driver: Npgsql, carregado pelo agente — nada para instalar no PlanetScale. Nome de usuário: com ponto, como postgres.<id-do-banco-de-dados>. O cartão verifica se o ponto está presente.

Posso fazer um join entre o PlanetScale Postgres e outro banco de dados na mesma consulta?

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar o PlanetScale Postgres 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 PlanetScale Postgres é diferente de conectar-se ao PostgreSQL?

Apenas a string de conexão. O PlanetScale Postgres 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 PlanetScale preenche automaticamente as configurações de host, porta e SSL que o provedor espera.

Existe algum guia para converter PlanetScale para Excel?

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

Instale o PlanetScale onde o trabalho acontece.

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

Comece gratuitamente Todos os conectores

Somente leitura Apenas envio As credenciais permanecem com o agente.