Zusammenfassung
Setzt einen Layer mit einem anderen Layer oder mit einer Tabelle basierend auf einem Feldwert in Beziehung. Feature-Layer, Tabellensichten und Raster-Layer mit einer Raster-Attributtabelle werden unterstützt.
Die Datensätze aus der Beziehungstabelle werden den Datensätzen aus der Eingabe für Layer-Name oder Tabellensicht zugeordnet. Eine Übereinstimmung tritt auf, wenn das Eingabe-Beziehungsfeld und das Ausgabe-Beziehungsfeld gleich sind. Beziehungen ändern keine Daten, sie sind eine Eigenschaft des Layers.
Verwendung
Wenn es sich bei der Eingabe um eine Feature-Class oder einen Dataset-Pfad handelt, wird von diesem Werkzeug mit dem Ergebnis des angewendeten Werkzeugs automatisch ein neuer Layer erstellt und zurückgegeben.
Datensätze aus der Relate-Tabelle können mehr als einem Datensatz aus dem Eingabe-Layer oder der Tabellensicht zugeordnet werden.
Die Beziehungstabelle kann als eine Geodatabase-Tabelle oder eine dBASE-Datei erstellt werden. Die Beziehungstabelle muss kein Layer sein.
Die Eingabe muss ein ObjectID-Feld aufweisen. Die Beziehungstabelle muss kein ObjectID-Feld enthalten.
Wenn Sie die Beziehung für ein anderes Projekt speichern möchten, speichern Sie den Layer mit dem Werkzeug In Layer-Datei speichern als Layer-Datei. Dies gilt jedoch nur für Layer. Tabellensichten können auf diese Weise nicht gespeichert werden.
Um eine permanente Beziehung zu erstellen, verwenden Sie das Werkzeug Beziehungsklasse erstellen.
Die Indizierung der Felder in dem Eingabe-Layer bzw. der Tabellensicht und Beziehungstabelle, auf denen die Beziehung basiert, kann zu einer Performance-Steigerung beitragen. Dies kann mit dem Werkzeug Attributindex hinzufügen erfolgen.
Syntax
AddRelate(in_layer_or_view, in_field, relate_table, relate_field, relate_name, {cardinality})
Parameter | Erklärung | Datentyp |
in_layer_or_view | Der Layer oder die Tabellensicht, mit dem bzw. der die Beziehungstabelle in Beziehung gesetzt wird. | Mosaic Layer; Raster Layer; Table View |
in_field | Das Feld im Eingabe-Layer oder in der Tabellensicht, auf dem die Beziehung basiert. | Field |
relate_table | Die Tabelle oder Tabellensicht, mit der der Eingabe-Layer oder die Tabellensicht in Beziehung gesetzt wird. | Mosaic Layer; Raster Layer; Table View |
relate_field | Das Feld in der Beziehungstabelle, das die Werte enthält, auf denen die Beziehung basiert. | Field |
relate_name | Der eindeutige Name für eine Beziehung. | String |
cardinality (optional) | Die Beziehungsart.
| String |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_layer_or_view | Das aktualisierte Eingabe-Dataset. | Tabellensicht; Raster-Layer; Mosaik-Layer |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion AddRelate im unmittelbaren Modus verwendet wird.
import arcpy
relate = arcpy.AddRelate_management("Parcel", "ParcelID", "owner_table",
"ParcelID", "Owner2Parcel")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja