ユーザーガイド > ビューとテーブルリソース > 列の依存関係と参照の表示 > APIを使用した列の依存関係の取得
 
APIを使用した列の依存関係の取得
TDVに用意されているシステムプロシージャを指定した複合ビューに対して使用して、列の依存関係を取得し、データの取得元を検出し、データがどのように派生するかを確認できます。データは、テーブル、ビュー、プロシージャ、パッケージ化されたクエリー、区切られたファイル、Webサービス操作など、さまざまなリソースタイプとパスから取得できます。これらについていくつかの例を以下の図に示します。
ビューがプロシージャ、Webサービス、またはパッケージ化されたクエリーに依存している場合、そのデータの依存関係分析の終わりです。プロシージャ、Webサービス、またはパッケージ化されたクエリーからそれ以上の分析は行われません。
ビューの列の依存関係を要求すると、GetColumnDependenciesプロシージャの結果から、ビューの各列について、次の例に示すように、どのデータソースがデータを生成したか、どのビューがデータを変換またはフィルタリングしたかがわかります。
この例では、列系列データの結果は次のようになります。
GetColumnDependenciesプロシージャを使用すると、次のことができます。
• データソースまたはプロシージャにまでさかのぼって、列の結果の作成に関連するリソースを表示する
• どの列がどのように変換されたかを調べる
• 変換されていない列を見つける
• 元のデータソースタイプを検出する
• どの列に定数が含まれているかを調べる
• 関係するリソースを最初に作成したのは誰か、いつ作成したかを確認する
• プロシージャの上にビューを作成し、データソース情報を分析および集約する
• GetColumnDependenciesプロシージャを公開する
— 新しいデータサービスとして公開します。公開後、JDBC、ODBC、ADO.NETなどのサポートされているプロトコルを使用してアクセスできます。
— REST、SOAPなどのサポートされているプロトコルを使用してアクセスできる新しいWebサービスとして公開します。
ビューの列の依存関係を取得するには
1.Studioで、学習したい列を含むビューを開きます。
2.[Info(情報)]タブをクリックし、ビューのパスである[Name(名前)]フィールドの内容全体をコピーします。
3.localhostディレクトリーで、lib/resourceフォルダーに移動し、GetColumnDependenciesプロシージャを開きます。
4.[Execute(実行)]をクリックします。Studioから、このプロシージャの入力パラメーターを入力するように求められます。
5.先ほどコピーしたビューのパス名をresourcePathフィールドに貼り付けます。
6.プロシージャの他の入力値を表に従って入力します。
 
パラメーター
値の説明
resourcePath
必須。分析するリソースのパスを入力します。
サポートされているリソースタイプは、プレーン形式または公開形式のTDV SQLビューです。
columnFilter
オプション。列系列の結果をフィルタリングするかどうかを指定します。空の場合、フィルタリングは行われません。結果をフィルタリングするには、大文字と小文字を区別しない列名のカンマ区切りのシーケンスを入力し、依存関係の分析が必要な列を示します。
ignoreCaches
オプション。依存リソースがキャッシュされているかどうかを分析で無視するかどうかを指定します。次のいずれかの値を入力します。
true—列系列の一部としてキャッシュを返しません。
false—デフォルト。空白またはfalseの場合、列系列の既存のキャッシュはすべて、プロシージャの結果として返されます。
recursively
オプション。分析をソースレベルの依存関係まで再帰的に実行するか、1レベルの依存関係のみを返すかを指定します。次のいずれかの値を入力します。
true—元のソースレベルまでのすべてのレベルの依存関係を返します。
false—デフォルト。空白またはfalseの場合、単一レベルの列依存関係のみを返します。
分析は、ビューがキャッシュされているかどうかに関係なく、ビュー定義に基づいて行われます。
7.[OK]をクリックします。
TDVによってプロシージャが実行され、下部の[Result For columnDependencies(columnDependenciesの結果)]パネルに列の依存関係を表示します。
列の内容を以下に示します。
列
説明
columnName
行にエンコードされた列の依存関係を持つリソース列の名前。
dependencyDatasourcePath
依存関係を所有するリソースを含むデータソースへのパス。該当しない場合は空です。
dependencyDatasourceType
依存関係を所有するリソースを含むデータソースのタイプ。該当しない場合は空です。
dependencyResourcePath
依存関係を所有するリソースへのパス。該当しない場合は空です。
dependencyResourceType
依存関係を所有するリソースのタイプ。該当しない場合は空です。データソースタイプのセットは、TDVによって受け入れられるすべてのデータソースアダプター名で構成されます。
TDVによって受け入れられるテーブルとプロシージャのリソースタイプは次のとおりです。
Database Table
Delimited File
Excel Table
TDV SQL View
System Table
SAP RT Table
SAP RFC Table
SAP AQ Query Table
SAP Infoset Query Table
Siebel Table
Database Stored Procedure
Packaged Query
Java Procedure
Web Service Operation
Composite SQL Script Procedure
XQuery Procedure
Transform Procedure
Basic Transform Procedure
Stream Transform Procedure
XQuery Transform Procedure
XSLT Transform Procedure
dependencyIdentifier
依存関係が列にある場合は列名。ない場合はリテラル。
dependencyKind
次のいずれかです。
• column。列への依存関係を示します。
• literal。定数値への依存関係を示します。
• parameter。実行時に提供される動的な値への依存関係を示します。
derivationKind
次のいずれかです。
• direct。依存関係の値が依存列によって保持されることを示します。
• indirect。依存関係の値が依存列によって変換されることを示します。
cardinalityInfo
該当する場合は、次のいずれかです。
• aggregate。集計関数が従属列の派生に関与していることを示します。
• analytic。分析関数が従属列の派生に関与していることを示します。
derivations
従属列が依存関係の直接射影ではない場合、このフィールドは従属列がどのように派生されるかを示します。
8.列の依存関係の詳細を表示するには、依存関係を選択し、[Result For columnDependencies(columnDependenciesの結果)]パネルの[Details(詳細)]ボタンをクリックします。Studioには、次の例に示すように、選択した列の依存関係の完全な詳細が表示されます。
9.必要に応じて、[Result For columnDependencies(columnDependenciesの結果)]パネルの[Save to File(ファイルに保存)]をクリックして、結果をカンマ区切り値(*.csv)ファイルとして保存します。
10.必要に応じて、リソースの[Info(情報)]タブで関連するリソースのいずれかを開いて、リソースの作成者と作成日時を確認します。