Tous les produits
Search
Centre de documentation

AnalyticDB:Use the copy command to export data to your computer

Dernière mise à jour :Aug 10, 2026

La commande \copy dans psql vous permet d'exporter les données d'une instance AnalyticDB for PostgreSQL directement vers un fichier sur votre ordinateur local, sans nécessiter de privilèges SUPERUSER.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

  • Une instance AnalyticDB for PostgreSQL en cours d'exécution

  • psql installé et configuré pour se connecter à votre instance (voir Connexion du client)

Data Management (DMS) ne prend pas en charge la commande \copy . Utilisez psql pour exécuter \copy .

Fonctionnement

\copy est une méta-commande psql qui exécute la commande SQL sous-jacente COPY mais achemine les données via le client plutôt que par le serveur. Au lieu que le serveur lise ou écrive le fichier spécifié, psql lit ou écrit le fichier et fait transiter les données entre le serveur et le système de fichiers local. Cela signifie que l'accès aux fichiers et les permissions sont contrôlés par l'utilisateur local, et non par le serveur de base de données ; aucune permission SUPERUSER n'est donc requise.

Différences entre \copy et COPY :

**\copy** **COPY**
Lieu d'exécution Client psql Serveur de base de données
Accès aux fichiers Système de fichiers local (FILE, STDIN, STDOUT) STDIN et STDOUT uniquement
SUPERUSER requis Non Oui (pour l'accès FILE)
AnalyticDB for PostgreSQL ne prend pas en charge la permission SUPERUSER. Utilisez \copy pour exporter les données vers des fichiers locaux.

Syntaxe

\COPY {table [(column [, ...])] | (query)} TO {'file' | STDOUT}
    [ [WITH] [OIDS] [HEADER]
      [DELIMITER [ AS ] 'delimiter']
      [NULL [ AS ] 'null string']
      [ESCAPE [ AS ] 'escape' | 'OFF']
      [CSV [QUOTE [ AS ] 'quote']
           [FORCE QUOTE column [, ...]] ]
      [IGNORE EXTERNAL PARTITIONS ] ]

où les options WITH sont :

Option Description
OIDS Inclure les OID pour chaque ligne
HEADER Inclure une ligne d'en-tête avec les noms des colonnes (format CSV uniquement)
DELIMITER 'delimiter' Caractère séparant les colonnes, par exemple ,
NULL 'null string' Chaîne représentant les valeurs nulles, par exemple \N
ESCAPE 'escape' Caractère d'échappement pour la sortie CSV
CSV Utiliser le format CSV
QUOTE 'quote' Caractère de guillemet pour le format CSV
FORCE QUOTE column Forcer l'utilisation de guillemets pour les colonnes spécifiées dans la sortie CSV
IGNORE EXTERNAL PARTITIONS Ignorer les partitions externes lors de l'exportation

Pour la référence complète de la syntaxe, consultez COPY dans la documentation PostgreSQL.

AnalyticDB for PostgreSQL prend également en charge l'exécution de l'instruction COPY via JDBC. La méthode CopyIn est encapsulée dans JDBC. Pour plus de détails, consultez Interface CopyIn .

Exportation des données vers un fichier local

Connectez-vous à votre instance à l'aide de psql, puis exécutez \copy pour exporter une table ou le résultat d'une requête vers un fichier local.

Exporter une table entière :

\COPY test1 TO '/path/to/localfile';

Exporter au format CSV avec un délimiteur personnalisé :

\COPY test1 TO '/path/to/localfile.csv' WITH CSV DELIMITER ',';

Exporter les résultats d'une requête :

\COPY (SELECT id, name FROM test1 WHERE status = 'active') TO '/path/to/output.csv' WITH CSV HEADER;

Remplacez les espaces réservés suivants par vos valeurs réelles :

Espace réservé Description Exemple
test1 Nom de la table à exporter orders
/path/to/localfile Chemin absolu vers le fichier de sortie sur votre machine locale /home/user/export.csv

Étapes suivantes