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'instructionCOPYvia JDBC. La méthodeCopyInest 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 |