Сводка
Переименовывает поля и их псевдонимы или изменяет свойства поля.
Использование
Этот инструмент позволяет переименовывать поля и менять их псевдонимы в любых таблицах баз геоданных и классов объектов.
При использовании классов объектов или таблиц в памяти компьютера переименование ObjectID, Shape или других обязательных полей, таких как поля слоя сетевого анализа, может привести к повреждению данных или непредсказуемому поведению.
Синтаксис
arcpy.management.AlterField(in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})| Параметр | Объяснение | Тип данных |
in_table | Входная таблица или класс пространственных объектов, которые содержат изменяемое поле. | Table View; Raster Layer; Raster Catalog Layer; Mosaic Layer |
field | Имя изменяемого поля. Если поле является требуемым (isRequired=true), то изменен может быть только его псевдоним. | Field |
new_field_name (Дополнительный) | Новое имя для поля. | String |
new_field_alias (Дополнительный) | Новый псевдоним для поля. | String |
field_type (Дополнительный) | Указывается новый тип поля. Это свойство доступно только если входная таблица пуста (не содержит записей).
| String |
field_length (Дополнительный) | Новая длина поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для полей типа TEXT или BLOB. Используется только для пустых таблиц. | Long |
field_is_nullable (Дополнительный) | Определяет, может ли поле содержать пустые значения. Возможность отсутствия значений поддерживается только в полях баз геоданных. Это опция доступна только если входная таблица пуста (не содержит записей).
| Boolean |
clear_field_alias (Дополнительный) | Указывает, будет ли удален псевдоним входного поля. Параметр псевдонима поля должен быть пустым, чтобы очистить псевдоним поля.
| Boolean |
Производные выходные данные
| Имя | Объяснение | Тип данных |
| out_table | Обновленная входная таблица. | Table View; Raster Layer; Mosaic Layer |
Пример кода
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 arcpy module
import arcpy
#Set local variables
in_table = "C:/Data/Garbo.gdb/trails" #Note: empty feature class
field = "condition_rating" #short int, non nullable field
new_field_name = "notes"
new_field_alias = "Comments on Trail Condition"
field_type = "TEXT"
field_length = "60"
field_is_nullable = "NULLABLE"
clear_field_alias = "FALSE"
#Alter the properties of a non nullable, short data type field to become a text field
arcpy.management.AlterField(in_table,
field,
new_field_name,
new_field_alias,
field_type,
field_length,
field_is_nullable,
clear_field_alias)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да