Pular para o conteúdo principal

Importar dados (dumps)

A importação de dados carrega um dump num banco gerenciado do ambiente. O arquivo vai do seu computador direto para o armazenamento temporário da plataforma (o portal e a CLI enviam em partes e retomam um envio interrompido), é validado antes de tocar no banco e, só então, restaurado com a credencial da aplicação. Antes da restauração a plataforma faz um backup do banco de destino.

Formatos​

BancoFormatos
PostgreSQLpg_dump -Fc (custom), -Ft (tar), diretório em .tar, SQL puro
MySQLSQL do mysqldump
Banco de documentosarchive do mongodump --archive

Todos aceitam compressão gzip. O tamanho máximo depende do plano (imports.maxDataImportGiB), e uma importação por banco pode estar ativa de cada vez.

O que a validação recusa​

A restauração roda como o usuário da aplicação, nunca como superusuário. A validação lê o dump e recusa, com a linha do problema, o que esse usuário não pode fazer: COPY ... FROM PROGRAM, criação de funções em linguagens não confiáveis, ALTER SYSTEM, papéis e permissões globais e extensões fora da lista permitida. Proprietários e permissões do dump são ignorados (--no-owner --no-privileges).

Pelo portal​

Na aba Importar dados do banco:

  1. Escolha Enviar arquivo ou Baixar de uma URL (HTTPS, sem parâmetros de assinatura; endereços privados são recusados).
  2. Informe o formato e, se quiser, o SHA-256 esperado.
  3. Acompanhe a validação. O relatório lista tabelas, extensões e avisos.
  4. Clique em Restaurar. Se o banco já tiver dados, digite o nome do banco para confirmar.

Pela CLI​

coda db import --node db --file dump.pgcustom --format PG_CUSTOM --wait             # envia e valida
coda db import --node db --file dump.pgcustom --format PG_CUSTOM --wait --restore   # e restaura em seguida
coda db import --node db --url https://exemplo.com/dump.sql.gz --format PG_SQL --compression GZIP

O envio é feito em partes de 64 MiB; se a conexão cair, --resume <importação> continua de onde parou. Para o assistente de IA, start_data_import aceita só URL ou uma importação já enviada pelo portal ou pela CLI.

Depois da restauração​

O arquivo é apagado do armazenamento temporário assim que a importação termina (ou em até 48 horas, se o envio for abandonado). O backup feito antes da restauração fica disponível na aba de backups do banco pelo período de retenção do plano.