トピックエイリアス

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：5分

    • トピックエイリアスを使用して、 ストリームコネクト でのトピック管理を簡素化します。トピックエイリアスは、基礎となる任意の Hermes またはダイレクト Kafka トピックに接続できる一意のトピック名です。トピックエイリアスは、異なるインスタンスに移動し、各インスタンスの異なる基礎となるトピックに接続することができます。

    トピックエイリアスの例

    この例は、Direct Kafka トピックに接続されているトピックエイリアスのフォームを示しています。

    トピックエイリアスレコードのスクリーンショット。

    トピックエイリアスの正式名称は Incoming-Messages [Global] です。トピックエイリアスには修飾名があります。これは、指定された名前 (この場合は Incoming-Messages) とそれに続くアプリケーションスコープの組み合わせです。エイリアスが異なるアプリケーションスコープ内にある場合、同じ名前のトピックエイリアスが複数存在する可能性があります。

    [関連リンク] セクションには、トピックを接続または切断するためのリンクがあります。トピックエイリアスが既にトピックに接続されている場合は、接続を切断するためのリンクが表示されます。この例では、トピックエイリアスは既にトピックに接続されているため、リンクは [ 直接 Kafka トピックを切断 (Disconnect Direct Kafka Topic)] です。トピックエイリアスがまだトピックに接続されていない場合、リンクには [ 直接 Kafka トピックを接続 (Connect Direct Kafka Topic)] と表示されます。

    ここに表示されるリンクは、インストールされているプラグインによっても決まります。
    • ServiceNow ストリームコネクト Installer (Direct Kafka) (com.glide.hub.stream_connect.onprem_installer) プラグインがインストールされている場合、Direct Kafka トピックを接続または切断するためのリンクが表示されます。
    • ServiceNow ストリームコネクト Hermes (com.glide.hub.stream_connect.hermes) プラグインがインストールされている場合、Hermesトピックを接続または切断するためのリンクが表示されます。
    • 両方のプラグインがインストールされている場合、 Hermes トピックとダイレクト Kafka トピックの両方のリンクが表示されます。
    ストリームコネクト プラグインのリストについては、「統合ハブ プラグイン」を参照してください。
    [関連リンク] の下には、[トピック]、[Kafka サブスクリプション]、および [Kafka プロデューサー] のタブがあります。
    • [ Hermes トピック] タブには、接続されている Hermes トピックが表示されます。このタブは、 ServiceNow でホストされている Hermes サービスにアクセスできるホストインスタンスでのみ表示されます。
    • [ダイレクト Kafka トピック] タブには、接続されているダイレクト Kafka トピックが表示されます。通常、このタブは、 ServiceNow ストリームコネクト Direct Kafka (com.glide.hub.stream_connect.direct_kafka) プラグインがインストールされているオンプレミスインスタンスに対してのみ表示されます。
    • [Kafka サブスクリプション] タブには、関連するサブスクリプションと関連する統計情報が表示されます。サブスクリプション統計の詳細については、「 Kafka サブスクリプションと統計情報の表示」を参照してください。
    • [Kafka プロデューサー] タブには、関連するプロデューサーとその関連統計情報が表示されます。プロデューサー統計情報の説明については、「 プロデューサー統計情報の表示」を参照してください。

    トピックおよびトピックエイリアステーブル

    トピックエイリアスは、トピックエイリアス [sys_sc_topic_alias] テーブルで確認できます。特定の ServiceNow 製品オファリングでは、削除または変更できない内部トピックエイリアスが作成される場合があります。

    直接 Kafka トピックは、直接 Kafka トピック [sys_kafka_direct_topic] テーブルにあります。 Hermes トピックは Kafka トピック [sys_kafka_topic] テーブルにあります。

    トピックエイリアスの作成と接続

    トピックエイリアスを作成し、基礎となる Hermes または Direct Kafka トピックに接続します。

    始める前に

    必要なロール:stream_connect_admin

    手順

    1. 移動先 すべて > 統合ハブ > ストリームコネクト > トピックエイリアス をクリックし、[ 新規] を選択します。
    2. 名前を入力し、[ 送信] を選択します。
    3. [トピックエイリアス] リストから、作成したトピックエイリアスを選択します。
    4. [関連リンク] で、[ Direct Kafka トピックを接続 (Connect Direct Kafka Topic )] または [ Hermes トピックを接続 (Connect Hermes Topic)] を選択します。

      [関連リンク] セクションのリンクは、インストールされているプラグインによって決まります。ServiceNow ストリームコネクト Installer (Direct Kafka) (com.glide.hub.stream_connect.onprem_installer) プラグインがインストールされている場合は、[Connect Direct Kafka トピック] リンクが表示されます。ServiceNow ストリームコネクト Hermes (com.glide.hub.stream_connect.hermes) プラグインがインストールされている場合は、[Hermes トピックを接続] リンクが表示されます。両方のプラグインがインストールされている場合は、両方のリンクが表示されます。

      リンクを選択すると、[直接 Kafka トピックを接続 (Connect Direct Kafka Topic)] または [ Hermes トピックを接続 (Connect Topic)] というダイアログボックスが表示されます。

    5. 虫眼鏡アイコンを使用してトピックのリストを開き、トピックエイリアスに接続するトピックを選択してから、[ OK] を選択します。
      注:
      トピックエイリアスにまだ接続されていないトピックのみがトピックのリストに表示されます。

    タスクの結果

    トピックエイリアスがトピックに接続されると、トピック名が適切なタブに表示されます。 Hermes トピックが [ Hermes トピック] タブに表示され、ダイレクト Kafka トピックが [ダイレクト Kafka トピック] タブに表示されます。

    [関連リンク] の下で、関連付けられているリンクが [接続] から [切断] に変わります。たとえば、 Connect Hermes トピック が [ 切断] Hermes トピックに変わります。切断リンクを使用して、基礎となるトピックからトピックエイリアスを切断できます。
    注:
    トピックエイリアスを切断すると、アクティブなコンシューマーまたはプロデューサーに影響を与える可能性があります。