Résumé
Exporte les lignes d’une table, d’une vue tabulaire, d’une couche d’entités, d’une classe d’entités ou d’un raster avec une table attributaire dans une nouvelle géodatabase, une table .csv, .txt ou .dbf.
Utilisation
Cet outil prend en charge les formats tabulaires suivants en entrée :
- Géodatabase
- dBASE (.dbf)
- Valeurs séparées par des virgules (.csv ou .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
Tous les champs du jeu de données en sortie et leur contenu peuvent être gérés à l’aide de l’appariement des champs.
- Vous pouvez modifier l’ordre des champs en cliquant sur le nom d’un champ et en le faisant glisser vers la position de votre choix.
- Le type de données d’un champ en sortie possède par défaut la même valeur que le type de données du premier champ en entrée (du même nom) qu’il rencontre. Vous pouvez à tout moment modifier manuellement ce type de données en type de données valide.
- Plusieurs règles de combinaison sont disponibles : premier, dernier, jointure, somme, moyenne, médiane, mode, minimum, écart type et totaux.
- Lors de l’utilisation d’une règle de fusion Join (Jointure), vous pouvez spécifier votre propre délimiteur, comme un espace, une virgule, un point, un tiret, etc. Pour utiliser un espace, vérifiez que le pointeur de votre souris se trouve au début de la zone de saisie et cliquez une fois sur la barre d'espacement.
- Vous pouvez spécifier les positions de début et de fin des champs de texte à l'aide de l'option de format.
- L'écart type ne doit pas être exécuté sur une entrée unique. En effet, les valeurs ne pouvant pas être divisées par zéro, l'écart type n'est pas une option valide pour les entrées uniques.
Lors de la conversion en une table dBASE de données de géodatabase qui présentent des sous-types ou des domaines , les codes de domaine et de sous-type, ainsi que les descriptions, peuvent figurer dans la sortie. Utilisez l'environnement de géotraitement Transfert des descriptions de domaine de champ pour contrôler ce comportement. Par défaut, seuls les codes de domaine et de sous-type sont inclus dans la sortie, mais pas les descriptions.
Syntaxe
arcpy.conversion.TableToTable(in_rows, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})
Paramètre | Explication | Type de données |
in_rows | Table en entrée à exporter dans une nouvelle table. | Table View; Raster Layer |
out_path | Destination pour l'enregistrement de la table en sortie. | Workspace; Feature Dataset |
out_name | Le nom de la table en sortie. Si l’emplacement en sortie est un dossier, précisez une extension, telle que .csv, .txt ou .dbf, pour exporter la table dans ce format. Si l’emplacement en sortie est une géodatabase, ne précisez pas d’extension. | String |
where_clause (Facultatif) | Expression SQL permettant de sélectionner un sous-ensemble d'enregistrements. Pour en savoir plus sur les expressions de requête SQL | SQL Expression |
field_mapping (Facultatif) | Champs et contenus de champ choisis dans la table en entrée. Vous pouvez ajouter, renommer ou supprimer des champs en sortie et définir des propriétés telles que le type de données et la règle de fusion. En savoir plus sur le choix et la définition des champs en sortie Vous pouvez utiliser l'objet ArcPy FieldMappings pour ce paramètre. | Field Mappings |
config_keyword (Facultatif) | Spécifie les paramètres de stockage par défaut (configuration) des géodatabases d'un SGBDR (système de gestion de bases de données relationnelles). Ce paramètre est applicable uniquement dans le cas de tables de géodatabase d'entreprise. Les mots-clés de configuration sont définis par l'administrateur de base de données. | String |
Sortie dérivée
Nom | Explication | Type de données |
out_table | Table en sortie. | Tableau |
Exemple de code
Exemple 1 d'utilisation de l'outil TableToTable (fenêtre Python)
Le script de fenêtre Python suivant montre comment utiliser l'outil TableToTable en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.TableToTable_conversion("vegtable.dbf", "C:/output/output.gdb", "vegtable")
Exemple 2 d'utilisation de l'outil TableToTable (script Python autonome)
Le script autonome suivant illustre l'utilisation de l'outil TableToTable.
# Description: Use TableToTable with an expression to create a subset
# of the original table.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inTable = "vegtable.dbf"
outLocation = "C:/output/output.gdb"
outTable = "estuarine"
# Set the expression, with help from the AddFieldDelimiters function, to select
# the appropriate field delimiters for the data type
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "VEG_TYPE") + " = 'Estuarine'"
# Execute TableToTable
arcpy.TableToTable_conversion(inTable, outLocation, outTable, expression)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui