Table vers table (Conversion)

Synthèse

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

Héritage :

Il s’agit d’un outil déconseillé. Cette fonction a été remplacée par l’outil Exporter la 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.

  • Si la valeur du paramètre Emplacement en sortie n’est pas une géodatabase, les champs BLOB ou raster ne sont pas inclus. Les champs GlobalID sont convertis en champs de texte.

  • 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)

  • Utilisez le paramètre Field Map (Appariement des champs) pour gérer les champs et leur contenu dans le jeu de données en sortie.

    • Ajoutez et supprimez des champs de la liste des champs, réorganisez la liste des champs et renommez des champs.
    • 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 modifier le type de données en un autre type de données valide.
    • Utilisez une action pour identifier la manière dont les valeurs d’un ou de plusieurs champs en entrée sont fusionnés en un seul champ en sortie. Les actions disponibles sont First (Premier), Last (Dernier), Concatenate (Concaténer), Sum (Somme), Mean (Moyenne), Median (Médiane), Mode, Minimum, Maximum, Standard Deviation (Écart type) et Count (Total).
    • Lorsque vous utilisez l’action Concatenate (Concaténer), vous pouvez spécifier un délimiteur, comme une virgule ou d’autres caractères. Cliquez au début de la zone de texte Delimiter (Délimiteur) pour ajouter les caractères de délimitation.
    • L’option Standard Deviation (Écart type) n’est pas valide pour une seule valeur en entrée.
    • Utilisez le bouton Slice Text (Texte de tranche) sur les champs de la source du texte pour préciser les caractères d’une valeur en entrée à extraire vers le champ en sortie. Pour accéder au bouton Slice Text (Texte de tranche), survolez un champ de texte dans la liste des champs en entrée, puis spécifiez les positions des caractères de début et de fin.
    • Il est également possible d’apparier des champs à l’aide de scripts Python.

  • Lors de la conversion de données de géodatabase comportant des sous-types ou domaines en table dBASE, les codes de domaine et de sous-type, ainsi que les descriptions, peuvent être inclus dans la sortie. Pour ce faire, utilisez l’environnement de géotraitement Transférer les descriptions des domaines de champs. Par défaut, seuls les codes de domaine et de sous-type sont inclus dans la sortie, mais pas les descriptions.

    Remarque :

    La conversion en une table dBASE avec des descriptions de sous-type et de domaine risque de prendre plus de temps (performances moindres) que la conversion sans les descriptions. Si les descriptions de sous-type et de domaine ne sont pas requises dans la table dBASE en sortie, laissez l’environnement Transférer les descriptions des domaines de champs non sélectionné afin d’optimiser les performances.

Paramètres

ÉtiquetteExplicationType de données
Enregistrements en entrée

Table en entrée à exporter dans une nouvelle table.

Table View; Raster Layer
Emplacement en sortie

Destination pour l’enregistrement de la table en sortie.

Workspace
Nom en sortie

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
Expression
(Facultatif)

Expression SQL utilisée pour sélectionner un sous-ensemble d’enregistrements.

SQL Expression
Appariement des champs
(Facultatif)

Les champs sont transférés au jeu de données en sortie avec leurs propriétés et champs sources respectifs. Par défaut, la sortie inclut tous les champs du jeu de données en entrée.

Utilisez l’appariement des champs pour ajouter, supprimer, renommer et réorganiser les champs, ainsi que pour modifier d’autres propriétés des champs.

L’appariement des champs peut aussi servir à combiner les valeurs de deux champs en entrée ou plus en un seul champ en sortie.

Field Mappings
Mot-clé de configuration
(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 obtenue

ÉtiquetteExplicationType de données
Table en sortie

Table en sortie.

Table

arcpy.conversion.TableToTable(in_rows, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})
NomExplicationType 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
out_name

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 utilisée pour sélectionner un sous-ensemble d’enregistrements.

SQL Expression
field_mapping
(Facultatif)

Les champs sont transférés au jeu de données en sortie avec leurs propriétés et champs sources respectifs. Par défaut, la sortie inclut tous les champs du jeu de données en entrée.

Utilisez l’appariement des champs pour ajouter, supprimer, renommer et réorganiser les champs, ainsi que pour modifier d’autres propriétés des champs.

L’appariement des champs peut aussi servir à combiner les valeurs de deux champs en entrée ou plus en un seul champ en sortie.

Dans Python, utilisez la classe FieldMappings pour définir 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 obtenue

NomExplicationType de données
out_table

Table en sortie.

Table

Exemple de code

Exemple 1 d’utilisation de la fonction TableToTable (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction TableToTable en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.TableToTable("vegtable.dbf", "C:/output/output.gdb", "vegtable")
Exemple 2 d’utilisation de la fonction TableToTable (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction 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'"
 
# Run TableToTable
arcpy.conversion.TableToTable(inTable, outLocation, outTable, expression)