Обновить свойства подключения набора больших данных (GeoAnalytics Desktop)

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

Обновляет свойства подключения к набору больших данных (НБД). Инструмент обновляет поля, геометрию, время и настройки полей, определенные для набора больших данных.

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

  • Для этого инструмента требуется BDC. Чтобы создать BDC, используйте диалоговое окно Новое подключение к большим данным или инструмент Создать подключение к большим данным.

  • Используйте этот инструмент для изменения схемы НБД, геометрии или времени для использования в анализе или визуализации в сценариях, например:

    • Ваш набор данных CSV был зарегистрирован с полями строкового типа, а вы хотите часть полей перевести в числовой формат для использования в анализе.
    • В вашем наборе больших данных есть атрибутивные значения для двух отдельных местоположений, например, стоянка такси и зона посадки, и вы хотите изменить геометрию для использования в анализе.
    • Для рабочего процесса анализа необходимо установить время для входного слоя.
    • Вы хотите опубликовать набор больших данных для ваших коллег, но им требуется только поднабор, поэтому вы добавите выражение для определяющего запроса и скроете часть ненужных полей.

  • Вы можете изменить следующие свойства:

    • Определяющий запрос – выражение для ограничения числа объектов для анализа.
    • Поля – имя поля, тип поля и видимость.
    • Геометрия – представление геометрии. Недоступно для редактирования в формате шейп-файла.
    • Время – представление времени.
    • Файл – свойства файла, необходимые для чтения набора данных.

  • Используйте диалоговое окно Новое подключение к большим данным чтобы легко создать, отредактировать и просмотреть подключение к большим данным.

  • Укажите набор больших данных, свойства которого вы хотите изменить с использованием параметра Подключение к набору больших данных. Вы можете перейти к набору данных или указать его с помощью пути, например c:\<path>\MyBDC.bdc\<dataset_name>, c:\MyBDCFolder\MyBDC.bdc\earthquakes_dataset.

  • Задайте выражение для ограничения числа объектов в анализе с помощью параметра Выражение. Добавление фильтра к набору больших данных подобно применению определяющего запроса к набору данных на карте: укажите выражение SQL для выбора интересующих объектов.

  • Вы можете обновить тип поля только для файлов с разделителями. Вы не можете обновить тип поля для других источников данных (например шейп-файлы, ORC или parquet).

  • Вы можете изменить геометрию для файлов с разделителями, ORC и parquet. Вы не можете изменить геометрию для источников данных на основе шейп-файлов.

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

    Форматы времени в подключениях к наборам больших данных

    СимволЗначениеПример

    yy

    Год выражается двумя цифрами.

    16

    гггг

    Год выражается четырьмя цифрами.

    2016

    MM

    Месяц выражается числом.

    01 или 1

    MMM

    Месяц выражается трехбуквенным обозначением.

    Jan

    MMMM

    Месяц выражается полным названием.

    January

    dd

    День.

    02 или 2

    HH

    Час в 24-часовой системе (значения от 0 до 23).

    21

    hh

    Час в 12-часовой системе; значения от 1 до 12).

    9

    мм

    Минута; значения в диапазоне от 0 до 59.

    45

    ss

    Секунда; значения в диапазоне от 0 до 59.

    02

    ССС

    Миллисекунда; значения в диапазоне от 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

    You can specify the time zone using one of the following:
    • Полное имя часового пояса: Pacific Standard Time
    • Смещение часового пояса, выраженное в часах: -0100 или -01:00
    • Аббревиатуры UTC или GMT
  • Вы можете изменить следующие свойства для файлов с разделителями:

    • Разделитель полей – определяет разделитель для каждого поля. Стандартными разделителями являются , и ;.
    • Ограничитель записей – определяет ограничитель для каждой строки данных. Стандартными ограничителями являются \n и \t.
    • Символ кавычки – символ кавычки в исходном наборе данных.
    • Содержит строку заголовка – значение истина или ложь для определения, содержит ли исходный набор данных заголовки. Если в наборе данных есть строка заголовка, для имен полей будут использоваться заголовки.
    • Кодировка – тип кодировки для набора данных. По умолчанию это UTF-8.

  • Инструмент Обновить свойства подключения к набору больших данных обновляет свойства подключения к отдельному набору. Для изменения наборов больших данных используйте следующие инструменты:

  • Вы можете дополнительно отредактировать свой файл BDC вручную. Вы всегда должны изменять файл .bdc вручную в следующих ситуациях:

    • У вас есть одно или несколько полей, используемых для представления координат x,y или z.
    • Вы хотите обновить путь для источника.

    Более подробно о форматировании файлов подключения больших данных.

  • Этот инструмент геообработки работает от Spark. Чтобы изучить вопросы, посвященные подключениям больших данных и работе с ними, см. раздел Подключения больших данных.

Параметры

ПодписьОписаниеТип данных
Подключение к набору больших данных

Набор больших данных для обновления. Опции для редактирования будут отличаться друг от друга в зависимости от источников данных (шейп-файлы, файлы с разделителями, ORC или файлы parquet).

Table View
Выражение
(Дополнительный)

Выражение для ограничения числа объектов для анализа.

SQL Expression
Свойства поля
(Дополнительный)

Указывает имена полей и свойства для изменения.

  • Short —Это поле будет типа short.
  • Long —Это поле будет типа long
  • Double —Это поле будет типа double.
  • Float —Это поле будет типа float.
  • String —Это поле будет типа string.
  • Date —Это поле будет типа date.
  • BLOB —Это поле будет типа BLOB.
Value Table
Тип геометрии
(Дополнительный)

Указывает тип геометрии, который будет использован для пространственного представления набора данных. Геометрию нельзя изменить для наборов данных на основе шейп-файлов.

  • Точка —Тип геометрии – точка.
  • Полилиния —Тип геометрии – полилиния.
  • Полигон —Тип геометрии – полигон.
  • Нет —Отсутствует тип геометрии
String
Пространственная привязка
(Дополнительный)

Значение WKID или строка WKT будет использована для пространственного представления набора данных. По умолчанию WKID 4326 (WGS84). Пространственную привязку нельзя изменить для наборов данных на основе шейп-файлов.

String
Тип формата геометрии
(Дополнительный)

Указывает, как может быть отформатирована геометрия. Геометрию нельзя изменить для наборов данных на основе шейп-файлов.

  • XYZ —Два или более полей будут представлять x, y и, дополнительно z.
  • WKT —Геометрия будет представлена одним полем в формате стандартного текстового поля.
  • WKB —Геометрия будет представлена одним полем в формате стандартного бинарного поля.
  • GeoJSON —Геометрия будет представлена одним полем в формате GeoJSON.
  • EsriJSON —Геометрия будет представлена одним полем в формате EsriJSON.
String
Поле геометрии
(Дополнительный)

Единое поле, использующееся для представления геометрии. Это поле будет использовано, если формат геометрии: WKT, WKB, GeoJSON или EsriJSON.

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

Поле, используемое для представления местоположения x. Если местоположение x представлено более чем одним полем, измените файл .bdc вручную.

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

Поле, используемое для представления местоположения y. Если местоположение y представлено более чем одним полем, измените файл .bdc вручную.

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

Поле, используемое для представления местоположения z. Если местоположение z представлено более чем одним полем, измените файл .bdc вручную.

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

Указывает тип времени, используемый для временного представления набора данных.

  • Интервальный —Тип времени может быть представлен временным интервалом или временем начала и временем окончания.
  • Мгновение —Этот тип времени будет представлять мгновение во времени.
  • Нет —Время не активно.
String
Часовой пояс
(Дополнительный)

Часовой пояс набора данных..

String
Время начала
(Дополнительный)

Поля используемые для определения формата времени начала и времени окончания.

Value Table
Время окончания
(Дополнительный)

Поля используемые для определения формата времени начала и времени окончания.

Value Table
Расширение файла
(Дополнительный)

Расширение файла исходного набора данных. Этот параметр не может быть изменен.

String
Разделитель полей
(Дополнительный)

Разделитель поля, используемый в исходном наборе данных.

String
Ограничитель записи
(Дополнительный)

Ограничитель записи, используемый в исходном наборе данных.

String
Символ кавычки
(Дополнительный)

Символ кавычки, используемый в исходном наборе данных.

String
Содержит строку заголовка
(Дополнительный)

Указывает, содержит ли исходный набор данных строку заголовка.

  • Отмечено – исходный набор данных содержит строку заголовка.
  • Не отмечено – исходный набор данных не содержит строку заголовка.

Boolean
Кодировка
(Дополнительный)

Тип кодировки, используемый исходным набором данных. По умолчанию используется UTF-8.

String

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

ПодписьОписаниеТип данных
Обновленный набор больших данных

Файл обновленного набора больших данных с измененными свойствами примененными к указанному набору данных.

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

Набор больших данных для обновления. Опции для редактирования будут отличаться друг от друга в зависимости от источников данных (шейп-файлы, файлы с разделителями, ORC или файлы parquet).

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

Выражение для ограничения числа объектов для анализа.

SQL Expression
field_properties
[field_properties,...]
(Дополнительный)

Указывает имена полей и свойства для изменения.

  • SHORTЭто поле будет типа short.
  • LONGЭто поле будет типа long
  • DOUBLEЭто поле будет типа double.
  • FLOATЭто поле будет типа float.
  • STRINGЭто поле будет типа string.
  • DATEЭто поле будет типа date.
  • BLOBЭто поле будет типа BLOB.

Указывает, будут ли поля видимы или скрыты.

  • TRUEПоля видимы и доступны для использования в инструментах геообработки. Это значение по умолчанию
  • FALSEПоля будут скрыты и не могут быть использованы в инструментах геообработки.
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.
String
geometry_field
(Дополнительный)

Единое поле, использующееся для представления геометрии. Это поле будет использовано, если формат геометрии: WKT, WKB, GeoJSON или EsriJSON.

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

Поле, используемое для представления местоположения x. Если местоположение x представлено более чем одним полем, измените файл .bdc вручную.

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

Поле, используемое для представления местоположения y. Если местоположение y представлено более чем одним полем, измените файл .bdc вручную.

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

Поле, используемое для представления местоположения z. Если местоположение z представлено более чем одним полем, измените файл .bdc вручную.

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

Указывает тип времени, используемый для временного представления набора данных.

  • INTERVALТип времени может быть представлен временным интервалом или временем начала и временем окончания.
  • INSTANTЭтот тип времени будет представлять мгновение во времени.
  • NONEВремя не активно.
String
time_zone
(Дополнительный)

Часовой пояс набора данных..

String
start_time_format
[start_time_format,...]
(Дополнительный)

Поля используемые для определения формата времени начала и времени окончания.

Value Table
end_time_format
[end_time_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

Файл обновленного набора больших данных с измененными свойствами примененными к указанному набору данных.

File

Пример кода

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

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

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

# Import system modules
import arcpy

# Set local variables
dataset = r"c:\Projects\MyProjectFolder\my_BigDataConnection.bdc\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_extenstion = "csv"
file_delimitor = ","
file_terminator = r"\n"
file_quotechar = '"'
has_header_row = True
file_encoding = "UTF-8"


# Execute Update BDC 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_delimitor, file_terminator, 
file_quotechar, has_header_row, file_encoding)

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

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

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

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

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