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

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

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

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

    Внимание:

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

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

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

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

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

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

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

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

Параметры

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

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

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

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

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

  • Field Name– имя поля, добавляемого к входной таблице.
  • Field Type– тип нового поля.
  • Field Alias— псевдоним, соответствующий имени поля. Используется для расшифровки кратких и трудных для восприятия имен полей. Это значение применяется только к базам геоданных.
  • Field Length– длина добавляемого поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для полей типа text, с длиной по умолчанию 255.
  • Default Value– значение для поля по умолчанию.
  • Field Domain– домен базы геоданных, назначаемый полю.

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

  • Text — тип поля будет текстовым. Текстовые поля поддерживают строки символов.
  • Float (32-разрядное с плавающей точкой) — тип поля будет с плавающей точкой. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38.
  • Double (64-разрядное с плавающей точкой) — тип поля будет двойной точности. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308.
  • Short (16-разрядное целочисленное) — тип поля будет короткое целое. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767.
  • Long (32-разрядное целочисленное) — тип поля будет длинное целое. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647.
  • Date — тип поля будет дата. Поля типа Дата поддерживают значения даты и времени.
  • BLOB (Большой двоичный объект) — тип поля будет BLOB. Большой двоичный объект (BLOB) поддерживает данные, хранимые в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого.
  • Raster imagery — тип поля будет растр. Поле типа Растр может хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется для этого поля использовать только маленькие изображения.
  • GUID (глобальный уникальный идентификатор) — Тип поля будет GUID. Поле типа GUID содержат строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки.
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}],...]
(Дополнительный)

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

  • Field Name– имя поля, добавляемого к входной таблице.
  • Field Type– тип нового поля.
  • Field Alias— псевдоним, соответствующий имени поля. Используется для расшифровки кратких и трудных для восприятия имен полей. Это значение применяется только к базам геоданных.
  • Field Length– длина добавляемого поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для полей типа text, с длиной по умолчанию 255.
  • Default Value– значение для поля по умолчанию.
  • Field Domain– домен базы геоданных, назначаемый полю.

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

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

В параметре 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', '']])

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

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

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