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

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

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

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

    Внимание:

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

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

  • Поля, указанные в параметре Свойства поля по умолчанию включают следующие параметры:

    • Параметр Разрешить пустые значения будет задано как true.
    • Свойство Редактируемое будет задано как true.
    • Свойство Обязательное будет задано как false.
    • Разрядность и Точность задаются типом поля и значениями источника данных по умолчанию.

  • Поля добавляются к входным данным либо через параметр Свойства поля, либо Таблицы шаблонов. Если заданы значения обоих параметров, поля добавляются из двух параметров.

  • Параметр Длина поля в Свойствах поля используется только для текстовых полей.

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

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

Параметры

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

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

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

Table View; Raster Layer; Mosaic Layer
Свойства поля
(Дополнительный)

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

  • Имя поля – имя поля, добавляемого к входной таблице.
  • Тип поля – тип нового поля.
  • Псевдоним поля – альтернативное имя поля. Используется для описания сложных имен полей. Это значение применяется только к базам геоданных.
  • Длина поля – длина добавляемого поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для текстовых полей. Длина по умолчанию 255 символов.
  • Значение по умолчанию – значение для поля по умолчанию.
  • Домен поля – домен базы геоданных, назначаемый полю.

Доступны следующие типы полей:

  • Short (16-разрядное целочисленное) — тип поля будет короткое целое. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767.
  • Long (32-разрядное целочисленное) — тип поля будет длинное целое. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647.
  • Big integer (64-разрядное целое) — типом поля будет большое целое. Поля типа big integer поддерживают целые числа в диапазоне от -(253) до 253.
  • Float (32-разрядное с плавающей точкой) — тип поля будет с плавающей точкой. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38.
  • Double (64-разрядное с плавающей точкой) — тип поля будет двойной точности. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308.
  • Text — тип поля будет текстовым. Текстовые поля поддерживают строки символов.
  • Date — тип поля будет дата. Поля типа Date поддерживают значения даты и времени.
  • Date (high precision) — Тип поля будет дата с высокой точностью. Поля даты с высокой точностью поддерживают дату и время с точностью до миллисекунды.
  • Только дата – типом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени.
  • Только время – типом поля будет только время. Поля только для времени поддерживают значения времени без значения даты.
  • Метка времени – типом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC.
  • BLOB (Большой двоичный объект) — тип поля будет BLOB. Большой двоичный объект (BLOB) поддерживает данные, хранимые в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого.
  • GUID (глобальный уникальный идентификатор) — Тип поля будет GUID. Поле типа GUID содержат строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки.
  • Raster imagery — тип поля будет растр. Поле типа Raster может хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется для этого поля использовать только маленькие изображения.
Value Table
Таблицы шаблонов
(Дополнительный)

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

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

Table View

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

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

Обновленные входные таблицы.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AddFields(in_table, {field_description}, {template})
ИмяОписаниеТип данных
in_table

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

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

Table View; Raster Layer; Mosaic Layer
field_description
[[Field Name, Field Type, {Field Alias}, {Field Length}, {Default Value}, {Field Domain}],...]
(Дополнительный)

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

  • Имя поля – имя поля, добавляемого к входной таблице.
  • Тип поля – тип нового поля.
  • Псевдоним поля – альтернативное имя поля. Используется для описания сложных имен полей. Это значение применяется только к базам геоданных.
  • Длина поля – длина добавляемого поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для текстовых полей. Длина по умолчанию 255 символов.
  • Значение по умолчанию – значение для поля по умолчанию.
  • Домен поля – домен базы геоданных, назначаемый полю.

Доступны следующие типы полей:

  • SHORT — тип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767.
  • LONG — тип поля будет длинное целое. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647.
  • BIGINTEGER – типом поля будет большое целое. Поля типа big integer поддерживают целые числа в диапазоне от -(253) до 253.
  • FLOAT — тип поля будет с плавающей точкой. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38.
  • DOUBLE — тип поля будет двойной точности. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308.
  • TEXT — тип поля будет текстовым. Текстовые поля поддерживают строки символов.
  • DATE — тип поля будет дата. Поля типа Date поддерживают значения даты и времени.
  • DATEHIGHPRECISION — Тип поля будет дата с высокой точностью. Поля даты с высокой точностью поддерживают дату и время с точностью до миллисекунды.
  • DATEONLY – типом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени.
  • TIMEONLY – типом поля будет только время. Поля только для времени поддерживают значения времени без значения даты.
  • TIMESTAMPOFFSET – типом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC.
  • BLOB — типом поля будет BLOB. Большой двоичный объект (BLOB) поддерживает данные, хранимые в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого.
  • GUID — Тип поля будет GUID. Поле типа GUID содержат строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки.
  • RASTER — тип поля будет растр. Поле типа Raster может хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется для этого поля использовать только маленькие изображения.

В параметре field_description с дополнительными параметрами используйте None в качестве заполнителя пустых мест.

Value Table
template
[template,...]
(Дополнительный)

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

Поля из входных данных, указанных в этом параметре, добавляются к in_table в дополнение к полям, указанным в параметре field_description.

Table View

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

ИмяОписаниеТип данных
out_table

Обновленные входные таблицы.

Table View; Raster Layer; Mosaic Layer

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data/district.gdb"
arcpy.management.AddFields(
    'school', 
    [['school_name', 'TEXT', 'Name', 255, 'Hello world', ''], 
     ['street_number', 'LONG', 'Street Number', None, 35, 'StreetNumDomain'],
     ['year_start', 'DATE', 'Year Start', None, '2017-08-09 16:05:07', '']])

Связанные разделы