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

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

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

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

    Внимание:

    Этот инструмент изменяет входные значения. Более подробно о стратегиях предотвращения нежелательных изменений данных см. в разделе Инструменты, которые изменяют или обновляют входные данные.

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

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

Параметры

ПодписьОписаниеТип данных
Входная таблица

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

Table View; Raster Layer; Mosaic Layer
Имя поля

Имя изменяемого поля. Если поле является обязательным, то изменен может быть только его псевдоним.

Field
Имя нового поля
(Дополнительный)

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

String
Новый псевдоним поля
(Дополнительный)

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

String
Тип нового поля
(Дополнительный)

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

  • ТекстТип поля будет Текст. Текстовые поля поддерживают строку символов.
  • Float (32-разрядное с плавающей точкой)Тип поля будет С плавающей точкой. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38.
  • Double (64-разрядное с плавающей точкой)Тип поля будет Двойной точности. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308.
  • Short (16-разрядное целочисленное)Тип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767.
  • Long (32-разрядное целочисленное)Тип поля будет Длинное целое. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647.
  • ДатаТипом поля будет Дата. Поля даты поддерживают значения даты и времени.
  • BLOB (Большой двоичный объект)Тип поля будет BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого.
  • Raster imageryТипом поля будет Растр. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения.
  • GUID (глобальный уникальный идентификатор)Типом поля будет GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки.
String
Длина нового поля
(Дополнительный)

Новая длина поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Этот параметр применим только для полей типа Text или Blob (binary data). Если таблица пуста, длину поля можно увеличить или уменьшить. Если таблица не пустая, длину можно только увеличить от текущего значения.

Long
Возможность пустых значений для нового поля
(Дополнительный)

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

  • Отмечено - поле может содержать значения null. Это значение по умолчанию
  • Не отмечено – значения null для поля недопустимы.
Boolean
Очистить псевдоним
(Дополнительный)

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

  • Отмечено – псевдоним поля будет очищен (null). Параметр псевдонима поля должен быть пустым.
  • Не отмечено – псевдоним поля не будет очищен. Это значение по умолчанию
Boolean

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

ПодписьОписаниеТип данных
Обновленная входная таблица

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

Table View; Raster Layer; Mosaic Layer

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

Имя изменяемого поля. Если поле является обязательным, то изменен может быть только его псевдоним.

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. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого.
  • RASTERТипом поля будет Растр. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения.
  • GUIDТипом поля будет GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки.
String
field_length
(Дополнительный)

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

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

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

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

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

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

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

ИмяОписаниеТип данных
out_table

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

Table View; Raster Layer; Mosaic Layer

Пример кода

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

В следующем скрипте окна Python показано, как используется функция AlterField в режиме прямого запуска.

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

В следующем скрипте окна Python показано, как использовать функцию AlterField в автономном скрипте.

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:  # Lloop through each field
        if field.name.lower() == 'elev':  # Look for the name elev
            arcpy.management.AlterField(fc, field.name, 'ELEVATION', 'Elevation in Metres')
AlterField, пример 3 (автономный скрипт)

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

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: Да

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