Краткая информация
Переименование полей и их псевдонимов или изменение свойств поля.
Использование
Этот инструмент позволяет переименовывать поля и менять их псевдонимы в любых таблицах баз геоданных и классов объектов.
Вы можете изменить такие свойства полей, как тип поля, его длину и возможность отсутствия значений (только в пустых таблицах и классах пространственных объектов базы геоданных).
При использовании классов объектов или таблиц в памяти переименование ObjectID, или других обязательных полей, таких как полей слоев сетевого анализа, может привести к повреждению данных или непредсказуемому поведению.
Синтаксис
AlterField_management (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 (Дополнительный) | Определяет, может ли в поле отсутствовать значение (null). Возможность отсутствия значений поддерживается только в полях баз геоданных. Доступно только если входная таблица пуста (не содержит записей).
| Boolean |
clear_field_alias (Дополнительный) | Определяет, нужно ли очистить псевдоним входного поля. Параметр псевдонима поля должен быть пустым, чтобы очистить псевдоним поля.
| Boolean |
Пример кода
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)
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Да
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да