Logotipo Xata

Postgres sem servidor fala PostgreSQL

Conectar Xata para Excel, Planilhas Google, IA e REST

O Xata Postgres utiliza o protocolo de rede, com endereçamento por banco de dados e branch. Cole a string do console do Xata e a branch digitada será a branch exibida.

Uma conexão, todas as superfícies

Para onde seus dados Xata podem ir

O Query Streams lê dados Xata 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. O Xata utiliza o protocolo de comunicação do Postgres, portanto, o agente se conecta a ele com o Npgsql exatamente como faria com qualquer outro Postgres. Uma diferença fundamental está no campo Database, que utiliza uma rota database:branch em vez de um nome simples. Além disso, o Xata é o único conector na plataforma cujo nome do banco de dados é transmitido com a capitalização intacta. O TLS é obrigatório para todos os hosts .sql.xata.sh, independentemente da configuração selecionada na caixa de seleção.

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

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

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

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

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

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

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

    Compartilhe um resultado Xata 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 da Xata endpoint HTTP

    Publique uma consulta Xata 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. Xata 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 Xata em tempo real via HTTPS — sem driver ODBC, sem porta de banco de dados aberta.

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

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

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

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

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

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

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

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

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

    Programe uma consulta Xata 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 não há regra de entrada e nenhuma informação sobre o banco de dados fica exposta.

02

Cole a string de conexão do console Xata. Host, porta, ID do espaço de trabalho, chave da API e a rota database:branch são todos lidos dela.

03

Verifique se o campo Database contém o seguinte: database:branch — mydb:main, por exemplo. Um nome simples, sem os dois pontos, é aceito e indica implicitamente a branch padrão.

04

Lembre-se de qual credencial é qual: o nome de usuário é o ID do seu espaço de trabalho e a senha é uma chave de API, não a senha da sua conta.

05

Salvar. O Microsoft Excel, o Google Sheets, o Power BI, o MCP e a API REST leem a ramificação por meio dessa única conexão ou a combinam com suas outras fontes em uma única instrução somente leitura.

Análise detalhada do recurso

O que a Xata te oferece

O campo "Database" é uma rota, não um nome.

Em todos os outros conectores do Postgres, o campo Database contém um identificador, e o Query Streams o converte para minúsculas durante a transmissão, pois é assim que o Postgres lida com nomes sem aspas. No Xata, isso seria um erro, portanto, essa é a única instância em que a regra está desativada.

  • O valor é um par banco de dados:ramificação — mydb:main — que o Xata resolve como uma rota. Não é um identificador do Postgres e não segue as regras de refinamento de identificadores.
  • Um ramo chamado Feature-X mantém seu F maiúsculo e seu X maiúsculo. Ao ser convertido para minúsculas, Feature-X, ele deixa de ser resolvido, razão pela qual Xata é o único conector isento da normalização.
  • Remova os dois pontos e a conexão ainda funcionará. — ele acaba no branch padrão. O cartão destaca isso em vez de deixar passar silenciosamente, porque acabar no branch principal quando se pretendia um branch de recurso produz números aparentemente corretos a partir de dados incorretos.
  • Nenhuma outra informação sobre o nome é verificada. O Query Streams repassa a rota exatamente como você a digitou e deixa que o Xata decida se ela será resolvida.

O que o agente faz com um host Xata

Dois comportamentos estão associados ao sufixo .sql.xata.sh, e nenhum deles pode ser configurado por você.

  • O TLS é obrigatório, não opcional. Qualquer host .sql.xata.sh se conecta com criptografia ativada, independentemente da caixa "Usar SSL", portanto, uma string que perdeu seu modo SSL na área de transferência ainda será transmitida criptografada.
  • A conexão é criptografada, mas a cadeia de certificados não é verificada. Essa é a descrição precisa da situação, e é a mesma em todos os provedores de hospedagem reconhecidos pelo Query Streams.
  • Não há nenhum pooler no caminho. Alguns serviços Postgres sem servidor colocam um pooler de modo transacional na frente e precisam que as instruções preparadas sejam bloqueadas para funcionar; o Xata não faz isso, então o agente se conecta diretamente e ignora tudo isso.
  • A conexão é salva como PostgreSQL com Xata como identificador. Não existe um tipo de conexão chamado Xata. — o que também significa que uma conexão Postgres simples que você tenha feito anteriormente com o mesmo host exibirá a marca Xata imediatamente.

Cole o texto em vez de digitá-lo novamente.

Quatro credenciais, duas das quais são fáceis de confundir e uma que é longa o suficiente para ser digitada incorretamente. O cartão é baseado na colagem da sequência de caracteres e na captura do restante.

  • O URI postgresql:// do console está no formato esperado. O formato de palavra-chave host= do libpq também é analisado corretamente.
  • Qualquer string de conexão que não seja do Postgres será rejeitada com uma mensagem informando onde a string correta está localizada, em vez de ser parcialmente interpretada e inserida em campos incorretos.
  • Uma chave de API com espaços em branco no início ou no final é sinalizada. 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.
  • O ID do espaço de trabalho vai no campo de nome de usuário e a chave da API vai no campo de senha. O cartão os identifica dessa forma, em vez de simplesmente dizer "Nome de usuário" e "Senha" e deixar você adivinhar.
-- Postgres comum, somente leitura, contra qualquer branch que você apontou 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 Xata ao restante dos seus dados.

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

3 conexões · 3 agentes

Xata Postgres sem servidor
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     xata_app.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 Xata precisa

Hospedar
<region>.sql.xata.sh
Porto
5432
Motorista
Npgsql, incluído no agente — nada a instalar no Xata.
Banco de dados
Uma rota database:branch, como mydb:main. Passada com a capitalização intacta — o único conector onde isso é verdade.
Nome de usuário
Seu ID de espaço de trabalho, não um nome de conta.
Senha
Uma chave de API, não a senha da sua conta.
TLS
Obrigatório e imposto pelo agente para cada host .sql.xata.sh. Criptografado; a cadeia de certificados não é verificada.
Agrupamento
Nenhuma — o Xata não precisa de um ponto de extremidade agrupado, portanto o agente se conecta diretamente.
Salvo como
PostgreSQL, com Xata mantido como um emblema — não existe um tipo de conexão chamado Xata.
Esquema padrão
público, que é o que uma referência federada carrega.

A regra de capitalização é o principal motivo da existência deste cartão, em vez de simplesmente direcionar as pessoas para o cartão padrão do PostgreSQL. O Query Streams converte os nomes de bancos de dados do Postgres para minúsculas durante a consulta, o que é correto em todos os outros casos — um identificador sem aspas é convertido para minúsculas no Postgres, portanto, preservar o que alguém digitou só criaria confusão. O campo Database do Xata não é um identificador. É uma rota composta por um banco de dados e uma ramificação unidos por dois pontos, e o Xata lê a parte da ramificação literalmente. Se a ramificação for convertida para minúsculas, um nome chamado Feature-X se torna feature-x e para de ser resolvido. Portanto, o Xata está isento dessa regra, sendo o único conector na plataforma que a possui.

A falha que a isenção previne é grave, pois não se parece com uma falha. O roteamento de ramificações que dá errado geralmente não gera um erro — ele simplesmente leva você a algum lugar. Uma consulta na ramificação errada retorna linhas, e elas parecem dados, e nada no resultado indica que você está lendo o esquema do mês passado em vez do desta semana. O mesmo raciocínio explica por que um nome de banco de dados sem dois pontos é sinalizado: funciona, significa silenciosamente a ramificação padrão, e uma planilha cheia de "main" quando você queria uma ramificação de recurso é pior do que uma mensagem de erro.

Para uma consulta entre fontes diferentes, o Xata é um Postgres comum. Uma conexão que você chamou de xata_app é escrita como xata_app.public.orders e realiza um join 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. O branch escolhido na conexão é o branch que o join lê.

Documentação do fornecedor: xata.io

Perguntas frequentes

Perguntas sobre Xata

Quais ferramentas conseguem ler dados Xata 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 Xata?

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 em fluxos de consulta no Xata?

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 Xata?

Um host acessível, uma função e sua senha — o agente carrega o driver, portanto nada é instalado no banco de dados. Host: <região>.sql.xata.sh. Porta: 5432. Driver: Npgsql, carregado pelo agente — nada para instalar no Xata. Banco de dados: Uma rota banco de dados:ramificação, como mydb:main. Passado com a capitalização intacta — o único conector onde isso é verdade.

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

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar o Xata 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 — SELECT, WITH e EXPLAIN apenas — 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 Xata é diferente de conectar-se ao PostgreSQL?

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

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

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

Coloque o Xata 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.