Erstellt ein eigenständiges Schema in Stream Connect

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 1 Minute Lesedauer

    • Erstellen Sie ein Schema, damit Ihre Stream Connect-Ersteller und -Verbraucher Kafka-Nachrichten im AVRO-Format Apache senden und empfangen können.

    Vorbereitungen

    • Erforderliche Rolle: kafka_admin
    • Diese Funktion ist Teil der Schemaverwaltung in Stream Connect. Weitere Informationen finden Sie unter Schemaverwaltung in Stream Connect.
    • Das Plugin ServiceNow Stream Connect-Installationsprogramm [com.glide.hub.stream_connect.installer] ist erforderlich.

    Warum und wann dieser Vorgang ausgeführt wird

    Stream Connect verwendet Schemas, um Nachrichten von Nur-Text in ein AVRO-Format und zurück zu konvertieren. Die Verwendung eines AVRO-Formats kann die Größe der Nutzlast reduzieren und die Integration in Ihre lokale Kafka-Instanz vereinfachen.

    In diesem Dokument erfahren Sie, wie Sie ein eigenes eigenständiges Schema erstellen, indem Sie eine JSON-Datei hochladen oder ein Schema direkt als JSON-formatierte Zeichenfolge eingeben. Sie können auch Importieren Sie ein Schema aus der Confluent-Registrierung.

    Prozedur

    1. Navigieren zu Alle > IntegrationHub > Schemaverwaltung > Eigenständiges Schema erstellen.

      Im Formular zum Erstellen eines AVRO-Schemas wird der Wert der Schema-ID automatisch ausgefüllt. Sie können den vorgeschlagenen Wert beibehalten oder ändern.

      Alle Schemas haben eine Schema-ID, einen global eindeutigen Bezeichner des Schemas. Bei eigenständigen Schemas wird die Schema-ID lokal generiert und ist für die Instanz eindeutig. Standardmäßig ist der generierte Schema-ID-Wert die nächsthöhere verfügbare Schema-ID in der Instanz. Wenn Ihre Schemas beispielsweise die ID-Nummern eins bis fünf haben, hat das nächste von Ihnen erstellte Schema eine Schema-ID von sechs. Schema-IDs sind pro Registrierung eindeutig. Beispielsweise können zwei Schemas die ID 1 haben, solange sie sich in unterschiedlichen Registrierungen befinden.

    2. Wählen Sie im Feld Quelle eine der folgenden Optionen aus.
      Option Beschreibung
      Datei Wählen Sie eine JSON-Datei aus, um das Schema zu importieren. Nach dem Import wird der Inhalt der Datei im JSON- Schemafeld angezeigt.
      AVRO-formatierte Zeichenfolge (JSON) Geben Sie ein Schema im JSON-Zeichenfolgenformat ein.
    3. Wählen Sie Absenden.
      Im Formular „Eigenständiges Stream-Verbindungsschema“ enthält das Feld Schema das JSON-formatierte Schema, das Sie hochgeladen oder eingegeben haben.

    Ergebnisse

    Ihr Schema ist in der Tabelle „Eigenständiges Stream-Verbindungsschema“ [standalone_stream_connect_schema] und in der Tabelle „Stream Connect-Schemas“ [stream_connect_schema] sichtbar.

    Nächste Maßnahme

    Verwenden Sie Stream Connect-Ersteller und -Verbraucher, um Nachrichten im AVRO-Format zu senden und zu empfangen.