Ajouter une jointure (Gestion des données)—ArcGIS Pro

Synthèse

Permet de joindre une couche à une autre couche ou table selon un champ commun. Les couches d'entités, les vues tabulaires et les couches raster avec une table attributaire de rasters sont prises en charge.

Les enregistrements du paramètre Join Table (Table de jointure) sont appariés aux enregistrements du paramètre Input Table (Table en entrée). Un appariement est effectué lorsque les valeurs du champ de jointure en entrée et du champ de table de jointure sont égales. Cette jointure est temporaire.

Illustration

Utilisation

La valeur du paramètre Input Table (Table en entrée) peut être une couche d’entités, une vue tabulaire ou une couche raster avec une table attributaire. Si un chemin de données est utilisé, la couche est créée avec une jointure. La jointure se trouvera toujours dans la couche, pas avec les données.
Pour établir une jointure permanente, utilisez l’outil Joindre un champ ou utilisez la couche jointe en entrée d’un des outils suivants : Copier des entités, Copier des enregistrements, Exporter des entités ou Exporter la table. Lorsque vous enregistrez les résultats dans une nouvelle table ou classe d’entités, vous pouvez utiliser l’environnement Noms de champ qualifiés pour vérifier si les noms de champs joints en sortie sont qualifiés avec le nom de la table d’origine du champ.
Si l’entrée est le chemin d’accès à une classe d’entités ou à un jeu de données, cet outil crée automatiquement une nouvelle couche en appliquant le résultat de l’outil.
Lorsqu’une jointure un vers plusieurs est générée, le résultat de la jointure peut être visualisé dans la table attributaire, où un message d’avertissement indique si la table contient des ID d’objet dupliqués. Étant donné que de nombreux outils de géotraitement ne prennent pas en charge les données contenant des ID d’objet dupliqués et que le traitement de telles données est susceptible de générer des résultats inattendus, il est recommandé de d’abord copier la couche jointe dans une nouvelle classe d’entités à l’aide de l’outil Exporter des entités. Utilisez ensuite cette nouvelle classe d’entités comme entrée d’autres outils de géotraitement.

Les tables suivantes comprennent des sorties potentielles de l’exécution d’une jointure avec différentes entrées.

La première table illustre une jointure de type un vers plusieurs. La conservation d’enregistrements d’appariement uniquement n’aura aucun effet, car tous les enregistrements ont des appariements.

Exemple d’utilisation de l’outil Ajouter une jointure : jointure de type un vers plusieurs lorsque chaque table comporte un champ ID d’objet
Table en entrée		Table de jointure		Résultat
Champ en entrée	Type	Champ de jointure	Valeur	Champ en entrée	Type	Champ de jointure	Valeur
1	Un	1	100	1	Un	1	100
2	B	2	200	2	B	2	200
		1	300	1	Un	1	300
		2	400	2	B	2	400

La deuxième table utilise une table de jointure sans ID d’objet ; seule une jointure de type un vers premier est possible. Une jointure de type un vers premier est également possible uniquement si chaque table provient d’un espace de travail différent.

Exemple d’utilisation de l’outil Ajouter une jointure : jointure de type un vers premier lorsqu’une des tables ne comporte pas de champ ID d’objet
Table en entrée		Table de jointure		Résultat
Champ en entrée	Type	Champ de jointure	Valeur	Champ en entrée	Type	Champ de jointure	Valeur
1	Un	1	100	1	Un	1	100
2	B	2	200	2	B	2	200
		3	300
		4	400

Dans la dernière table, la table en entrée comporte plus d’enregistrements que la table de jointure. Si vous conservez tous les enregistrements, tous les enregistrements correspondants sont également conservés, plus les enregistrements de la table en entrée qui ne correspondaient pas.

Exemple d’utilisation de l’outil Ajouter une jointure : jointure de type un vers plusieurs lorsque chaque table comporte un champ ID d’objet et que le paramètre Keep All Target Features (Conserver toutes les entités cible) est activé
Table en entrée		Table de jointure		Résultat
Champ en entrée	Type	Champ de jointure	Valeur	Champ en entrée	Type	Champ de jointure	Valeur
1	Un	1	100	1	Un	1	100
2	B	2	200	2	B	2	200
3	C	1	300	1	Un	1	300
4	D	2	400	2	B	2	400
				3	C	<Nul>	<Nul>
				4	D	<Nul>	<Nul>

La table en entrée doit comporter un champ ID d’objet pour réaliser une jointure de type un vers plusieurs et figurer dans le même espace de travail.

Les enregistrements de la table de jointure peuvent être appariés à plusieurs enregistrements si la table de jointure comporte un champ ID d’objet. Sinon, une jointure de type un vers premier est réalisée.

Par défaut, tous les enregistrements sont conservés lors de la jointure de tables. Si un enregistrement de la table cible n'a pas d'équivalent dans la table de jointure, il affiche des valeurs Null pour tous les champs ajoutés à la table cible à partir de la table de jointure.


Table en entrée		Table de jointure		Résultat
Champ en entrée	Type	Champ de jointure	Valeur	Champ en entrée	Type	Champ de jointure	Valeur
1	Un	1	100	1	Un	1	100
2	B	2	200	2	B	2	200
3	C	1	300	1	Un	1	300
4	D	2	400	2	B	2	400
				3	C	<Nul>	<Nul>
				4	D	<Nul>	<Nul>

Lorsque le paramètre Conserver toutes les entités cibles est activé, si un enregistrement de la table cible n’a pas d’équivalent dans la table de jointure, il est supprimé de la table cible obtenue. Si la table cible représente la table attributaire d'une couche, les entités sans données jointes n'apparaissent pas sur la carte.


Table en entrée		Table de jointure		Résultat
Champ en entrée	Type	Champ de jointure	Valeur	Champ en entrée	Type	Champ de jointure	Valeur
1	Un	1	100	1	Un	1	100
2	B	2	200	2	B	2	200
		3	300
		4	400

Les propriétés de champ telles que les alias, la visibilité et la mise en forme des nombres sont conservées lors de l'ajout ou de la suppression d'une jointure.
Une table en entrée ne peut effectuer qu’une jointure à la fois.
La jointure est conservée uniquement pour la durée de la couche. Pour conserver une couche, enregistrez la session ArcGIS Pro ou enregistrez-la dans un fichier de couche à l’aide de l’outil Enregistrer une couche dans un fichier.

Pour que vous puissiez afficher les résultats d’une jointure créée dans un outil de script, l’outil doit inclure la couche comme paramètre dérivé en sortie. De manière similaire, le paramètre Couche ou vue tabulaire en entrée mise à jour doit être défini comme paramètre en sortie dérivé dans un outil de modèle pour que vous puissiez afficher les résultats joints.
Dans la table résultante, les champs seront préfixés avec le nom de l’entrée et un point (.) ; tous les champs de la table de jointure seront préfixés avec le nom de table de jointure et un point comme valeur par défaut.
Par exemple, joindre landuse, qui comporte les champs A et B, à lookup_tab, qui comporte les champs C et D, donne une couche ou une vue tabulaire avec les champs suivants : landuse.A, landuse.B, lookup_tab.C et lookup_tab.D.
L’indexation des champs dans la table en entrée et la table de jointure sur lesquelles la jointure sera basée peut améliorer les performances. Si le paramètre Indexer les champs joints est coché, un index attributaire sera ajouté aux deux champs de jointure. Vous pouvez également indexer chaque champ de jointure à l’aide de l’outil Ajouter un index attributaire.
Si les résultats de la jointure sont inattendus ou incomplets, vérifiez si les valeurs des paramètres Champ Table de jointure et Champ de jointure en entrée sont indexées. S'ils ne le sont pas, essayez de supprimer et de recréer l'index, puis réexécutez l'outil.
Si les champs de la couche ou de la vue tabulaire en entrée ont été modifiés (renommés ou masqués) à l’aide du paramètre Informations de champ dans l’outil Créer une couche d’entités ou Générer une vue tabulaire, ces modifications de champ ne sont pas incluses dans la couche ou la vue tabulaire jointe en sortie.
L’ensemble de définition de la table en entrée est appliqué à la couche ou vue tabulaire en entrée. Pour supprimer l’ensemble de définition, utilisez l’outil Supprimer une jointure ou supprimez manuellement l’ensemble de définition de la couche.
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.
Les sélections sur la couche ne sont pas utilisées dans l’outil Ajouter une jointure mais sont utilisées dans l’outil Joindre un champ.

Paramètres

Étiquette	Explication	Type de données
Table en entrée	La couche ou la vue tabulaire à laquelle la table de jointure sera jointe.	Mosaic Layer; Raster Layer; Table View
Champ de jointure en entrée	Le champ de la couche ou de la vue tabulaire en entrée sur lequel la jointure sera basée.	Field
Table de jointure	La table ou la vue tabulaire à joindre à la couche ou à la vue tabulaire en entrée.	Mosaic Layer; Raster Layer; Table View
Champ Table de jointure	Champ dans la table de jointure qui contient les valeurs sur lesquelles sera basée la jointure.	Field
Conserver toutes les entités cibles (Facultatif)	Spécifie si seuls les enregistrements de l’entrée qui correspondent à un enregistrement de la table de jointure seront inclus dans la sortie. Activé : tous les enregistrements de la couche ou de la vue tabulaire en entrée sont inclus dans la sortie. On parle également de jointure externe. Il s’agit de l’option par défaut. Désactivé : seuls les enregistrements en entrée qui correspondent à une ligne de la table de jointure sont inclus dans la sortie. On parle également de jointure interne.	Boolean
Indexer les champs joints (Facultatif)	Spécifie si des index attributaires de table seront ajoutés aux deux champs de jointure. Activé : les deux champs de jointure seront indexés. Si la table possède un index existant, aucun nouvel index n’est ajouté. Désactivé : aucun index ne sera ajouté. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

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

arcpy.management.AddJoin(in_layer_or_view, in_field, join_table, join_field, {join_type}, {index_join_fields})

Nom	Explication	Type de données
in_layer_or_view	La couche ou la vue tabulaire à laquelle la table de jointure sera jointe.	Mosaic Layer; Raster Layer; Table View
in_field	Le champ de la couche ou de la vue tabulaire en entrée sur lequel la jointure sera basée.	Field
join_table	La table ou la vue tabulaire à joindre à la couche ou à la vue tabulaire 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
join_type (Facultatif)	Spécifie si seuls les enregistrements de l’entrée qui correspondent à un enregistrement de la table de jointure seront inclus dans la sortie. KEEP_ALL—Tous les enregistrements de la couche ou de la vue tabulaire en entrée sont inclus dans la sortie. On parle également de jointure externe. Il s’agit de l’option par défaut. KEEP_COMMON—Seuls les enregistrements en entrée qui correspondent à une ligne de la table de jointure sont inclus dans la sortie. On parle également de jointure interne.	Boolean
index_join_fields (Facultatif)	Spécifie si des index attributaires de table seront ajoutés aux deux champs de jointure. INDEX_JOIN_FIELDS—Les deux champs de jointure seront indexés. Si la table possède un index existant, aucun nouvel index n’est ajouté. NO_INDEX_JOIN_FIELDS—Aucun index ne sera ajouté. Il s’agit de l’option par défaut.	Boolean

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 AddJoin (fenêtre Python)

La fenêtre de script Python suivante illustre l’utilisation de la fonction AddJoin en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
veg_joined_table = arcpy.management.AddJoin("vegetation", "HOLLAND95", 
                                            "vegtable", "HOLLAND95")
arcpy.management.CopyFeatures(veg_joined_table, "vegjoin")

Exemple 2 d'utilisation de la fonction AddJoin (script autonome)

Ce script autonome illustre la fonction AddJoin dans le cadre d'un workflow permettant de joindre une table à une classe d'entités et d'extraire les entités spécifiées.

# Name: AttributeSelection.py
# Purpose: Join a table to a featureclass and select the desired attributes

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
# The qualifiedFieldNames environment is used by Copy Features when persisting 
# the join field names.
arcpy.env.qualifiedFieldNames = False

# Set local variables
inFeatures = "vegtype"
joinTable = "vegtable"
joinField = "HOLLAND95"
expression = "vegtable.HABITAT = 1"
outFeature = "vegjoin"

# Join the feature layer to a table
veg_joined_table = arcpy.management.AddJoin(inFeatures, joinField, joinTable, 
                                            joinField)

# Select desired features from veg_layer
arcpy.management.SelectLayerByAttribute(veg_joined_table, "NEW_SELECTION", 
                                        expression)

# Copy the layer to a new permanent feature class
arcpy.management.CopyFeatures(veg_joined_table, outFeature)

Environnements

Espace de travail courant

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Rubriques connexes

Vous avez un commentaire à formuler concernant cette rubrique ?

Synthèse

Illustration

Utilisation

Paramètres

Sortie obtenue

Sortie obtenue

Exemple de code

Environnements

Informations de licence

Rubriques connexes

Dans cette rubrique