Инструмент Обновить поля обновляет имя поля или тип поля.
Примеры
Инструмент Обновить поля можно использовать в следующих сценариях:
- В наборе данных есть поля с неинформативными именами. Обновите поля, чтобы сделать их названия более осмысленными.
- Поле Почтовый код было обнаружено как тип integer, но ваш рабочий процесс требует, чтобы значения Почтового кода были строками. Обновите тип поля с целого на строковый.
- У вас есть строковое поле, представляющее геометрию в формате WKT. Используйте функцию «Обновить поля», чтобы преобразовать строку в геометрию.
Параметры
В следующей таблице приводится описание параметров, используемых в инструменте Обновить поля:
| Параметр | Описание |
|---|---|
Входной набор данных | Набор данных, содержащий поля, которые будут обновлены. |
Обновления | Одно или нескольких полей и обновления, которые будут выполнены для каждого поля. |
Разделитель десятичных знаков | Укажите значение разделителя десятичных знаков, если вы конвертируете строковые значения в число, и строковые значения не используют точку (.) в качестве разделителя десятичных знаков. Это дополнительный параметр. |
Примечания по использованию
Используйте параметр Входной набор данных для определения набора данных, содержащего поля, которые будут обновлены.
Нажмите кнопку Настроить обновления, чтобы открыть модальное окно Обновить поля, где вы можете указать поля для обновления.
В модальном окне Обновить поля предлагаются следующие возможности:
- Вы можете изменить имя поля, тип или их комбинацию. Для каждого поля требуется хотя бы одно обновление. Можно выбрать следующие опции:
- Поле для обновления - указывает поле, которое будет обновлено.
- Новое имя поля — Обновляет имя указанного поля.
- Новый тип поля — Обновляет тип указанного поля.
- Кнопка Добавить поле позволяет добавлять отдельные поля для обновления. Чтобы добавить все поля сразу, используйте кнопку Добавить все поля.
- Кнопка Добавить предложенные поля позволяет автоматически настраивать обновления, рекомендованные Data Pipelines. При нажатии этой кнопки Data Pipelines производит выборку данных и может предложить обновления. Например, если у вас есть строковое поле со значениями типа "12/23/2025", то Data Pipelines может предложить новый тип поля — только дата с форматом даты MM/dd/yyyy.
Рекомендации формируются на основе выборки данных. Если поле содержит много значений null или пустых значений, подсказки для этого поля могут не отображаться.
Ниже приведены опции для типа поля:
- String — Выводит поле строкового типа. Строковые поля поддерживают строки символов (текст).
- Float — Выводит поле типа с плавающей точкой. Поля типа с плавающей точкой поддерживают дробные числа приблизительно от -3.4E38 до 3.4E38.
- Double — Выводит поле типа double Поля типа двойной точности поддерживают дробные числа приблизительно от -2.2E308 до 1.8E308.
- Small integer — Выводит поле типа small integer. Поля типа Small integer поддерживают целые числа в диапазоне от -32768 до 32767.
- Integer — Выдает поле целочисленного типа. Поля типа Integer поддерживают целые числа в диапазоне от -2147483648 до 2147483647.
- Big integer — Выводит поле типа big integer. Поля типа Big integer поддерживают целые числа в диапазоне от -9223372036854776000 до 9223372036854776000.
- Date — Выводит поле типа дата. Поля даты содержат значения и даты, и времени, например, такие - 12/23/2025 12:30:30 PM.
- Date only - Выводит поле типа только дата. Поля только дата содержат значение даты, например, 12/23/2025.
- Point - Выводит поле с точечной геометрией.
- Polyline - Выводит поле с полилинейной геометрией.
- Polygon - Выводит поле с полигональной геометрией.
- Multipoint - Выводит поле с мультиточечной геометрией.
- Boolean — Выводит поле типа Булево. Поля Boolean поддерживают значения true и false.
Если значения не могут быть преобразованы в новый тип, результат будет null, а выходные данные будут пустые.
Используйте параметр Разделитель десятичных знаков для преобразования строковых полей в поле double, если в строках используются разделители десятичных знаков, не являющиеся точками (.). Это дополнительный параметр. Ниже приведены примеры использования параметра десятичного разделителя:
- Строковое поле содержит значения double, в которых в качестве десятичного разделителя используется запятая, например "3,55". Чтобы преобразовать это поле в поле double, укажите новый тип поля double и используйте запятую (,) в качестве разделителя десятичных значений. Результатом будет поле double со значениями, такими как 3.55.
- Строковое поле содержит целочисленные значения с дополнительным заполнением нулями, например, "5,0000". Чтобы преобразовать это поле в целочисленное, укажите новый тип поля integer и используйте запятую (,) в качестве разделителя десятичных значений. Результатом будет целочисленное поле со значениями, такими как 5.
Для всех числовых полей предварительный просмотр отформатирует число в соответствии с регионом, установленным в настройках пользователя.
Поведение преобразования типов
Инструмент Обновить поля обрабатывает преобразование полей по-разному в зависимости от типа входных данных и целевого типа. Поддерживаемые преобразования будут либо успешными, либо вернут значение null, если исходное значение не может быть преобразовано в целевой тип. Если преобразование не поддерживается, конвейер данных завершится с ошибкой. В следующей таблице подробно описано, поддерживается ли преобразование и какой формат конвертируемого значения, если это применимо:
| String | Small integer | Integer | Big integer | Float | Double | Date only | Date | Boolean | Point | Multipoint | Polyline | Polygon | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
String | Да | Да (округлить) | Да (округлить) | Да (округлить) | Да | Да | Да | Да | Да | Yes5 | Yes5 | Yes5 | Yes5 |
Small integer | Да | Да | Да | Да | Да | Да | Нет | Нет | Да | Нет | Нет | Нет | Нет |
Integer | Да | Да | Да | Да | Да | Да | Нет | Да3 | Да | Нет | Нет | Нет | Нет |
Big integer | Да | Да | Да | Да | Да | Да | Нет | Да3 | Да | Нет | Нет | Нет | Нет |
Float | Да | Да (округлить) | Да (округлить) | Да (округлить) | Да | Да | Нет | Да3 | Да | Нет | Нет | Нет | Нет |
Double | Да | Да (округлить) | Да (округлить) | Да (округлить) | Да | Да | Нет | Да3 | Да | Нет | Нет | Нет | Нет |
Date only | Да (ISO 8601) | Нет | Нет | Нет | Нет | Нет | Yes1 | Нет | Нет | Нет | Нет | Нет | Нет |
Date | Да (ISO 8601) | Нет | Да (секунды) | Нет | Нет | Да (секунды) | Yes2 | Yes1 | Нет | Нет | Нет | Нет | Нет |
Boolean | Да ("true", "false") | Да | Да | Да | Да | Да | Нет | Нет | Да | Нет | Нет | Нет | Нет |
Blob | Да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Yes5 | Yes5 | Yes5 | Yes5 |
Массив | Да (JSON) | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
Карта | Да (JSON) | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
Структура | Да (JSON) | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Yes5 | Yes5 | Yes5 | Yes5 |
Точка | Да (EsriJSON) | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Yes4 | Нет | Нет | Нет |
Мультиточка | Да (EsriJSON) | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Yes4 | Нет | Нет |
Полилиния | Да (EsriJSON) | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Yes4 | Нет |
Полигон | Да (EsriJSON) | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Yes4 |
1 Игнорируются параметры Формат даты and Часовой пояс
2 Игнорируется Формат даты. Часовой пояс является обязательным. Дата будет сокращена до даты, соответствующей указанному часовому поясу.
3 Формат даты должен быть указан в секундах или миллисекундах от начала эпохи. Игнорируется Часовой пояс. Даты, хранящиеся в миллисекундах или секундах, всегда отображаются в часовом поясе UTC.
4 Игнорируются Формат геометрии и Пространственная привязка. Чтобы изменить пространственную привязку поля геометрии, используйте инструмент Проецировать геометрию.
5 Формат геометрии должен быть совместим с типом входного поля. Строковые входные поля должны использовать формат WKT, GeoJSON или EsriJSON. Входные поля структуры должны использовать формат GeoJSON или EsriJSON. Бинарные поля должны использовать формат WKB.
Выходные данные
Выходные данные инструмента содержат входной набор данных с обновленными полями. Если значения поля не могут быть преобразованы в новый тип, результирующее значение будет null, а выходные данные будут пустые.
Лицензионные требования
Требуется следующее лицензии и конфигурации:
- Тип пользователя Creator или Professional
- Роль Издатель, Посредник или Администратор, или эквивалентная пользовательская роль
Подробнее о системных требованиях Data Pipelines см. раздел Требования