Изменить поля (несколько) (Управление данными)—ArcGIS Pro

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

Изменяет свойства нескольких полей в классе объектов или таблице.

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

Внимание:

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

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

Параметры

Подпись	Описание	Тип данных
Входная таблица	Входная таблица или класс пространственных объектов базы геоданных, которые содержат изменяемое поле.	Table View; Raster Layer; Mosaic Layer
Свойства поля (Дополнительный)	Поля входной таблицы и их свойства, которые будут изменены. Имя поля - имя изменяемого поля. Если поле является обязательным, то будет изменен только его псевдоним. Новое имя поля (необязательно) — новое имя для поля. Новый псевдоним поля (необязательно) - новый псевдоним для поля. Новый тип поля (необязательно) — задает новый тип поля для данного поля. Этот столбец применим только если входная таблица пуста (не содержит записей). Новая длина поля (необязательно) — новая длина поля (тип Long). Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для полей типа Text или Blob (двоичные данные). Если таблица пуста, длину поля можно увеличить или уменьшить. Если таблица не пустая, длину можно только увеличить от текущего значения. Новое поля IsNullable (необязательно) - определяет, может ли поле содержать пустые значения. Возможность отсутствия значений поддерживается только в полях баз геоданных. Эта опция доступна только если входная таблица пуста (не содержит записей). Если отмечено, поле может содержать значения null. Это значение по умолчанию Если не отмечено, значения null для поля недопустимы. Очистить псевдоним (необязательно) - задает, будет ли удален псевдоним входного поля. Чтобы очистить псевдоним поля, параметр Новый псевдоним поля должен быть пустым. Если отмечено, псевдоним поля будет очищен (задан как null). Если не отмечено, псевдоним поля не будет очищен. Это значение по умолчанию Доступны следующие типы полей: Короткое (16-bit целое) - тип поля short. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767. Длинное (32-bit целое) - тип поля long. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647. Большое целое (64-bit целочисленное) - тип поля big integer. Поля типа большое целое поддерживают целые числа в диапазоне от -(2⁵³) до 2⁵³. С плавающей точкой (32-bit с плавающей точкой) - тип поля float. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38. Двойной точности (64-bit с плавающей точкой) - тип поля double. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308. Текст - тип поля text. Текстовые поля поддерживают строку символов. Дата - тип поля date. Поля даты поддерживают значения даты и времени. Дата (высокой точности) - тип поля high precision date. Поля даты с высокой точностью поддерживают значения даты и времени с миллисекундами. Только дата - тип поля date only. Поля только для даты поддерживают значения даты без значений времени. Только время - тип поля time only. Поля только для времени поддерживают значения времени без значений дат. Сдвиг метки времени - тип поля timestamp offset. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. Blob (бинарные данные) - тип поля BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID (глобальный уникальный идентификатор) - тип поля GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. Растровые изображения - тип поля raster. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения.	Value Table

Подпись

Описание

Тип данных

Входная таблица

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

Table View; Raster Layer; Mosaic Layer

Свойства поля

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

Поля входной таблицы и их свойства, которые будут изменены.

Имя поля - имя изменяемого поля. Если поле является обязательным, то будет изменен только его псевдоним.
Новое имя поля (необязательно) — новое имя для поля.
Новый псевдоним поля (необязательно) - новый псевдоним для поля.
Новый тип поля (необязательно) — задает новый тип поля для данного поля. Этот столбец применим только если входная таблица пуста (не содержит записей).
Новая длина поля (необязательно) — новая длина поля (тип Long). Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для полей типа Text или Blob (двоичные данные). Если таблица пуста, длину поля можно увеличить или уменьшить. Если таблица не пустая, длину можно только увеличить от текущего значения.
Новое поля IsNullable (необязательно) - определяет, может ли поле содержать пустые значения. Возможность отсутствия значений поддерживается только в полях баз геоданных. Эта опция доступна только если входная таблица пуста (не содержит записей). Если отмечено, поле может содержать значения null. Это значение по умолчанию Если не отмечено, значения null для поля недопустимы.
Очистить псевдоним (необязательно) - задает, будет ли удален псевдоним входного поля. Чтобы очистить псевдоним поля, параметр Новый псевдоним поля должен быть пустым. Если отмечено, псевдоним поля будет очищен (задан как null). Если не отмечено, псевдоним поля не будет очищен. Это значение по умолчанию

Доступны следующие типы полей:

Короткое (16-bit целое) - тип поля short. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767.
Длинное (32-bit целое) - тип поля long. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647.
Большое целое (64-bit целочисленное) - тип поля big integer. Поля типа большое целое поддерживают целые числа в диапазоне от -(2⁵³) до 2⁵³.
С плавающей точкой (32-bit с плавающей точкой) - тип поля float. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38.
Двойной точности (64-bit с плавающей точкой) - тип поля double. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308.
Текст - тип поля text. Текстовые поля поддерживают строку символов.
Дата - тип поля date. Поля даты поддерживают значения даты и времени.
Дата (высокой точности) - тип поля high precision date. Поля даты с высокой точностью поддерживают значения даты и времени с миллисекундами.
Только дата - тип поля date only. Поля только для даты поддерживают значения даты без значений времени.
Только время - тип поля time only. Поля только для времени поддерживают значения времени без значений дат.
Сдвиг метки времени - тип поля timestamp offset. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC.
Blob (бинарные данные) - тип поля BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого.
GUID (глобальный уникальный идентификатор) - тип поля GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки.
Растровые изображения - тип поля raster. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения.

Value Table

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

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

arcpy.management.AlterFields(in_table, {field_description})

Имя	Описание	Тип данных
in_table	Входная таблица или класс пространственных объектов базы геоданных, которые содержат изменяемое поле.	Table View; Raster Layer; Mosaic Layer
field_description [[Field Name, {New Field Name}, {New Field Alias}, {New Field Type}, {New Field Length}, {New Field IsNullable}, {Clear Alias}],...] (Дополнительный)	Поля входной таблицы и их свойства, которые будут изменены. Field Name - имя изменяемого поля. Если поле является обязательным, то будет изменен только его псевдоним. New Field Name (необязательно) — новое имя для поля. New Field Alias (необязательно) - новый псевдоним поля. New Field Type (необязательно) — задает новый тип поля для данного поля. Это опция доступна только если входная таблица пуста (не содержит записей). New Field Length (необязательно) — новая длина поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для полей типа TEXT или BLOB. Если таблица пуста, длину поля можно увеличить или уменьшить. Если таблица не пустая, длину можно только увеличить от текущего значения. New Field IsNullable (необязательно) - определяет, может ли поле содержать значения null. Возможность отсутствия значений поддерживается только в полях баз геоданных. Эта опция доступна только если входная таблица пуста (не содержит записей). Если задано True, поле может содержать значения null. Это значение по умолчанию Если задано False, поле не может содержать значения null. Clear Alias (необязательно) - задает, будет ли удален псевдоним входного поля. Чтобы очистить псевдоним поля, параметр New Field Alias должен быть пустым. Если задано True, псевдоним поля будет очищен (задан как null). Если задано False, псевдоним поля не будет очищен. Это значение по умолчанию Доступны следующие типы полей: SHORT - тип поля short. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767. LONG - тип поля long. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647. BIGINTEGER - тип поля big integer. Поля типа большое целое поддерживают целые числа в диапазоне от -(2⁵³) до 2⁵³. FLOAT - тип поля float. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38. DOUBLE - тип поля double. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308. TEXT - тип поля text. Текстовые поля поддерживают строку символов. DATE - тип поля date. Поля даты поддерживают значения даты и времени. DATEHIGHPRECISION - тип поля high precision date. Поля даты с высокой точностью поддерживают значения даты и времени с миллисекундами. DATEONLY - тип поля date only. Поля только для даты поддерживают значения даты без значений времени. TIMEONLY - тип поля time only. Поля только для времени поддерживают значения времени без значений дат. TIMESTAMPOFFSET - тип поля timestamp offset. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC. BLOB - тип поля BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID - тип поля GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. RASTER - тип поля raster. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения.	Value Table

Имя

Описание

Тип данных

in_table

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

Table View; Raster Layer; Mosaic Layer

field_description

[[Field Name, {New Field Name}, {New Field Alias}, {New Field Type}, {New Field Length}, {New Field IsNullable}, {Clear Alias}],...]

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

Поля входной таблицы и их свойства, которые будут изменены.

Field Name - имя изменяемого поля. Если поле является обязательным, то будет изменен только его псевдоним.
New Field Name (необязательно) — новое имя для поля.
New Field Alias (необязательно) - новый псевдоним поля.
New Field Type (необязательно) — задает новый тип поля для данного поля. Это опция доступна только если входная таблица пуста (не содержит записей).
New Field Length (необязательно) — новая длина поля. Устанавливает максимально возможное количество знаков для каждой записи в поле. Эта опция доступна только для полей типа TEXT или BLOB. Если таблица пуста, длину поля можно увеличить или уменьшить. Если таблица не пустая, длину можно только увеличить от текущего значения.
New Field IsNullable (необязательно) - определяет, может ли поле содержать значения null. Возможность отсутствия значений поддерживается только в полях баз геоданных. Эта опция доступна только если входная таблица пуста (не содержит записей). Если задано True, поле может содержать значения null. Это значение по умолчанию Если задано False, поле не может содержать значения null.
Clear Alias (необязательно) - задает, будет ли удален псевдоним входного поля. Чтобы очистить псевдоним поля, параметр New Field Alias должен быть пустым. Если задано True, псевдоним поля будет очищен (задан как null). Если задано False, псевдоним поля не будет очищен. Это значение по умолчанию

Доступны следующие типы полей:

SHORT - тип поля short. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767.
LONG - тип поля long. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647.
BIGINTEGER - тип поля big integer. Поля типа большое целое поддерживают целые числа в диапазоне от -(2⁵³) до 2⁵³.
FLOAT - тип поля float. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38.
DOUBLE - тип поля double. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308.
TEXT - тип поля text. Текстовые поля поддерживают строку символов.
DATE - тип поля date. Поля даты поддерживают значения даты и времени.
DATEHIGHPRECISION - тип поля high precision date. Поля даты с высокой точностью поддерживают значения даты и времени с миллисекундами.
DATEONLY - тип поля date only. Поля только для даты поддерживают значения даты без значений времени.
TIMEONLY - тип поля time only. Поля только для времени поддерживают значения времени без значений дат.
TIMESTAMPOFFSET - тип поля timestamp offset. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC.
BLOB - тип поля BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого.
GUID - тип поля GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки.
RASTER - тип поля raster. Растровые поля могут хранить растровые данные в базе геоданных или вне ее. Можно хранить все поддерживаемые в ArcGIS форматы наборов растровых данных, но рекомендуется использовать только маленькие изображения.

Value Table

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

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

Пример кода

AlterFields, пример 1 (автономный скрипт)

Следующий автономный скрипт демонстрирует, как использовать функцию AlterFields для изменения псевдонимов полей в классе пространственных объектов.

import arcpy

test_class = arcpy.management.CreateFeatureclass(out_gdb, "new_fc", geometry_type='POLYGON')
field_description = [
    ['SHORT_FIELD', 'SHORT', 'SHORT_FIELD_Alias', '#', '#', '#'],
    ['LONG_FIELD', 'LONG', 'LONG_FIELD_Alias', '#', '#', '#'],
    ['BIGINTEGER_FIELD', 'BIGINTEGER', 'BIGINTEGER_FIELD_Alias', '#', '#', '#'], 
    ['FLOAT_FIELD', 'FLOAT', 'FLOAT_FIELD_Alias', '#', '#', '#'],
    ['DOUBLE_FIELD', 'DOUBLE', 'DOUBLE_FIELD_Alias', '#', '#', '#'],
    ['TEXT_FIELD', 'TEXT', 'TEXT_FIELD_Alias', '#', '#', '#'],
    ['DATE_FIELD', 'DATE', 'DATE_FIELD_Alias', '#', '#', '#'],
    ['DATEONLY_FIELD', 'DATEONLY', 'DATEONLY_FIELD_Alias', '#', '#', '#'],
    ['TIMEONLY_FIELD', 'TIMEONLY', 'TIMEONLY_FIELD_Alias', '#', '#', '#'],
    ['TIMESTAMPOFFSET_FIELD', 'TIMESTAMPOFFSET', 'TIMESTAMPOFFSET_FIELD_Alias', '#', '#', '#']
]
arcpy.management.AddFields(test_class, field_description, None)

alter_field_description = [
    ['SHORT_FIELD', 'SHORT_FIELD_altered', '#', '#', '#', '#'],
    ['LONG_FIELD', 'LONG_FIELD_altered', '#', '#', '#', '#'],
    ['BIGINTEGER_FIELD', 'BIGINTEGER_FIELD_altered', '#', '#', '#', '#'],
    ['FLOAT_FIELD', 'FLOAT_FIELD_altered', '#', '#', '#', '#'],
    ['DOUBLE_FIELD', 'DOUBLE_FIELD_altered', '#', '#', '#', '#'],
    ['TEXT_FIELD', 'TEXT_FIELD_altered', '#', '#', '#', '#'],
    ['DATE_FIELD', 'DATE_FIELD_altered', '#', '#', '#', '#'],
    ['DATEONLY_FIELD', 'DATEONLY_FIELD_altered', '#', '#', '#', '#'],
    ['TIMEONLY_FIELD', 'TIMEONLY_FIELD_altered', '#', '#', '#', '#'],
    ['TIMESTAMPOFFSET_FIELD', 'TIMESTAMPOFFSET_FIELD_altered', '#', '#', '#', '#']
]
arcpy.management.AlterFields(in_table=test_class, field_description=alter_field_description)

AlterFields, пример 2 (автономный скрипт)

Следующий автономный скрипт демонстрирует, как использовать функцию AlterFields для изменения свойства is nullable для полей в пустой таблице.

import arcpy

test_class = arcpy.management.CreateTable(out_gdb, "new_table")
field_description = [
    ['SHORT_FIELD', 'SHORT', 'SHORT_FIELD_Alias', '#', '#', '#'],
    ['LONG_FIELD', 'LONG', 'LONG_FIELD_Alias', '#', '#', '#'],
    ['BIGINTEGER_FIELD', 'BIGINTEGER', 'BIGINTEGER_FIELD_Alias', '#', '#', '#'],
    ['FLOAT_FIELD', 'FLOAT', 'FLOAT_FIELD_Alias', '#', '#', '#'],
    ['DOUBLE_FIELD', 'DOUBLE', 'DOUBLE_FIELD_Alias', '#', '#', '#'],
    ['TEXT_FIELD', 'TEXT', 'TEXT_FIELD_Alias', '#', '#', '#'],
    ['DATE_FIELD', 'DATE', 'DATE_FIELD_Alias', '#', '#', '#'],
    ['DATEONLY_FIELD', 'DATEONLY', 'DATEONLY_FIELD_Alias', '#', '#', '#'],
    ['TIMEONLY_FIELD', 'TIMEONLY', 'TIMEONLY_FIELD_Alias', '#', '#', '#'],
    ['TIMESTAMPOFFSET_FIELD', 'TIMESTAMPOFFSET', 'TIMESTAMPOFFSET_FIELD_Alias', '#', '#', '#']
]

arcpy.management.AddFields(test_class, field_description, None)

# Change the nullable property to true
alter_field_description = [
    ['SHORT_FIELD', '#', '#', '#','#', 'true', '#'],
    ['LONG_FIELD', '#', '#', '#','#', 'true', '#'],
    ['BIGINTEGER_FIELD', '#', '#', '#','#', 'true', '#'],
    ['FLOAT_FIELD', '#', '#', '#','#', 'true', '#'],
    ['DOUBLE_FIELD', '#', '#', '#','#', 'true', '#'],
    ['TEXT_FIELD', '#', '#', '#','#', 'true', '#'],
    ['DATE_FIELD', '#', '#', '#','#', 'true', '#'],
    ['DATEONLY_FIELD', '#', '#', '#','#', 'true', '#'],
    ['TIMEONLY_FIELD', '#', '#', '#','#', 'true', '#'],
    ['TIMESTAMPOFFSET_FIELD', '#', '#', '#','#', 'true', '#']
]

arcpy.management.AlterFields(in_table=test_class, field_description=alter_field_description)

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

Текущая рабочая область

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

Basic: Да
Standard: Да
Advanced: Да

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

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

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

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

Внимание:

Параметры

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

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

Пример кода

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

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

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

В этом разделе