データ ソースのイントロスペクト

イントロスペクションの手順には、次の3つのフェーズがあります。

• データ ソースからリソース情報をフェッチします。
• ルールとフィルターに基づいてイントロスペクション プランを作成します。
• データ ソースのイントロスペクト。

これらのフェーズはすべて、[Data Source Introspection(データソースのイントロスペクト)]ウィンドウを使用して実行します。

データソースをイントロスペクトするには

1. データ ソース イントロスペクションの呼び出しで説明されているように、イントロスペクション プロセスを呼び出します。

[Data Source Introspection(データソースのイントロスペクト)]ウィンドウが開き、データソースで検出されたリソースのリストがロードされます。

データ ソースのサイズ、接続、およびリソース情報が TDV 内にキャッシュされているかどうかによっては、リソースをロードするプロセスにかなりの時間がかかる場合があります。「リソース ID 取得フェーズの理解」を参照してください。

リソース情報のロード中に、リソース名の横にあるチェックボックスをオンにすることで、イントロスペクトするリソースの選択を開始できます。すべてのリソース情報がロードされる前に、イントロスペクションタスクを開始することもできます。

注意: 三角形をクリックしてコンテナーを展開すると、TDVによってすぐに追加の呼び出しが実行され、そのコンテナーの内容がロードされます。これにより、リソースのロードに優先順位を付けることができます。

2. イントロスペクトするリソースの横にあるチェックボックスをオンにして、そのリソースを選択します。

親フォルダーを選択すると、そのフォルダーに含まれるすべてのリソースが選択されます。

注意: 含まれているリソースのリスト全体がロードされる前にカタログ、スキーマ、または親ノードを選択すると、選択時にロード済みの子リソースのみが選択されます。この場合は、リスト全体がロードされたことを後で再確認することをお勧めします。

リソースを選択すると、右側の [プロパティ] タブにチェックボックスが表示され、今後の新しいリソースのイントロスペクションを制御するためにチェックできます。「データ ソースの再イントロスペクション」を参照してください。

3. 必要に応じて、以下で説明するように、検出されたリソースの表示をフィルター処理します。

リソースリストに表示されている検出済みリソースの数と総リソース数が、リソースリストの上部に表示されます(例: 「5 Visible of 6 Total(検出5/総数6)」)。

リソースリストの上にあるフィールドとボタンを使用して、表示内容を制御できます。

[Find(検索)]フィールドで検索する場合、特定の文字列で始まるリソースのみを表示するには、リソースの名前の一部またはすべてを入力します。[Find(検索)]フィールドの検索パターンには、次のルールがあります。

— 検索パターンは、リソースのパスと名前全体に適用されます。
— マッチしたもののみが表示されます。
— 検索パターン内の文字は隣接している必要はなく、同じ順序である必要があります。
— 検索パターンは大文字と小文字を区別しません。
— 「/」(スラッシュ) を使用して、コンテナーの一致方法を制御できます。スラッシュがない場合、検索パターンはカタログ、スキーマ、およびリソース名にまたがります。 (例: abc はリソース a/b/c に一致します。) 1 つまたは複数のスラッシュがある場合、一致する文字はスラッシュを基準にして同じ位置にある必要があります。
— ワイルド カードはサポートされていません。

[Show(表示)]フィールドで検索する場合は、次のいずれかのオプションを使用して、リソースリストに表示される内容をフィルタリングします。

オプション

表示内容

[Introspectable(イントロスペクト可能)]

イントロスペクション用に選択できるすべてのリソース

[Introspected(イントロスペクト済み)]

すでにイントロスペクトされているリソース

変更

新しい選択やクリアなど、ダイアログが開いてから行われた変更のみ

[Adds(追加)]

ダイアログボックスが開いてから追加されたリソースのみ

[Removes(削除)]

ダイアログが開いてからTDVで削除する対象として選択されたリソースのみ
— フィルタ ボタンで検索する場合、いずれかのボタンをクリックして、空のコンテナを含めるか含めないか、すべてのリソースをチェックまたはクリアするか、リストを展開または折りたたむことができます。
4. 必要に応じて、[リソース リストの更新] をクリックして、イントロスペクションに使用できるリソースのリストを更新します。

注： 現在選択されているリソースは、更新プロセス中はチェックされません。

メタデータをキャッシュした後に新しいリソースを追加し、それらの新しいリソースをTDVに取り込む場合は、[Refresh Resource List(リソースリストの更新)]をクリックする必要があります。StudioとTDV Serverはリソースリストをキャッシュします。このボタンを使用すると、両方のキャッシュが強制的に更新されます。デフォルトでは、現在のユーザーセッション中にイントロスペクトされた最新の7つのデータソースに関するリソースのリストがStudio内にキャッシュされます。このキャッシュはメモリー内にのみ存在し、Studioを閉じるとクリアされます。リソースのロード時間を改善するために、TDV Server内に別のキャッシュが存在します。TDV Server内のキャッシュは、Serverを再起動しても保持されます。

5. [データ ソースのイントロスペクション] ダイアログの下部にあるチェック ボックスを使用して、検出したリソースに基づいて TDV がイントロスペクションを実行する方法を選択します。

チェックボックス

説明

[Re-Introspect previously introspected resources(イントロスペクト済みリソースの再イントロスペクト)]

すでにイントロスペクトされているものを含め、すべてのデータソースをイントロスペクトする場合は、オンにします。

このチェックボックスがオンになっていて淡色表示されている場合は、新しいイントロスペクションフレームワークにまだアップグレードされていないデータソースアダプターを使用しています。

ソースで変更された可能性のあるリソースの既存のTDVメタデータを更新する場合は、このチェックボックスをオンにします。

新しいリソースのセットを追加するときの応答を速くするには、このチェックボックスをオフにします。既存のすべてのリソースの不要なフル再イントロスペクションを実行しなければ、新しいリソースをより迅速に使用できます。

このチェックボックスの設定は、APIによって開始された再イントロスペクション、スケジュールされた再イントロスペクション、トリガーによって開始された再イントロスペクション、または手動で開始された再イントロスペクションには適用されません。

部分的なイントロスペクションを許可し、エラーのあるリソースを省略

他のリソースがイントロスペクトに失敗した場合でも、イントロスペクトされたリソースのメタデータをTDVリポジトリーにコミットすることを許可する場合は、オンにします。

このチェックボックスがオンになっていて淡色表示されている場合は、新しいイントロスペクションフレームワークにまだアップグレードされていないデータソースアダプターを使用しています。

最初のエラーでイントロスペクションを停止

データソースアダプターが新しいイントロスペクションフレームワークをまだサポートしていない場合にのみオンにします。オフにすると、他のリソースのイントロスペクションを途中で終了することなく、イントロスペクションステータスレポートですべてのエラーと警告を確認できます。

このチェックボックスがオンになっていて淡色表示されている場合は、新しいイントロスペクションフレームワークにまだアップグレードされていないデータソースアダプターを使用しています。

親フォルダから権限をコピー

親リソースに付与されたアクセス権をデータソースリソースに継承させる場合はオンにします。
6. 必要に応じて、SOAP データ ソースの場合は、各ノードのプロパティを展開して定義します。プロパティには、次のいずれかを含めることができます。

プロパティ

説明

[Detect New Resources During Re-Introspection(再イントロスペクション中に新しいリソースを検出する)]

このオプションをオンにすると、このイントロスペクション後に現在のリソースに追加された子リソースが、再イントロスペクション時に検出されます。

現在のリソースがカタログであり、このイントロスペクションの後にスキーマを追加すると、追加されたスキーマは再イントロスペクション中に検出されます。再イントロスペクションの詳細については、イントロスペクションと再イントロスペクションについてを参照してください。

このオプションをオフにした場合、このイントロスペクション後に現在のリソースに追加される子リソースは再イントロスペクション時に検出されません。

現在のリソースがカタログであり、このイントロスペクションの後にスキーマが追加された場合、そのスキーマは再イントロスペクション中に検出されません。再内視の詳細については、データ ソースの再イントロスペクションを参照してください。

バインディング プロファイル タイプ

HTTPトランスポートプロトコル、リテラルエンコーディングスキーム、およびドキュメントメッセージスタイルの指定を許可します。

[Use Endpoint URL(エンドポイントURLを使用する)]

エンドポイントURLの構成を許可するチェックボックス。オフにした場合は、WSDLで定義されているURLが使用されます。

[Endpoint URL(エンドポイントURL)]には、SOAPデータソースの実際のURLが表示されます。これは、WSDLのURLとは異なる場合があります。

指定されたURLが無効な場合、SOAPデータソースのイントロスペクションプロセスは失敗します。WSDLデータソースは、リクエストが送信されるまで失敗します。

[Endpoint URL(エンドポイントURL)]

[Endpoint URL(エンドポイントURL)]には、クライアントがSOAPデータソースにアクセスできるURLが表示されます。これは、WSDLのURLとは異なる場合があります。

このフィールドを使用して、エンドポイントURLを編集できます。

デフォルト タイムアウト (ミリ秒)

試行が失敗したことを宣言する前に接続が待機するミリ秒数。

MTOM 有効化

Web サービスとの間でバイナリ データを送受信する方法である Message Transmission Optimization Mechanism (MTOM)の使用を有効にする場合に選択します。

Fast Infoset 有効

XMLファイルをXMLインフォセットに変換できるようにする場合はオンにします。このオプションを使用すると、テキストベースのXML形式よりも効率的なシリアル化が実現します。

[Timeout (msec)(タイムアウト(ミリ秒))]

試行が失敗したことを宣言する前に接続が待機するミリ秒数。

入力エンベロープを選択

従来のWSDLデータソース用の廃止されたフィールド。

このオプションをオフにすると、[Choose Top Level Child Elements (最上位の子エレメントを選択)] が表示されます。

最上位の子エレメントを選択

操作のリクエストとレスポンスをそれぞれ入力パラメーターと出力パラメーターにマップするには、このオプションをオンにします。このオプションは、メッセージ部分ごとに個別に構成できます。

JMS関連

SOAPデータソースがJMSを介して接続する場合、次のようなJMS情報を入力できるフィールドがノードに表示される場合があります。

• JMS コネクター
• JMS デスティネーション
• JMS 配信モード
• JMS の有効期限
• JMS プライオリティ
7. 必要に応じて、イントロスペクション プロパティを展開して定義します。これには、次のいずれかを含めることができます。

プロパティ

説明

再イントロスペクション中に新しいリソースを検出

このイントロスペクションの後に現在のリソースに追加された子リソースを検出します。

現在のリソースがカタログであり、このイントロスペクションの後にスキーマを追加すると、追加されたスキーマは再イントロスペクション中に検出されます。 イントロスペクションと再イントロスペクションについてをご覧ください。

このオプションをオフにした場合、このイントロスペクション後に現在のリソースに追加される子リソースは再イントロスペクション時に検出されません。

現在のリソースがカタログで、このイントロスペクションの後にスキーマが追加された場合、そのスキーマは再イントロスペクション中に検出されません。「データ ソースの再イントロスペクション」を参照してください。

[Wildcard Symbol for Single Character Match(1文字に一致するワイルドカード記号)]

デフォルトはアンダースコアです。

[Wildcard Symbol for Zero or More Character Match(0個以上の文字に一致するワイルドカード記号)]

デフォルトはパーセント記号(%)です。

[Escape Character for Wildcard Symbols(ワイルドカード記号のエスケープ文字)]

デフォルトは円記号(\)です。

[Filter in Case Sensitive Mode(大文字と小文字を区別するモードでフィルタリングする)]

フィルターの実行に関する設定を示すチェックボックス。

[Separator for Each Filter(各フィルターのセパレーター)]

デフォルトはカンマ(,)です。

[New Resource <Schema|Catalog|Procedure|Table> Name Filter(s)(新しいリソースの<スキーマ|カタログ|プロシージャ|テーブル>名フィルター)]

指定した名前でフィルター設定を保存できます。

文字セット

文字エンコーディングの種類。

スキーマの場所

次の構文を使用してスキーマの場所を入力します。

<namespace> <location> [<namespace> <location>]

<namespace>は、XMLスキーマのターゲット名前空間です。

<location>は、.XSDファイルへの絶対パス(ファイルの名前を含む)です。

[No Namespace Schema Location(名前空間スキーマの場所なし)]

ターゲット名前空間を定義しないスキーマドキュメントのURL(1つのみ)。

区切り

デフォルトはカンマ(,)です。

テキスト修飾子

デフォルトはアスタリスク(*)です。

[Starting Row(開始行)]

デフォルトは1です。

[Has Header Row(ヘッダー行を含める)]

このチェックボックスはデフォルトでオンになっています。
8. 必要に応じて、リソースのフィルターを設定できますが、それらは再イントロスペクションが行われた場合にのみ適用されます。詳細については、「リソースでのイントロスペクション フィルタの設定」を参照してください。
9. [次へ] をクリックします。

Studio は、選択に基づいて、イントロスペクトされるリソースを一覧表示する Data Source イントロスペクション プランを開きます。データ ソース イントロスペクション プランには、[完了] ボタンをクリックしたときに発生するすべてのイントロスペクションの変更 (追加、削除、および更新) が一覧表示されます。

— 黒のリソースはイントロスペクトされます。
— 緑色のリソースが追加されます。 (親リソースも緑色で表示されます。)
— 灰色のリソースは削除されます。
10. イントロスペクションの概要を確認し、必要に応じて [戻る] をクリックして、イントロスペクション プランとその実行方法を修正します。
11. [完了] をクリックして、リソースをイントロスペクトします。

TDVは、選択されたリソースをイントロスペクトし、それらのリソースに関するメタデータをTDVリポジトリーに追加します。

12. [OK] をクリックすると、いつでもこのウィンドウを閉じることができます。ただし、イントロスペクション プロセスは引き続きバックグラウンドで実行されます。 Studio セッションを閉じても、イントロスペクション プロセスは続行されます。

パネル

表示される内容

実行中のタスク/完了したタスク

(左側)

現在のユーザーセッションのイントロスペクションタスクの進行状況とステータス。

イントロスペクション サマリー

(右上)

ステータス、イントロスペクションの開始時間と終了時間、警告とエラーの数、および追加、削除、更新、スキップされたリソースの数(および合計)。

詳細

(右下)

選択したイントロスペクションで追加、更新、削除、およびスキップされた個別のリソース。TDVによって使用されるメタデータに変更がないリソースは、スキップされた数に追加されます。次のことを実行できます。

• オプションの表示 - 表示される詳細をフィルタリングして、すべての詳細、警告のみ、またはエラーのみを表示します。
• 詳細の表示 - 追加されたリソースを選択し、[詳細の表示] をクリックして、リソースに関する追加情報を取得します。
• エクスポート - クリックすると、イントロスペクションされたテーブル、カラム、およびインデックスをリストしたテキスト イントロスペクション レポートが保存されます。このファイルの例については、「 データ ソースのイントロスペクション レポートの表示」を参照してください。
13. 後でデータ ソースのイントロスペクション情報を表示できます。「イントロスペクション プロセスのトレースと表示」を参照してください。