Comando COPY no Azure Cosmos DB for PostgreSQL

Importante

O Azure Cosmos DB para PostgreSQL não tem mais suporte para novos projetos. Não use esse serviço para novos projetos. Em vez disso, use um destes dois serviços:

• Use o Azure Cosmos DB para NoSQL para uma solução de banco de dados distribuída projetada para cenários de alta escala com um SLA (contrato de nível de serviço de disponibilidade) de 99,999%, dimensionamento automático instantâneo e failover automático em várias regiões.

• Use o recurso Clusters Elásticos do Banco de Dados do Azure para PostgreSQL para PostgreSQL fragmentado usando a extensão de código aberto Citus.

O comando COPY é usado para mover dados entre arquivos e tabelas de banco de dados. COPY é um comando baseado no servidor que exige acesso ao disco, geralmente limitado aos administradores do servidor. Entretanto, o Azure Cosmos DB for PostgreSQL opera como uma solução PaaS (Plataforma como Serviço), o que significa que os usuários não recebem privilégios de superusuário. Portanto, o comando COPY não é totalmente compatível com a plataforma.

Como alternativa, \COPY é um comando disponível em psql e em outras interfaces do cliente o que facilita a interação direta com o sistema de arquivos local da máquina em que ele é executado.

Suporte para o Armazenamento de Blobs do Azure

A extensão pg_azure_storage supera a limitação de acesso ao disco, aproveitando o Armazenamento de Blobs do Azure como uma fonte de dados. Quando habilitada, a extensão também melhora o comando COPY interno com suporte para o Armazenamento de Blobs do Azure.

Carregue os dados na tabela github_users usando o comando COPY:

COPY github_users
FROM 'https://pgquickstart.blob.core.windows.net/github/users.csv.gz';

Atualmente, a extensão dá suporte aos seguintes formatos de arquivo:

format	descrição
csv	Formato de valores separados por vírgula usado pelo PostgreSQL COPY
tsv	Valores separados por tabulação, o formato PostgreSQL COPY
binário	Formato PostgreSQL COPY binário
enviar SMS	Um arquivo que contém um único valor de texto (por exemplo, JSON ou XML grande)

Observação

• A sintaxe e as opções suportadas permanecem igualmente no comando COPY do Postgres Native, com as seguintes exceções:

  • FREEZE [ boolean ]
  • HEADER MATCH

• A sintaxe COPY TO ainda não é suportada.

• \COPY é um comando baseado em psql e não tem suporte para a integração do Armazenamento de Blobs do Azure.

• \COPY permite executar a importação/exportação no cluster, mas exige a movimentação/cópia de arquivos pela rede.

Próximas etapas

Saiba mais sobre o uso da extensão pg_azure_storage.

Referência das funções do azure_storage

Como ingerir dados usando pg_azure_storage