Входной коннектор Подписаться на Kafka Topic для текста может использоваться для извлечения и адаптации записей данных событий, отформатированных как текст с разделителями, с Apache Kafka Topic. Разделителем текста обычно является запятая, поэтому этот тип текстовых данных иногда называют данными значений с разделителями-запятыми, но ArcGIS GeoEvent Server может использовать для разделения значений атрибутов данных любой обычный символ ASCII. Для получения информации о работе с Apache Kafka см. раздел Введение в Apache Kafka.
Примечания по использованию
При работе с входным коннектором Подписаться на Kafka Topic для текста имейте в виду следующее:
- Этот входной коннектор можно использовать для получения данных форматированного теста или текста с разделителями с Kafka Topic. Этот входной коннектор — потребитель Kafka.
- Этот входной коннектор связывает входной адаптер текста с входным транспортом Kafka.
- Текст с разделителями не обязательно должен содержать данные, представляющие геометрию. Поэтому этот входной коннектор может использоваться для получения и обработки непространственных данных от Kafka.
- Адаптер поддерживает возможность построения точечной геометрии по атрибутивным значениям X, Y и Z.
- Для обработки текста с разделителями из Kafka необходимы параметры Разделитель сообщений и Разделитель атрибутов. Разделитель сообщений указывает символ, определяющий конец записи данных. По умолчанию используется \n (новая строка). Разделитель атрибутов задает символ, используемый для отделения одного значения атрибута от другого в одной строке текста. По умолчанию используется запятая (,). Любой стандартный ASCII-символ, заданный как символ или значение Юникод, может использоваться в качестве разделителя сообщений или атрибутов.
- Входящий транспорт Kafka поддерживает протоколы безопасности TLS 1.2 и SASL для аутентификации с помощью кластера или брокера Kafka.
Параметры
Ниже приведены параметры для входного коннектора Подписаться на Kafka Topic для текста:
| Параметр | Описание |
|---|---|
Имя | Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager. |
Заменить пользовательскими свойствами Kafka | Указывает, заменяются ли свойства клиента GeoEvent Server Kafka по умолчанию. По умолчанию Нет.
|
Серверы Kafka Bootstrap (Условия) | Список пар hostname:port, используемых для установки исходного подключения к кластеру Kafka. Пары Hostname:port должны быть разделены запятыми, например, broker0.example.com:9092,broker1.example.com:9092,broker2.example.com:9092. Этот параметр показывается, когда для свойства Заменить пользовательскими свойствами Kafka задано Нет. |
Названия тем | Название темы Kafka или список тем Kafka, из которых будут использоваться интересующие данные. Разделяйте несколько тем точкой с запятой. Ниже приведены примеры:
Примечание:Указание нескольких тем Kafka поддерживается в ArcGIS GeoEvent Server 10.8 и более поздних версиях. Примечание:Порядок данных из определенной темы не гарантируется. |
Число пользователей | Число пользователей для каждой группы пользователей. Число пользователей по умолчанию равно 1. Примечание:Число пользователей ограничено количеством разделов в Kafka topic. См. Введение в Apache Kafka для получения дополнительной информации о примерах пользователей. |
ID группы потребителей (Условия) | Необязательная строка, которая однозначно идентифицирует группу потребителей для набора потребителей. Он также известен как название группы потребителей. Если ID группы потребителей не указан, GeoEvent Server назначает статические ID группы потребителей, называемые ID geoevent-потребителей. Этот статический ID группы потребителей является общим для всех экземпляров коннекторов Kafka, когда ID группы потребителей не указан. Рекомендуется указывать пользовательский ID группы потребителей. См. Введение в Apache Kafka для получения дополнительной информации о группах потребителей. Этот параметр показывается, когда для свойства Заменить пользовательскими свойствами Kafka задано Нет. |
Зарегистрированная папка для файла свойств Kafka (Условия) | Папка, зарегистрированная на GeoEvent Server, содержащая файл Kafka .properties. Файл Kafka .properties определяет пользовательские свойства Kafka, когда для параметра Заменить пользовательскими свойствами Kafka установлено Да. Убедитесь, что папка, зарегистрированная на GeoEvent Server, является полным путем к местоположению файла Kafka.properties. Этот параметр показывается, когда для свойства Заменить пользовательскими свойствами Kafka задано Да. |
Имя файла свойств Kafka (Условия) | Имя файла Kafka .properties, содержащего пользовательские свойства Kafka для конфигурации клиента. Укажите имя файла без расширения .properties.
Этот параметр показывается, когда для свойства Заменить пользовательскими свойствами Kafka задано Да. |
Начать с начала | Указывает, будут ли записи взяты из раздела, начинающегося с начального смещения, или из последнего смещения, зафиксированного для потребителя. По умолчанию – Да.
Примечание:Дополнительные сведения о смещениях см. в разделе Настройка Apache Kafka. |
Разделитель событий | Один буквенный символ, который указывает на конец записи данных событий. Значения Unicode могут применяться для указания разделителя символов. Не заключайте символ в кавычки. Перенос строки (\n) - это наиболее типичный разделитель конца записи. |
Разделитель полей | Один буквенный символ, используемый для отделения одного значения атрибута от другого в сообщении. Значения Unicode могут применяться для указания разделителя символов. Не заключайте символ в кавычки. Обычно разделителем атрибутов является запятая. |
Создать определение GeoEvent | Указывает, используется ли новое или существующее определение GeoEvent для данных входящих событий. Определение GeoEvent требуется GeoEvent Server, чтобы понимать поля атрибутов и типы данных входящих событий.
|
Имя определения GeoEvent (новое) (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, используется существующее определение GeoEvent. Первая полученная запись данных используется для определения ожидаемой схемы последующих записей данных, на основе которой создается новое определение GeoEvent. Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если задано значение Нет. |
|
Имя определения GeoEvent (существующее) (Условия) | Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent. Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если задано значение Да. |
Построить геометрию из полей | Указывает, будет ли входной коннектор создавать геометрию точки, используя значения координат, полученные в качестве атрибутов. По умолчанию Нет.
|
Поле геометрии X (Условия) | Поле атрибута в данных входящего события, содержащее координатную часть X (например, горизонталь или долготу) местоположения точки. Этот параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если задано значение Нет. |
Поле геометрии Y (Условия) | Поле атрибута в данных входящего события, содержащее координатную часть Y (например, вертикаль или широту) местоположения точки. Этот параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если задано значение Нет. |
Поле геометрии Z (Условия) | Поле атрибута в данных входящего события, содержащего координатную часть Z (например, глубина или высота) местоположения точки. Если значение не предоставлено, значение z опускается и строится 2D геометрия точки. Этот параметр показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если задано значение Нет. |
Пространственная привязка по умолчанию | Известный идентификатор (WKID) пространственной привязки, используемый при построении геометрии из значений полей атрибутов, координаты которых не являются значениями широты и долготы для предполагаемой географической системы координат WGS84, или когда получены строки геометрии, не содержащие пространственной привязки. Также может быть указано известное текстовое значение (WKT) или имя поля атрибута, содержащего WKID или WKT. |
Ожидаемый формат данных | Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты/времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat. Хотя предпочтительным шаблоном для значений даты/времени в GeoEvent Server является стандарт ISO 8601, несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания значения Ожидаемого формата даты. К ним относятся:
Если полученные значения даты/времени используют соглашение, отличное от перечисленных выше, необходимо указать ожидаемый шаблон формата даты, чтобы GeoEvent Server мог адаптировать значения даты/времени. |
Язык форматирования чисел | Идентификатор локали (ID), используемый для чувствительного к локали поведения при форматировании чисел из значений данных. По умолчанию используется локаль компьютера, на котором установлен GeoEvent Server. Дополнительные сведения см. в разделе Поддерживаемые локали Java. |
Необходима аутентификация | Указывает, требуется ли аутентификация для подключения к кластеру Kafka или брокеру Kafka. По умолчанию Нет.
|
Аутентификация с использованием (Условия) | Указывает протокол безопасности, используемый для защиты кластера Kafka. Варианты протоколов безопасности: TLS 1.2 и SASL.
Примечание:Используя Kerberos, убедитесь, что у учетной записи операционной системы, от имени которой запущен ArcGIS GeoEvent Server, есть права на чтение файла keytab в настройке и конфигурации Kerberos. Этот параметр показывается, когда для свойства Требуется аутентификация задано Да. |
Зарегистрированная папка для файла учетных данных (Условия) | Папка, зарегистрированная в GeoEvent Server, которая содержит файл PKI кластера Kafka (сертификат x509). Убедитесь, что папка, зарегистрированная на GeoEvent Server, является полным путем к местоположению сертификата кластера Kafka. Этот параметр показывается, когда для свойства Требуется аутентификация задано Да. Это применимо только к протоколу TLS 1.2. |
Файл конфигурации учетных данных (Условия) | Имя файла PKI кластера Kafka (сертификат x509). Сертификат и связанный с ним ключ должны храниться в формате PKCS#12, который представлен файлом с расширением .p12 или .pfx. Укажите имя файла в дополнении к расширению. Примечание:Для этого параметра поддерживаются только имя файла сертификата и расширение. Не указывайте относительные пути к сертификату для этого параметра. Зарегистрируйте полный путь к файлу сертификата с помощью параметра Зарегистрированная папка для файла учетных данных. Этот параметр показывается, когда для свойства Требуется аутентификация задано Да. Это применимо только к протоколу TLS 1.2. |
Пароль Keystore (Условия) | Пароль для файлв PKI кластера Kafka (сертификат x509). Он также известен как личный ключ сертификата. Этот параметр показывается, когда для свойства Требуется аутентификация задано Да. Параметр применим только к протоколу TLS 1.2 |
Тип аутентификации SASL (Условия) | Определяет тип механизма аутентификации SASL, поддерживаемого кластером Kafka. Опции типа аутентификации SASL: SASL GSSAPI (Kerberos) и SASL PLAIN.
Этот параметр показывается, когда для свойства Требуется аутентификация задано Да. Это применимо только к протоколу SASL. |
Участник Kerberos (Условия) | Участник Kerberos для определенного пользователя, например, GeoEventKafkaClient1@example.com. Этот параметр показывается, когда для свойства Требуется аутентификация задано Да. Параметр применим только к протоколу SASL/GSSAPI (Kerberos). |
Использовать Key Tab (Условия) | Указывает, используется ли key tab в настройках Kerberos. По умолчанию – Да.
Этот параметр показывается, когда для свойства Требуется аутентификация задано Да. Это применимо только к протоколу SASL/GSSAPI (Kerberos). |
Хранить ключ (Условия) | Указывает, хранится ли ключ в настройках Kerberos. По умолчанию – Да.
Этот параметр показывается, когда для свойства Требуется аутентификация задано Да. Это применимо только к протоколу SASL/GSSAPI (Kerberos). |
Имя пользователя (Условия) | Имя пользователя, используемое для аутентификации в кластере Kafka. Он также известен как строка подключения с определенными провайдерами облачных ресурсов. Обратитесь к документации выбранного провайдера облачных услуг для получения правильного синтаксиса. Этот параметр показывается, когда для свойства Требуется аутентификация задано Да. Это применимо только к протоколу SASL/PLAIN. |
Пароль (Условия) | Пароль, используемый для аутентификации в кластере Kafka. Обратитесь к документации выбранного провайдера облачных услуг для получения правильного синтаксиса. Этот параметр показывается, когда для свойства Требуется аутентификация задано Да. Этот параметр применим только к протоколу SASL/PLAIN. |
Советы и ограничения
При использовании входного коннектора Подписаться на Kafka Topic для текста имейте в виду следующее:
- Неправильные работа и оптимизация потребителей приведут к тому, что в некоторых случаях входной коннектор Подписаться на Kafka Topic для текста не получит никаких данных. Количество потребителей в группе ограничено количеством разделов Kafka Topic. Если число потребителей в группе превышает количество разделов, доступных на Kafka Topic, избыточные потребители не будут потреблять данные. Чтобы этого не допустить, рассмотрите возможность оптимизации числа потребителей для лучшего соответствия числу разделов в Kafka Topic, или добавления разных групп потребителей для каждого коннектора. Для получения подробной информации о потребителях и группах потребителей обратитесь к Документации Kafka.
- Входной коннектор Подписаться на Kafka Topic для текста — клиент-потребитель Kafka. Такие же соображения могут быть применены к этому входному коннектору и потребуются для любого другого клиента-потребителя Kafka. Например, если этот входной коннектор не получает никаких данных из Kafka Topic, а является отдельным клиентом Kafka, учитывайте факторы, связанные с наличием двух клиентов-потребителей. Это касается, в том числе, указанного ID группы потребителей, количества разделов, доступных для Topic, и числа существующих потребителей. Или же, если входной коннектор остановлен и запущен в быстрой последовательности, учитывайте последствия для Kafka с точки зрения потребителя. Перебалансировка разделов Kafka Topic может помешать немедленному воссоединению входного коннектора в качестве потребителя в той же группе.