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

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

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

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

    Внимание:

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

  • Short (16-разрядное целочисленное)Тип поля будет установлен на short. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767.
  • Long (32-разрядное целочисленное)Тип поля будет установлен на long. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647.
  • Big integer (64-разрядное целое число)Типом поля будет большое целочисленное. Поля типа big integer поддерживают целые числа в диапазоне -(253). и 253.
  • Float (32-разрядное с плавающей точкой)Тип поля будет установлен на float. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38.
  • Double (64-разрядное с плавающей точкой)Тип поля будет установлен на double. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308.
  • TextТип поля будет установлен на text. Текстовые поля поддерживают строки символов.
  • DateТип поля будет установлен на date. Поля типа Date поддерживают значения даты и времени.
  • Только датаТипом поля будет только поле даты. Поля только для даты поддерживают значения даты без значений времени.
  • Только времяТипом поля будет только поле времени. Поля только для времени поддерживают значения времени без значения даты.
  • Сдвиг метки времениТипом поля будет поле сдвига метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC.
  • BLOB (Большой двоичный объект)Тип поля будет BLOB. Большой двоичный объект (BLOB) поддерживает данные, хранимые в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого.
  • GUID (глобальный уникальный идентификатор)Типом поля будет GUID. Поле типа GUID содержат строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки.
  • RasterТипом поля будет Растр. Поле типа Raster может хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется для этого поля использовать только маленькие изображения.
String
Длина нового поля
(Дополнительный)

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

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

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

  • Отмечено - поле может содержать значения 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
(Дополнительный)

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

  • SHORTТип поля будет установлен на short. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767.
  • LONGТип поля будет установлен на long. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647.
  • BIGINTEGERТипом поля будет большое целочисленное. Поля типа big integer поддерживают целые числа в диапазоне -(253). и 253.
  • FLOATТип поля будет установлен на float. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38.
  • DOUBLEТип поля будет установлен на double. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308.
  • TEXTТип поля будет установлен на text. Текстовые поля поддерживают строки символов.
  • DATEТип поля будет установлен на date. Поля типа Date поддерживают значения даты и времени.
  • DATEONLYТипом поля будет только поле даты. Поля только для даты поддерживают значения даты без значений времени.
  • TIMEONLYТипом поля будет только поле времени. Поля только для времени поддерживают значения времени без значения даты.
  • TIMESTAMPOFFSETТипом поля будет поле сдвига метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC.
  • BLOBТип поля будет BLOB. Большой двоичный объект (BLOB) поддерживает данные, хранимые в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого.
  • GUIDТипом поля будет GUID. Поле типа GUID содержат строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки.
  • RASTERТипом поля будет Растр. Поле типа Raster может хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется для этого поля использовать только маленькие изображения.
String
field_length
(Дополнительный)

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

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

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

  • NULLABLEПоле может содержать значения null. Используется по умолчанию.
  • NON_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: Да

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