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

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

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

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

Внимание:

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

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

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

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

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входная таблица	Входная таблица, в которую будут добавлены поля. Поля будет добавлено к существующей входной таблице, новая выходная таблица не создаётся. Поля могут быть добавлены в классы пространственных объектов в базах геоданных, шейп-файлы, покрытия, автономные таблицы, каталоги растров, растры с таблицами атрибутов и в слои.	Table View; Raster Layer; Mosaic Layer
Свойства поля (Дополнительный)	Поля и их свойства, которые будут добавлены к входной таблице. Имя поля – имя поля, добавляемого к входной таблице. Тип поля – тип нового поля. Псевдоним поля – альтернативное имя поля. Используется для описания сложных имен полей. Это значение применяется только к базам геоданных. Длина поля – длина добавляемого поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для текстовых полей. Длина по умолчанию 255 символов. Значение по умолчанию – значение для поля по умолчанию. Домен поля – домен базы геоданных, назначаемый полю. Доступны следующие типы полей: Короткое (16-bit целое) - тип поля short. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767. Длинное (32-bit целое) - тип поля long. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647. Большое целое (64-bit целочисленное) - тип поля big integer. Поля типа большое целое поддерживают целые числа в диапазоне от -(2^53) до 2^53. С плавающей точкой (32-bit с плавающей точкой) - тип поля float. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38. Двойной точности (64-bit с плавающей точкой) - тип поля double. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308. Текст - тип поля text. Текстовые поля поддерживают строку символов. Дата - тип поля date. Поля даты поддерживают значения даты и времени. Дата (высокой точности) - тип поля high precision date. Поля даты с высокой точностью поддерживают значения даты и времени с миллисекундами. Только дата - тип поля date only. Поля только для даты поддерживают значения даты без значений времени. Только время - тип поля time only. Поля только для времени поддерживают значения времени без значений дат. Сдвиг метки времени - тип поля timestamp offset. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. Blob (бинарные данные) - тип поля BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID (глобальный уникальный идентификатор) - тип поля GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. Растровые изображения - тип поля raster. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения.	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 – длина добавляемого поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для текстовых полей. Длина по умолчанию 255 символов. Default Value – значение для поля по умолчанию. Field Domain – домен базы геоданных, назначаемый полю. Доступны следующие типы полей: SHORT - тип поля short. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767. LONG - тип поля long. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647. BIGINTEGER - тип поля big integer. Поля типа большое целое поддерживают целые числа в диапазоне от -(2^53) до 2^53. FLOAT - тип поля float. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38. DOUBLE - тип поля double. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308. TEXT - тип поля text. Текстовые поля поддерживают строку символов. DATE - тип поля date. Поля даты поддерживают значения даты и времени. DATEHIGHPRECISION - тип поля high precision date. Поля даты с высокой точностью поддерживают значения даты и времени с миллисекундами. DATEONLY - тип поля date only. Поля только для даты поддерживают значения даты без значений времени. TIMEONLY - тип поля time only. Поля только для времени поддерживают значения времени без значений дат. TIMESTAMPOFFSET - тип поля timestamp offset. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. BLOB - тип поля BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID - тип поля GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. RASTER - тип поля raster. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения. При использовании этого параметра с дополнительными значениями, используйте 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: Да