Copier des enregistrements (Outils de gestion des données)

Résumé

Copie les enregistrements d’une table vers une autre table.

Utilisation

L’outil copie les lignes d’une table, d’une vue tabulaire, d’une classe d’entités, d’une couche d’entités, d’un fichier délimité ou d’un raster avec une table attributaire dans une nouvelle géodatabase, une table dBASE ou un fichier délimité.

Cet outil prend en charge les formats tabulaires suivants en entrée :
- Géodatabase
- dBASE (.dbf)
- Feuilles de calcul Microsoft Excel (.xls et .xlsx)
- Tables en mémoire
- Fichiers délimités
  - Fichiers délimités par des virgules (.csv, .txt et .asc)
  - Fichiers délimités par des tabulations (.tsv et .tab)
  - Fichiers délimités par des barres verticales (.psv)
Dans le cas des fichiers délimités, la première ligne du fichier en entrée est utilisée comme nom des champs de la table en sortie. Les noms de champ ne peuvent pas contenir d’espaces ou de caractères spéciaux ($ ou *, par exemple) et une erreur se produit si la première ligne du fichier en entrée contient des espaces ou des caractères spéciaux.

L’outil peut être utilisé pour générer un fichier délimité en ajoutant l’une des extensions de fichier suivantes au nom en sortie dans l’espace de travail de dossier :
- Fichiers délimités par des virgules (.csv, .txt ou .asc)
- Fichiers délimités par des tabulations (.tsv ou .tab)
- Fichiers délimités par des barres verticales (.psv)

Si l’entrée est une vue tabulaire ou une couche d’entités et comporte une sélection, seuls les enregistrements sélectionnés sont copiés vers la table en sortie.
Tous les enregistrements sont copiés si l’entrée est une classe d’entités ou une table. Si les lignes en entrée appartiennent à une couche ou à une vue tabulaire qui comporte une sélection, seules les entités ou les lignes sélectionnées sont utilisées.
Si la valeur du paramètre Input Rows (Enregistrements en entrée) est une classe d’entités, seuls les attributs, et non la géométrie, sont copiés dans la table en sortie.
Pour ajouter les enregistrements copiés à une table existante, utilisez l’outil Add (Ajouter).

Etiqueter Explication Type de données

Etiqueter	Explication	Type de données
Enregistrements en entrée	Lignes en entrée à copier dans une nouvelle table.	Table View; Raster Layer
Table en sortie	Table qui sera créée et dans laquelle les lignes de l’entrée seront copiées. Si la table en sortie se trouve dans un dossier, précisez une extension, telle que `.csv`, `.txt` ou `.dbf`, pour que la table soit au format spécifié. Si la table en sortie se trouve dans une géodatabase, ne précisez pas d’extension.	Table
Mot-clé de configuration (Facultatif)	Paramètres de stockage par défaut pour une géodatabase d’entreprise.	String

Enregistrements en entrée

Lignes en entrée à copier dans une nouvelle table.

Table View; Raster Layer

Table en sortie

Table qui sera créée et dans laquelle les lignes de l’entrée seront copiées.

Si la table en sortie se trouve dans un dossier, précisez une extension, telle que .csv, .txt ou .dbf, pour que la table soit au format spécifié. Si la table en sortie se trouve dans une géodatabase, ne précisez pas d’extension.

Table

Mot-clé de configuration

(Facultatif)

Paramètres de stockage par défaut pour une géodatabase d’entreprise.

String

arcpy.management.CopyRows(in_rows, out_table, {config_keyword})

Nom Explication Type de données

Nom	Explication	Type de données
in_rows	Lignes en entrée à copier dans une nouvelle table.	Table View; Raster Layer
out_table	Table qui sera créée et dans laquelle les lignes de l’entrée seront copiées. Si la table en sortie se trouve dans un dossier, précisez une extension, telle que `.csv`, `.txt` ou `.dbf`, pour que la table soit au format spécifié. Si la table en sortie se trouve dans une géodatabase, ne précisez pas d’extension.	Table
config_keyword (Facultatif)	Paramètres de stockage par défaut pour une géodatabase d’entreprise.	String

in_rows

Lignes en entrée à copier dans une nouvelle table.

Table View; Raster Layer

out_table

Table qui sera créée et dans laquelle les lignes de l’entrée seront copiées.

Table

config_keyword

(Facultatif)

Paramètres de stockage par défaut pour une géodatabase d’entreprise.

String

Exemple de code

Exemple 1 d’utilisation de l’outil CopyRows (fenêtre Python)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction CopyRows en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.CopyRows("vegtable.dbf", "C:/output/output.gdb/vegtable")

Exemple 2 d’utilisation de l’outil CopyRows (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction CopyRows pour copier les tables d’un dossier dans une géodatabase fichier.

# Description: Convert all dBASE tables in a folder to geodatabase tables
# Requirement: os module

# Import system modules
import arcpy
import os

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
outWorkspace = "c:/output/output.gdb"

# Use ListTables to generate a list of dBASE tables in the
#  workspace shown above.
tableList = arcpy.ListTables()

# Run CopyRows for each input table
for dbaseTable in tableList:
    # Determine the new output feature class path and name
    outTable = os.path.join(outWorkspace, os.path.splitext(dbaseTable)[0])
    arcpy.management.CopyRows(dbaseTable, outTable)

Environnements

Espace de travail courant, Mot-clé CONFIG en sortie, Conserver les pièces jointes, Espace de travail temporaire, Etendue, Conserver les ID globaux

Informations de licence