Feld ändern (Data Management)

Zusammenfassung

Benennt Felder und Feldaliasnamen um, oder ändert die Feldeigenschaften.

Verwendung

    Vorsicht:

    Mit diesem Werkzeug werden die Eingabedaten geändert. Weitere Informationen und Strategien zur Vermeidung unerwünschter Datenänderungen finden Sie unter Werkzeuge, die Eingabedaten ändern oder aktualisieren.

  • Mit diesem Werkzeug können Sie Felder oder Feldaliasnamen in einer Geodatabase-Tabelle oder Feature-Class umbenennen.

  • Mit diesem Werkzeug können Sie den Feldaliasnamen eines Feldes in einer Tabelle oder Sicht ändern, die in der Geodatenbank registriert wurde.

  • Wenn es sich bei dem Eingabefeld um ein erforderliches Feld handelt, können nur die Feldaliasnamen geändert werden.

Parameter

BeschriftungErläuterungDatentyp
Eingabetabelle

Die Eingabe-Geodatabase-Tabelle oder -Feature-Class mit dem Feld, das geändert wird.

Table View; Raster Layer; Mosaic Layer
Feldname

Der Name des zu ändernden Feldes. Wenn es sich bei dem Feld um ein erforderliches Feld handelt, werden nur die Feldaliasnamen geändert.

Field
Neuer Feldname
(optional)

Der neue Name für das Feld.

String
Neuer Feld-Alias
(optional)

Der neue Feldaliasname für das Feld.

String
Neuer Feldtyp
(optional)

Gibt den neuen Feldtyp für das Feld an. Dieser Parameter gilt nur für eine leere Eingabetabelle (ohne Datensätze).

  • Short (16-Bit-Integer)Der Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767.
  • Long (32-Bit-Integer)Der Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647.
  • Big Integer (64-Bit-Ganzzahl)Der Feldtyp ist "Big Integer". Felder des Typs "Big Integer" unterstützen ganze Zahlen zwischen -(253) und 253.
  • Float (32-Bit-Gleitkomma)Der Feldtyp ist "Float". Felder des Typs "Float" unterstützen Bruchzahlen zwischen -3,4E38 und 1,2E38.
  • Double (64-Bit-Gleitkomma)Der Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308.
  • TextDer Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge.
  • DatumDer Feldtyp ist "Date". Felder des Typs "Date" unterstützen Datums- und Uhrzeitwerte.
  • Nur DatumDer Feldtyp ist "Nur Datum". Felder des Typs "Nur Datum" unterstützen Datumswerte ohne Uhrzeitwerte.
  • Nur ZeitDer Feldtyp ist "Nur Zeit". Felder des Typs "Nur Zeit" unterstützen Uhrzeitwerte ohne Datumswert.
  • ZeitstempelversatzDer Feldtyp ist "Zeitstempelversatz". Felder des Typs "Zeitstempelversatz" unterstützen ein Datum, eine Uhrzeit und einen Versatz vom UTC-Wert.
  • Blob (Binärdaten)Der Feldtyp ist "BLOB". BLOB-Felder unterstützen Daten, die als lange Abfolge von binären Zahlen gespeichert sind. Sie benötigen ein spezielles Programm zum Laden und Anschauen oder eine Anwendung eines Drittanbieters, um Objekte in ein BLOB-Feld zu laden bzw. den Inhalt in einem BLOB-Feld anzuzeigen.
  • GUID (Globally Unique Identifier)Der Feldtyp ist "GUID". In GUID-Feldern werden Zeichenfolgen aus 36 Zeichen gespeichert (ähnlich denen in der Registrierung), die in geschweifte Klammern eingeschlossen sind.
  • RasterDer Feldtyp ist "Raster". In Raster-Feldern können Raster-Daten innerhalb oder zusammen mit der Geodatabase gespeichert werden. Es können zwar alle von der ArcGIS-Software unterstützten Raster-Dataset-Formate gespeichert werden, es wird jedoch empfohlen, nur kleine Bilder zu verwenden.
String
Neue Feldlänge
(optional)

Die neue Länge des Feldes. Dadurch wird die maximal zulässige Anzahl von Zeichen für jeden Datensatz des Feldes festgelegt. Dieser Parameter gilt nur für Felder des Typs Text oder Blob (Binärdaten). Wenn die Tabelle leer ist, kann die Feldlänge erhöht oder verringert werden. Wenn die Tabelle nicht leer ist, kann die Feldlänge lediglich ausgehend vom aktuellen Wert erhöht werden.

Long
Neues Feld erlaubt NULL-Werte
(optional)

Gibt an, ob NULL-Werte im Feld enthalten sein dürfen. NULL-Werte werden nur für Felder in einer Geodatabase unterstützt. Dieser Parameter gilt nur für eine leere Tabelle (ohne Datensätze).

  • Aktiviert: Das NULL-Werte kann NULL-Werte enthalten. Dies ist die Standardeinstellung.
  • Deaktiviert: Das Feld darf keine NULL-Werte enthalten.
Boolean
Alias löschen
(optional)

Gibt an, ob der Alias für das Eingabefeld gelöscht wird. Der Parameterwert für Neuer Feld-Alias muss leer sein, um den Aliasnamen des Feldes zu löschen.

  • Aktiviert: Der Feldaliasname wird gelöscht (auf NULL gesetzt). Der Parameter für Feldaliasnamen muss leer sein.
  • Deaktiviert: Der Feldaliasname wird nicht gelöscht. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Eingabetabelle

Die aktualisierte Eingabetabelle.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AlterField(in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})
NameErläuterungDatentyp
in_table

Die Eingabe-Geodatabase-Tabelle oder -Feature-Class mit dem Feld, das geändert wird.

Table View; Raster Layer; Mosaic Layer
field

Der Name des zu ändernden Feldes. Wenn es sich bei dem Feld um ein erforderliches Feld handelt, werden nur die Feldaliasnamen geändert.

Field
new_field_name
(optional)

Der neue Name für das Feld.

String
new_field_alias
(optional)

Der neue Feldaliasname für das Feld.

String
field_type
(optional)

Gibt den neuen Feldtyp für das Feld an. Dieser Parameter gilt nur für eine leere Eingabetabelle (ohne Datensätze).

  • SHORTDer Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767.
  • LONGDer Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647.
  • BIGINTEGERDer Feldtyp ist "Big Integer". Felder des Typs "Big Integer" unterstützen ganze Zahlen zwischen -(253) und 253.
  • FLOATDer Feldtyp ist "Float". Felder des Typs "Float" unterstützen Bruchzahlen zwischen -3,4E38 und 1,2E38.
  • DOUBLEDer Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308.
  • TEXTDer Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge.
  • DATEDer Feldtyp ist "Date". Felder des Typs "Date" unterstützen Datums- und Uhrzeitwerte.
  • DATEONLYDer Feldtyp ist "Nur Datum". Felder des Typs "Nur Datum" unterstützen Datumswerte ohne Uhrzeitwerte.
  • TIMEONLYDer Feldtyp ist "Nur Zeit". Felder des Typs "Nur Zeit" unterstützen Uhrzeitwerte ohne Datumswert.
  • TIMESTAMPOFFSETDer Feldtyp ist "Zeitstempelversatz". Felder des Typs "Zeitstempelversatz" unterstützen ein Datum, eine Uhrzeit und einen Versatz vom UTC-Wert.
  • BLOBDer Feldtyp ist "BLOB". BLOB-Felder unterstützen Daten, die als lange Abfolge von binären Zahlen gespeichert sind. Sie benötigen ein spezielles Programm zum Laden und Anschauen oder eine Anwendung eines Drittanbieters, um Objekte in ein BLOB-Feld zu laden bzw. den Inhalt in einem BLOB-Feld anzuzeigen.
  • GUIDDer Feldtyp ist "GUID". In GUID-Feldern werden Zeichenfolgen aus 36 Zeichen gespeichert (ähnlich denen in der Registrierung), die in geschweifte Klammern eingeschlossen sind.
  • RASTERDer Feldtyp ist "Raster". In Raster-Feldern können Raster-Daten innerhalb oder zusammen mit der Geodatabase gespeichert werden. Es können zwar alle von der ArcGIS-Software unterstützten Raster-Dataset-Formate gespeichert werden, es wird jedoch empfohlen, nur kleine Bilder zu verwenden.
String
field_length
(optional)

Die neue Länge des Feldes. Dadurch wird die maximal zulässige Anzahl von Zeichen für jeden Datensatz des Feldes festgelegt. Dieser Parameter gilt nur für Felder des Typs TEXT oder BLOB. Wenn die Tabelle leer ist, kann die Feldlänge erhöht oder verringert werden. Wenn die Tabelle nicht leer ist, kann die Feldlänge lediglich ausgehend vom aktuellen Wert erhöht werden.

Long
field_is_nullable
(optional)

Gibt an, ob NULL-Werte im Feld enthalten sein dürfen. NULL-Werte werden nur für Felder in einer Geodatabase unterstützt. Dieser Parameter gilt nur für eine leere Eingabetabelle (ohne Datensätze).

  • NULLABLEDas Feld kann NULL-Werte enthalten. Dies ist die Standardeinstellung.
  • NON_NULLABLEDas Feld darf keine NULL-Werte enthalten.
Boolean
clear_field_alias
(optional)

Gibt an, ob der Alias für das Eingabefeld gelöscht wird. Der Parameter new_field_alias muss leer sein, um den Aliasnamen des Feldes zu löschen.

  • CLEAR_ALIASDer Feldaliasname wird gelöscht (auf NULL gesetzt).
  • DO_NOT_CLEARDer Feldaliasname wird nicht gelöscht. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_table

Die aktualisierte Eingabetabelle.

Table View; Raster Layer; Mosaic Layer

Codebeispiel

AlterField: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.management.AlterField(
    r'C:\Data\Garbo.gdb\Khyber', 'Elev', 'ELEVATION', 'Elevation in Metres')
AlterField: Beispiel 2 (eigenständiges Skript)

Im folgenden Skript für das -Fenster wird veranschaulicht, wie die Funktion AlterFieldPythonin einem eigenständigen Skript verwendet wird.

import arcpy

# Set workspace
arcpy.env.workspace = r'C:\Data\Garbo.gdb'

# Loop through feature classes looking for a field named 'elev'
fcList = arcpy.ListFeatureClasses()  # Get a list of feature classes
for fc in fcList:  # Loop through feature classes
    fieldList = arcpy.ListFields(fc)  # Get a list of fields for each feature class
    for field in fieldList:  # Lloop through each field
        if field.name.lower() == 'elev':  # Look for the name elev
            arcpy.management.AlterField(fc, field.name, 'ELEVATION', 'Elevation in Metres')
AlterField: Beispiel 3 (eigenständiges Skript)

Im folgenden Skript für das Python-Fenster wird veranschaulicht, wie die Funktion AlterField für eine leere Feature-Class in einem eigenständigen Skript verwendet wird.

import arcpy

# Set local variables
in_table = "C:/Data/Garbo.gdb/trails"  # Note: empty feature class
field = "condition_rating"  # short int, non nullable field
new_field_name = "notes"
new_field_alias = "Comments on Trail Condition"
field_type = "TEXT"
field_length = 60
field_is_nullable = "NULLABLE"
clear_field_alias = "FALSE"

# Alter the properties of a non nullable, short data type field to become a text field
arcpy.management.AlterField(in_table,
                            field,
                            new_field_name,
                            new_field_alias,
                            field_type,
                            field_length,
                            field_is_nullable,
                            clear_field_alias)

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen