Table croisée (Gestion des données)

Disponible avec une licence Advanced.

Synthèse

Crée une table à partir de la table en entrée en réduisant la redondance dans les enregistrements et en mettant à plat les relations un vers plusieurs.

Illustration

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 Champs en entrée, Champ de croisement et Champ de valeur doit être unique. Utilisez l’outil Fréquence pour déterminer si la combinaison est unique.

• Si la valeur 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 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 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 Champ de croisement contient des valeurs nulles.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
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

Python

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 ci-dessous pour la fenêtre Python 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 suivant 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