Обновить свойства набора данных подключения к многофайловым объектам (Инструменты GeoAnalytics Desktop)

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

Обновляет свойства набора данных из подключения к многофайловым объектам (MFC). Инструмент обновляет поля, геометрию, время и настройки файла для указанного набора данных MFC.

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

Этому инструменту требуется MFC. Чтобы создать MFC, используйте диалоговое окно Новое подключение к многофайловым объектам или инструмент Создать подключение к многофайловым объектам.
Используйте этот инструмент, чтобы изменить схему набора данных MFC, геометрию или время, чтобы использовать его в анализе или визуализации в таких сценариях, как:
- Ваш набор данных CSV был зарегистрирован с полями строкового типа, а вы хотите задать эти поля как числовые, чтобы использовать их в анализе.
- В вашем наборе данных MFC есть атрибутивные значения для двух разных местоположений, мест посадки и высадки такси, и вы хотите изменить геометрию, используемую в анализе.
- Ваш рабочий процесс требует, чтобы для входного слоя было задано время.
- Вы хотите поделиться набором данных MFC с коллегой, который интересуется только определенным поднабором объектов, поэтому вы добавляете выражение определяющего запроса и скрываете некоторые неиспользуемые поля.
Можно изменить следующие свойства:
- Definition query—выражение, которое используется для ограничения объектов, используемых в анализе.
- Fields—имя поля, тип поля и видимость.
- Geometry—порядок представления геометрии. Недоступно редактирование для шейп-файлов.
- Time—как представлено время.
- File—свойства файла, используемые для чтения набора данных.
Используйте диалоговое окно Новое подключение к многофайловым объектам для упрощения процесса создания, редактирования и предварительного просмотра подключения к многофайловым объектам.
Укажите набор данных MFC со свойствами, которые вы хотите изменить, используя параметр Набор данных подключения к многофайловым объектам. Вы можете перейти к набору данных или задать его, используя путь, такой как c:\<path>\MyMFC.mfc\<dataset_name>, например, c:\MyMFCFolder\MyMFC.mfc\earthquakes_dataset.
Задайте выражение для ограничения объектов, используемых в анализе, с помощью параметра Выражение. Добавление фильтра к набору данных MFC аналогично применению определяющего запроса к набору данных на карте: задайте выражение SQL для фильтрации объектов.
Тип поля можно изменить для файлов с разделителями. Для остальных источников данных (например, шейп-файлов, ORC и parquet) тип поля изменить нельзя.
Вы можете изменить геометрию для файлов с разделителями, файлов ORC и файлов parquet. Вы не можете изменить геометрию для набора данных на основе шейп-файла.

В следующей таблице описано, как, редактируя набор данных MFC, задать форматы времени для параметров Время начала и Время окончания. В примере показано, как представляется следующий момент времени: 2 января 2016 года в 21:45:02.05.

Форматы времени в подключениях к многофайловым объектам


Символ	Значение	Пример
yy	Год выражается двумя цифрами.	`16`
yyyy	Год выражается четырьмя цифрами.	`2016`
MM	Месяц выражается числом.	`01` или `1`
MMM	Месяц выражается трехбуквенным обозначением.	`Jan`
MMMM	Месяц выражается полным названием.	`January`
dd	День.	`02` или `2`
HH	Час в 24-часовой системе (значения от 0 до 23).	`21`
hh	Час в 12-часовой системе; значения от 1 до 12).	`9`
mm	Минута; значения в диапазоне от 0 до 59.	`45`
ss	Секунда; значения в диапазоне от 0 до 59.	`02`
SSS	Миллисекунда; значения в диапазоне от 0 до 999.	`50`
a	Маркер AM/PM.	`PM`
epoch_millis	Время в миллисекундах с epoch.	`1509581781000`
epoch_seconds	Время в секундах с epoch.	`1509747601`
Z	Смещение часового пояса, выраженное в часах.	`-0100` или `-01:00`
ZZZ	Смещение часового пояса, выраженное с помощью ID.	`America/Los_Angeles`
''	Используйте одинарные кавычки для добавления текста, который не представляет значение, описанное в этой таблице.	`'T'`

В следующей таблице содержатся примеры различных форматов представления одной и той же даты: 2 января 2016 года, 21:45:02.05:

Примеры формата времени


Входная дата	Формат даты
01/02/2016 9:45:02PM	ММ/дд/гггг чч:мм:ссa
Jan02-16 21:45:02	ММММдд-гг ЧЧ:мм:сс
January 02 2016 9:45:02.050PM	ММММ дд гггг чч:мм:сс.СССa
01/02/2017T9:45:14:05-0000	ММ/дд/гггг чч:мм:ссa

Вы можете указать часовой пояс одним из следующих способов:

Полное название часового пояса, например, Тихоокеанское стандартное время
Смещение часового пояса, выраженное в часах: -0100 или -01:00
Аббревиатура UTC или GMT

Вы можете изменить следующие свойства файла с разделителями:
- Field Delimiter—Разделитель для каждого поля. Распространенными разделителями являются запятая (,) и точка с запятой (;).
- Record Terminator—Ограничитель для каждой строки данных. Распространенными ограничителями являются \n и \t.
- Quote Character—Символ, используемый для кавычек в исходном наборе данных.
- Has Header Row—Истинное или ложное значение, указывающее, включает ли исходный набор данных заголовки. Если строка заголовка включена в набор данных, заголовки будут использоваться для имен полей.
- Encoding—Тип кодировки, используемый исходным набором данных. По умолчанию это будет UTF-8.
Инструмент Обновить свойства набора данных подключения к многофайловым объектам обновляет свойства отдельного набора данных. Используйте следующие инструменты для изменения MFC:
- Копировать набор данных из подключения к многофайловым объектам—копирует набор данных из MFC в класс объектов.
- Дублировать набор данных из подключения к многофайловым объектам—создает представление имеющегося набора данных MFC.
- Обновить подключение к многофайловым объектам—проверяет наличие новых наборов данных и добавить их в MFC.
- Удалить набор данных из подключения к многофайловым объектам—удаляет набор данных из MFC.
- Обновить свойства набора данных подключения к многофайловым объектам—изменяет свойства набора данных MFC.
- Предварительный просмотр набора данных из подключения к многофайловым объектам—предварительный просмотр первых десяти объектов в наборе данных, чтобы убедиться в их правильной регистрации.
- Описать набор данных—чтобы убедиться в том, что обновленный набор данных вас устраивает.
Вы можете дополнительно отредактировать свой файл MFC вручную. Вы всегда должны изменять файл .mfc вручную в следующих ситуациях:
- У вас есть одно или несколько полей, используемых для представления координат x,y или z.
- Вы хотите обновить путь для источника.
Более подробно о форматировании файла подключения к многофайловым объектам.
Этот инструмент геообработки работает на Spark. См. раздел Подключения к многофайловым объектам, чтобы узнать об использовании таких подключений.

Подпись	Объяснение	Тип данных
Набор данных подключения к многофайловым объектам	Обновляемый набор данных MFC. Опции редактирования будут различаться в зависимости от исходных данных (шейп-файл, файл с разделителями, файл ORC или parquet).	Table View
Выражение (Дополнительный)	Выражение, которое используется для ограничения объектов, используемых в анализе.	SQL Expression
Свойства поля (Дополнительный)	Задает имена полей и свойства, которые будут изменены. Столбцы таблицы значений: Name–The field name. Type–Specifies the field type. Short–The field will be type short. Long–The field will be type long. Double–The field will be type double. Float–The field will be type float. String–The field will be type string. Date–The field will be type date. Blob–The field will be type BLOB. Big Integer–The field will be type big integer. Show–Specifies whether fields will be visible or hidden for use in geoprocessing tools. Fields will be visible by default.	Value Table
Тип геометрии (Дополнительный)	Задает тип геометрии, который будет использоваться для пространственного представления набора данных. Геометрию нельзя изменить для наборов данных на основе шейп-файла. Точка–Тип геометрии будет точка. Полилиния–Тип геометрии будет линия. Полигон–Тип геометрии будет полигон. Нет–Тип геометрии не задан.	String
Пространственная привязка (Дополнительный)	Значение WKID или строка WKT, которая будет использоваться для пространственной привязки набора данных. По умолчанию WKID 4326 (WGS84). Пространственную привязку нельзя изменить для наборов данных на основе шейп-файла.	String
Тип формата геометрии (Дополнительный)	Определяет, как будет отформатирована геометрия. Геометрию нельзя изменить для данных на основе шейп-файла. XYZ–Два или большее число полей будут хранить значения x, y и, дополнительно, z. WKT–Геометрия будет храниться в одном поле в виде стандартного текстового поля. WKB–Геометрия будет храниться в одном поле в виде стандартного бинарного поля. GeoJSON–Геометрия будет храниться в одном поле в формате GeoJSON. EsriJSON–Геометрия будет храниться в одном поле в формате EsriJSON. EsriShape–Геометрия будет храниться в одном поле в формате EsriShape.	String
Поле геометрии (Дополнительный)	Одно поле, используемое для представления геометрии. Это поле используется, когда форматом геометрии является WKT, WKB, GeoJSON, EsriJSON или EsriShape.	String
Поле X (Дополнительный)	Поле, используемое для представления координаты x местоположений: Если более одного поля представляют координату x, измените файл `.mfc` вручную.	String
Поле Y (Дополнительный)	Поле, используемое для представления координаты y местоположений: Если более одного поля представляют координату y, измените файл `.mfc` вручную.	String
Поле Z (Дополнительный)	Поле, используемое для представления координаты z местоположений: Если более одного поля представляют координату z, измените файл `.mfc` вручную.	String
Тип времени (Дополнительный)	Задает тип времени, который будет использоваться для временного представления набора данных. Интервал–Тип времени будет представлять продолжительность времени с начальным и конечным временем. Текущий–Тип времени будет представлять момент времени. Нет–Время не включено.	String
Часовой пояс (Дополнительный)	Часовой пояс набора данных.	String
Время начала (Дополнительный)	Поля, используемые для определения времени начала и форматирования времени. Столбцы таблицы значений: Name–The field name. Short–The field type will be short. Long–The field type will be long. Big Integer–The field type will be big integer. Float–The field type will be float. Double–The field type will be double. Text–The field type will be text. Date–The field type will be date. Format–The field format.	Value Table
Конечное время (Дополнительный)	Поля, используемые для определения времени окончания и форматирования времени. Столбцы таблицы значений: Name–The field name. Short–The field type will be short. Long–The field type will be long. Big Integer–The field type will be big integer. Float–The field type will be float. Double–The field type will be double. Text–The field type will be text. Date–The field type will be date. Format–The field format.	Value Table
Расширение файла (Дополнительный)	Расширение файла исходного набора данных. Значение параметра не может быть изменено.	String
Разделитель полей (Дополнительный)	Разделитель полей, используемый в исходном наборе данных.	String
Ограничитель записи (Дополнительный)	Ограничитель записи, используемый в исходном наборе данных.	String
Символ кавычки (Дополнительный)	Символ кавычки, используемый в исходном наборе данных.	String
Содержит строку заголовка (Дополнительный)	Указывает, включает ли исходный набор данных строку заголовка. Отмечено–Исходный набор данных включает строку заголовка. Не отмечено–Исходный набор данных не включает строку заголовка.	Boolean
Кодировка (Дополнительный)	Тип кодировки, используемый в исходном наборе данных. По умолчанию используется UTF-8.	String

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

Подпись	Объяснение	Тип данных
Обновленный MFC	Обновленный файл MFC с отредактированными свойствами, примененными к определенному набору данных.	File

arcpy.gapro.UpdateBDCDatasetProperties(bdc_dataset, {expression}, {field_properties}, {geometry_type}, {spatial_reference}, {geometry_format_type}, {geometry_field}, {x_field}, {y_field}, {z_field}, {time_type}, {time_zone}, {start_time_format}, {end_time_format}, {file_extension}, {field_delimiter}, {record_terminator}, {quote_character}, {has_header_row}, {encoding})

Имя	Объяснение	Тип данных
bdc_dataset	Обновляемый набор данных MFC. Опции редактирования будут различаться в зависимости от исходных данных (шейп-файл, файл с разделителями, файл ORC или parquet).	Table View
expression (Дополнительный)	Выражение, которое используется для ограничения объектов, используемых в анализе.	SQL Expression
field_properties [field_properties,...] (Дополнительный)	Задает имена полей и свойства, которые будут изменены. Столбцы таблицы значений: `Name`–The field name. `Type`–Specifies the field type. `SHORT`–The field will be type short. `LONG`–The field will be type long. `DOUBLE`–The field will be type double. `FLOAT`–The field will be type float. `STRING`–The field will be type string. `DATE`–The field will be type date. `BLOB`–The field will be type BLOB. `BIG_INTEGER`–The field will be type big integer. `Show`–Specifies whether fields will be visible or hidden for use in geoprocessing tools. Fields will be visible by default.	Value Table
geometry_type (Дополнительный)	Задает тип геометрии, который будет использоваться для пространственного представления набора данных. Геометрию нельзя изменить для наборов данных на основе шейп-файла. `POINT`–Тип геометрии будет точка. `LINE`–Тип геометрии будет линия. `POLYGON`–Тип геометрии будет полигон. `NONE`–Тип геометрии не задан.	String
spatial_reference (Дополнительный)	Значение WKID или строка WKT, которая будет использоваться для пространственной привязки набора данных. По умолчанию WKID 4326 (WGS84). Пространственную привязку нельзя изменить для наборов данных на основе шейп-файла.	String
geometry_format_type (Дополнительный)	Определяет, как будет отформатирована геометрия. Геометрию нельзя изменить для данных на основе шейп-файла. `XYZ`–Два или большее число полей будут хранить значения x, y и, дополнительно, z. `WKT`–Геометрия будет храниться в одном поле в виде стандартного текстового поля. `WKB`–Геометрия будет храниться в одном поле в виде стандартного бинарного поля. `GEOJSON`–Геометрия будет храниться в одном поле в формате GeoJSON. `ESRIJSON`–Геометрия будет храниться в одном поле в формате EsriJSON. `ESRISHAPE`–Геометрия будет храниться в одном поле в формате EsriShape.	String
geometry_field (Дополнительный)	Одно поле, используемое для представления геометрии. Это поле используется, когда форматом геометрии является WKT, WKB, GeoJSON, EsriJSON или EsriShape.	String
x_field (Дополнительный)	Поле, используемое для представления координаты x местоположений: Если более одного поля представляют координату x, измените файл `.mfc` вручную.	String
y_field (Дополнительный)	Поле, используемое для представления координаты y местоположений: Если более одного поля представляют координату y, измените файл `.mfc` вручную.	String
z_field (Дополнительный)	Поле, используемое для представления координаты z местоположений: Если более одного поля представляют координату z, измените файл `.mfc` вручную.	String
time_type (Дополнительный)	Задает тип времени, который будет использоваться для временного представления набора данных. `INTERVAL`–Тип времени будет представлять продолжительность времени с начальным и конечным временем. `INSTANT`–Тип времени будет представлять момент времени. `NONE`–Время не включено.	String
time_zone (Дополнительный)	Часовой пояс набора данных.	String
start_time_format [start_time_format,...] (Дополнительный)	Поля, используемые для определения времени начала и форматирования времени. Столбцы таблицы значений: `Name`–The field name. `Short`–The field type will be short. `Long`–The field type will be long. `BigInteger`–The field type will be big integer. `Float`–The field type will be float. `Double`–The field type will be double. `Text`–The field type will be text. `Date`–The field type will be date. `Format`–The field format.	Value Table
end_time_format [end_time_format,...] (Дополнительный)	Поля, используемые для определения времени окончания и форматирования времени. Столбцы таблицы значений: `Name`–The field name. `Short`–The field type will be short. `Long`–The field type will be long. `BigInteger`–The field type will be big integer. `Float`–The field type will be float. `Double`–The field type will be double. `Text`–The field type will be text. `Date`–The field type will be date. `Format`–The field format.	Value Table
file_extension (Дополнительный)	Расширение файла исходного набора данных. Значение параметра не может быть изменено.	String
field_delimiter (Дополнительный)	Разделитель полей, используемый в исходном наборе данных.	String
record_terminator (Дополнительный)	Ограничитель записи, используемый в исходном наборе данных.	String
quote_character (Дополнительный)	Символ кавычки, используемый в исходном наборе данных.	String
has_header_row (Дополнительный)	Указывает, включает ли исходный набор данных строку заголовка. `HAS_HEADER`–Исходный набор данных включает строку заголовка. `NO_HEADER`–Исходный набор данных не включает строку заголовка.	Boolean
encoding (Дополнительный)	Тип кодировки, используемый в исходном наборе данных. По умолчанию используется UTF-8.	String

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

Имя	Объяснение	Тип данных
updated_bdc	Обновленный файл MFC с отредактированными свойствами, примененными к определенному набору данных.	File

Пример кода

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

Следующий скрипт Python демонстрирует использование функции UpdateBDCDatasetProperties.

# Name: UpdateBDCDatasetProperties.py
# Description: Add a filter and modify the schema, time, and geometry for a MFC dataset
# Requirements: ArcGIS Pro Advanced License

# Import system modules
import arcpy

# Set local variables
dataset = r"c:\Projects\MyProjectFolder\my_BigDataConnection.mfc\myBigDataset"
filter = "COUNT > 500"
field_properties = "Field1 FLOAT true;Field2 STRING true;Field3 DOUBLE true"
geometry_type = "POINT"
sref = "4326"
geometry_format = "XYZ"
x_field = "Long"
y_field = "Lat"
z_field = ""
time_type = "INSTANT"
time_zone = "UTC"
time_formats = "Year yyyy"
file_extension = "csv"
file_delimiter = ","
file_terminator = r"\n"
file_quotechar = '"'
has_header_row = True
file_encoding = "UTF-8"

# Run Update MFC Dataset Properties
arcpy.gapro.UpdateBDCDatasetProperties(dataset, filter, field_properties, geometry_type, sref, geometry_format, "",
x_field, y_field, z_field, time_type, time_zone, time_formats, None, file_extension, file_delimiter, file_terminator,
file_quotechar, has_header_row, file_encoding)

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

Этот инструмент не использует параметры среды геообработки.

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

Basic: Нет
Standard: Нет
Advanced: Да

Обновить свойства набора данных подключения к многофайловым объектам (Инструменты GeoAnalytics Desktop)

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

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

Параметры

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

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

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

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