Informatica Enterprise Data Catalog で RabbitMQ のデータ を追加

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CData JDBC Driver for RabbitMQ を Informatica Enterprise Data Catalog で使用し、データを分類・整理します。

Informatica は、データの転送と変換を行うための強力で洗練された手段を提供します。CData JDBC Driver for RabbitMQ を使用すると、業界標準に準拠したドライバーを通じて Informatica Enterprise Data Catalog とシームレスに連携できます。このチュートリアルでは、あらゆる環境で RabbitMQ データを分類・整理する方法を説明します。

JDBC ドライバーのロード

JDBC ドライバーをロードするには:

  1. Informatica が動作しているホストに JDBC ドライバーをインストールします。この記事では、ドライバーが cdata.jdbc.api.APIDriver にインストールされていることを前提としています。
  2. $ java -jar setup.jar
    
  3. JDBC インストールディレクトリに移動し、ドライバーとそのライセンスファイルを含む genericJDBC.zip という名前の zip ファイルを作成します。
  4. $ cd ~/cdata-jdbc-driver-for-api/lib
    $ zip genericJDBC.zip cdata.jdbc.api.jar cdata.jdbc.api.lic
    
  5. genericJDBC.zip ファイルを Informatica 内の Catalog Service ディレクトリに移動します。この記事では、Informatica が /opt/informatica にインストールされていることを前提としています。このフォルダでの作業には、おそらく root 権限が必要です。続行する前に、su または sudo で root に切り替えてください。
  6. # mv genericJDBC.zip /opt/informatica/services/CatalogService/ScannerBinaries
    
  7. zip ファイルを展開するために、カスタムデプロイメント設定を編集します。
  8. # cd /opt/informatica/services/CatalogService/ScannerBinaries/CustomDeployer/
    # nano scannerDeployer.xml
    

    既存の ExecutionContextProperty ノードを展開した後、以下の内容で新しい ExecutionContextProperty ノードを追加します。

    
    <ExecutionContextProperty
        isLocationProperty="true"
        dependencyToUnpack="genericJDBC.zip">
    <PropertyName>JDBCScanner_DriverLocation</PropertyName>
    <PropertyValue>scanner_miti/genericJDBC/Drivers</PropertyValue>
    </ExecutionContextProperty>
    
  9. Admin コンソールから Catalog Service をリフレッシュします。

JDBC リソースの設定

JDBC リソースを設定するには:

  1. Catalog 管理画面を開き、以下のプロパティで新しい JDBC リソースを追加します:
    • Driver Class: cdata.jdbc.api.APIDriver
    • URL: jdbc.api:Profile=C:\profiles\\RabbitMQ.apip;AuthScheme=Basic;URL=http://localhost:15672;User=guest;Password=guest;
    • RabbitMQ Management HTTP API について

      RabbitMQ は、複数のメッセージングプロトコルをサポートするオープンソースのメッセージブローカーです。RabbitMQ Management HTTP API は、RabbitMQ サーバーの管理データと監視データに HTTP 経由でアクセスする手段を提供します。この API では、仮想ホスト、エクスチェンジ、キュー、バインディング、コネクション、チャネル、コンシューマー、ユーザー、権限、ポリシー、クラスター全体の統計情報を取得できます。

      HTTP API を利用するには、RabbitMQ サーバーで Management プラグインを有効化する必要があります。デフォルトでは、管理インターフェースはポート 15672 でリッスンします。

      Basic 認証の設定

      RabbitMQ Management HTTP API は HTTP Basic 認証を使用します。RabbitMQ 管理ユーザーのユーザー名とパスワードを指定する必要があります。

      管理 API へのアクセスを有効にするには、以下のステップで進めます:

      1. サーバーで RabbitMQ Management プラグインが有効になっていることを確認します(rabbitmq-plugins enable rabbitmq_management)。
      2. 既存の管理ユーザーを使用するか、適切な管理タグ(management、policymaker、monitoring、または administrator)を持つユーザーを作成します。
      3. RabbitMQ Management HTTP API の完全なベース URL を控えておきます(例:http://localhost:15672)。

      RabbitMQ サーバーを設定したら、以下の接続プロパティを設定して接続します:

      • AuthScheme:Basic に設定します。
      • URL:RabbitMQ Management HTTP API のベース URL に設定します(例:http://localhost:15672)。
      • User:RabbitMQ の管理ユーザー名に設定します(例:guest)。
      • Password:RabbitMQ の管理パスワードに設定します。

      接続文字列の例:

      Profile=C:\profiles\RabbitMQ.apip;AuthScheme=Basic;URL=http://localhost:15672;User=guest;Password=guest;
      

      利用可能なテーブル

      RabbitMQ プロファイルでは、以下のテーブルにアクセスできます:

      • Overview - クラスター全体の統計情報と RabbitMQ ノードに関する情報
      • Nodes - RabbitMQ クラスター内の個々のノードに関する情報
      • NodeMemory - 特定のクラスターノードの詳細なメモリ使用状況の内訳
      • Connections - ブローカーへのすべてのオープンな AMQP コネクションの一覧
      • Channels - すべてのコネクションにわたるオープンな AMQP チャネルの一覧
      • Consumers - すべてのキューに登録されたコンシューマーの一覧
      • Exchanges - すべての仮想ホストで宣言されたエクスチェンジの一覧
      • Queues - すべての仮想ホストで宣言されたキューの一覧
      • Bindings - エクスチェンジとキュー間のすべてのバインディングの一覧
      • VirtualHosts - ブローカーに設定された仮想ホストの一覧
      • VhostPermissions - 特定の仮想ホスト内のユーザー権限
      • Users - すべての RabbitMQ ユーザーの一覧
      • Permissions - すべての仮想ホストにわたる全ユーザーの権限レコード
      • TopicPermissions - 全ユーザーのトピックレベルの権限レコード
      • Policies - 仮想ホスト内のキューおよびエクスチェンジに適用されたポリシーの一覧
      • OperatorPolicies - 仮想ホスト内のキューに適用されたオペレーターポリシーの一覧
      • Parameters - 仮想ホストごとのコンポーネントパラメータ(例:federation、shovel)の一覧
      • GlobalParameters - すべての仮想ホストに適用されるグローバルパラメータの一覧
      • VhostLimits - 特定の仮想ホストに設定されたリソース制限
      • UserLimits - 特定のユーザーに設定されたリソース制限
      • FeatureFlags - フィーチャーフラグの一覧と、ノード上での有効/無効の状態
      • DeprecatedFeatures - 非推奨機能の一覧と、その使用状態
      • AuthAttempts - ノードの認証試行統計
      • ClusterName - RabbitMQ クラスターの名前
      • WhoAmI - 現在認証されている管理ユーザーに関する情報
      • ExchangeBindingsSource - 特定のエクスチェンジがソースとなっているバインディング
      • ExchangeBindingsDestination - 特定のエクスチェンジが宛先となっているバインディング
      • QueueBindings - 仮想ホスト内の特定のキューのバインディング

      組み込みの接続文字列デザイナー

      JDBC URL の構築については、RabbitMQ JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。.jar ファイルをダブルクリックするか、コマンドラインから .jar ファイルを実行します。

      java -jar cdata.jdbc.api.jar
      

      接続プロパティを入力し、接続文字列をクリップボードにコピーします。

      JDBC URL を設定する際に、Max Rows 接続プロパティも設定することをお勧めします。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時にパフォーマンスを向上させることができます。

    一般的な追加の接続文字列プロパティは以下のとおりです:

    JDBC;MSTR_JDBC_JAR_FOLDER=PATH\TO\JAR\;DRIVER=cdata.jdbc.api.APIDriver;URL={jdbc:api:Profile=C:\profiles\\RabbitMQ.apip;AuthScheme=Basic;URL=http://localhost:15672;User=guest;Password=guest;};
    
  2. Username: user
  3. Password: password
  4. Username と Password プロパティは、使用するドライバーが必要としない場合でも必須です。その場合は、代わりにプレースホルダー値を入力してください。

  5. 少なくとも1つのソースメタデータスキャンを実行するために、メタデータオプションを設定します。このスキャンでは、ドライバーを使用してサービス経由で利用可能なテーブル、ビュー、ストアドプロシージャを特定します。
    • Source Metadata: このオプションを有効にします。
    • Catalog: マルチカタログのデータソースの場合は、適切なカタログに設定します。それ以外の場合は、CData に設定します。
    • Schema: マルチスキーマのデータソースの場合は、適切なスキーマに設定します。それ以外の場合は、サービス名(例:Couchbase)に設定します。
    • Case-sensitivity: 通常、このオプションは無効にしてください。大文字と小文字を区別するデータソースの場合のみ有効にします。
    • Import stored procedures: テーブルやビューに加えてストアドプロシージャの定義もインポートしたい場合は、これを有効にします。

    必要に応じて、他のメタデータスキャナーも有効にできます。

  6. ドライバーの設定を完了し、オプションでカスタム属性とスキャナースケジュールを設定します。
  7. Monitoring タブに移動し、Run をクリックしてメタデータスキャンを実行します。データソースによっては、数分かかる場合があります。

スキャンが完了すると、すべてのメタデータオブジェクトの概要と Metadata Load ジョブのステータスが表示されます。エラーが発生した場合は、ジョブの Log Location リンクを開いて、Informatica またはドライバーが報告したエラーを確認できます。

検出されたメタデータの確認

Catalog Service ブラウザを開いて、データソースから抽出されたメタデータを表示します。メタデータスキャナーの設定時に選択したオプションに応じて、定義したリソースのテーブル、ビュー、ストアドプロシージャの任意の組み合わせが表示されます。

はじめる準備はできましたか?

API Driver で RabbitMQ のライブデータに接続

RabbitMQ に接続