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

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

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входная таблица	Входная таблица или класс пространственных объектов базы геоданных, которые содержат изменяемое поле.	Table View; Raster Layer; Mosaic Layer
Имя поля	Имя изменяемого поля. Если поле является требуемым (isRequired=true), то изменен может быть только его псевдоним.	Field
Имя нового поля (Дополнительный)	Новое имя для поля.	String
Новый псевдоним поля (Дополнительный)	Новый псевдоним для поля.	String
Тип нового поля (Дополнительный)	Указывается новый тип поля. Это свойство доступно только если входная таблица пуста (не содержит записей). 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 или просмотра его содержимого. Растровое изображение—Растровые изображения. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но настоятельно рекомендуется для этого поля использовать только маленькие изображения. GUID (глобальный уникальный идентификатор)—Глобальный уникальный идентификатор.	String
Длина нового поля (Дополнительный)	Новая длина поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для полей типа Text или Blob (binary data). Если таблица пустая, длина поля может быть увеличена или уменьшена. Если таблица не пустая, длину можно только увеличить от текущего значения.	Long
Возможность пустых значений для нового поля (Дополнительный)	Определяет, может ли поле содержать пустые значения. Возможность отсутствия значений поддерживается только в полях баз геоданных. Эта опция доступна только если входная таблица пуста (не содержит записей). Отмечено – допустимы значения null для поля. Это значение по умолчанию Не отмечено – значения null для поля недопустимы.	Boolean
Очистить псевдоним (Дополнительный)	Указывает, будет ли удален псевдоним входного поля. Параметр псевдонима поля должен быть пустым, чтобы очистить псевдоним поля. Отмечено – псевдоним поля будет очищен (null). Параметр псевдонима поля должен быть пустым. Не отмечено – псевдоним поля не будет очищен. Это значение по умолчанию	Boolean

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

Подпись	Описание	Тип данных
Обновленная входная таблица	Обновленная входная таблица.	Table View; Raster Layer; Mosaic Layer

Python

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; 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—Пустые значения не допустимы для этого поля. NULLABLE—Допустимы пустые (NULL) значения для поля. Это значение по умолчанию	Boolean
clear_field_alias (Дополнительный)	Указывает, будет ли удален псевдоним входного поля. Параметр псевдонима поля должен быть пустым, чтобы очистить псевдоним поля. CLEAR_ALIAS—Псевдоним поля будет очищен (null). DO_NOT_CLEAR—Псевдоним поля не будет очищен. Это значение по умолчанию	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 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: Да