Verwalten von Themen in Hermes

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

    • Verwalten Sie Themendatensätze in Ihrer Instanz und Kafka-Themen in HermesKafka-Cluster mit Hermes Messaging-Service.

    Themendatensätze

    Nachrichten werden in Kafka-Themen in organisiert und gespeichert HermesKafka-Cluster. Themendatensätze werden in der Tabelle „Kafka-Themen“ [sys_kafka_topic] in Ihrer Instanz gespeichert. Diese Tabelle zeigt eine Liste von Themendatensätzen mit einem Verweis auf den Namespace jedes Themas. Jeder Themendatensatz hat ein Feld für den Namen des Themas, den zugehörigen Namespace und die Angabe, ob das Thema aktiv ist.

    Werte in der Spalte Name der Tabelle „Kafka-Themen“ [sys_kakfa_topic] sind nicht von Natur aus eindeutig. Beispielsweise können Themendatensätze denselben Namenwert haben, wenn sie zu verschiedenen Namespaces gehören oder in verschiedenen Clustern vorhanden sind. Werte in der Spalte „vollständiger Name“ sind jedoch immer eindeutig.

    Eine geplante Aufgabe wird regelmäßig ausgeführt, um Themendatensätze mit den in gefundenen Themen zu synchronisieren Hermes. Dieser Auftrag führt die folgenden Funktionen aus:
    • Erstellt Themendatensätze für alle erkannten Themen und weist sie dem entsprechenden Namespace basierend auf dem Präfix für den Themennamen zu.
    • Synchronisiert Themen, die aus externen Quellen erstellt wurden, z. B. der Kafka-Befehlszeilenschnittstelle (CLI). Wenn beispielsweise ein Thema aus einer externen Quelle im nahen Cluster erstellt wird, wird der Auftrag ausgeführt und das Thema auch im entfernten Cluster erstellt.
    • Protokolliert eine Warnmeldung, wenn ein Thema keinem Namespace zugeordnet werden kann. Wenn ein Thema keinem Namespace zugeordnet werden kann, wird der Themendatensatz nicht erstellt. Es gibt einen standardmäßigen Namespace ohne Präfix, der als Standardnamespace bezeichnet wird und allen Themen entspricht. Ein Thema stimmt nur dann mit keinem Namespace überein, wenn der Standardnamespace gelöscht oder geändert wurde.
    • Markiert Themen als inaktiv, wenn kein Kafka-Thema für sie gefunden wurde.

    Sie können Themen in überwachen und anzeigen HermesKafka-Cluster mit dem Themeninspektor. Weitere Informationen finden Sie unter Überwachungsthemen in HermesKafka-Cluster.

    Kafka-Themen sind spezifisch für eine bestimmte Instanz. Dies bedeutet, dass Sie einen Themendatensatz nicht mit einem Update-Satz aus der Tabelle „kafka-Themen“ [sys_kafka_topic] zu einer anderen Instanz migrieren können. Stattdessen müssen Sie das Thema manuell in der Zielinstanz erstellen.

    Themen werden erstellt

    Sie können Themen in erstellen HermesKafka-Cluster mit einer der folgenden Methoden:
    • Erstellen Sie das Thema aus Ihrer Instanz. Dadurch wird ein Datensatz in der Tabelle „kafka-Themen“ [sys_kafka_topic] erstellt und ein Kafka-Thema in erstellt HermesKafka-Cluster. Weitere Informationen finden Sie unter Erstellen Sie ein Thema in Hermes.
    • Erstellen Sie das Thema extern. Erstellen Sie beispielsweise das Thema mithilfe der Kafka-Befehlszeilenschnittstelle (CLI).
      Hinweis:
      Um Synchronisierungsprobleme zwischen dem Cluster und Ihrer Instanz zu vermeiden, fügen Sie beim externen Erstellen von Themen die Anwendungs-ID hinzu. Beispiel: Ohne die Anwendungs-ID ein Thema, das aus der CLI mit einem Namen wie erstellt wurde snc.instancename.fulfillment.topicname Wird im Standard-Namespace anstelle von erstellt Erfüllung Namespace. Um sicherzustellen, dass das Thema in erstellt wird Erfüllung Namespace: Fügen Sie die Anwendungs-ID im Format in den Namen ein snc.instancename.fulfillment.app_id.topicname . Ersetzen App_ID Mit der Anwendungs-ID Ihrer Wahl.

    Wenn aus irgendeinem Grund kein Thema in erstellt werden kann HermesKafka-Cluster, wird auch nicht in der Tabelle „Kafka-Themen“ [sys_kafka_topic] erstellt.

    Themen werden aktualisiert

    Bei Bedarf können Sie die Anzahl der Partitionen in einem Thema ändern. Beachten Sie, dass Sie nur die Anzahl der Partitionen in einem Thema erhöhen können. Weitere Informationen finden Sie unter Aktualisieren Sie ein Thema in Hermes.

    Nach der Erstellung ist der Namespace, der einem Themendatensatz zugewiesen ist, dauerhaft. Wenn Sie einen Namespace-Datensatz erstellen und vorhandene Themen dorthin verschieben möchten, müssen Sie die Themen löschen und in neu erstellen HermesKafka-Cluster mit dem neuen Namespace-Präfix. Wenn die Themen nicht über die Instanz erstellt wurden, werden neue Themendatensätze erstellt und nach einem erneuten Scan dem übereinstimmenden Namespace-Datensatz zugewiesen.

    Themen werden gelöscht

    Sie können Themen aus löschen HermesKafka-Cluster mit einer der folgenden Methoden:
    • Löschen Sie das Thema direkt aus der Tabelle „Kafka-Themen“ [sys_kafka_topic] in Ihrer Instanz. Mit dieser Methode wird das Thema automatisch aus allen gelöscht HermesKafka-Cluster in einer Aktion. Siehe Löschen Sie ein Thema in Hermes
    • Löschen Sie das Thema extern. Löschen Sie beispielsweise das Thema mithilfe der Kafka-Befehlszeilenschnittstelle (CLI).
      Wichtig:
      Wenn Sie das Thema extern löschen, müssen Sie das Thema aus beiden löschen HermesCluster manuell, indem jeder Satz von Ports angegeben wird (410x und 420x). Löschen Sie nach Möglichkeit das Thema stattdessen über die Instanz.

    Sie können ein Thema nicht löschen, wenn es Abonnements in hat Stream Connect.

    Themen werden erneut gescannt

    Durch erneutes Scannen werden Themendatensätze für alle Themen in erstellt HermesKafka-Cluster, der noch nicht über entsprechende Themendatensätze verfügt. Beispiel: Wenn Sie Themen in erstellen HermesMit der CLI können Sie sofort erneut scannen, um entsprechende Themendatensätze in der Tabelle „Kafka-Themen“ [sys_kafka_topic] zu erstellen, anstatt auf die Erstellung durch die geplante Aufgabe zu warten.

    • Der erneute Scan erfolgt automatisch alle zehn Minuten.
    • Erstellte Themendatensätze werden vorhandenen Namespaces basierend auf Präfix-Übereinstimmungsregeln zugewiesen.
    Manchmal stimmen Themendatensätze in Ihrer Instanz nicht mit dem überein Hermes. Diese Situation kann in den folgenden Fällen auftreten:
    • Wenn ServiceNow IntegrationHubDas Plugin „Kafka-Verbraucher“ (com.Glide.Hub.kafka_Consumer) ist aktiviert, nachdem bereits Themen in vorhanden sind Hermes.
    • Wenn Themendatensätze versehentlich gelöscht werden.
    • Wenn Namespace-Definitionen geändert werden und Sie den neuen Namespaces vorhandene Themen zuweisen möchten.