Zusammenfassung
Benennen Sie Felder und Feldaliasnamen um oder ändern Sie die Feldeigenschaften.
Verwendung
Mit diesem Werkzeug können Sie Felder oder Feld-Aliasnamen in einer beliebigen Geodatabase-Tabelle oder Feature-Class umbenennen.
Für leere Geodatabase-Tabellen oder Feature-Classes können Sie Feldeigenschaften wie den Feldtyp, die Länge oder die NULL-Zulässigkeit ändern.
Wenn Sie In-Memory-Feature-Classes oder -Tabellen verwenden, die Felder OBJECTID, Shape oder andere erforderliche Felder, wie etwa die in Netzwerkanalyse-Layern, umbenennen, kann dies zu beschädigten Daten oder unerwartetem Verhalten führen.
Syntax
AlterField_management (in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})| Parameter | Erläuterung | Datentyp |
in_table | Eingabetabelle oder Feature-Class mit dem Feld, das geändert werden soll. | Table View |
field | Der Feldname, der geändert werden soll. Wenn es sich bei dem Feld um ein erforderliches Feld handelt (isRequired=true), können nur die Feldaliasnamen geändert werden. | Field |
new_field_name (optional) | Der neue Name für das Feld. | String |
new_field_alias (optional) | Der neue Feld-Aliasname für das Feld. | String |
field_type (optional) | Der neue Feldtyp für das Feld. Nur bei leerer Eingabetabelle relevant (enthält keine Datensätze).
| 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. Diese Option ist nur für Felder des Typs TEXT oder BLOB anwendbar. Nur bei leerer Tabelle relevant. | Long |
field_is_nullable (optional) | Bestimmt, ob das Feld Nullwerte enthalten darf. Nullwerte werden nur für Felder in einer Geodatabase unterstützt. Nur bei leerer Eingabetabelle relevant (enthält keine Datensätze).
| Boolean |
clear_field_alias (optional) | Legen Sie fest, ob der Aliasname für das Eingabefeld gelöscht werden soll. Dieser Parameter für Feldaliasnamen muss leer sein, um den Aliasnamen des Feldes zu löschen.
| Boolean |
Codebeispiel
AlterField – Beispiel 1 (Python-Fenster)
Im folgenden Skript im Python-Fenster wird veranschaulicht, wie das Werkzeug "AlterField" im unmittelbaren Modus verwendet wird.
arcpy.AlterField_management(r'C:\Data\Garbo.gdb\Khyber', 'Elev', 'ELEVATION', 'Elevation in Metres')
AlterField – Beispiel 2 (eigenständiges Skript)
Im folgenden Skript im Python-Fenster wird veranschaulicht, wie das Werkzeug "AlterField" in einem eigenständigen Python-Skript verwendet wird.
#Import geoprocessing
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: #loop through each field
if field.name.lower() == 'elev': #look for the name elev
arcpy.AlterField_management(fc, field.name, 'ELEVATION', 'Elevation in Metres')
AlterField – Beispiel 3 (eigenständiges Skript)
Im folgenden Skript im Python-Fenster wird veranschaulicht, wie das Werkzeug "AlterField" für eine leere Feature-Class in einem eigenständigen Python-Skript verwendet wird.
#Import geoprocessing
import arcpy
#Set local variables
fc = "C:/Data/Garbo.gdb/trails" #Note:empty feature class
field = "condition_rating" #short int, non nullable field
new_name = "notes"
new_alias = "Comments on Trail Condition"
new_type = "TEXT"
new_length = "60"
new_is_nullable = "NULLABLE"
clear_alias = "FALSE"
#Alter the properties of a non nullable, short data type field to become a text field
arcpy.AlterField_management(fc, field, new_name, new_alias, new_type, new_length, new_is_nullable, clear_alias)
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Ja
- ArcGIS for Desktop Standard: Ja
- ArcGIS for Desktop Advanced: Ja