Tous les produits
Search
Centre de documentation

AnalyticDB:Importer des données locales à l'aide de la commande COPY

Dernière mise à jour :Aug 10, 2026

Utilisez la commande \copy dans l'interface de ligne de commande (CLI) psql pour importer directement des fichiers texte locaux dans une instance AnalyticDB for PostgreSQL, sans accès aux fichiers côté serveur.

Important

La commande \copy écrit les données de manière séquentielle via le nœud coordinateur. Elle convient aux ensembles de données de petite et moyenne taille, mais ne permet pas les importations parallèles à grande échelle. Pour charger de grands volumes de données, privilégiez les tables externes basées sur OSS. Consultez la rubrique Use an external table to import data from OSS.

Quand utiliser \copy plutôt que COPY

Bien que ces deux commandes partagent la même syntaxe (voir COPY/ dans la documentation PostgreSQL), elles s'exécutent dans des contextes différents.

La commande \copy s'exécute au niveau du client psql et lit les fichiers depuis votre machine locale. L'accès aux fichiers et les permissions relèvent de l'utilisateur local, et non du serveur de base de données. Aucun privilège SUPERUSER n'est donc requis. AnalyticDB for PostgreSQL n'accordant pas l'autorisation SUPERUSER, la commande COPY côté serveur avec l'option FILE est indisponible ; utilisez \copy à la place.

**\copy** **COPY**
S'exécute dans Client psql Serveur de base de données
Lit les fichiers depuis Machine locale Système de fichiers du serveur
Requiert SUPERUSER Non Oui (pour l'accès FILE)
Gère FILE, STDIN, STDOUT STDIN, STDOUT uniquement

Prérequis

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

  • psql installé et connecté à votre instance AnalyticDB for PostgreSQL

  • Un fichier texte local à importer

  • Les autorisations d'écriture sur la table cible

Importer un fichier local

Exécutez la commande \copy dans votre session psql pour charger le fichier dans une table :

\COPY table [(column [, ...])] FROM {'file' | STDIN}
[ [WITH]
  [OIDS]
  [HEADER]
  [DELIMITER [ AS ] 'delimiter']
  [NULL [ AS ] 'null string']
  [ESCAPE [ AS ] 'escape' | 'OFF']
  [NEWLINE [ AS ] 'LF' | 'CR' | 'CRLF']
  [CSV [QUOTE [ AS ] 'quote']
  [FORCE NOT NULL column [, ...]]
  [FILL MISSING FIELDS]
  [[LOG ERRORS [INTO error_table] [KEEP]
  SEGMENT REJECT LIMIT count [ROWS | PERCENT] ]

Exemple : Importez toutes les lignes d'un fichier local dans une table nommée test1.

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

Vérifier l'importation

Après avoir exécuté \copy, vérifiez que les données ont été chargées correctement :

SELECT COUNT(*) FROM test1;

Si le nombre de lignes correspond à celui de votre fichier source, l'importation est terminée.

Si vous avez utilisé l'option LOG ERRORS, interrogez la table des erreurs pour examiner les lignes rejetées :

SELECT * FROM error_table;

Utiliser JDBC au lieu de psql

Pour importer des données par programmation, utilisez Java Database Connectivity (JDBC). Le pilote JDBC PostgreSQL expose l'interface CopyIn, qui encapsule l'instruction COPY. Consultez Interface CopyIn/ dans la documentation JDBC PostgreSQL.

Étapes suivantes