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

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

ÉtiquetteExplicationType 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

arcpy.management.PivotTable(in_table, fields, pivot_field, value_field, out_table)
NomExplicationType 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)

Rubriques connexes