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

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

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

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

Внимание:

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

• Для шейп-файлов и таблиц 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

Python

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: Да