Table croisée (Outils de gestion des données)

Résumé

Crée une table à partir de la table en entrée en réduisant la redondance des enregistrements et en aplatissant les relations un-à-plusieurs.

Illustration

Illustration de l’outil Table croisée

Utilisation

Cet outil est généralement utilisé pour réduire les enregistrements redondants et mettre à plat les relations un vers plusieurs.
La combinaison des valeurs des paramètres Input Fields (Champs en entrée), Pivot Field (Champ de croisement) et Value Field (Champ de valeur) doit être unique. Utilisez l’outil Fréquence pour déterminer si la combinaison est unique.
Si la valeur Pivot Field (Champ de croisement) est de type texte, ses valeurs doivent commencer par un caractère (par exemple, a2) et pas un nombre (par exemple, 2a). Si la valeur du premier enregistrement commence par un nombre, toutes les valeurs en sortie seront nulles (0).
Si la valeur de Pivot Field (Champ de croisement) est de type numérique, sa valeur est ajoutée au nom de son champ d’origine dans la table en sortie.
Le nombre de champs dans la table en sortie est déterminé par le nombre de champs en entrée que vous spécifiez, plus un champ pour chaque valeur unique du paramètre Pivot Field (Champ de croisement). Le nombre d’enregistrements dans la table en sortie est déterminé par la combinaison unique de valeurs entre les champs en entrée et le champ de croisement spécifiés.
L’outil échoue si la valeur Pivot Field (Champ de croisement) contient des valeurs nulles.

Etiqueter	Explication	Type de données
Input Table (Table en entrée)	Table contenant les enregistrements qui seront croisés.	Table View
Champs en entrée	Champs qui définissent les enregistrements à inclure dans la table en sortie.	Field
Champ de croisement	Champ dont les valeurs d’enregistrement permettront de générer le nom des champs dans la table en sortie.	Field
Champ de valeur	Champ dont les valeurs renseigneront les champs croisés dans la table en sortie.	Field
Table en sortie	Table contenant les enregistrements croisés à créer.	Table

arcpy.management.PivotTable(in_table, fields, pivot_field, value_field, out_table)

Nom	Explication	Type de données
in_table	Table contenant les enregistrements qui seront croisés.	Table View
fields [fields,...]	Champs qui définissent les enregistrements à inclure dans la table en sortie.	Field
pivot_field	Champ dont les valeurs d’enregistrement permettront de générer le nom des champs dans la table en sortie.	Field
value_field	Champ dont les valeurs renseigneront les champs croisés dans la table en sortie.	Field
out_table	Table contenant les enregistrements croisés à créer.	Table

Exemple de code

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

Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction PivotTable en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.PivotTable("attributes.dbf", "OwnerID", "AttrTagNam",
                            "AttrValueS", "C:/output/attribPivoted.dbf")

Exemple 2 d’utilisation de la fonction PivotTable (script Python autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction PivotTable dans un script autonome.

# Name: PivotTable_Example2.py
# Description: Pivot the attributes table by the specified fields

# Import system modules
import arcpy

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

# Set local variables
in_table = "attributes.dbf"
fields = "OwnerID"
pivot_field = "AttrTagNam"
value_field = "AttrValueS"
out_table = "C:/output/attribPivot.dbf"

# Run PivotTable
arcpy.management.PivotTable(in_table, fields, pivot_field, value_field, out_table)

Environnements

Espace de travail courant, Mot-clé CONFIG en sortie, Espace de travail temporaire

Informations de licence

Basic: Non
Standard: Non
Advanced: Oui