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 Felder, die in das Ausgabe-Dataset übertragen werden sollen, mit ihren jeweiligen Eigenschaften und Quellfeldern. Die Ausgabe enthält standardmäßig alle Felder aus dem Eingabe-Dataset. 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.
| Value Table |
Zusammenfassung
Exportiert die Zeilen einer Tabelle oder Tabellensicht in eine neue 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 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.
- Der Standarddatentyp eines Ausgabefeldes ist der Datentyp des zuerst gefundenen Eingabefeldes (mit diesem Namen). Sie können den Datentyp in einen anderen gültigen Datentyp ändern.
- Verwenden Sie eine Aktion, um festzulegen, wie die 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 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 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 in 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 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 Umgebung "Felddomänen-Beschreibungen übertragen" deaktiviert lassen.
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 Felder, die in das Ausgabe-Dataset übertragen werden sollen, mit ihren jeweiligen Eigenschaften und Quellfeldern. Die Ausgabe enthält standardmäßig alle Felder aus dem Eingabe-Dataset. 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.
| 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