ユーザーガイド > データソースメタデータの取得 > データソースのイントロスペクト > データソースをイントロスペクトする
 
データソースをイントロスペクトする
イントロスペクションの手順には、次の3つのフェーズがあります。
データソースからリソース情報を取得する
ルールとフィルターに基づいてイントロスペクション計画を作成する
データソースをイントロスペクトする
これらのフェーズはすべて、[Data Source Introspection(データソースのイントロスペクト)]ウィンドウを使用して実行します。
データソースをイントロスペクトするには
1.データソースイントロスペクションを呼び出す」の説明に従ってイントロスペクションプロセスを呼び出します。
[Data Source Introspection(データソースのイントロスペクト)]ウィンドウが開き、データソースで検出されたリソースのリストがロードされます。
リソースのロードプロセスは、データソースのサイズ、接続性、およびリソース情報がTDV内にキャッシュされているかどうかに応じて、かなり時間がかかる場合があります。「リソースID取得フェーズを理解する」を参照してください。
リソース情報のロード中に、リソース名の横にあるチェックボックスをオンにすることで、イントロスペクトするリソースの選択を開始できます。すべてのリソース情報がロードされる前に、イントロスペクションタスクを開始することもできます。
注意: 三角形をクリックしてコンテナーを展開すると、TDVによってすぐに追加の呼び出しが実行され、そのコンテナーの内容がロードされます。これにより、リソースのロードに優先順位を付けることができます。
2.イントロスペクトするリソースの横にあるチェックボックスをオンにして、リソースを選択します。
親フォルダーを選択すると、そのフォルダーに含まれるすべてのリソースが選択されます。
注意: 含まれているリソースのリスト全体がロードされる前にカタログ、スキーマ、または親ノードを選択すると、選択時にロード済みの子リソースのみが選択されます。この場合は、リスト全体がロードされたことを後で再確認することをお勧めします。
リソースを選択すると、右側の[Properties(プロパティ)]タブにボックスが表示されます。これを使用して、以降の新しいリソースのイントロスペクションを制御できます。「データソースの再イントロスペクト」を参照してください。
3.必要に応じて、以下に説明する方法で検出されたリソースの表示をフィルタリングします。
リソースリストに表示されている検出済みリソースの数と総リソース数が、リソースリストの上部に表示されます(例: 「5 Visible of 6 Total(検出5/総数6)」)。
リソースリストの上にあるフィールドとボタンを使用して、表示内容を制御できます。
[Find(検索)]フィールドで検索する場合、特定の文字列で始まるリソースのみを表示するには、リソースの名前の一部またはすべてを入力します。[Find(検索)]フィールドの検索パターンには、次のルールがあります。
- 検索パターンは、リソースパスと名前全体に適用されます。
- 一致したリソースのみが表示されます。
- 検索パターン内の文字は隣接している必要はなく、順序が同じである必要があります。
- 検索パターンでは大文字と小文字は区別されません。
- 「/」(スラッシュ)を使用して、コンテナーの一致方法を制御できます。スラッシュがない場合、検索パターンはカタログ、スキーマ、およびリソース名にまたがります(たとえば、abcはリソースa/b/cと一致します)。1つ以上のスラッシュを使用する場合、一致する文字はスラッシュに対して同じ位置にある必要があります。
- ワイルドカードはサポートされていません。
[Show(表示)]フィールドで検索する場合は、次のいずれかのオプションを使用して、リソースリストに表示される内容をフィルタリングします。
 
オプション
表示内容
[Introspectable(イントロスペクト可能)]
イントロスペクション用に選択できるすべてのリソース
[Introspected(イントロスペクト済み)]
すでにイントロスペクトされているリソース
[Changes(変更)]
新しい選択やクリアなど、ダイアログが開いてから行われた変更のみ
[Adds(追加)]
ダイアログボックスが開いてから追加されたリソースのみ
[Removes(削除)]
ダイアログが開いてからTDVで削除する対象として選択されたリソースのみ
- フィルターボタンで検索する場合は、空のコンテナーを含めるまたは含めない、すべてのリソースをオンまたはオフにする、リストを展開するまたは折りたたむボタンのいずれかをクリックします。
4.必要に応じて、[Refresh Resource List(リソースリストの更新)]をクリックして、イントロスペクションに使用できるリソースのリストを更新します。
注意: 現在選択されているリソースは、更新プロセスを行うと選択解除されます。
メタデータをキャッシュした後に新しいリソースを追加し、それらの新しいリソースをTDVに取り込む場合は、[Refresh Resource List(リソースリストの更新)]をクリックする必要があります。StudioとTDV Serverはリソースリストをキャッシュします。このボタンを使用すると、両方のキャッシュが強制的に更新されます。デフォルトでは、現在のユーザーセッション中にイントロスペクトされた最新の7つのデータソースに関するリソースのリストがStudio内にキャッシュされます。このキャッシュはメモリー内にのみ存在し、Studioを閉じるとクリアされます。リソースのロード時間を改善するために、TDV Server内に別のキャッシュが存在します。TDV Server内のキャッシュは、Serverを再起動しても保持されます。
5.[Data Source Introspection(データソースのイントロスペクト)]ダイアログの下部にあるチェックボックスを使用して、TDVが検出したリソースに基づいてイントロスペクションを実行する方法を選択します。
チェックボックス
説明
[Re-Introspect previously introspected resources(イントロスペクト済みリソースの再イントロスペクト)]
すでにイントロスペクトされているものを含め、すべてのデータソースをイントロスペクトする場合は、オンにします。
このチェックボックスがオンになっていて淡色表示されている場合は、新しいイントロスペクションフレームワークにまだアップグレードされていないデータソースアダプターを使用しています。
ソースで変更された可能性のあるリソースの既存のTDVメタデータを更新する場合は、このチェックボックスをオンにします。
新しいリソースのセットを追加するときの応答を速くするには、このチェックボックスをオフにします。既存のすべてのリソースの不要なフル再イントロスペクションを実行しなければ、新しいリソースをより迅速に使用できます。
このチェックボックスの設定は、APIによって開始された再イントロスペクション、スケジュールされた再イントロスペクション、トリガーによって開始された再イントロスペクション、または手動で開始された再イントロスペクションには適用されません。
[Allow partial introspection, omitting resources with errors(エラーがあるリソースを除外して部分的にイントロスペクトすることを許可する)]
他のリソースがイントロスペクトに失敗した場合でも、イントロスペクトされたリソースのメタデータをTDVリポジトリーにコミットすることを許可する場合は、オンにします。
このチェックボックスがオンになっていて淡色表示されている場合は、新しいイントロスペクションフレームワークにまだアップグレードされていないデータソースアダプターを使用しています。
[Stop introspection upon the first error(最初のエラー発生時にイントロスペクトを停止する)]
データソースアダプターが新しいイントロスペクションフレームワークをまだサポートしていない場合にのみオンにします。オフにすると、他のリソースのイントロスペクションを途中で終了することなく、イントロスペクションステータスレポートですべてのエラーと警告を確認できます。
このチェックボックスがオンになっていて淡色表示されている場合は、新しいイントロスペクションフレームワークにまだアップグレードされていないデータソースアダプターを使用しています。
[Copy privileges from parent folder(親フォルダーから権限をコピーする)]
親リソースに付与されたアクセス権をデータソースリソースに継承させる場合はオンにします。
6.SOAPデータソースの場合は、必要に応じて各ノードのプロパティを展開して定義します。次のようなプロパティがあります。
プロパティ
説明
[Detect New Resources During Re-Introspection(再イントロスペクション中に新しいリソースを検出する)]
このオプションをオンにすると、このイントロスペクション後に現在のリソースに追加された子リソースが、再イントロスペクション時に検出されます。
たとえば、現在のリソースがカタログで、このイントロスペクション後にスキーマを追加した場合、追加されたスキーマが再イントロスペクション時に検出されます。再イントロスペクションの詳細については、「イントロスペクションと再イントロスペクションについて」を参照してください。
このオプションをオフにした場合、このイントロスペクション後に現在のリソースに追加される子リソースは再イントロスペクション時に検出されません
たとえば、現在のリソースがカタログで、このイントロスペクション後にスキーマを追加した場合、そのスキーマは再イントロスペクション時に検出されません。再イントロスペクションの詳細については、「データソースの再イントロスペクト」を参照してください。
[Binding Profile Type(バインディングプロファイルタイプ)]
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を編集できます。
[Default Timeout (msec)(デフォルトのタイムアウト(ミリ秒))]
試行が失敗したことを宣言する前に接続が待機するミリ秒数。
[MTOM Enabled(MTOM対応)]
Webサービスとの間でバイナリーデータを送受信する方法であるMTOM(Message Transmission Optimization Mechanism)の使用を有効にする場合は、オンにします。
[Fast Infoset Enabled(高速インフォセット対応)]
XMLファイルをXMLインフォセットに変換できるようにする場合はオンにします。このオプションを使用すると、テキストベースのXML形式よりも効率的なシリアル化が実現します。
[Timeout (msec)(タイムアウト(ミリ秒))]
試行が失敗したことを宣言する前に接続が待機するミリ秒数。
[Choose Input Envelope(入力エンベロープを選択する)]
従来のWSDLデータソース用の廃止されたフィールド。
このオプションをオフにすると、[Choose Top Level Child Elements(最上位の子要素を選択する)]が表示されます。
[Choose Top Level Child Elements(最上位の子要素を選択する)]
操作のリクエストとレスポンスをそれぞれ入力パラメーターと出力パラメーターにマップするには、このオプションをオンにします。このオプションは、メッセージ部分ごとに個別に構成できます。
JMS関連
SOAPデータソースがJMSを介して接続する場合、次のようなJMS情報を入力できるフィールドがノードに表示される場合があります。
[JMS Connector(JMSコネクター)]
[JMS Destination(JMS宛先)]
[JMS Delivery Mode(JMSの配信モード)]
[JMS Expiry(JMSの有効期限)]
[JMS Priority(JMSの優先度)]
7.必要に応じて、イントロスペクションプロパティを展開して定義します。次のようなプロパティがあります。
プロパティ
説明
[Detect New Resources During Re-Introspection(再イントロスペクション中に新しいリソースを検出する)]
このイントロスペクションの後に現在のリソースに追加された子リソースを検出します。
たとえば、現在のリソースがカタログで、このイントロスペクション後にスキーマを追加した場合、追加されたスキーマが再イントロスペクション時に検出されます。「イントロスペクションと再イントロスペクションについて」を参照してください。
このオプションをオフにした場合、このイントロスペクション後に現在のリソースに追加される子リソースは再イントロスペクション時に検出されません
たとえば、現在のリソースがカタログで、このイントロスペクション後にスキーマを追加した場合、そのスキーマは再イントロスペクション時に検出されません。「データソースの再イントロスペクト」を参照してください。
[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)(新しいリソースの<スキーマ|カタログ|プロシージャ|テーブル>名フィルター)]
指定した名前でフィルター設定を保存できます。
[Character Set(文字セット)]
文字エンコーディングの種類。
[Schema Location(スキーマの場所)]
次の構文を使用してスキーマの場所を入力します。
<namespace> <location> [<namespace> <location>]
 
<namespace>は、XMLスキーマのターゲット名前空間です。
<location>は、.XSDファイルへの絶対パス(ファイルの名前を含む)です。
[No Namespace Schema Location(名前空間スキーマの場所なし)]
ターゲット名前空間を定義しないスキーマドキュメントのURL(1つのみ)。
[Delimiter(区切り文字)]
デフォルトはカンマ(,)です。
[Text Qualifier(テキスト修飾子)]
デフォルトはアスタリスク(*)です。
[Starting Row(開始行)]
デフォルトは1です。
[Has Header Row(ヘッダー行を含める)]
このチェックボックスはデフォルトでオンになっています。
8.必要に応じてリソースのフィルターを設定できますが、それらは再イントロスペクションが実行された場合にのみ適用されます。詳細については、「リソースでのイントロスペクションフィルターの設定」を参照してください。
9.[Next(次へ)]をクリックします。
データソースイントロスペクション計画が開き、選択内容に基づいてイントロスペクトされるリソースが一覧表示されます。データソースイントロスペクション計画に一覧表示されたイントロスペクションのすべての変更(追加、削除、および更新)は、[Finish(終了)]ボタンをクリックすると実行されます。
- 黒のリソースはイントロスペクトされます。
- 緑のリソースは追加されます(それらの親リソースも緑色で表示されます)。
- グレーのリソースは削除されます。
10.イントロスペクションの概要を確認し、必要に応じて[Back(戻る)]をクリックしてイントロスペクション計画とその実行方法を修正します。
11.[Finish(終了)]をクリックして、リソースをイントロスペクトします。
TDVは、選択されたリソースをイントロスペクトし、それらのリソースに関するメタデータをTDVリポジトリーに追加します。
12.[OK]をクリックすると、いつでもこのウィンドウを閉じることができます。ただし、イントロスペクションプロセスはバックグラウンドで実行され続けます。Studioセッションを閉じても、イントロスペクションプロセスは続行されます。
パネル
表示される内容
[Running Tasks(実行中のタスク)/Completed Tasks(完了タスク)]
(左側)
現在のユーザーセッションのイントロスペクションタスクの進行状況とステータス。
[Introspection Summary(イントロスペクトの概要)]
(右上)
ステータス、イントロスペクションの開始時間と終了時間、警告とエラーの数、および追加、削除、更新、スキップされたリソースの数(および合計)。
[Details(詳細)]
(右下)
選択したイントロスペクションで追加、更新、削除、およびスキップされた個別のリソース。TDVによって使用されるメタデータに変更がないリソースは、スキップされた数に追加されます。次のことを実行できます。
[Show(表示)]オプション-表示される詳細情報をフィルタリングして、すべての詳細、警告のみ、またはエラーのみを表示します。
[Show Details(詳細を表示)]-追加されたリソースを選択して[Show Details(詳細を表示)]をクリックすると、リソースに関する追加情報が表示されます。
[Export(エクスポート)]-イントロスペクトされたテーブル、列、およびインデックスが一覧表示されるテキストイントロスペクションレポートを保存する場合はクリックします。このファイルの例については、「データソースのイントロスペクションレポートの表示」を参照してください。
13.後でデータソースのイントロスペクション情報を表示できます。「イントロスペクションプロセスの追跡と表示」を参照してください。