Commande COPY sur Azure Cosmos DB for PostgreSQL

Important

Azure Cosmos DB pour PostgreSQL n’est plus pris en charge pour les nouveaux projets. N’utilisez pas ce service pour les nouveaux projets. Utilisez plutôt l’un des deux services suivants :

• Utilisez Azure Cosmos DB pour NoSQL pour une solution de base de données distribuée conçue pour des scénarios à grande échelle avec un contrat de niveau de service de disponibilité (SLA) de 99,999%, une mise à l’échelle automatique instantanée et un basculement automatique entre plusieurs régions.

• Utilisez la fonctionnalité Clusters élastiques d’Azure Database pour PostgreSQL pour PostgreSQL partitionné à l’aide de l’extension Citus open source.

Vous pouvez utiliser la commande COPY pour déplacer des données entre des fichiers et des tables de base de données. COPY est une commande basée sur le serveur qui nécessite l’accès au disque, généralement limitée aux administrateurs de serveur. Toutefois, Azure Cosmos DB for PostgreSQL fonctionne en tant que solution Platform-as-a-Service (PaaS), ce qui signifie que les utilisateurs ne disposent pas de privilèges superutilisateur. La commande COPY n’est par conséquent pas entièrement prise en charge sur la plateforme.

Autrement, \COPY est une commande disponible dans psql et d’autres interfaces clientes qui facilite l’interaction directe avec le système de fichiers local de la machine où elle est exécutée.

Prise en charge du Stockage Blob Azure

L’extension pg_azure_storage surmonte la limitation d’accès au disque en tirant parti de Stockage Blob Azure comme source de données. Lorsqu’elle est activée, l’extension améliore également la commande COPY intégrée avec la prise en charge de Stockage Blob Azure.

Charger des données dans une table github_users en utilisant la commande COPY :

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

Actuellement, l’extension prend en charge les formats de fichier suivants :

format	description
csv	Format sous forme de valeurs séparées par des virgules utilisé par PostgreSQL COPY
tsv	Valeurs séparées par des tabulations, format POSTGRESQL COPY par défaut
binary	Format PostgreSQL COPY binaire
text	Fichier contenant une valeur de texte unique (par exemple, un fichier JSON ou XML volumineux)

Notes

• La syntaxe et les options prises en charge restent identiques à la commande Postgres Native COPY, avec les exceptions suivantes :

  • FREEZE [ boolean ]
  • HEADER MATCH

• La syntaxe COPY TO n’est pas encore prise en charge.

• \COPY est une commande basée sur psql et ne prend pas en charge l’intégration de Stockage Blob Azure.

• \COPY permet d’effectuer l’importation/exportation sur le cluster, mais nécessite le déplacement/la copie des fichiers sur le réseau.

Étapes suivantes

Si vous souhaitez obtenir plus d’informations sur l’utilisation de l’extension pg_azure_storage.

Fonctions de référence azure_storage

Comment ingérer des données avec pg_azure_storage