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 FieldMappings für den Parameter field_mapping in 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-Datasets ü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-Datasets ü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-Datasets ü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.
Dieses Werkzeug kann zur Gewährleistung einer optimalen Performance direkt im Back-End-Data-Store, auf dem Server oder in der Datenbank für Web-Feature-Layer verwendet werden. Bei Feature-Services, die eine Geodatabase referenzieren, kann dieses Werkzeug mit einer Datenbankverbindung verwendet werden, um große Datenmengen direkt in die zugrunde liegende Datenbank zu laden. Bei gehosteten Services in ArcGIS Enterprise können Sie die append-Operation über die Feature-Layer-Elementseite oder die ArcGIS REST API verwenden.
Für eine optimale Performance bei Feature-Services in ArcGIS Online und ArcGIS Enterprise können Administratoren und Service-Besitzer dieses Werkzeug mit der ArcGIS REST API verwenden, wenn die Eigenschaft supportsAppend auf true festgelegt 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 Feature-Layer oder Web-Layer in ArcGIS Enterprise, die registrierte Daten referenzieren, muss die Bearbeitung mit den Optionen "Hinzufügen", "Löschen" oder "Aktualisieren" aktiviert sein (dies aktiviert die Funktion Uploads).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, geschieht Folgendes:
- Das Werkzeug verwendet die ArcGIS REST API für eine 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 das 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 ID aufweisen, werden die Global ID-Werte beibehalten. Wenn die Felder Global ID nicht enthalten sind, werden alle Eingabe-Zeilen eingefügt und ihnen werden neue Global ID-Werte zugewiesen.
