Выходной оператор подключения Записать GeoJSON в Kafka Topic может использоваться для записи данных событий, адаптированных и отформатированных как GeoJSON, в Apache Kafka® Topic. Более подробно о начале работы с Apache Kafka® см. в разделе Введение в Apache Kafka. Дополнительную информацию и примеры записей данных в формате GeoJSON см. в Спецификация GeoJSON.
Примечания по использованию
- Используйте этот выходной оператор подключения для записи данных, адаптированных и отформатированных как GeoJSON, в Kafka Topic. Этот входной оператор подключения является производителем для Kafka.
- Этот выходной оператор подключения связывает исходящий адаптер GeoJSON с исходящим транспортом Kafka.
- Как и объект JSON, GeoJSON по сути является одним из вариантов JSON. Для обработки этих разных специальных форматов используются разные адаптеры GeoEvent Server.
- Этот выходной оператор подключения поддерживает запись GeoJSON в Kafka Topic в формате либо исходный GeoJSON, либо Feature GeoJSON. Исходный GeoJSON соответствует стандарту GeoJSON, а Feature GeoJSON является пользовательским форматом, который используется для хранилища пространственно-временных больших данных ArcGIS.
- Выходящий транспорт Kafka поддерживает протоколы безопасности TLS 1.2 и SASL для аутентификации с помощью кластера или брокера Kafka.
Параметры
Параметр | Описание |
---|---|
Имя | Описательное имя входного коннектора, используемое для справки в GeoEvent Manager. |
Заменить пользовательскими свойствами Kafka | Укажите, следует ли переопределять свойства клиента Kafka GeoEvent Server по умолчанию. По умолчанию Нет.
|
Серверы Kafka Bootstrap (Условия) | Список пар hostname:port, используемый для установки исходного подключения к кластеру Kafka. Пары hostname:port должны быть разделены запятыми, например:
|
Зарегистрированная папка для файла свойств Kafka (Условия) | Папка, зарегистрированная в GeoEvent Server, которая содержит файл Kafka .properties. Файл Kafka .properties определяет пользовательские свойства Kafka, когда для параметра Заменить пользовательскими свойствами Kafka установлено Да. Убедитесь, что папка, зарегистрированная на GeoEvent Server, является полным путем к местоположению файла Kafka .properties. |
Имя файла свойств Kafka (Условия) | Имя того файла Kafka .properties, содержащего пользовательские свойства Kafka для конфигурации клиента. Имя файла должно быть указано без имени расширения .properties.
|
Название темы | Имя темы Kafka, в которую публикуются данные.
Примечание:Исходящий транспорт Kafka не поддерживает публикацию данных в нескольких темах. |
Включить Доставку только один раз | Указывает, следует ли при написании на тему соблюдать семантику exactly-once. Для получения дополнительной информации см. Семантика Exactly-once Semantics. По умолчанию задано Да.
Примечание:Убедитесь, что кластер Kafka поддерживает семантику exactly-once, прежде чем продолжить работу со свойством Включить Доставку только один раз. Включение семантики exactly-once влияет на уровень производительности. Дополнительную информацию см. в разделе Конфигурации производителя, в отношении подтверждений. |
Форматированный JSON | Указывает, будет ли строка объекта JSON иметь отступ с пробелом и форматированием новой строки. Этот JSON, иногда называемый PJSON, обычно подходит только при записи в системный файл, содержимое которого может быть просмотрено в текстовом редакторе. По умолчанию Нет.
|
Тип конвертера | Задает формат GeoJSON адаптированных записей событий. Доступные форматы GeoJSON включают Исходный GeoJson и Объектный GeoJSON. Формат по умолчанию: Исходный GeoJSON.
|
Игнорировать зарезервированные имена полей | Указывает, следует ли игнорировать зарезервированные имена полей при адаптации обработанных данных событий как GeoJSON для Kafka. Зарезервированные имена полей включают "ObjectId", "GlobalId" или "UniqueId" (с учетом регистра). По умолчанию Нет.
|
Необходима аутентификация | Указывает, требуется ли аутентификация при подключению к кластеру Kafka, или брокеру Kafka. По умолчанию Нет.
|
Аутентификация с использованием (Условия) | Указывает протокол безопасности, используемый для защиты кластера Kafka. Доступные протоколы безопасности включают TLS 1.2 и SASL.
Примечание:Используя Kerberos, убедитесь, что у учетной записи операционной системы, от имени которой запущен ArcGIS GeoEvent Server , есть права на чтение файла keyTab в настройке/конфигурации Kerberos. Свойство показывается, когда для свойства Требуется аутентификация задано Да. |
Зарегистрированная папка для файла учетных данных (Условия) | Папка, зарегистрированная в GeoEvent Server, которая содержит файл PKI кластера Kafka (сертификат x509). Убедитесь, что папка, зарегистрированная на GeoEvent Server, является полным путем к местоположению сертификата кластера Kafka. |
Файл конфигурации учетных данных (Условия) | Имя файла PKI кластера Kafka (сертификат x509). Сертификат и его ключ должны храниться в формате PKCS#12, который выглядит как файл с расширением .p12 или .pfx. Укажите имя файла в дополнении к расширению.
Примечание:Для этого параметра поддерживаются только имя файла сертификата и расширение. Относительные пути к сертификату не должны указываться в этом параметре. Зарегистрируйте полный путь к файлу сертификата с помощью параметра Зарегистрированная папка для файла учетных данных. Свойство показывается, когда для свойства Требуется аутентификация задано Да. Это свойство применимо только к протоколу TLS 1.2. |
Пароль Keystore (Условия) | Пароль для файлв PKI кластера Kafka (сертификат x509). Также известный как частный ключ сертификата. |
Тип аутентификации SASL (Условия) | Указывает тип механизма аутентификации SASL, поддерживаемого кластером Kafka. Доступные типы аутентификации SASL включают SASL GSSAPI (Kerberos) и SASL PLAIN.
|
Участник Kerberos (Условия) | Участник Kerberos для определенного пользователя. Пример:
|
Использовать Key Tab (Условия) | Указывает, следует ли использовать keytab в настройках Kerberos. По умолчанию – Да.
|
Хранить ключ (Условия) | Указывает, следует ли хранить ключ в настройках Kerberos. По умолчанию – Да.
|
Имя пользователя (Условия) | Указывает Имя пользователя, используемое для аутентификации в кластере Kafka. Также известен как строка подключения с определенными провайдерами облачных ресурсов. Обратитесь к документации выбранного провайдера облачных услуг для получения правильного синтаксиса. |
Пароль (Условия) | Указывает пароль, используемый для аутентификации в кластере Kafka. Обратитесь к документации выбранного провайдера облачных услуг для получения правильного синтаксиса. |
Советы и ограничения
- Выходной оператор подключения Записать GeoJSON в Kafka Topic является производителем для Kafka. К этому выходному оператору подключения применяются те же рекомендации, что и к любому другому внешнему производителю для Kafka.