Feld hinzufügen (Data Management)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Fügt einer Tabelle oder der Tabelle einer Feature-Class, einem Feature-Layer, Raster-Katalog und/oder Raster mit Attributtabellen ein neues Feld hinzu.

Verwendung

Syntax

AddField_management (in_table, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable}, {field_is_required}, {field_domain})
ParameterErläuterungDatentyp
in_table

Die Eingabetabelle, der das Feld hinzugefügt wird. Das Feld wird der vorhandenen Eingabetabelle hinzugefügt. Es wird keine neue Ausgabetabelle erstellt.

Sie können Feature-Classes von ArcSDE-, File- oder Personal-Geodatabases, Coverages, Shapefiles, Raster-Katalogen sowie Standalone-Tabellen, Rastern mit Attributtabellen und/oder Layern Felder hinzufügen.

Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View
field_name

Der Name des Feldes, das der Eingabetabelle hinzugefügt wird.

String
field_type

Der für die Erstellung des neuen Feldes verwendete Feldtyp.

  • TEXTNamen oder andere Textangaben.
  • FLOATNumerische Werte mit Bruchzahlen innerhalb eines spezifischen Bereichs.
  • DOUBLENumerische Werte mit Bruchzahlen innerhalb eines spezifischen Bereichs.
  • SHORTNumerische Werte ohne Bruchzahlen innerhalb eines spezifischen Bereichs; codierte Werte.
  • LONGNumerische Werte ohne Bruchzahlen innerhalb eines bestimmten Bereichs.
  • DATEDatum und/oder Uhrzeit.
  • BLOBBilder oder andere Multimedia-Elemente.
  • RASTERRaster-Bilder.
  • GUIDGUID-Werte.
String
field_precision
(optional)

Bestimmt die Anzahl der Ziffern, die im Feld gespeichert werden können. Dabei werden alle Ziffern berücksichtigt, unabhängig davon, auf welcher Seite des Dezimalkommas sie sich befinden.

Handelt es sich bei der Eingabetabelle um eine Personal- oder File-Geodatabase, wird der Genauigkeitswert des Feldes ignoriert.

Long
field_scale
(optional)

Legt die Anzahl der Dezimalstellen fest, die in einem Feld gespeichert werden können. Dieser Parameter wird nur für die Felddatentypen "Float" und "Double" verwendet.

Handelt es sich bei der Eingabetabelle um eine Personal- oder File-Geodatabase, wird der Maßstabswert des Feldes ignoriert.

Long
field_length
(optional)

Die Länge des hinzugefügten Feldes. Dadurch wird die maximal zulässige Anzahl von Zeichen für jeden Datensatz des Feldes festgelegt. Diese Option ist nur in Feldern des Typs "Text" oder "Blob" anwendbar.

Long
field_alias
(optional)

Der alternative Name für den Feldnamen. Dieser dient als aussagekräftigere Beschreibung für kryptische Feldnamen. Der Parameter "Feldalias" gilt nur für Geodatabases und Coverages.

String
field_is_nullable
(optional)

Ein geographisches Feature, das keine zugehörigen Attributinformationen besitzt. Der Parameter unterscheidet sich von Nullfeldern oder leeren Feldern. Er wird nur für Felder in einer Geodatabase unterstützt.

  • NON_NULLABLENULL-Werte sind für das Feld nicht zulässig.
  • NULLABLENULL-Werte sind für das Feld zulässig. Dies ist die Standardeinstellung.
Boolean
field_is_required
(optional)

Legt fest, ob es sich bei dem erstellten Feld um ein erforderliches Feld für die Tabelle handelt. Dieser Parameter wird nur für Felder in einer Geodatabase unterstützt.

  • NON_REQUIREDDas Feld ist kein erforderliches Feld. Dies ist die Standardeinstellung.
  • REQUIREDDas Feld ist ein erforderliches Feld. Erforderliche Felder sind permanent und können nicht gelöscht werden.
Boolean
field_domain
(optional)

Hiermit beschränken Sie die in einem bestimmten Attribut für eine Tabelle, eine Feature-Class oder einen Subtype in der Geodatabase zulässigen Werte. Sie müssen den Namen einer vorhandenen Domäne angeben, damit dieser Parameter auf das Feld angewendet wird.

String

Codebeispiel

AddField – Beispiel (Python-Fenster)

Im folgenden Skript im Python-Fenster wird veranschaulicht, wie das Werkzeug "AddField" im unmittelbaren Modus verwendet wird.

import arcpy
from arcpy import env
env.workspace = "C:/data/airport.gdb"
arcpy.AddField_management("schools", "ref_ID", "LONG", 9, "", "", "refcode", "NULLABLE", "REQUIRED")
AddField – Beispiel 2 (eigenständiges Skript)

Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug "AddField" verwendet wird.

# Name: AddField_Example2.py
# Description: Add a pair of new fields to a table
 
# Import system modules
import arcpy
from arcpy import env
 
# Set environment settings
env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inFeatures = "schools"
fieldName1 = "ref_ID"
fieldPrecision = 9
fieldAlias = "refcode"
fieldName2 = "status"
fieldLength = 10
 
# Execute AddField twice for two new fields
arcpy.AddField_management(inFeatures, fieldName1, "LONG", fieldPrecision, "", "",
                          fieldAlias, "NULLABLE")
arcpy.AddField_management(inFeatures, fieldName2, "TEXT", "", "", fieldLength)

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Ja
ArcGIS for Desktop Standard: Ja
ArcGIS for Desktop Advanced: Ja
9/11/2013