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

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

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

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

Внимание:

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

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

Подпись	Объяснение	Тип данных
Входная таблица	Входная таблица или класс объектов базы геоданных, которые содержат изменяемое поле.	Table View; Raster Layer; Mosaic Layer
Имя поля	Имя изменяемого поля. Если поле является обязательным, то будет изменен только его псевдоним.	Field
Имя нового поля (Дополнительный)	Новое имя поля.	String
Новый Псевдоним поля (Дополнительный)	Новый псевдоним поля.	String
Тип нового поля (Дополнительный)	Задает новый тип поля. Этот параметр применяется, только если входная таблица пуста (не содержит записей). Короткое целое (16-разрядное целочисленное)–Тип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767. Длинное целое (32-разрядное целочисленное)–Тип поля будет Длинное целое. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647. Большое целочисленное (64-разрядное целое число)–Типом поля будет большое целое. Поля типа большое целое поддерживают целые числа в диапазоне от -(2⁵³) до 2⁵³. С плавающей точкой (32-разрядное с плавающей точкой)–Тип поля будет С плавающей точкой. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38. Двойной точности (64-разрядное с плавающей точкой)–Тип поля будет Двойной точности. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308. Text–Тип поля будет Текст. Текстовые поля поддерживают строку символов. Дата–Типом поля будет Дата. Поля даты поддерживают значения даты и времени. Только дата–Типом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени. Time only–Типом поля будет только время. Поля только для времени поддерживают значения времени без значений дат. Сдвиг метки времени–Типом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. BLOB (большой двоичный объект)–Тип поля будет BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID (глобальный уникальный идентификатор)–Типом поля будет GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. Растр–Типом поля будет Растр. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения.	String
Длина нового поля (Дополнительный)	Новая длина поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Этот параметр доступен только для полей типа Text или Blob (Большой двоичный объект). Если таблица пуста, длину поля можно увеличить или уменьшить. Если таблица не пуста, длину можно увеличить только от текущего значения.	Long
Возможность пустых значений для нового поля (Дополнительный)	Определяет, может ли поле содержать значения null. Возможность отсутствия значений поддерживается только в полях баз геоданных. Этот параметр применяется, только если входная таблица пуста (не содержит записей). Отмечено–Поле может содержать значения null. Используется по умолчанию. Не отмечено–Поле не может содержать значения null.	Boolean
Очистить псевдоним (Дополнительный)	Определяет, нужно ли очистить псевдоним входного поля. Параметр `new_field_alias` должен быть пустым, чтобы очистить псевдоним поля. Отмечено–Псевдоним поля будет очищен (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`–Тип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767. `LONG`–Тип поля будет Длинное целое. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647. `BIGINTEGER`–Типом поля будет большое целое. Поля типа большое целое поддерживают целые числа в диапазоне от -(2⁵³) до 2⁵³. `FLOAT`–Тип поля будет С плавающей точкой. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38. `DOUBLE`–Тип поля будет Двойной точности. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308. `TEXT`–Тип поля будет Текст. Текстовые поля поддерживают строку символов. `DATE`–Типом поля будет Дата. Поля даты поддерживают значения даты и времени. `DATEONLY`–Типом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени. `TIMEONLY`–Типом поля будет только время. Поля только для времени поддерживают значения времени без значений дат. `TIMESTAMPOFFSET`–Типом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. `BLOB`–Тип поля будет BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. `GUID`–Типом поля будет GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. `RASTER`–Типом поля будет Растр. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения.	String
field_length (Дополнительный)	Новая длина поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Этот параметр применим только для полей типа `TEXT` или `BLOB`. Если таблица пуста, длину поля можно увеличить или уменьшить. Если таблица не пуста, длину можно увеличить только от текущего значения.	Long
field_is_nullable (Дополнительный)	Определяет, может ли поле содержать значения null. Возможность отсутствия значений поддерживается только в полях баз геоданных. Этот параметр применяется, только если входная таблица пуста (не содержит записей). `NULLABLE`–Поле может содержать значения null. Используется по умолчанию. `NON_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 в режиме прямого запуска.

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

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

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

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

Внимание:

Параметры

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

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

Информация о лицензировании

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