TIBCO TDV メタデータアダプタのインストール
概要
このアダプタを使用して、メタデータエージェントを TIBCO® Data Virtualization (TDV) サーバーに接続し、収集機能を使用して管理対象データソースを EBX® メタデータ管理アプリケーションに送信します。
2 つの TDV アプリケーションパーツをインストールする必要があります。
-
TDV Sever - TDV のサーバー部分。システムからメタデータを収集するには、TDV サーバーのインストールが必須です。
-
TDV Studio - TDV のクライアント部分。データソースを作成し、TDV からローカルでパブリックビューにアクセスする場合にのみインストールする必要があります。
インストールの要件とプロセスについては、TDV に付属の『インストールガイド』を参照してください。
メタデータエージェントに必要な TDV バージョンは TDV 8.3 以降です。
EBX® メタデータ管理アプリケーションと組み合わせて使用できる機能の概要を以下に示します。
これらの機能に関するガイダンスについては、対応する TDV ドキュメントを使用することをお勧めします。
データソースの作成
EBX® メタデータ管理アプリケーションで既存のデータソースに関する情報を収集する場合は、まず TDV でコードを構成する必要があります。これは、TDV Studio の 新しいデータソース機能を使用して実行できます。
作成の最初のステップでは、新しいデータソースのコネクターを選択するように求められます。
コネクターを選択すると、このデータソースのラベルと、TDV がシステム上の物理データソースにアクセスするための接続の詳細を入力するよう求められます。
EBX® メタデータ管理アプリケーションが自動的に実行できるため、新しいデータソースでイントロスペクションを実行する必要はありません。ただし、接続をテストし、TDV がシステム上の物理データソースにアクセスできることを確認するため、 ではなく ボタンを使用してデータソースの作成を完了することをお勧めします。
データソースが TDV で正しく構成されると、メタデータエージェントに表示されるようになり、このソースのメタデータ収集を実行できるようになります。
公開データソースの表示
メタデータエージェントは、メタデータプロビジョニング機能を実行することで、資産とデータソースの公開ビューを作成できます。これにより、TDV Studio を使用してアクセスできる TDV のパブリックデータソースが作成されます。
パブリックデータソースは、TDV のすべてのユーザーが共有し、JDBC クエリを介して外部ソフトウェアに公開できるフォルダー Composite Data Services の下にある TDV で使用できます。メタデータエージェントは、メタデータプロビジョニングの起動時に定義されたラベルを使用して、パブリック データソースを Composite Data Services - Databases の下に作成します。
プロビジョニング対象として選択した資産に対応するデータソースとリソースは、このパブリックデータソースに集められ、そのメタデータは TDV Studio と、サードパーティソフトウェアがクエリできるシステムデータベースに表示されます。
一般的なエラーメッセージ
場合によっては、設定が誤っていたり互換性がなかったりして、エージェントと TDV 間のやり取りが失敗することがあります。以下は、TDV またはエージェント/EBX® メタデータ管理アプリケーション側で微調整することで解決できる一般的なエラーの一覧です。
エラーメッセージ/理由と解決策:データソースが上位関数をサポートしておらず、大文字と小文字の区別の設定が一致しないため、選択可能な EBX\_HG\_ACCOUNT.OP をプッシュできません。
このエラーメッセージは、特定のデータソースのデータのサンプリングまたはプロファイリング中に表示されることがあります。これを回避するには、TDV Studio - 管理 - 構成メニューに移動し、検索バーに match と入力します。 設定を探し、true に切り替えます。**についても同じ設定にすることをお勧めします。これらの変更を保存して適用し、問題を解決します。
TDV 接続権限
エージェントは、次の 2 つの接続フローを使用して TDV インスタンスに接続することを許可される必要があります。
-
プロパティ
ma.tdv.datasource.urlで定義された JDBC URL を使用した、TDV systcode データソースへの JDBC 接続。 -
プロパティ
ma.tdv.soap.resources-urlで定義された URL を使用した SOAP 接続。
エージェントを起動する前に、これらのタイプの接続が TDV インスタンスで許可されていることを確認してください。
必要に応じて、TIBCO® メタデータエージェントのインストール の接続暗号化の詳細を参照してください。
プロパティテンプレート
以下にサンプルテンプレートを示します。
######################################################
######################################################
##### #####
##### TDV Database #####
##### #####
######################################################
######################################################
ma.tdv.datasource.url=jdbc:compositesw:dbapi@[[TDV SERVER HOST]]:9401?domain=composite&dataSource=system
ma.tdv.datasource.username=[[TDV USER]]
ma.tdv.datasource.password=[[TDV PASSWORD / MAY BE ENCRYPTED]]
#####################################################
######################################################
##### #####
##### TDV SOAP #####
##### #####
######################################################
######################################################
#Base URL for TDV SOAP interfaces
ma.tdv.soap.base-url=http://[[TDV SERVER HOST]]:9400
ma.tdv.soap.username=[[TDV USER]]
ma.tdv.soap.password=[[TDV PASSWORD / MAY BE ENCRYPTED]]
#A root folder to get private data sources. This folder will be scanned as well as its subfolders
#You can indicate several root comma separated paths
ma.tdv.soap.datasources-root-folder=/shared/examples
#Folder in which Agent will create new private datasources from TCMD. It must exist in your TDV server.
ma.tdv.soap.new-datasources-folder=/shared/examples
#Additional SQL data types not supported for profiling feature
ma.tdv.profiling.not-supported-types=
#Additional SQL data types supported by profiling feature except for the cardinality analyses
ma.tdv.profiling.not-supported-types-for-cardinality=
プロパティの構成
TIBCO® TDV メタデータアダプタを使用して TIBCO® メタデータエージェントを起動する前に、プロパティファイルの情報を入力して TDV への接続を確認する必要があります。
以下の表には記載されていませんが、プロパティファイルに存在するプロパティを変更することはお勧めしません。構成ファイルに特定のプロパティのみを残すために、バージョン 4 より前のエージェントから古い特定のプロパティを削除することをお勧めします。
プロパティ名の説明
TDV データベース接続
TDV SOAP 接続
プライベートプロパティ (特定の場合にのみ上書きする必要があります)
| プロパティ名 | 説明 |
|---|---|
| TDV データベース接続 | |
ma.tdv.datasource.url |
エージェントを TDV の systcode データベースに接続するための複合データソース URL。想定される形式は jdbc:compositesw:dbapi@<host>:<port>?domain=composite&dataSource=systcode です。 |
ma.tdv.datasource.username |
システムデータソースに対する読み取り権限を持つ TDV ユーザー名。 |
ma.tdv.datasource.password |
対応するパスワード |
| TDV SOAP 接続 | |
ma.tdv.soap.base-url |
TDV SOAP 操作の URL。想定される形式は https://: です。 |
ma.tdv.soap.username |
SOAP 操作の読み取り/書き込み権限を持つ TDVユーザー名 |
ma.tdv.soap.password |
対応するパスワード |
ma.tdv.soap.datasources-root-folder |
プライベートデータソースを取得するためのルートフォルダー。このフォルダーとそのサブフォルダーがスキャンされます。複数のパスをカンマで区切って指定できます。 |
ma.tdv.soap.new-datasources-folder |
エージェントが EBX® メタデータ管理アプリケーションから新しいプライベートデータソースを作成するフォルダー。 |
ma.tdv.profiling.not-supported-types |
プロファイリング機能でサポートされていない SQL データ型のリスト。型は小文字のカンマ区切りでリストする必要があります。 |
ma.tdv.profiling.not-supported-types-for-cardinality |
プロファイリングではサポートされているが、カーディナリティ関数ではサポートされていない SQL データ型のリスト。タイプは小文字のカンマ区切りでリストする必要があります。 |
| プライベートプロパティ (特定の場合にのみ上書きする必要があります) | |
ma.tdv.soap.public-databases-folder |
パブリックデータソースを作成するためのフォルダー。メタデータプロビジョニング機能は、このフォルダーの下にパブリックコンテナを作成します。このフォルダーは、TDV /services/databases フォルダーを指している必要があります。このプロパティはパブリックプロパティで定義されておらず、TDV のアップグレードに内部構造の変更が含まれる場合を除き、上書きしてはなりません。 |
ma.tdv.soap.introspect-result-timeout |
イントロスペクション タスク実行のタイムアウト (実時間 (秒) は、タイムアウト * 間隔として計算されます)。プロパティが指定されていない場合のデフォルト値は 600 秒です。このタイムアウトに達すると、エージェントは TDV でのイントロスペクション タスクの状態のチェックを停止し、進行中の収集要求に対してエラーを返します。 |
ma.tdv.soap.introspect-result-interval |
エージェントが TDV のイントロスペクション タスクの状態をチェックする間隔 (秒単位)。このプロパティが指定されていない場合のデフォルト値は 5 秒です。 |
ma.tdv.datasource.max-query-timeout |
TDV データソースのクエリ タイムアウトの間隔 (秒単位)。デフォルトでは 600 秒です。 |
これらのプロパティが設定されると、コマンドラインまたはその他の適切なツールを使用して、エージェントを Java アプリケーションとして起動できます (このページの下記を参照)。
起動するたびに、アダプタは TIBCO® Data Virtualization JDBC および SOAP 接続をテストします。
アダプタの起動が成功すると、TIBCO® メタデータエージェントで説明されているように、対応するエージェントのメタデータ管理パースペクティブに表示されます。
トラブルシューティング
| エラーメッセージ | 原因と解決策 |
|---|---|
| TDV データソースの初期化に失敗しました:無効なログイン試行です。 | このエラーは、ログインまたはパスワードが正しくないためにエージェントが TDV インスタンスに接続できない場合に表示されます。プロパティ ma.tdv.datasource.username および ma.tdv.datasource.password に設定した情報を確認してください。 |
| TDV データソースの初期化に失敗しました:接続を完了できませんでした:接続がタイムアウトしました:詳細情報はありません | この種の問題は、さまざまな原因で発生する可能性があります。最も一般的な原因は次のとおりです。 - TDV データソース接続のホストとポートが正しくありません。ma.tdv.datasource.url プロパティの値を確認してください。 - TDV サーバーでポートが開かれていません。ma.tdv.datasource.url プロパティで指定したポートがサーバーで開かれており、エージェントがインストールされているマシンからの接続が許可されていることを確認してください。 - ファイアウォールが、TDV サーバーとエージェントがインストールされているマシン間のアクセスをブロックしています。 |
| TDV データソースの初期化に失敗しました:ドライバークラスを読み込めません | ドライバーがクラスパスに存在することを確認します。 |