Beschriftung | Erläuterung | Datentyp |
Eingabetabelle | Die Eingabetabelle mit den Zeilen, die in eine neue Tabelle exportiert werden sollen. | Table View; Raster Layer |
Ausgabetabelle | Die Ausgabetabelle mit den exportierten Zeilen. Wenn es sich beim Ausgabeverzeichnis um einen Ordner handelt, geben Sie eine Erweiterung wie .csv, .txt oder .dbf an, um die Tabelle in diesem Format zu exportieren. Wenn es sich beim Ausgabeverzeichnis um eine Geodatabase handelt, geben Sie keine Erweiterung an. | Table |
Ausdruck (optional) | Ein SQL-Ausdruck, mit dem eine Teilmenge der Datensätze ausgewählt wird. | SQL Expression |
Feld-Alias als Name verwenden | Gibt an, ob die Feldnamen oder Feldaliasnamen der Eingabe als Ausgabefeldname verwendet werden.
| Boolean |
Feldzuordnung (optional) | Die Attributfelder, die in die Ausgabe geschrieben werden, sowie zugehörige Feldeigenschaften und Quellfelder. Standardmäßig werden alle Felder der Eingaben aufgenommen. Felder können hinzugefügt, gelöscht, umbenannt und neu angeordnet werden. Zudem können Sie deren Eigenschaften ändern. Mit Vereinigungsregeln geben Sie an, wie Werte aus zwei oder mehr Eingabefeldern zu einem einzigen Ausgabewert zusammengeführt bzw. kombiniert werden. Mit den folgenden Vereinigungsregeln können Sie bestimmen, wie das Ausgabefeld mit Werten gefüllt wird:
| Field Mappings |
Sortierfeld (optional) | Das Feld bzw. die Felder sowie die Sortierreihenfolge, mit denen die Eingabedatensätze neu angeordnet und sortiert werden.
| Value Table |
Zusammenfassung
Exportiert die Zeilen einer Tabelle oder Tabellensicht in eine Tabelle.
Verwendung
Das Werkzeug kopiert die Zeilen einer Tabelle, einer Tabellensicht, einer Feature-Class, eines Feature-Layers, einer durch Trennzeichen getrennten Datei oder eines Rasters mit einer Attributtabelle in eine neue Geodatabase- oder dBASE-Tabelle oder eine durch Trennzeichen getrennte Datei.
Dieses Werkzeug unterstützt die folgenden Tabellenformate als Eingabe:
- Geodatabase
- dBASE (.dbf)
- Microsoft Excel-Arbeitsblätter (.xls und .xlsx)
- Speicherbasierte Tabellen
- Durch Trennzeichen getrennte Dateien
- Kommagetrennte Dateien (.csv, .txt und .asc)
- Dateien mit Tabstopptrennzeichen (.tsv und .tab)
- Durch senkrechte Striche getrennte Dateien (.psv)
Für durch Trennzeichen getrennte Dateien wird die erste Zeile der Eingabedatei für die Feldnamen in der Ausgabetabelle verwendet. Feldnamen dürfen keine Leerzeichen oder Sonderzeichen (z. B. $ oder *) enthalten. Es tritt ein Fehler auf, wenn die erste Zeile der Eingabedatei Leerzeichen oder Sonderzeichen enthält.
Mit diesem Werkzeug kann eine durch Trennzeichen getrennte Datei ausgegeben werden. Dazu wird dem Ausgabenamen in einem Ordner-Workspace eine Datei mit einer der folgenden Erweiterungen hinzugefügt:
- Kommagetrennte Dateien (.csv, .txt oder .asc)
- Dateien mit Tabstopptrennzeichen (.tsv oder .tab)
- Durch senkrechte Striche getrennte Dateien (.psv)
Wenn die Ausgabe sich nicht in einer Geodatabase befindet, werden BLOB- oder Raster-Felder nicht einbezogen. GlobalID-Felder werden in Textfelder konvertiert.
Verwenden Sie den Parameter Feldzuordnung, um die Felder im Ausgabe-Dataset und deren Inhalt zu verwalten.
- Um die Feldreihenfolge zu ändern, wählen Sie den Namen eines Feldes aus, und ziehen Sie es an die neue Position.
- Als Datentyp der Ausgabefelder wird der Datentyp des zuerst gefundenen Eingabefeldes (dieses Namens) übernommen. Sie können den Datentyp jederzeit manuell in einen anderen gültigen Datentyp ändern.
- Die verfügbaren Vereinigungsregeln lauten: Erste(r), Letzte(r), Verbinden, Summe, Mittelwert, Medianwert, Modus, Minimum, Maximum, Standardabweichung und Anzahl.
- Bei der Anwendung der Vereinigungsregel Verbinden können Sie Ihr ein Trennzeichen angeben, wie z. B. Leerzeichen, Komma, Punkt, Bindestrich. Um ein Leerzeichen zu verwenden, muss sich der Mauszeiger am Anfang des Eingabefeldes befinden. Drücken Sie dann einmal die Leertaste.
- Sie können Start- und Endpositionen von Textfeldern mithilfe der Formatoption festlegen.
- Führen Sie die Standardabweichung nicht für eine einzelne Eingabe aus, da die Werte nicht durch 0 geteilt werden können. Die Standardabweichung ist daher keine gültige Option für Einzeleingaben.
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 eine dBASE-Tabelle mit Subtype- und Domänenbeschreibungen kann länger dauern (langsamere Performance) als ohne Beschreibungen. Wenn keine Subtype- und Domänenbeschreibungen in der Ausgabe benötigt werden, sollten Sie für eine optimale Performance die Standardeinstellung der Umgebung "Felddomänen-Beschreibungen übertragen" verwenden (Umgebung deaktiviert).
Parameter
arcpy.conversion.ExportTable(in_table, out_table, {where_clause}, use_field_alias_as_name, {field_mapping}, {sort_field})
Name | Erläuterung | Datentyp |
in_table | Die Eingabetabelle mit den Zeilen, die in eine neue Tabelle exportiert werden sollen. | Table View; Raster Layer |
out_table | Die Ausgabetabelle mit den exportierten Zeilen. Wenn es sich beim Ausgabeverzeichnis um einen Ordner handelt, geben Sie eine Erweiterung wie .csv, .txt oder .dbf an, um die Tabelle in diesem Format zu exportieren. Wenn es sich beim Ausgabeverzeichnis um eine Geodatabase handelt, geben Sie keine Erweiterung an. | Table |
where_clause (optional) | Ein SQL-Ausdruck, mit dem eine Teilmenge der Datensätze 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 | Gibt an, ob die Feldnamen oder Feldaliasnamen der Eingabe als Ausgabefeldname verwendet werden.
| Boolean |
field_mapping (optional) | Die Attributfelder, die in die Ausgabe geschrieben werden, sowie zugehörige Feldeigenschaften und Quellfelder. Standardmäßig werden alle Felder der Eingaben aufgenommen. Felder können hinzugefügt, gelöscht, umbenannt und neu angeordnet werden. Zudem können Sie deren Eigenschaften ändern. Mit Vereinigungsregeln geben Sie an, wie Werte aus zwei oder mehr Eingabefeldern zu einem einzigen Ausgabewert zusammengeführt bzw. kombiniert werden. Mit den folgenden Vereinigungsregeln können Sie bestimmen, wie das Ausgabefeld mit Werten gefüllt wird:
| 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.
| Value Table |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion ExportTable im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.ExportTable("vegtable.dbf", "C:/output/output.gdb/vegtable")
Das folgende eigenständige Skript veranschaulicht, wie die Funktion ExportTable verwendet wird.
# Description: Use TableToTable with an expression to create a subset
# of the original table.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inTable = "vegtable.dbf"
outTable = "C:/output/output.gdb/estuarine.csv"
# Set the expression, with help from the AddFieldDelimiters function, to select
# the appropriate field delimiters for the data type
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "VEG_TYPE") + " = 'Estuarine'"
# Run TableToTable
arcpy.conversion.ExportTable(inTable, outTable, expression, "NOT_USE_ALIAS")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja