Добавить поле (Add Field) (Управление данными (Data Management))

Уровень лицензии:BasicStandardAdvanced

Резюме

Добавляет новое поле в таблицу или таблицу класса пространственных объектов, векторный слой, каталог растров и/или растры с атрибутивными таблицами.

Использование

Синтаксис

AddField_management (in_table, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable}, {field_is_required}, {field_domain})
ПараметрОбъяснениеТип данных
in_table

Входная таблица, к которой будет добавлено указанное поле. Поле будет добавлено к существующей входной таблице и не создаст новой выходной таблицы.

Поля могут быть добавлены в классы пространственных объектов ArcSDE, файловой или персональной баз геоданных, покрытия, шейп-файлы, каталоги растров, автономные таблицы, растры с таблицами атрибутов и/или слои.

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

Имя поля, добавляемого к входной таблице.

String
field_type

Тип создаваемого поля.

  • TEXTИмена или другие текстовые значения.
  • FLOATЧисловые значения с дробными значениями в пределах заданного интервала.
  • DOUBLEЧисловые значения с дробными значениями в пределах заданного интервала.
  • КОРОТКОЕЧисленные значения без дробных значений в пределах заданного интервала; кодированные значения.
  • LONGЧисловые значения без дробных значений в пределах заданного интервала.
  • DATEДата и/или время.
  • BLOBИзображения и другие виды мультимедиа.
  • RASTERРастровые изображения.
  • GUIDЗначения GUID
String
field_precision
(дополнительно)

Определяет общее количество цифр, хранимых в поле. Учитываются все цифры, независимо от их расположения относительно разделяющей запятой.

Если входная таблица - файловая или персональная база геоданных, значение точности поля будет игнорироваться.

Long
field_scale
(дополнительно)

Определяет количество знаков после запятой, хранимых в поле. Данный параметр применяется только для полей типа Float или Double.

Если входная таблица - файловая или персональная база геоданных, значение масштаба поля будет игнорироваться.

Long
field_length
(дополнительно)

Длина добавляемого поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция применяется только к полям типа текстовый или Blob.

Long
field_alias
(дополнительно)

Альтернативное имя, добавляемое в качестве псевдонима к имени поля. Используется для расшифровки кратких и трудных для восприятия имен полей. Возможность добавлять псевдонимы доступна только для полей в классах и таблицах базы геоданных и покрытиях.

String
field_is_nullable
(дополнительно)

Географический объект, для которого нет связанной атрибутивной информации. Отличается от значения 0 или от отсутствия значения.

  • NON_NULLABLEНулевые значения для поля недопустимы.
  • NULLABLEДопустимы нулевые значения для поля. Это значение по умолчанию.
Boolean
field_is_required
(дополнительно)

Определяет, будет ли создаваемое поле обязательным для таблицы или нет.Применимо только для полей базы геоданных.

  • NON_REQUIREDПоле не является обязательным. Это значение используется по умолчанию.
  • REQUIREDПоле является обязательным. Обязательные поля не могут быть удалены.
Boolean
field_domain
(дополнительно)

Этот инструмент добавляет поле к таблице любого класса пространственных объектов, векторного слоя и/или каталога растров. Вы должны определить имя существующего домена, чтобы он был применен к полю.

String

Пример кода

Добавить поле.Пример (окно Python)

На следующем скрипте окна Python демонстрируется, как использовать инструмент Добавить поле (Add Field) с запуском из окна Python в ArcGIS.

import arcpy
from arcpy import env
env.workspace = "C:/data/airport.gdb"
arcpy.AddField_management("schools", "ref_ID", "LONG", 9, "", "", "refcode", "NULLABLE", "REQUIRED")
Добавить поле.Пример 2 (автономный скрипт)

Пример скрипта Python для выполнения функции Добавить поле (Add Field).

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

Параметры среды

Связанные темы

Информация о лицензировании

ArcGIS for Desktop Basic: Да
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
9/10/2013