Справка

Изменить поле

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

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

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

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

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

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

Синтаксис

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
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
(дополнительно)

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

  • NON_NULLABLE —Нулевые значения для поля недопустимы.
  • NULLABLE —Допустимы нулевые значения для поля. Это значение используется по умолчанию.
Boolean
clear_field_alias
(дополнительно)

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

  • TRUE —Псевдоним поля будет очищен (null).
  • FALSE —Псевдоним поля не будет очищен. Это значение используется по умолчанию.
Boolean

Пример кода

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

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

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)

Параметры среды

Связанные темы

Отзыв по этому разделу?