Tabelle exportieren (Konvertierung)

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:

    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 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 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

BeschriftungErläuterungDatentyp
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.

  • 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.ExportTable(in_table, out_table, {where_clause}, use_field_alias_as_name, {field_mapping}, {sort_field})
NameErläuterungDatentyp
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.

  • 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

ExportTable: Beispiel 1 (Python-Fenster)

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")
ExportTable: Beispiel 2 (eigenständiges Skript)

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")