Входной коннектор Следить за появлением новых файлов GeoJSON в папке можно использовать для чтения и интерпретации данных событий в формате GeoJSON из системного файла.
Если в файле GeoJSON указано несколько записей данных событий, организуйте их в FeatureCollection, как показано ниже. Входной адаптер GeoJSON обработает каждую запись объекта в коллекции объектов как отдельную запись данных события. GeoJSON, проиллюстрированный ниже, будет адаптирован для создания двух записей событий для обработки сервисом GeoEvent.
Дополнительную информацию и примеры записей данных в формате GeoJSON см. в Спецификация GeoJSON.
Примечания по использованию
При использовании входного коннектора Следить за появлением новых файлов JSON в папке имейте в виду следующее:
- Описываемый входной коннектор используется для чтения данных событий, отформатированных как GeoJSON, из системного файла и их интерпретации для создания записей данных событий с целью дальнейшей обработки.
- Этот входной коннектор связывает входной адаптер GeoJSON с входным транспортом файлов.
- Входной коннектор просматривает указанную системную папку и считывает файл полностью, как только он появляется в папке.
- Содержимое всего файла будет прочитано заново, если в файл будут внесены и сохранены изменения.
- Все файлы в просматриваемой папке будут прочитаны заново с начала файлов в следующих ситуациях:
- Свойства входного коннектора было обновлено и сохранено.
- Входной коннектор был остановлен и перезапущен (был перезапущен сервис ArcGIS GeoEvent Server).
- Ожидается, что запись объекта GeoJSON содержит и геометрию и свойства участников.
- Входной адаптер GeoJSON не поддерживает возможность Построить геометрию из полей.
- Зарегистрированная папка сервера, указанная в параметре Входная папка хранилища данных, может быть задана с помощью абсолютного или относительного пути UNC. Если используется путь UNC, учетной записи службы Windows, под которой запущен ArcGIS GeoEvent Server, требуется разрешение на чтение/запись в папку.
- Рекомендуется использовать абсолютные пути — например C:\GeoEvent\input, — для параметра Входная папка хранилища данных.
- Параметр Входная директория позволяет указать подпапку связанную с зарегистрированной папкой сервера.
- Параметр Включить подпапки позволяет указать, следует ли выполнять рекурсивный поиск папок, расположенных ниже папки, указанной в параметре Входная папка хранилища данных. Часто хранение данных с различными схемами в разных папках и изменение параметра Включить подпапки со значения по умолчанию на отключение рекурсивного поиска позволяет задать более прямую и простую конфигурацию этого входного коннектора.
- Ожидание сети может отрицательно повлиять на способность GeoEvent Server извлекать большие объемы данных событий.
Параметры
Ниже приведены параметры для входного коннектора Следить за появлением новых файлов GeoJSON в папке:
| Параметр | Описание |
|---|---|
| Имя | Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager. |
Входная папка хранилища данных | Зарегистрированная системная папка, в которой находятся файлы. |
Входная директория | Подпапка непосредственно под зарегистрированной системной папкой. Параметр Входная директория следует оставить пустым, если подпапка под зарегистрированной системной папкой не существует. |
Фильтр входных файлов |
Шаблон регулярных выражений, используемый для идентификации файлов, подходящих для входных данных в этом случае, и адаптации для создания записей данных событий для обработки. Поскольку GeoJSON технически является подтипом универсального JSON, значение по умолчанию (.*\.json) используется для сопоставления любого имени файла (.*), заканчивающегося буквенным суффиксом (.json). Предполагая, что все входные файлы были названы с помощью расширения (.geojson), шаблон по умолчанию может быть изменен на .*\.geojson, чтобы избежать путаницы с более общими файлами JSON. Хотя этот параметр не является обязательным и может быть оставлен пустым, рекомендуется указать шаблон, который соответствует имени любого файла, схема которого соответствует определению GeoEvent, чтобы эти входные данные были настроены для использования и исключения файлов (по имени), которые не должны обрабатываться. |
Пространственная привязка по умолчанию | Известный идентификатор (WKID) или известный текст (WKT) системы пространственной привязки, в которой выражены геометрические координаты. У этого параметра нет значения по умолчанию. |
Включить подпапки | Указывает, используются ли для файлов подпапки в Входной папке хранилища данных и Входной директории (дополнительно). По умолчанию – Да, однако, организация данных с разными схемами в разные папки и изменение этого параметра на Нет, чтобы отключить рекурсивный поиск, позволяет упростить конфигурацию.
|
Удалить файлы после обработки | Указывает, удаляются ли файлы в зарегистрированной системной папке после обработки их содержимого. Даже если содержимое файла не может быть адаптировано, записи событий не создаются и обработка событий в реальном времени не выполняется, входящий транспорт все равно удаляет файл, содержимое которого было успешно прочитано. Значение по умолчанию – Нет.
|
Создать определение GeoEvent | Указывает, используется ли новое или существующее определение GeoEvent для данных входящих событий. Определение GeoEvent требуется GeoEvent Server, чтобы понимать поля атрибутов и типы данных входящих событий.
|
Имя определения GeoEvent (новое) (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, используется существующее определение GeoEvent. Первая полученная запись данных используется для определения ожидаемой схемы последующих записей данных, на основе которой создается новое определение GeoEvent. Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если задано значение Нет. |
Имя определения GeoEvent (существующее) (Условия) | Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent. Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если задано значение Да. |
Ожидаемый формат данных |
Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты/времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat. Хотя предпочтительным шаблоном для значений даты/времени в GeoEvent Server является стандарт ISO 8601, несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания значения Ожидаемого формата даты. К ним относятся:
Если полученные значения даты/времени используют соглашение, отличное от перечисленных выше, необходимо указать ожидаемый шаблон формата даты, чтобы GeoEvent Server мог адаптировать значения даты/времени. |
Считать файл в виде текстовых строк | Указывает, как содержание файла читается и анализируется. По умолчанию – Да.
При работе с текстовым файлом, содержащим один или несколько объектов FeatureCollection geoJSON, рекомендуется читать содержимое файла целиком, а не отдельные строки текста в файле. Документы GeoJSON лучше всего читать как единый документ. |
Максимальное число строк на пакет (Условия) | Максимальное количество строк для чтения из файла в каждом пакете или интервале. По умолчанию – 1000 строк. Уменьшите это значение, если каждая запись события содержит много атрибутов, для ограничения объема данных, отправляемых текстовому адаптеру в виде пакета. Этот параметр показывается, когда для Считать файл в виде текстовых строк задано значение Да, и скрыт, если задано значение Нет. |
Интервал записи пакета (миллисекунды) (Условия) | Количество миллисекунд ожидания перед чтением очередного пакета строк из файла. Значение по умолчанию равно 500. Уменьшите это значение, если ожидается, что размер файла будет очень большим или потребуется дополнительное время для обработки каждой партии строк, извлеченных из файла. Этот параметр показывается, когда для Считать файл в виде текстовых строк задано значение Да, и скрыт, если задано значение Нет. |
Число строк, пропускаемых от начала файла (Условия) | Количество строк, пропущенных от начала файла. Значение по умолчанию равно 0. Увеличьте это значение, чтобы пропустить определенное количество строк, например, строки заголовка, указывающие имена полей атрибутов или типы данных, поскольку они не содержат фактических данных для обработки. Этот параметр показывается, когда для Считать файл в виде текстовых строк задано значение Да, и скрыт, если задано значение Нет. |