Data Engineering Administrator Guide > Connections Reference > Kafka Connection Properties
  

Kafka Connection Properties

The Kafka connection is a messaging connection. Use the Kafka connection to access Kafka as a message target. You can create and manage a Kafka connection in the Developer tool or through infacmd.
The following table describes the general connection properties for the Kafka connection:
Property
Description
Name
The name of the connection. The name is not case sensitive and must be unique within the domain. You can change this property after you create the connection. The name cannot exceed 128 characters, contain spaces, or contain the following special characters:
~ ` ! $ % ^ & * ( ) - + = { [ } ] | \ : ; " ' < , > . ? /
ID
The string that the Data Integration Service uses to identify the connection. The ID is not case sensitive. It must be 255 characters or less and must be unique in the domain. You cannot change this property after you create the connection. Default value is the connection name.
Description
The description of the connection. Enter a string that you can use to identify the connection. The description cannot exceed 4,000 characters.
Location
The domain where you want to create the connection.
Type
The connection type.
The following table describes the Kafka broker properties for the Kafka connection:
Property
Description
Kafka Broker List
Comma-separated list of Kafka brokers which maintains the configuration of the Kafka messaging broker.
To specify a Kafka broker, use the following format:
<IP Address>:<port>
ZooKeeper Host Port List
Optional. Comma-separated list of Apache ZooKeeper which maintains the configuration of the Kafka messaging broker.
To specify the ZooKeeper, use the following format:
<IP Address>:<port>
Retry Timeout
Number of seconds the Integration Service attempts to reconnect to the Kafka broker to write data. If the source or target is not available for the time you specify, the mapping execution stops to avoid any data loss.
Kafka Broker Version
Configure the Kafka messaging broker version to 0.10.1.x-2.0.0.

Allgemeine Eigenschaften

In der folgenden Tabelle werden die allgemeinen Verbindungseigenschaften für die Kafka-Verbindung beschrieben:
Eigenschaft
Beschreibung
Name
Der Name der Verbindung. Der Name unterliegt nicht der Groß-/Kleinschreibung und muss innerhalb der Domäne eindeutig sein. Sie können diese Eigenschaft nach dem Erstellen der Verbindung ändern. Der Name darf nicht mehr als 128 Zeichen und weder Leerzeichen noch die folgenden Sonderzeichen enthalten:
~ ` ! $ % ^ & * ( ) - + = { [ } ] | \ : ; " ' < , > . ? /
ID
Die Zeichenfolge, die der Datenintegrationsdienst zum Erkennen der Verbindung verwendet. Bei der ID wird die Groß- und Kleinschreibung nicht beachtet. Sie darf maximal 255 Zeichen umfassen und muss in der Domäne eindeutig sein. Sie können diese Eigenschaft nach dem Erstellen der Verbindung nicht mehr ändern. Als Standardwert dient der Verbindungsname.
Beschreibung
Die Beschreibung der Verbindung. Geben Sie eine Zeichenfolge ein, mit der Sie die Verbindung angeben können. Die Beschreibung darf nicht mehr als 4.000 Zeichen enthalten.
Speicherort
Die Domäne, in der Sie die Verbindung erstellen möchten. Wählen Sie den Domänennamen aus.
Typ
Der Verbindungstyp. Wählen Sie Messaging/Kafka.

Eigenschaften des Kafka-Brokers

In der folgenden Tabelle werden die Kafka-Broker-Eigenschaften für die Kafka-Verbindung beschrieben:
Eigenschaft
Beschreibung
Liste der Kafka-Broker
Durch Kommas getrennte Liste der Kafka-Broker, die die Konfiguration des Kafka-Messaging-Brokers beibehalten.
Verwenden Sie das folgende Format, um einen Kafka-Broker anzugeben:
<IP-Adresse>:<Port>
Timeout der Wiederholungen
Anzahl der Sekunden, nach denen der Integrationsdienst versucht, erneut eine Verbindung zum Kafka-Broker herzustellen, um Daten zu lesen oder zu schreiben. Ist die Quelle oder das Ziel für den angegebenen Zeitraum nicht verfügbar, wird die Zuordnungsausführung zur Vermeidung von Datenverlusten angehalten.
Kafka-Broker-Version
Konfigurieren Sie die Kafka Messaging Broker-Version auf Apache 0.10.1.1 und höher.
Zusätzliche Verbindungseigenschaften
Optional. Durch Kommas getrennte Liste der Verbindungseigenschaften, um eine Verbindung zum Kafka-Broker herzustellen.
Sie können beispielsweise folgende Syntax verwenden:
request.timeout.ms=<value>,session.timeout.ms=<value>,
fetch.max.wait.ms=<value>,heartbeat.interval.ms=<value>,
security.protocol=SASL_PLAINTEXT,sasl.kerberos.
service.name=<kerberos name>,sasl.mechanism=GSSAPI,
sasl.jaas.config=com.sun.security.auth.module.
Krb5Login Modulerequired useKeyTab=true
doNotPrompt=true storeKey=true client=true
keyTab="<Keytab Location>" principal="<principal>";
Um die Zeit für den Verbindungsaufbau mit dem Kafka-Broker zu reduzieren, stellen Sie sicher, dass Sie die folgenden Eigenschaften festgelegt haben:
  • - request.timeout.ms
  • - session.timeout.ms
  • - fetch.max.wait.ms
  • - heartbeat.interval.ms
Um eine sichere Verbindung zum Kafka-Broker herzustellen, stellen Sie sicher, dass Sie einen der folgenden Werte für die Eigenschaft security.protocol festlegen:
  • - SASL_SSL
  • - SSL
Der Standardwert der Eigenschaft security.protocol ist SASL_PLAINTEXT.
Die zusätzlichen Verbindungseigenschaften stehen für die technische Vorschau zur Verfügung. Funktionen für die technische Vorschau sind noch nicht produktionsreif und werden daher zwar unterstützt, aber nicht garantiert. Informatica empfiehlt, dass Sie sie nur in Nicht-Produktionsumgebungen verwenden.
Weitere Informationen über die Verbindungseigenschaften finden Sie unter https://kafka.apache.org/documentation/.

SSL-Eigenschaften

In der folgenden Tabelle werden die SSL-Eigenschaften für die Kafka-Verbindung beschrieben:
Eigenschaft
Beschreibung
SSL-Modus
Erforderlich. SSL-Modus, der den für die Verbindung zu verwendenden Verschlüsselungstyp angibt.
Sie können einen Modus aus den folgenden SSL-Modi auswählen:
  • - Deaktiviert
  • - Unidirektional
  • - Bidirektional
SSL-TrustStore-Dateipfad
Erforderlich, wenn der SSL-Modus Unidirektional ausgewählt ist.
Absoluter Pfad und Dateiname der SSL-Truststore-Datei, die Zertifikate des vertrauenswürdigen SSL-Servers enthält.
SSL-Truststore-Passwort
Erforderlich, wenn der SSL-Modus Unidirektional ausgewählt ist.
Passwort für den SSL-Truststore.
SSL-KeyStore-Dateipfad
Erforderlich, wenn der SSL-Modus Bidirektional ausgewählt ist.
Absoluter Pfad und Dateiname der SSL-Schlüsselspeicherdatei, die private Schlüssel und Zertifikate für den SSL-Server enthält.
SSL-Schlüsselspeicherpasswort
Erforderlich, wenn der SSL-Modus Bidirektional ausgewählt ist.
Passwort für den SSL-Schlüsselspeicher.

Erstellen einer Kafka-Verbindung mit infacmd

Sie können das infacmd-Befehlszeilenprogramm verwenden, um eine Kafka-Verbindung zu erstellen.
Führen Sie den folgenden Befehl aus, um eine Kafka-Verbindung unter UNIX zu erstellen:
sh infacmd.sh createConnection -dn <domain name> -un <domain user> -pd <domain password> -cn <connection name> -cid <connection id> -ct Kafka -o kfkBrkList=<host1:port1>,<host2:port2>,<host3:port3> kafkabrokerversion=<version> additionalConnectionProperties=<additional properties>
Weitere Informationen zu dem Befehl finden Sie in der Informatica-Befehlsreferenz.