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

Краткая информация

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

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

Внимание:

Этот инструмент изменяет входные значения. Более подробно о стратегиях предотвращения нежелательных изменений данных см. в разделе Инструменты, которые изменяют или обновляют входные данные.

• Для шейп-файлов и таблиц dBase, если тип поля определяет символ, для каждой записи водятся пробелы. Если тип поля определяет числовой элемент, для каждой записи вводится 0.

• Длина поля применима только к полям текстового типа. Если длина поля не указана, будет использоваться длина 255.

• Для баз геоданных, если тип поля определяет буква или число, в каждую запись вводится <null>, если параметр Поле поддерживает пустые значения включен.

• Не поддерживающее значения null поле нельзя добавить в не пустой класс объектов и таблицу базы геоданных.

• Шейп-файл не поддерживает псевдонимы для полей, так что вы не можете добавить псевдонимы поля в шейп-файл.

• Вы можете использовать существующий домен из класса пространственных объектов в базе геоданных в качестве значения параметра Домен поля. Необходимо ввести имя существующего домена. Введение некорректных имен и значений доменов не приведет к тому, что инструмент не будет выполняться, но такие имена и значения будут проигнорированы, и для поля домен задан не будет.

• Разрядность и количество десятичных знаков поля представляют максимальный размер и точность данных, которые могут храниться в поле. Разрядность представляет количество цифр, которые могут храниться в поле, а количество десятичных знаков представляет количество знаков после запятой для полей с плавающей точкой и двойной точности. Например, если значение поля равняется 54,234, то количество десятичных знаков = 3, а разрядность = 5.

  Примечание:

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

  Для других типов баз данных, используйте следующие рекомендации для выбора корректного типа поля для заданной разрядности и точности:

  • Если вы создаете поля с плавающей точкой или двойной точности и задаете разрядность и количество десятичных знаков, то если разрядность больше 6, используйте значение двойной точности; в противном случае, используйте значение с плавающей точкой.
  • Для поля с числом десятичных знаков 0, используйте тип поля long или short integer. Если создается поле long integer, укажите разрядность 10 или менее, иначе будет создано поле типа double.

  Более подробно о типах числовых полей

• Обязательные поля постоянны, их невозможно удалить. Чтобы иметь возможность удалять их в дальнейшем, сделайте поле не обязательным (по умолчанию).

• Поле растрового типа позволяет иметь растровое изображение в качестве атрибута. Оно хранится внутри базы геоданных или рядом с ней. Это полезно, когда изображение является лучшим способом описания объекта. Точность, разрядность и длина не могут быть заданы для полей типа растр.

Параметры

Диалог

Подпись	Описание	Тип данных
Входная таблица	Входная таблица, куда будет добавлено указанное поле. Поле будет добавлено к существующей входной таблице и не создаст новой выходной таблицы. Поля могут быть добавлены в классы пространственных объектов в базах геоданных, шейп-файлы, покрытия, автономные таблицы, каталоги растров, растры с таблицами атрибутов и в слои.	Mosaic Layer; Raster Layer; Table View
Имя поля	Имя поля, добавляемого к входной таблице.	String
Тип поля	Задает тип для нового поля. Короткое целое (16-разрядное целочисленное)—Тип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767. Длинное целое (32-разрядное целочисленное)—Тип поля будет Длинное целое. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647. Большое целочисленное (64-разрядное целое число)—Типом поля будет большое целое. Поля типа Big integer поддерживают целые числа в диапазоне от -(2^53) до 2^53. С плавающей точкой (32-разрядное с плавающей точкой)—Тип поля будет С плавающей точкой. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38. Двойной точности (64-разрядное с плавающей точкой)—Тип поля будет Двойной точности. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308. Текст—Тип поля будет Текст. Текстовые поля поддерживают строку символов. Date—Типом поля будет Дата. Поля даты поддерживают значения даты и времени. Дата (высокой точности)—Типом поля будет дата высокой точности. Поля даты с высокой точностью поддерживают значения даты и времени с миллисекундами. Только дата—Типом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени. Только время—Типом поля будет только время. Поля только для времени поддерживают значения времени без значений дат. Сдвиг метки времени—Типом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. BLOB (большой двоичный объект)—Тип поля будет BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID (глобальный уникальный идентификатор)—Типом поля будет GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. Растр—Типом поля будет Растр. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения.	String
Разрядность поля (Дополнительный)	Число цифр, хранящихся в поле. Учитываются все цифры, независимо от их расположения относительно разделяющей запятой. Этот параметр применим только к числовым типам полей. Если входная таблица находится в файловой базе геоданных, значение разрядности поля будет игнорироваться.	Long
Точность поля (Дополнительный)	Количество знаков после запятой, хранящихся в поле. Этот параметр применим только к полям с плавающей точкой или double. Если входная таблица находится в файловой базе геоданных, значение точности поля будет игнорироваться.	Long
Длина поля (Дополнительный)	Длина поля Устанавливает максимально возможное количество знаков для каждой записи в поле. Если длина поля не указана, будет использоваться длина 255. Этот параметр доступен только для текстовых полей.	Long
Псевдоним поля (Дополнительный)	Альтернативное имя для поля. Это имя используется для описания непонятных имен полей. Данный параметр применяется только к базам геоданных.	String
Поле поддерживает нулевые значения (Дополнительный)	Определяет, может ли поле содержать пустые значения. Пустые (NULL) значения отличаются от 0 или пустых полей и поддерживаются только для полей в базе геоданных. Отмечено - поле может содержать значения null. Это значение по умолчанию Не отмечено – значения null для поля недопустимы.	Boolean
Обязательное поле (Дополнительный)	Определяет, будет ли создаваемое поле обязательным для таблицы или нет. Обязательные поля поддерживаются только базами геоданных. Отмечено – поле является обязательным. Обязательные поля постоянны, их невозможно удалить. Не отмечено – это поле не является обязательным. Это значение по умолчанию	Boolean
Домен поля (Дополнительный)	Ограничивает значения, поддерживаемые любом конкретным атрибутом таблицы, класса пространственных объектов или подтипа в базе геоданных. Вы должны определить имя существующего домена, чтобы он был применен к полю.	String

Производные выходные данные

Подпись	Описание	Тип данных
Обновленная входная таблица	Обновленная входная таблица.	Table

Python

arcpy.management.AddField(in_table, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable}, {field_is_required}, {field_domain})

Имя	Описание	Тип данных
in_table	Входная таблица, куда будет добавлено указанное поле. Поле будет добавлено к существующей входной таблице и не создаст новой выходной таблицы. Поля могут быть добавлены в классы пространственных объектов в базах геоданных, шейп-файлы, покрытия, автономные таблицы, каталоги растров, растры с таблицами атрибутов и в слои.	Mosaic Layer; Raster Layer; Table View
field_name	Имя поля, добавляемого к входной таблице.	String
field_type	Задает тип для нового поля. SHORT—Тип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767. LONG—Тип поля будет Длинное целое. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647. BIGINTEGER—Типом поля будет большое целое. Поля типа Big integer поддерживают целые числа в диапазоне от -(2^53) до 2^53. FLOAT—Тип поля будет С плавающей точкой. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38. DOUBLE—Тип поля будет Двойной точности. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308. TEXT—Тип поля будет Текст. Текстовые поля поддерживают строку символов. DATE—Типом поля будет Дата. Поля даты поддерживают значения даты и времени. DATEHIGHPRECISION—Типом поля будет дата высокой точности. Поля даты с высокой точностью поддерживают значения даты и времени с миллисекундами. DATEONLY—Типом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени. TIMEONLY—Типом поля будет только время. Поля только для времени поддерживают значения времени без значений дат. TIMESTAMPOFFSET—Типом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. BLOB—Тип поля будет BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID—Типом поля будет GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. RASTER—Типом поля будет Растр. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения. Хотя значения свойства type объекта Field в точности не соответствуют ключевым словам, используемым в параметре field_type инструмента Добавить поле, все значения type объекта Field могут использоваться как входные для этого параметра. Разные типы полей сопоставляются следующим образом: Integer с LONG, String с TEXT и SmallInteger с SHORT.	String
field_precision (Дополнительный)	Число цифр, хранящихся в поле. Учитываются все цифры, независимо от их расположения относительно разделяющей запятой. Этот параметр применим только к числовым типам полей. Если входная таблица находится в файловой базе геоданных, значение разрядности поля будет игнорироваться.	Long
field_scale (Дополнительный)	Количество знаков после запятой, хранящихся в поле. Этот параметр применим только к полям с плавающей точкой или double. Если входная таблица находится в файловой базе геоданных, значение точности поля будет игнорироваться.	Long
field_length (Дополнительный)	Длина поля Устанавливает максимально возможное количество знаков для каждой записи в поле. Если длина поля не указана, будет использоваться длина 255. Этот параметр доступен только для текстовых полей.	Long
field_alias (Дополнительный)	Альтернативное имя для поля. Это имя используется для описания непонятных имен полей. Данный параметр применяется только к базам геоданных.	String
field_is_nullable (Дополнительный)	Определяет, может ли поле содержать пустые значения. Пустые (NULL) значения отличаются от 0 или пустых полей и поддерживаются только для полей в базе геоданных. NULLABLE—Поле может содержать значения null. Это значение по умолчанию NON_NULLABLE—Поле не может содержать значения null.	Boolean
field_is_required (Дополнительный)	Определяет, будет ли создаваемое поле обязательным для таблицы или нет. Обязательные поля поддерживаются только базами геоданных. NON_REQUIRED—Поле не является обязательным. Это значение по умолчанию REQUIRED—Поле является обязательным. Обязательные поля постоянны, их невозможно удалить.	Boolean
field_domain (Дополнительный)	Ограничивает значения, поддерживаемые любом конкретным атрибутом таблицы, класса пространственных объектов или подтипа в базе геоданных. Вы должны определить имя существующего домена, чтобы он был применен к полю.	String

Производные выходные данные

Имя	Описание	Тип данных
out_table	Обновленная входная таблица.	Table

Пример кода

AddField, пример 1 (окно Python)

Пример скрипта окна Python для использования функции AddField в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"
arcpy.management.AddField("schools", "ref_ID", "LONG", 9, "", "", "refcode", 
                          "NULLABLE", "REQUIRED")

AddField, пример 2 (автономный скрипт)

В следующем автономном скрипте показано использование функции AddField.

# Name: AddField_Example2.py
# Description: Add a pair of new fields to a table
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inFeatures = "schools"
fieldName1 = "ref_ID"
fieldPrecision = 9
fieldAlias = "refcode"
fieldName2 = "status"
fieldLength = 10

# Run AddField twice for two new fields
arcpy.management.AddField(inFeatures, fieldName1, "LONG", fieldPrecision,
                          field_alias=fieldAlias, field_is_nullable="NULLABLE")

arcpy.management.AddField(inFeatures, fieldName2, "TEXT", 
                          field_length=fieldLength)

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

Текущая рабочая область

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

• Basic: Да
• Standard: Да
• Advanced: Да