Features exportieren (Conversion)

Zusammenfassung

Konvertiert eine Feature-Class oder einen Feature-Layer in eine neue Feature-Class.

Verwendung

  • Verwenden Sie den Parameter Feldzuordnung, um die Felder und deren Inhalte im Ausgabe-Dataset zu verwalten.

    • Sie können Felder aus der Feldliste hinzufügen und entfernen, die Feldliste umsortieren und Felder umbenennen.
    • Als Datentyp der Ausgabefelder wird der Datentyp des zuerst gefundenen Eingabefeldes (dieses Namens) übernommen. Sie können den Datentyp in einen anderen gültigen Datentyp ändern.
    • Verwenden Sie eine Aktion, um festzulegen, wie Werte aus einem oder mehreren Eingabefeldern in einem einzigen Ausgabefeld zusammengeführt 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 Schaltfläche Text ausschneiden bei Textquellfeldern, um auszuwählen, welche Zeichen aus einem Eingabewert in das Ausgabefeld 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 mit Python-Skripts zugeordnet werden.

  • Ein SQL-Ausdruck kann zur Auswahl einer Feature-Teilmenge verwendet werden. Weitere Informationen zur Syntax des Parameters Ausdruck finden Sie unter SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke.

  • Zeilen können in aufsteigender oder absteigender Reihenfolge neu angeordnet werden, indem ein Wert für den Parameter Sortierfeld angegeben wird. Wurde mehr als ein Feld angegeben, werden die Zeilen zuerst nach dem ersten Feld sortiert und innerhalb dieser Sortierung dann nach dem zweiten Feld usw.

  • Beim Konvertieren von Geodatabase-Daten, die Subtypes oder Domänen aufweisen und für die Sie keine Geodatabase als Ausgabe-Workspace verwenden, sind sowohl die Subtypes und die Domänencodes als auch die Beschreibungen in der Ausgabe enthalten. Verwenden Sie die Umgebung zum Felddomänen-Beschreibungen übertragen, um dieses Verhalten zu steuern. Standardmäßig sind nur Domänen- und Subtype-Codes in der Ausgabe enthalten, keine Beschreibungen.

    Hinweis:

    Die Konvertierung in ein Shapefile mit Subtype- und Domänenbeschreibungen kann länger dauern (verlangsamte Performance) als ohne Beschreibungen. Wenn keine Subtype- und Domänenbeschreibungen in der Ausgabe benötigt werden, sollten Sie für eine optimale Performance die Umgebung "Felddomänen-Beschreibungen übertragen" deaktiviert lassen.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Die Eingabe-Features, die in eine neue Feature-Class exportiert werden sollen.

Feature Layer
Ausgabe-Feature-Class

Die Ausgabe-Feature-Class, die die exportierten Features enthält.

Feature Class
Ausdruck
(optional)

Ein SQL-Ausdruck, mit dem eine Feature-Teilmenge ausgewählt wird.

SQL Expression
Feld-Alias als Name verwenden
(optional)

Gibt an, ob die Feldnamen oder Feldaliasnamen der Eingabe als Ausgabefeldname verwendet werden.

  • Deaktiviert: Die Feldnamen der Eingabe werden als Ausgabefeldnamen verwendet. Dies ist die Standardeinstellung.
  • Aktiviert: Die Feldaliasnamen der Eingabe werden als Ausgabefeldnamen verwendet.
Boolean
Feldzuordnung
(optional)

Die Felder, die in das Ausgabe-Dataset übertragen werden sollen, mit ihren jeweiligen Eigenschaften und Quellfeldern. Standardmäßig enthält die Ausgabe alle Felder des Eingabe-Datasets.

Verwenden Sie die Feldzuordnung, um Felder hinzuzufügen, zu löschen, umzubenennen und neu anzuordnen sowie andere Feldeigenschaften zu ändern.

Die Feldzuordnung kann auch verwendet werden, um Werte aus zwei oder mehr Eingabefeldern in einem einzigen Ausgabefeld zu kombinieren.

Field Mappings
Sortierfeld
(optional)

Das Feld bzw. die Felder sowie die Sortierreihenfolge, mit denen die Eingabedatensätze neu angeordnet und sortiert werden.

  • Aufsteigend: Die Datensätze werden vom niedrigsten bis zum höchsten Wert sortiert.
  • Absteigend: Die Datensätze werden vom höchsten bis zum niedrigsten Wert sortiert.

Value Table

arcpy.conversion.ExportFeatures(in_features, out_features, {where_clause}, {use_field_alias_as_name}, {field_mapping}, {sort_field})
NameErläuterungDatentyp
in_features

Die Eingabe-Features, die in eine neue Feature-Class exportiert werden sollen.

Feature Layer
out_features

Die Ausgabe-Feature-Class, die die exportierten Features enthält.

Feature Class
where_clause
(optional)

Ein SQL-Ausdruck, mit dem eine Feature-Teilmenge ausgewählt wird. Weitere Informationen zur SQL-Syntax finden Sie im Hilfethema SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke.

SQL Expression
use_field_alias_as_name
(optional)

Gibt an, ob die Feldnamen oder Feldaliasnamen der Eingabe als Ausgabefeldname verwendet werden.

  • NOT_USE_ALIASDie Feldnamen der Eingabe werden als Ausgabefeldnamen verwendet. Dies ist die Standardeinstellung.
  • USE_ALIASDie Feldaliasnamen der Eingabe werden als Ausgabefeldnamen verwendet.
Boolean
field_mapping
(optional)

Die Felder, die in das Ausgabe-Dataset übertragen werden sollen, mit ihren jeweiligen Eigenschaften und Quellfeldern. Standardmäßig enthält die Ausgabe alle Felder des Eingabe-Datasets.

Verwenden Sie die Feldzuordnung, um Felder hinzuzufügen, zu löschen, umzubenennen und neu anzuordnen sowie andere Feldeigenschaften zu ändern.

Die Feldzuordnung kann auch verwendet werden, um Werte aus zwei oder mehr Eingabefeldern in einem einzigen Ausgabefeld zu kombinieren.

Field Mappings
sort_field
[sort_field,...]
(optional)

Das Feld bzw. die Felder sowie die Sortierreihenfolge, mit denen die Eingabedatensätze neu angeordnet und sortiert werden.

  • ASCENDING: Die Datensätze werden vom niedrigsten bis zum höchsten Wert sortiert.
  • DESCENDING: Die Datensätze werden vom höchsten bis zum niedrigsten Wert sortiert.

Value Table

Codebeispiel

ExportFeatures: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion ExportFeatures im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data/SFValley.gdb"
arcpy.conversion.ExportFeatures("streets", "C:/output/output.gdb/streets")
ExportFeatures: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion ExportFeatures verwendet wird.

# Name: ExportFeatures_Example2.py
# Description: Use Export Features with an expression to create a subset of the
# original feature class.

# Import system modules

import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/SFValley.gdb"

# Set local variables
inFeatures = "streets"
outFeatureClass =  "C:/output/output.gdb/arterials"
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "Category") + " = 'Arterials'"

# Run ExportFeatures
arcpy.conversion.ExportFeatures(inFeatures, outFeatureClass, expression,
                               "NOT_USE_ALIAS")

Verwandte Themen