Digite para filtrar os verbetes do Glossário.

    Banco de dados · Vibe Coding: Do Zero ao MVP

    O que é FDW?

    O FDW permite consultar fontes externas por tabelas estrangeiras no PostgreSQL. O conector traduz o acesso e depende da conexão e das permissões remotas.

    Também chamado de: foreign data wrapper

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    A tabela estrangeira dá acesso à fonte externa

    O FDW (foreign data wrapper) é uma biblioteca que permite ao PostgreSQL consultar uma fonte externa por meio de tabelas estrangeiras. Ele cuida da comunicação com a origem para que você use consultas SQL no banco local, mesmo quando os registros estão em outro servidor.

    A configuração liga a tabela estrangeira a um objeto de servidor externo, que reúne as opções de conexão aceitas pelo conector. Quando a origem exige autenticação, um mapeamento de usuário associa o papel local às credenciais remotas. A definição da tabela descreve as colunas disponíveis, sem guardar os registros no servidor local.

    Uma consulta de clientes em outro PostgreSQL

    Como exemplo didático, a tabela estrangeira clientes_remotos pode apontar para a tabela clientes de outro PostgreSQL por meio do postgres_fdw. Com essa configuração pronta, SELECT nome FROM clientes_remotos WHERE id = 42 solicita o nome do cliente de identificador 42. O conector executa o acesso remoto e devolve o resultado à consulta local.

    A consulta depende da conexão com a origem e das permissões da identidade remota, além da autorização local para ler a tabela estrangeira. Os tipos das colunas precisam ser compatíveis com os da origem para preservar a interpretação dos valores.

    O postgres_fdw permite alterar registros remotos, mas essa capacidade varia entre conectores. Uma leitura bem-sucedida confirma aquele acesso, enquanto uma atualização também exige autorização de escrita na origem.

    Dúvidas frequentes

    Perguntas frequentes sobre FDW

    A tabela estrangeira mantém uma cópia local dos registros?
    A tabela estrangeira não tem armazenamento próprio no servidor PostgreSQL. Sua definição descreve o conteúdo acessado pelo conector na fonte externa.
    Todo FDW permite inserir ou atualizar registros?
    O suporte varia entre conectores. O postgres_fdw permite essas operações em outro PostgreSQL quando a configuração e as permissões locais e remotas autorizam a escrita.
    Qual é a diferença entre FDW e chave estrangeira?
    O FDW conecta o PostgreSQL a uma fonte externa. A chave estrangeira exige correspondência entre os valores das colunas relacionadas para manter a integridade da relação.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao integrar bancos em uma aplicação, você precisa conferir quais consultas acessam outro servidor e quais permissões esse acesso utiliza.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano