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

Сводка

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

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

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

  • Инструмент Добавить поля имеет следующие свойства поля по умолчанию:

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

  • Длина поля применима только к полям текстового типа.

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

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

Синтаксис

arcpy.management.AddFields(in_table, field_description)
ParameterОбъяснениеТип данных
in_table

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

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

Table View; Raster Layer; Mosaic Layer
field_description
[[Field Name, Field Type, {Field Alias}, {Field Length}, {Default Value} {Field Domain}],...]

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

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

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

  • TEXT – любая строка символов.
  • FLOAT – дробные числа от -3.4E38 до 1.2E38.
  • DOUBLE– дробные числа от -2.2E308 до 1.8E308.
  • SHORT – целые числа от -32 768 до 32 767.
  • LONG– целые числа от -2 147 483 648 до 2 147 483 647.
  • DATE – дата и/или время.
  • BLOB – длинная последовательность двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого.
  • RASTER – растровые изображения. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется для этого поля использовать только маленькие изображения.
  • GUID – глобальный уникальный идентификатор.

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

Value Table

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

NameОбъяснениеТип данных
out_table

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

Представление таблицы; Растровый слой; Слой мозаики

Пример кода

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

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