Изменить поле (Управление данными)

Сводка

Переименовывает поля и их псевдонимы или изменяет свойства поля.

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

  • Этот инструмент позволяет переименовывать поля и менять их псевдонимы в любых таблицах баз геоданных и классов объектов.

  • При использовании классов объектов или таблиц в памяти компьютера переименование ObjectID, Shape или других обязательных, полей, таких как поля слоя сетевого анализа, может привести к повреждению данных или непредсказуемому поведению.

Синтаксис

arcpy.management.AlterField(in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})
ParameterОбъяснениеТип данных
in_table

Входная таблица или класс пространственных объектов, которые содержат изменяемое поле.

Table View; Raster Layer; Mosaic Layer
field

Имя изменяемого поля. Если поле является требуемым (isRequired=true), то изменен может быть только его псевдоним.

Field
new_field_name
(Дополнительный)

Новое имя поля.

String
new_field_alias
(Дополнительный)

Новый псевдоним поля.

String
field_type
(Дополнительный)

Указывается новый тип поля. Это свойство доступно только если входная таблица пуста (не содержит записей).

  • 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Глобальный уникальный идентификатор.
String
field_length
(Дополнительный)

Новая длина поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для полей типа TEXT или BLOB. Если таблица пустая, длина поля может быть увеличена или уменьшена. Если таблица не пустая, длину можно только увеличить от текущего значения.

Long
field_is_nullable
(Дополнительный)

Определяет, может ли поле содержать пустые значения. Возможность отсутствия значений поддерживается только в полях баз геоданных. Это опция доступна только если входная таблица пуста (не содержит записей).

  • NON_NULLABLEПустые (NULL) значения для поля недопустимы.
  • NULLABLEДопустимы пустые (NULL) значения для поля. Используется по умолчанию.
Boolean
clear_field_alias
(Дополнительный)

Указывает, будет ли удален псевдоним входного поля. Параметр псевдонима поля должен быть пустым, чтобы очистить псевдоним поля.

  • CLEAR_ALIASПсевдоним поля будет очищен (null).
  • DO_NOT_CLEARПсевдоним поля не будет очищен. Используется по умолчанию.
Boolean

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

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

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

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

Пример кода

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

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

arcpy.AlterField_management(r'C:\Data\Garbo.gdb\Khyber', 'Elev', 'ELEVATION', 'Elevation in Metres')
AlterField, пример 2 (автономный скрипт)

Пример скрипта окна Python для использования инструмента AlterField в автономном скрипте.

#Import geoprocessing
import arcpy

#Set workspace
arcpy.env.workspace = r'C:\Data\Garbo.gdb'

#Loop through feature classes looking for a field named 'elev'
fcList = arcpy.ListFeatureClasses() #get a list of feature classes
for fc in fcList:  #loop through feature classes
    fieldList = arcpy.ListFields(fc)  #get a list of fields for each feature class
    for field in fieldList: #loop through each field
        if field.name.lower() == 'elev':  #look for the name elev
            arcpy.AlterField_management(fc, field.name, 'ELEVATION', 'Elevation in Metres')
AlterField, пример 3 (автономный скрипт)

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

#Import geoprocessing
import arcpy

#Set local variables
fc = "C:/Data/Garbo.gdb/trails" #Note:empty feature class
field = "condition_rating" #short int, non nullable field
new_name = "notes"
new_alias = "Comments on Trail Condition"
new_type = "TEXT"
new_length = "60"
new_is_nullable = "NULLABLE"
clear_alias = "FALSE"

#Alter the properties of a non nullable, short data type field to become a text field
arcpy.AlterField_management(fc, field, new_name, new_alias, new_type, new_length, new_is_nullable, clear_alias)

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

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

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