Joindre un champ (Gestion des données)

Synthèse

Joint définitivement le contenu d’une table à une autre table en fonction d’un champ attributaire commun. La table en entrée est mise à jour pour contenir les champs de la table de jointure. Vous pouvez sélectionner les champs de la table de jointure qui seront ajoutés à la table en entrée.

Utilisation

• Les enregistrements de la valeur Table en entrée sont appariés aux enregistrements de la valeur Table de jointure en fonction des valeurs des paramètres Champ de jointure en entrée et Champ de la table de jointure. Il est également possible de sélectionner des champs spécifiques de la valeur Table de jointure et de les ajouter à la valeur Table en entrée pendant la jointure.

• La valeur Table en entrée peut être une classe d’entités (y compris un shapefile) ou une table.

• Tous les champs de la valeur Table en entrée sont conservés pendant la jointure. Vous pouvez également sélectionner certains champs de la valeur Table de jointure pour les ajouter à la sortie. Utilisez le paramètre Transférer des champs pour ajouter ces champs.

• Les enregistrements de la valeur Table de jointure peuvent être appariés à plusieurs enregistrements de la valeur Table en entrée.

• Si aucun champ n’est sélectionné pour le paramètre facultatif Transférer des champs, tous les champs de la valeur Table de jointure sont joints à la sortie. Pour modifier les noms de champ, d’alias ou de propriétés, définissez le paramètre Méthode de transfert sur Utiliser l’appariement de champs.

• Les jointures peuvent être basées sur des champs de type texte, date ou nombre.

• Les jointures basées sur des champs de texte respectent la casse.

• Les champs présentant des formats de nombre différents peuvent être joints tant que les valeurs sont égales. Par exemple, un champ de type flottant peut être joint à un champ de type entier court.

• Lorsqu’ils sont joints à une table en entrée, les champs de la table de jointure avec un type d’ID global ou un type d’ID d’objet ne sont pas transférés.

  La valeur Champ de jointure en entrée et la valeur Champ de la table de jointure peuvent porter des noms de champ différents.

• Si un champ de jointure porte le même nom qu’un champ de la table en entrée, le suffixe _1 (ou _2, ou _3, etc.) est ajouté au nom du champ joint pour le rendre unique.

• Si l’option Sélectionner les champs à transférer est spécifiée pour le paramètre Méthode de transfert et si les valeurs de champs dans la valeur du paramètre Champ de la table de jointure ne sont pas uniques, seule la première occurrence de chaque valeur est utilisée. Pour prendre en compte des valeurs autres que la première occurrence (une jointure d’un vers plusieurs), définissez le paramètre Méthode de transfert sur Utiliser un appariement de champ. Pour réaliser une jointure de type un vers plusieurs, la valeur du paramètre Table en entrée doit comporter un champ ID d’objet et figurer dans le même espace de travail que la valeur du paramètre Table de jointure.

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

  En savoir plus sur l'appariement de champs dans les scripts

• Si le paramètre Appariement des champs est spécifié dans la règle de fusion Jointure, il n’est pas possible de garantir que l’ordre des valeurs jointes sera cohérent avec l’ordre des lignes du paramètre Champ de la table de jointure si les valeurs ne sont pas uniques. Par exemple, si trois entités avec des valeurs attributaires ANIMAL égales à souris, chat et chien, sont jointes, le résultat ne sera pas nécessairement dans l’ordre souris, chat et chien.

• L’outil Valider une jointure peut être utilisé pour valider une jointure entre deux couches ou tables afin de déterminer si celles-ci ont des noms de champ et des champs d’ID d’objet valides, si la jointure produit des enregistrements correspondants, s’il s’agit d’une jointure un vers un ou un vers plusieurs, ou d’autres propriétés de la jointure.

  Pour faciliter l’utilisation de l’outil, la boîte de dialogue associée contient un bouton permettant de valider la jointure.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	Table ou classe d’entités à laquelle la table de jointure sera jointe.	Mosaic Layer; Raster Layer; Table View
Champ de jointure en entrée	Champ de la table en entrée sur lequel la jointure sera basée.	Field
Table de jointure	Table qui est jointe à la table en entrée.	Mosaic Layer; Raster Layer; Table View
Champ de la table de jointure	Champ dans la table de jointure qui contient les valeurs sur lesquelles sera basée la jointure.	Field
Transférer des champs (Facultatif)	Champs de la table de jointure qui sont transférés vers la table en entrée, selon une jointure entre la table en entrée et la table de jointure.	Field
Méthode de transfert (Facultatif)	Spécifie comment les champs de jointure et les types de champ sont transférés vers la sortie. Sélectionner les champs à transférer—Les champs et les types de champ de la table jointe sont transférés vers la sortie. Il s’agit de l’option par défaut. Utiliser l’appariement de champs—Le transfert des champs et des types de champ de la table jointe vers la sortie est contrôlé par le paramètre Appariement des champs.	String
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 : Premier : utilisez la première valeur des champs en entrée. Dernier : utilisez la dernière valeur des champs en entrée. Joindre : concaténez (joignez) les valeurs des champs en entrée. Somme : calculez le total des valeurs des champs en entrée. Moyenne : calculez la moyenne des valeurs des champs en entrée. Médiane : calculez la valeur médiane (milieu) des valeurs des champs en entrée. Mode – Utilisez la valeur avec la plus haute fréquence. Min. : utilisez la valeur minimale de toutes les valeurs des champs en entrée. Max. : utilisez la valeur maximale de toutes les valeurs des champs en entrée. Écart type : utilisez la méthode de classification par écart type sur les valeurs de tous les champs en entrée. Total – Recherchez le nombre d'enregistrements inclus dans le calcul.	Field Mappings

Sortie obtenue

Étiquette	Explication	Type de données
Table en entrée mise à jour	Jeu de données en entrée mis à jour.	Table View; Raster Layer; Mosaic Layer

Python

arcpy.management.JoinField(in_data, in_field, join_table, join_field, {fields}, {fm_option}, {field_mapping})

Nom	Explication	Type de données
in_data	Table ou classe d’entités à laquelle la table de jointure sera jointe.	Mosaic Layer; Raster Layer; Table View
in_field	Champ de la table en entrée sur lequel la jointure sera basée.	Field
join_table	Table qui est jointe à la table en entrée.	Mosaic Layer; Raster Layer; Table View
join_field	Champ dans la table de jointure qui contient les valeurs sur lesquelles sera basée la jointure.	Field
fields [fields,...] (Facultatif)	Champs de la table de jointure qui sont transférés vers la table en entrée, selon une jointure entre la table en entrée et la table de jointure.	Field
fm_option (Facultatif)	Spécifie comment les champs de jointure et les types de champ sont transférés vers la sortie. NOT_USE_FM—Les champs et les types de champ de la table jointe sont transférés vers la sortie. Il s’agit de l’option par défaut. USE_FM—Le transfert des champs et des types de champ de la table jointe vers la sortie est contrôlé par le paramètre field_mapping.	String
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 : Premier : utilisez la première valeur des champs en entrée. Dernier : utilisez la dernière valeur des champs en entrée. Joindre : concaténez (joignez) les valeurs des champs en entrée. Somme : calculez le total des valeurs des champs en entrée. Moyenne : calculez la moyenne des valeurs des champs en entrée. Médiane : calculez la valeur médiane (milieu) des valeurs des champs en entrée. Mode – Utilisez la valeur avec la plus haute fréquence. Min. : utilisez la valeur minimale de toutes les valeurs des champs en entrée. Max. : utilisez la valeur maximale de toutes les valeurs des champs en entrée. Écart type : utilisez la méthode de classification par écart type sur les valeurs de tous les champs en entrée. Total – Recherchez le nombre d'enregistrements inclus dans le calcul. Dans Python, vous pouvez utiliser la classe FieldMappings pour définir ce paramètre.	Field Mappings

Sortie obtenue

Nom	Explication	Type de données
out_layer_or_view	Jeu de données en entrée mis à jour.	Table View; Raster Layer; Mosaic Layer

Exemple de code

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

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

import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.management.JoinField("zion_park", "zonecode", "zion_zoning", "zonecode", 
                           ["land_use", "land_cover"])

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

Ce script Python autonome illustre l’utilisation de la fonction JoinField pour joindre une table à une classe d’entités en n’incluant que deux des champs de la table dans la jointure.

# PermanentJoin.py
# Purpose: Join two fields from a table to a feature class 

# Import system modules
import arcpy

# Set the current workspace 
arcpy.env.workspace = "c:/data/data.gdb"

# Set the local parameters
inFeatures = "zion_park"
joinField = "zonecode"
joinTable = "zion_zoning"
fieldList = ["land_use", "land_cover"]

# Join two feature classes by the zonecode field and only carry 
# over the land use and land cover fields
arcpy.management.JoinField(inFeatures, joinField, joinTable, joinField, 
                           fieldList)

Environnements

Validation automatique, Espace de travail courant