Résumé
Inscrit les enregistrements d'une table, d'une vue tabulaire, d'une classe d'entités ou d'une couche d'entités en entrée dans une nouvelle table. Si une sélection est définie sur une classe d'entités ou sur une couche d'entités dans ArcMap, seuls les enregistrements sélectionnés sont copiés.
Utilisation
Tous les enregistrements sont copiés si l'entrée est une classe d'entités ou une table. Si les enregistrements en entrée appartiennent à une couche ou à une vue tabulaire qui comporte une sélection, seuls les entités ou les enregistrements sélectionnés sont utilisés.
Si les enregistrements en entrée sont une classe d'entités, seuls les attributs, et non pas la géométrie, sont copiés dans la table en sortie.
Cet outil prend en charge les formats tabulaires suivants en entrée :
- Géodatabase
- dBASE (.dbf)
- Valeurs séparées par des virgules (.csv)
- Texte séparé par des tabulations (.txt)
- feuilles de calcul Microsoft Excel (.xls ou .xlsx)
- INFO
- VPF
- base de données OLE
- Vues tabulaires en mémoire
Dans le cas d'une entrée de fichier (.csv ou .txt), 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 (tels que $ ou *). Vous recevrez une erreur si la première ligne du fichier en entrée contient des espaces ou des caractères spéciaux.
En savoir plus plus sur les formats tabulaires pris en charge dans ArcGIS
Pour ajouter les enregistrements copiés à une table existante, utilisez l'outil Ajouter.
La table en sortie peut être enregistrée dans une table dBASE, une géodatabase ArcSDE, une géodatabase fichier ou une géodatabase personnelle, ou en tant que table INFO.
Si la sortie est une table INFO, ni le chemin en sortie, ni le nom de la table ne peuvent comporter d'espaces.
Syntaxe
CopyRows_management (in_rows, out_table, {config_keyword})
Paramètre | Explication | Type de données |
in_rows | Enregistrements d'une classe d'entités, d'une couche, d'une table ou d'une vue tabulaire à copier. | Table View ; Raster Layer |
out_table | Table dans laquelle les enregistrements sont à copier. La table en sortie peut être enregistrée dans une table dBASE, une géodatabase ArcSDE, une géodatabase fichier ou une géodatabase personnelle, ou en tant que table INFO. Table dans laquelle les enregistrements sont à copier. La table en sortie peut être enregistrée dans une table dBASE, une géodatabase ArcSDE, une géodatabase fichier ou une géodatabase personnelle, ou en tant que table INFO. | Table |
config_keyword (Facultatif) | Le mot-clé de configuration spécifie les paramètres de stockage par défaut pour une Géodatabase ArcSDE. | String |
Exemple de code
Exemple 1 d'utilisation de l'outil CopyRows (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction CopyRows en mode immédiat.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CopyRows_management("vegtable.dbf", "C:/output/output.gdb/vegtable")
Exemple 2 d'utilisation de l'outil CopyRows (script autonome)
Le script autonome suivant montre comment utiliser la fonction CopyRows pour copier les tables d'un dossier dans une géodatabase fichier.
# Name: CopyRows_Example2.py
# Description: Convert all dBASE tables in a folder to geodatabase tables
# Requirement: os module
# Import system modules
import arcpy
from arcpy import env
import os
# Set environment settings
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()
# Execute CopyRows for each input table
for dbaseTable in tableList:
# Determine the new output feature class path and name
outTable = os.path.join(outWorkspace, dbaseTable.strip(".dbf"))
arcpy.CopyRows_management(dbaseTable, outTable)
Environnements
Informations de licence
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui