Étiquette | Explication | Type de données |
Table en entrée | Table en entrée contenant les lignes à exporter dans une nouvelle table. | Table View; Raster Layer |
Table en sortie | Table en sortie contenant les lignes exportées. 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, respectivement. Si l’emplacement en sortie est une géodatabase, ne précisez pas d’extension. | Table |
Expression (Facultatif) | Expression SQL permettant de sélectionner un sous-ensemble d’enregistrements. | SQL Expression |
Utiliser l’alias de champ comme nom | Indique si les noms ou alias de champ en entrée seront utilisés comme nom de champ en sortie.
| Boolean |
Appariement des champs (Facultatif) | Les champs attributaires qui figurent dans la sortie avec les propriétés de champ correspondantes et les champs source. Par défaut, tous les champs des entrées seront inclus. Il est possible d’ajouter, de supprimer, de renommer, de réorganiser les champs, ainsi que de modifier leurs propriétés. Les règles de combinaison permettent de spécifier la manière dont les valeurs de deux champs en entrée ou plus sont combinées ou fusionnées en une seule valeur en sortie. Les règles de combinaison suivantes permettent de déterminer de quelle manière sont renseignées les valeurs du champ en sortie :
| Field Mappings |
Champ de tri (Facultatif) | Le ou les champs dont les valeurs vont servir à réorganiser les enregistrements en entrée et le sens de tri des enregistrements.
| Value Table |
Synthèse
Exporte les lignes d’une table ou vue tabulaire vers une 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él.csvim.txtité.ascs
- 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 une virgule (.csv, .txt ou .asc)
- Fichiers délimités par des tabulations (.tsv ou .tab)
- Fichiers délimités par des barres verticales (.psv)
Si la sortie ne se trouve pas dans une géodatabase, les champs BLOB ou raster ne seront pas inclus. Les champs GlobalID seront convertis en champs de texte.
Pour gérer les champs dans le jeu de données en sortie, ainsi que le contenu de ces champs, utilisez le paramètre Appariement des champs.
- Pour modifier l’ordre des champs, sélectionnez un nom de champ et faites-le glisser jusqu’à la nouvelle position.
- Le type de données par défaut d’un champ en sortie est identique au type de données du premier champ en entrée (du même nom) qu’il rencontre. Vous pouvez à tout moment changer manuellement le type de données pour tout autre type de données valide.
- Les règles de combinaison disponibles sont : premier, dernier, joindre, somme, moyenne, médiane, mode, minimum, maximum, écart type, et total.
- Lorsque vous utilisez la règle de combinaison Join (Joindre), vous pouvez spécifier un délimiteur (espace, virgule, point, tiret, etc.). Pour utiliser un espace, vérifiez que le pointeur de la souris se trouve au début de la zone de saisie et appuyez 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.
- N’exécutez pas d’écart type sur une entrée unique car les valeurs ne peuvent pas être divisées par zéro. L'écart type n'est pas une option valide pour les entrées uniques.
Expression SQL permettant de sélectionner un sous-ensemble d’entités. Pour plus d’informations sur la syntaxe du paramètre Expression, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.
Vous pouvez réorganiser les lignes par ordre croissant ou décroissant en spécifiant la valeur du paramètre Champ de tri. Si plusieurs champs sont spécifiés, les lignes sont triées en fonction du premier champ, et dans cet ordre, en fonction du deuxième champ, et ainsi de suite.
Lorsque vous convertissez des données de géodatabase possédant des sous-types ou des domaines et que l’espace de travail en sortie n’est pas une géodatabase, les codes de domaine et de sous-types et les descriptions peuvent figurer dans la sortie. Utilisez l’environnement 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.
Remarque :
La conversion vers une table dBASE avec des descriptions de sous-type et de domaine est susceptible de prendre plus de temps (performances moindres) que sans les descriptions. Si les descriptions de sous-type et de domaine ne sont pas requises dans la sortie, il est recommandé d’utiliser le paramètre par défaut (non coché) de l’environnement Transfert des descriptions de domaine de champ afin d’optimiser les performances.
Paramètres
arcpy.conversion.ExportTable(in_table, out_table, {where_clause}, use_field_alias_as_name, {field_mapping}, {sort_field})
Nom | Explication | Type de données |
in_table | Table en entrée contenant les lignes à exporter dans une nouvelle table. | Table View; Raster Layer |
out_table | Table en sortie contenant les lignes exportées. 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, respectivement. Si l’emplacement en sortie est une géodatabase, ne précisez pas d’extension. | Table |
where_clause (Facultatif) | Expression SQL permettant de sélectionner un sous-ensemble d’enregistrements. Pour en savoir plus sur la syntaxe SQL, reportez-vous à la rubrique d'aide Référence SQL pour les expressions de requête utilisées dans ArcGIS. | SQL Expression |
use_field_alias_as_name | Indique si les noms ou alias de champ en entrée seront utilisés comme nom de champ en sortie.
| Boolean |
field_mapping (Facultatif) | Les champs attributaires qui figurent dans la sortie avec les propriétés de champ correspondantes et les champs source. Par défaut, tous les champs des entrées seront inclus. Il est possible d’ajouter, de supprimer, de renommer, de réorganiser les champs, ainsi que de modifier leurs propriétés. Les règles de combinaison permettent de spécifier la manière dont les valeurs de deux champs en entrée ou plus sont combinées ou fusionnées en une seule valeur en sortie. Les règles de combinaison suivantes permettent de déterminer de quelle manière sont renseignées les valeurs du champ en sortie :
| Field Mappings |
sort_field [sort_field,...] (Facultatif) | Le ou les champs dont les valeurs vont servir à réorganiser les enregistrements en entrée et le sens de tri des enregistrements.
| Value Table |
Exemple de code
Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction ExportTable en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.ExportTable("vegtable.dbf", "C:/output/output.gdb/vegtable")
Le script autonome ci-dessous illustre l’utilisation de la fonction ExportTable.
# 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"
outTable = "C:/output/output.gdb/estuarine.csv"
# 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'"
# Run TableToTable
arcpy.conversion.ExportTable(inTable, outTable, expression, "NOT_USE_ALIAS")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?