Comando COPY en Azure Cosmos DB for PostgreSQL

Importante

Azure Cosmos DB para PostgreSQL ya no se admite para nuevos proyectos. No use este servicio para nuevos proyectos. En su lugar, use uno de estos dos servicios:

• Use Azure Cosmos DB para NoSQL para una solución de base de datos distribuida diseñada para escenarios a gran escala con un contrato de nivel de servicio (SLA) de disponibilidad 99.9% 99, escalabilidad automática instantánea y conmutación automática por error en varias regiones.

• Use la característica Clústeres elásticos de Azure Database For PostgreSQL para PostgreSQL particionado mediante la extensión Citus de código abierto.

El comando COPY se usa para mover datos entre archivos y tablas de base de datos. COPY es un comando basado en servidores que requiere acceso al disco, normalmente limitado a los administradores del servidor. Sin embargo, Azure Cosmos DB for PostgreSQL funciona como una solución de plataforma como servicio (PaaS), lo que significa que a los usuarios no se les concederán privilegios de superusuario. Por lo tanto, el comando COPY no es totalmente compatible con la plataforma.

Como alternativa, \COPY es un comando disponible en psql y otras interfaces de cliente, que facilita la interacción directa con el sistema de archivos local de la máquina donde se ejecute.

Compatibilidad con Azure Blob Storage

La extensión pg_azure_storage supera la limitación de acceso al disco aprovechando Azure Blob Storage como origen de datos. Cuando se habilita, la extensión también mejora el comando integrado COPY con la compatibilidad con Azure Blob Storage.

Cargar datos en la tabla github_users mediante el comando COPY:

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

Actualmente, la extensión admite los siguientes formatos de archivo:

format	description
csv	Formato de valores separados por comas usado por COPY de PostgreSQL
tsv	Valores separados por tabulaciones, el formato COPY predeterminado de PostgreSQL
binary	Formato COPY de PostgreSQL binario
text	Un archivo que contiene un único valor de texto (por ejemplo, JSON grande o XML)

Nota:

• La sintaxis y las opciones admitidas se mantienen de manera similar al comando COPY nativo de Postgres, con las siguientes excepciones:

  • FREEZE [ boolean ]
  • HEADER MATCH

• No se admite la sintaxis COPY TO.

• \COPY es un comando basado en psql y no admite la integración de Azure Blob Storage.

• \COPY permite realizar importaciones o exportaciones en el clúster, pero requiere mover o copiar archivos a través de la red.

Pasos siguientes

Obtenga más información sobre el uso de la extensión pg_azure_storage.

Referencia a las funciones azure_storage

Cómo ingerir datos mediante pg_azure_storage