Anhängen (Data Management Tools)
Zusammenfassung
Hängt ein vorhandenes Ziel-Dataset an mehrere Eingabe-Datasets an und aktualisiert diese optional. Eingabe-Datasets können Feature-Classes, Tabellen, Shapefiles, Raster, Annotation- oder Dimension-Feature-Classes sein. Die Eingaben können auch gehostete Feature-Services sein.
Verwenden Sie das Werkzeug Zusammenführen (Merge), um Eingabe-Datasets mit einem neuen Ausgabe-Dataset zu kombinieren.
Abbildung

Verwendung
Mithilfe dieses Werkzeugs können Sie einem vorhandenen Dataset neue Features oder andere Daten aus verschiedenen Datasets hinzufügen. Mit diesem Werkzeug können Point-, Line- oder Polygon-Feature-Classes, Tabellen, Raster, Annotation-Feature-Classes oder Dimension-Feature-Classes an ein vorhandenes Dataset desselben Typs angehängt werden. Es können beispielsweise mehrere Tabellen an eine vorhandene Tabelle oder mehrere Raster an ein vorhandenes Raster-Dataset angefügt werden; es kann jedoch keine Line-Feature-Class an eine Point-Feature-Class angefügt werden.
Mit dem Parameter Feldzuordnung können Sie steuern, wie die Attributinformationen aus den Eingabe-Dataset-Feldern in das Ziel-Dataset übertragen werden. Der Parameter Feldzuordnung kann nur verwendet werden, wenn die Option Feldzuordnung zum Abgleichen von Feld-Unterschieden verwenden für den Parameter Typ der Feldübereinstimmung festgelegt wird.
Verwenden Sie den Parameter Feldzuordnung, um die Felder aus den Eingabe-Datasets den Feldern im Ziel-Dataset zuzuordnen oder mit ihnen abzugleichen.
Verwenden Sie eine Aktion, um festzulegen, wie die Werte aus einem oder mehreren Feldern des Eingabe-Datasets zu einem einzelnen Feld des Ziel-Datasets zugeordnet werden sollen.
Die verfügbaren Aktionen sind: Erste(r), Letzte(r), Verbinden, Summe, Mittelwert, Medianwert, Modus, Minimum, Maximum, Standardabweichung und Anzahl.
Bei Verwendung von Verbinden können Sie ein Trennzeichen angeben, z. B. ein Komma oder andere Zeichen. Klicken Sie auf den Beginn des Textfeldes Trennzeichen, um die Trennzeichen hinzuzufügen.
Standardabweichung ist keine gültige Option für einzelne Eingabewerte.
Verwenden Sie die Option Exportieren
, um eine Feldzuordnung als .fieldmap-Datei zu speichern.Verwenden Sie die Option Laden
, um eine .fieldmap-Datei zu laden. Der Feature-Layer oder das Dataset, der bzw. das in der Datei angegeben ist, muss mit dem im Werkzeug verwendeten Dataset übereinstimmen. Andernfalls wird der Parameter Feldzuordnung zurückgesetzt.Verwenden Sie die Schaltfläche Text ausschneiden
bei Textquellfeldern, um auszuwählen, welche Zeichen aus einem Eingabewert in das Zielfeld extrahiert werden sollen. Um auf die Schaltfläche Text ausschneiden zuzugreifen, bewegen Sie den Mauszeiger über ein Textfeld in der Liste der Eingabefelder, und geben Sie dann die Start- und Endposition der Zeichen an.Felder können auch in Python-Skripts zugeordnet werden.
Fügen Sie bei der Verwendung des Objekts
FieldMappingsfür den Parameterfield_mappingin Python zunächst die Felder aus dem Eingabe-Dataset hinzu, wie im nachstehenden Code gezeigt. Eingabe-Felder werden dem Schema der Zielfelder zugeordnet. Wenn die Eingabe-Felder zuerst hinzugefügt werden, kann die Feldzuordnung zurückgesetzt werden oder sich unerwartet verhalten.fieldmappings = arcpy.FieldMappings() fieldmappings.addTable(target) fieldmappings.addTable(input)Mit diesem Werkzeug werden Features nicht geteilt, wenn sie dem Ziel-Dataset hinzugefügt werden. Alle Features der Eingabe-Feature-Class und der Ziel-Feature-Class bleiben nach dem Anfügen bestehen, selbst wenn sich Features überschneiden. Zum Zusammenführen oder Teilen von Feature-Geometrien verwenden Sie das Werkzeug Vereinigen (Union).
Wenn der Parameter Typ der Feldübereinstimmung auf Eingabefelder müssen Zielfeldern entsprechen eingestellt ist, muss das Schema der Eingabe-Datasets mit dem des Ziel-Dataset übereinstimmen, damit Features angehängt werden können.
Wenn der Parameter Typ der Feldübereinstimmung auf Feldzuordnung zum Abgleichen von Feld-Unterschieden verwenden eingestellt ist, muss das Schema nicht übereinstimmen. Felder der Eingabe-Datasets, die nicht mit den Feldern des Ziel-Dataset übereinstimmen, werden dem Ziel-Dataset nicht zugeordnet, es sei denn, die Zuordnung wird im Parameter Feldzuordnung festgelegt. Felder im Ziel-Dataset, die keinen Feldern in den Eingabe-Datasets zugeordnet sind, enthalten NULL-Werte.
Wenn der Parameter Typ der Feldübereinstimmung auf Überspringen und eine Warnung anzeigen, wenn das Schema nicht übereinstimmt eingestellt ist, muss das Schema der Eingabe-Datasets mit dem des Ziel-Dataset übereinstimmen, damit Features angehängt werden können. Wenn ein Eingabe-Dataset Felder enthält, die nicht mit Feldern im Ziel-Dataset übereinstimmen, wird dieses Eingabe-Dataset weggelassen.
Die Anzahl der angehängten Zeilen wird in den Werkzeugmeldungen angezeigt und von der Ausgabe Anzahl angehängter Zeilen zurückgegeben.
Da die Daten der Eingabe-Datasets in ein vorhandenes Ziel-Dataset geschrieben werden, das ein vordefiniertes Schema hat, können Sie den Parameter Feldzuordnung nicht verwenden, um Felder zum Ziel-Dataset hinzuzufügen oder aus ihm zu entfernen.
Mit diesem Werkzeug können Sie neue Datensätze einfügen und bestehende Datensätze in einem Ziel-Dataset im gleichen Schritt aktualisieren (entspricht einer
UPSERT-Datenbankoperation). Verwenden Sie den Parameter Abgleichfelder für Aktualisierung, um die Felder aus dem Eingabe-Dataset anzugeben, die mit den Feldern im Ziel-Dataset abgeglichen werden sollen. Bei Datensätzen mit übereinstimmenden Feldwerten werden die Felder im Zieldatensatz mit den Werten aus den gleichnamigen Feldern im Eingabedatensatz aktualisiert. Die Anzahl der aktualisierten Zeilen mit abgeglichenen Feldern wird in den Werkzeugmeldungen angezeigt und von der Ausgabe Anzahl der aktualisierten Zeilen zurückgegeben. Die Geometrie wird aktualisiert, wenn der Parameter Geometrie aktualisieren aktiviert ist.Die Eingabe- und Zieldatensätze können unterschiedliche Raumbezüge aufweisen. Wenn dies der Fall ist, werden die Eingabe-Features vom Werkzeug in das Koordinatensystem des Ziels projiziert. Geben Sie unter Verwendung der Umgebungseinstellung "Geographische Transformationen" eine geeignete geographische Transformation an, um optimale Ergebnisse zu erzielen. Wenn es sich beim Ziel-Dataset um einen Karten-Layer handelt, kann das Werkzeug eine Standardtransformation anwenden. In Python gibt es keine Standardtransformation.
Mit diesem Werkzeug wird kein Kantenabgleich durchgeführt. Es findet keine Anpassung an die Geometrie von Features statt.
Karten-Layer können als Parameterwerte für Eingabe-Datasets verwendet werden. Wenn für einen Layer eine Auswahl getroffen wurde, werden nur die ausgewählten Datensätze (Features oder Tabellenzeilen) verwendet.
Sie können bei diesem Werkzeug nicht mehrere Eingabe-Layer mit demselben Namen verwenden. Verwenden Sie stattdessen die Schaltfläche "Durchsuchen" im Bereich Geoverarbeitung, um zu den vollständigen Pfaden der einzelnen Werte der Eingabe-Datasets zu navigieren.
Wenn ein Eingabe-Dataset und das Ziel-Dataset denselben Namen haben, ist die Performance des Werkzeugs reduziert.
Wenn Sie den Parameter Subtype verwenden möchten, muss das Ziel-Dataset ein definiertes Subtype-Feld und zugewiesene Subtype-Codes aufweisen. Geben Sie im Parameter Subtype eine Subtype-Beschreibung ein, um allen neuen Daten, die an das Ziel-Dataset angefügt werden, diesen Subtype zuzuweisen.
Verwenden Sie den Parameter Domänen erzwingen, um Attributdomänen für Felder im Ziel-Dataset zu erzwingen. Wenn dieser Parameter aktiviert ist, berücksichtigt das Werkzeug die im Ziel-Dataset definierten Domänenwerte. Daten aus den Eingabe-Feldern, die diesen Domänenwerten nicht entsprechen, werden als NULL-Werte eingefügt.
Die folgenden Informationen beziehen sich auf das Aktualisieren der Ziel-Dataset-Felder.
Verwenden Sie dieses Werkzeug, um neue Datensätze einzufügen und bestehende Datensätze in einem Ziel-Dataset im gleichen Schritt zu aktualisieren (entspricht einer
UPSERT-Datenbankoperation). Verwenden Sie den Parameter Abgleichfelder für Aktualisierung, um die Felder aus dem Eingabe-Dataset anzugeben, die mit den Feldern im Ziel-Dataset abgeglichen werden sollen.Standardmäßig werden bei Datensätzen, die übereinstimmende Feldwerte enthalten, die Felder im Zieldatensatz mit den Werten aus der Eingabe aktualisiert, sofern sie denselben Feldnamen aufweisen. Die Anzahl der aktualisierten Zeilen mit übereinstimmenden Feldern wird in den Werkzeugmeldungen angezeigt und im abgeleiteten Parameter Anzahl aktualisierter Zeilen zurückgegeben.
Der Parameter Kandidatenfelder kann verwendet werden, um selektiv Felder im Ziel-Dataset zu aktualisieren oder einzufügen. Beispielsweise können Sie für ein Ziel-Dataset, das Felder mit den Namen
f1,f2,f3undf4enthält, angeben, dass für die Zielzeilen nur die Felderf3undf4aktualisiert werden. Bei Einfügevorgängen werden nur die Felderf3undf4eingefügt.Die Geometrie wird aktualisiert, wenn der Parameter Geometrie aktualisieren aktiviert ist.
Um im Ziel-Dataset nur die Geometrie und nicht die Attributfelder zu aktualisieren, stellen Sie sicher, dass der Parameter Geometrie aktualisieren aktiviert und das Feld Shape das einzige Feld ist, das im Parameter Kandidatenfelder angegeben ist. Wenn es sich beim Ziel um einen Feature-Service handelt, finden Sie unten im Abschnitt Verwendung weitere Informationen.
Der Parameter Optionen für das Überspringen verfügt über die folgenden Optionen zur Steuerung des Verhaltens aktualisierter und eingefügter Zeilen:
- Aktualisierungen oder Einfügungen nicht überspringen: Alle Zeilen mit übereinstimmenden Feldern werden im Ziel aktualisiert, und alle Zeilen ohne Übereinstimmung aus der Eingabe werden eingefügt.
- Einfügungen für Zeilen ohne Übereinstimmung überspringen (nur Aktualisierung): Alle Zeilen mit übereinstimmenden Feldern werden im Ziel aktualisiert. Zeilen ohne Übereinstimmung aus dem Eingabe-Dataset werden nicht eingefügt.
- Aktualisierungen für Zeilen mit Übereinstimmung überspringen (nur Einfügung): Es werden keine Zeilen mit übereinstimmenden Feldern im Ziel aktualisiert. Es werden nur Zeilen ohne Übereinstimmung aus der Eingabe eingefügt.
Die folgenden Informationen beziehen sich auf Feature-Services:
Für optimale Performance verwenden Sie dieses Werkzeug direkt im Back-End-Data-Store, auf dem Server oder in der Datenbank für Web-Feature-Layer. Bei Feature-Services, die eine Geodatabase referenzieren, verwenden Sie eine Datenbankverbindung, um große Datenmengen direkt in die zugrunde liegende Datenbank zu laden. Bei gehosteten Services in ArcGIS Enterprise verwenden Sie den
append-Vorgang über die Feature-Layer-Elementseite oder die ArcGIS REST API.Für optimale Performance bei gehosteten Services in ArcGIS Online und ArcGIS Enterprise können Administratoren und Service-Besitzer dieses Werkzeug mit der ArcGIS REST API verwenden, wenn die Eigenschaft
supportAppendauftruefestgelegt ist. Damit Benutzer, die keine Administratoren sind, das Werkzeug mit der ArcGIS REST API verwenden können, müssen die Anhängfunktionen für den Feature-Service aktiviert sein. Für gehostete ArcGIS Enterprise-Feature-Layer muss die FunktionUploadsaktiviert sein.Der Parameter Performance für Feature-Services optimieren wird nur unterstützt, wenn das Ziel-Dataset die Anhängfunktionen für den Feature-Service unterstützt. Wenn dieser Parameter aktiviert ist, verhält sich das Werkzeug wie folgt:
Das Werkzeug verwendet die ArcGIS REST API für optimale Performance.
Der Parameter Eingabe-Datasets ist auf ein Dataset beschränkt.
Die Parameter Ausdruck und Domänen erzwingen werden nicht unterstützt.
Der Parameter Abgleichfelder für Aktualisierung ist auf ein Abgleichfeldpaar beschränkt.
Sämtliche Aktualisierungs- und Einfügevorgänge werden im Ausgabewert Anzahl angehängter Zeilen gezählt.
Wenn dieses Werkzeug in einer vorhandenen Editiersitzung ausgeführt wird oder die Umschaltfläche Rückgängig aktivieren aktiviert ist, wird der Parameter Performance für Feature-Services optimieren ignoriert.
Wenn der Parameter Performance für Feature-Services optimieren aktiviert ist und die Parameterwerte Abgleichfelder für Aktualisierung das Abgleichfeld
Global IDaufweisen, werden die Global ID-Werte beibehalten. Wenn die FelderGlobal IDnicht enthalten sind, werden alle Eingabe-Zeilen eingefügt und ihnen werden neue Global ID-Werte zugewiesen.Wenn Sie nur die Geometrie des Ziel-Dataset aktualisieren möchten, aktivieren Sie den Parameter Geometrie aktualisieren, und stellen Sie sicher, dass der Parameter Kandidatenfelder nur den Namen des Abgleichfeldes enthält. Wenn beispielsweise für den Parameterwert Abgleichfelder für Aktualisierung das Feld
globalidverwendet wird, dann sollte der Parameter Kandidatenfelder nur das Feldglobalidenthalten.
Parameter
| Beschriftung | Erläuterung | Datentyp |
|---|---|---|
|
Eingabe-Datasets |
Die Eingabe-Datasets, die die Daten enthalten, die an das Ziel-Dataset angehängt werden. Bei den Eingabe-Datasets kann es sich um Point-, Line- oder Polygon-Feature-Classes, Tabellen, Raster, Annotation-Feature-Classes oder Dimension-Feature-Classes handeln. Tabellen und Feature-Classes können kombiniert werden. Wird eine Feature-Class an eine Tabelle angehängt, werden die Attribute übertragen, die Features jedoch entfernt. Wird eine Tabelle an eine Feature-Class angehängt, haben die Zeilen aus der Eingabetabelle eine NULL-Geometrie. |
Table View; Raster Layer |
|
Ziel-Dataset |
Das vorhandene Dataset, an das die Daten der Eingabe-Datasets angehängt werden. |
Table View; Raster Layer |
|
Typ der Feldübereinstimmung (Optional) |
Gibt an, ob die Felder der Eingabe-Datasets den Feldern des Ziel-Datasets entsprechen müssen, damit die Daten angehängt werden können.
|
String |
|
Feldzuordnung (Optional) |
Der Parameter "Feldzuordnung" steuert die Übertragung oder Zuordnung von Feldern aus den Eingabe-Datasets in das Ziel-Dataset. Er kann nur verwendet werden, wenn der Parameter Typ der Feldübereinstimmung auf Feldzuordnung zum Abgleichen von Feld-Unterschieden verwenden festgelegt ist. Da die Eingabe-Datasets an ein vorhandenes Ziel-Dataset angehängt werden, das vordefinierte Felder hat, können Sie die Eigenschaften der Felder in der Feldzuordnung nicht hinzufügen, neu anordnen, entfernen oder ändern. Die Feldzuordnung kann verwendet werden, um Werte aus einem oder mehreren Eingabefeldern in einem einzigen Ausgabefeld zu kombinieren. |
Field Mappings |
|
Subtype (Optional) |
Die Subtype-Beschreibung, die allen neuen Daten zugewiesen wird, die an das Ziel-Dataset angefügt werden. |
String |
|
Ausdruck (Optional) |
Der SQL-Ausdruck, mit dem eine Teilmenge der Datensätze des Eingabe-Datasets ausgewählt wird. Wenn mehrere Eingabe-Datasets angegeben werden, werden sie alle anhand des Ausdrucks ausgewertet. Wenn keine Datensätze dem Ausdruck für ein Eingabe-Dataset entsprechen, werden keine Datensätze aus diesem Dataset an das Ziel-Dataset angehängt. Weitere Informationen zur SQL-Syntax finden Sie unter SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke. |
SQL Expression |
|
Abgleichfelder für Aktualisierung (Optional) |
Die Felder aus den Eingabe-Datasets, die zum Abgleich mit dem Ziel-Dataset verwendet werden. Wenn die Werte dieser Felder übereinstimmen, werden die entsprechenden Datensätze des Ziel-Datasets durch die Datensätze aus den Eingabe-Datasets aktualisiert. Spalten der Wertetabelle:
|
Value Table |
|
Geometrie aktualisieren (Optional) |
Gibt an, ob die Geometrie im Ziel-Dataset durch die Geometrie aus den Eingabe-Datasets aktualisiert wird, wenn die Feldwerte des Parameters
|
Boolean |
|
Domänen erzwingen (Optional) |
Gibt an, ob die Felddomänen des Ziels erzwungen werden.
|
Boolean |
|
Performance für Feature-Services optimieren (Optional) |
Gibt an, ob die Performance optimiert wird, wenn es sich beim Ziel-Dataset um einen Feature-Service in ArcGIS Online oder ArcGIS Enterprise handelt. Dieser Parameter ist nur aktiv, wenn das Ziel-Dataset die Optimierung unterstützt.
|
Boolean |
|
Kandidatenfelder (Optional) |
Die Felder, die im Ziel-Dataset aktualisiert oder eingefügt werden. Verwenden Sie diesen Parameter, wenn eine Teilmenge von Feldern im Ziel-Dataset aktualisiert oder eingefügt werden soll. Beim Einfügen neuer Datensätze weisen Felder, die nicht in dieser Liste enthalten sind, NULL-Werte auf. |
Field |
|
Optionen für das Überspringen (Optional) |
Gibt an, ob Aktualisierungen oder Einfügungen übersprungen werden, wenn der Parameter Abgleichfelder für Aktualisierung angegeben ist.
|
String |
Abgeleitete Ausgabe
| Beschriftung | Erläuterung | Datentyp |
|---|---|---|
|
Aktualisiertes Ziel-Dataset |
Das aktualisierte Ziel-Dataset. |
Table View; Raster Layer |
|
Anzahl angehängter Zeilen |
Die Anzahl der angehängten Zeilen im Ziel-Dataset. Wenn der Parameter Performance für Feature-Services optimieren aktiviert ist, und der Parameterwert Abgleichfelder für Aktualisierung angegeben wurde, werden sämtliche Aktualisierungs- und Einfügevorgänge gezählt. |
Long |
|
Anzahl aktualisierter Zeilen |
Die Anzahl der aktualisierten Zeilen im Ziel-Dataset. Für Ziel-Feature-Service-Datasets wird die Anzahl der aktualisierten Zeilen nicht angegeben, wenn der Parameter Performance für Feature-Services optimieren aktiviert ist. |
Long |
Umgebungen
Ausdehnung, Aktueller Workspace, Global-IDs beibehalten, Anlagen beibehalten, Geographische Transformationen
Sonderfälle
- Global-IDs beibehalten
-
For the Append tool, this environment will only preserve Global ID values from the input dataset if the target Global ID field has a unique index. If the target Global ID field does not have a unique index, the tool may fail. To add a unique index to a Global ID field, use the Add Attribute Index tool.
If the target dataset contains a Global ID field and the input data does not, running the Append tool with this environment set to
Truewill automatically generate new Global ID values for inserted rows.This environment is ignored for target feature services. To preserve Global IDs for feature services that support optimization, check the Optimize performance for feature services parameter and specify GlobalID as the match fields in the Matching Fields for Update parameter.
Lizenzierungsinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja