API を使用したカラム リファレンスの取得
TDV に用意されているシステム プロシージャを使用して、カラム参照を取得し、指定されたビュー カラムを直接参照するビューとカラムを検出できます。
このプロシージャは、データ ソース テーブルまたはコンポジット ビューで実行して、テーブルまたはビューの各カラムが持つアップストリーム参照を把握できます。一度に返される参照レベルは 1 つだけですが、GetColumnReferences プロシージャを繰り返し実行して、参照のパスを検出できます。
GetColumnReferences プロシージャを使用すると、次のことができます。
|
•
|
ビューを直接参照するすべてのビューとカラムを一覧表示します。 |
|
•
|
SELECT 句、FROM 句、WHERE 句、TIMESERIES 句など、参照の種類を確認してください。 |
|
•
|
カラムがトランスフォームされたかどうかを確認します。 |
|
•
|
関連するリソースを最初に誰がいつ作成したかを確認します。 |
|
•
|
カラム参照を決定したら、参照先のビューまたはテーブルで GetColumnReferences プロシージャを再度実行して、次のレベルの参照を決定できます。 |
|
•
|
GetColumnReferences プロシージャを次のようにパブリッシュします。 |
|
—
|
新しいデータ サービスとして。その後、JDBC、ODBC、ADO.NET などのサポートされているプロトコルを使用してアクセスできます。 |
|
—
|
REST、SOAP、およびその他のサポートされているプロトコルを使用してアクセスできる新しい Web サービスとして。 |
ビューのカラム参照を取得するには
|
1.
|
Studio で、知りたいカラムを含むデータ ソース テーブルまたはビューを開きます。 |
|
2.
|
Info タブをクリックし、ビューのパスである 名前 フィールドの内容全体をコピーします。 |
|
3.
|
<localhost> ディレクトリで、lib/resource フォルダーに移動し、GetColumnReferences プロシージャを開きます。 |
|
4.
|
[実行] をクリックします。このプロシージャの入力パラメーターを入力するように求められます。 |
|
5.
|
前にコピーしたテーブルまたはビューのパスパス名を resourcePath フィールドに貼り付けます。 |
|
6.
|
次のプロシージャで、その他の 入力値を入力します。 |
|
resourcePath
|
必須。分析するリソースのパスを入力します。サポートされているリソース タイプは、TDV SQL ビューまたはデータ ソース テーブルです。
|
|
columnFilter
|
オプション。カラム リニエージの結果をフィルタリングするかどうかを指定します。空の場合、フィルタリングは行われません。結果をフィルタリングするには、大文字と小文字を区別しないカラム名のカンマ区切りのシーケンスを入力し、参照の分析が必要なカラムを示します。
|
注： 分析は、指定したビューまたはテーブルがキャッシュされているかどうかを無視して実行されます。
TDV によってプロシージャが実行され、下部の [columnReferences の結果] パネルにカラム参照が表示されます。
カラムの内容を次の表に示します。
|
columnName
|
行にエンコードされたカラム参照を持つリソース カラムの名前。
|
|
referentResourcePath
|
カラム参照を含むリソースへのパス。該当しない場合は空です。
|
|
referentContext
|
カラムが参照されるコンテキスト:
|
•
|
WITH 句では、WITH 句内の参照を示します。 |
|
•
|
出力としての SELECT 句で、SELECT 句によって投影される参照を示します。 |
|
•
|
入力としての SELECT 句で、SELECT 句によって使用されているが投影されていない参照を示します。 |
|
•
|
FROM 句では、FROM 句内の参照を示します。 |
|
•
|
WHERE 句では、WHERE 句内の参照を示します。 |
|
•
|
TIMESERIES 句では、TIMESERIES 句内の参照を示します。 |
|
•
|
GROUP BY 句では、GROUP BY 句内の参照を示します。 |
|
•
|
HAVING 句では、HAVING 句内の参照を示します。 |
|
•
|
ORDER BY 句では、ORDER BY 句内の参照を示します。 |
|
|
referentColumnName
|
参照対象カラムの名前。referenceContext が出力として SELECT 句にある場合にのみ設定されます。ない場合は空です。
|
|
derivationKind
|
派生のタイプを示します。
|
•
|
ダイレクト。依存関係の値が依存カラムによって保持されることを示します。 |
|
•
|
インダイレクト。依存関係の値が依存カラムによって変換されることを示します。 |
referenceContext が出力として SELECT 句にある場合にのみ設定されます。ない場合は空です。
|
|
cardinalityInfo
|
該当する場合は、次のいずれかです。
|
•
|
アグリゲートは、従属カラムの派生にアグリゲート関数が含まれていることを示します。 |
|
•
|
分析: 依存カラムの導出に分析関数が関与していることを示します。 |
referenceContext が出力として SELECT 句にある場合にのみ設定されます。ない場合は空です。
|
|
reference
|
カラム参照のテキスト表現。
|
|
8.
|
カラム参照の詳細を表示するには、参照を選択し、[カラム参照の結果] パネルで [詳細] ボタンをクリックします。Studio は、選択した カラム参照の完全な詳細を表示します。 |
|
9.
|
必要に応じて、[カラム参照の結果] パネルで参照先のビューまたはテーブルに対して GetColumnReferences プロシージャを再度実行して、次の参照レベルを決定します。 |
GetColumnReferences プロシージャは、参照パスを検出するために必要な回数だけ実行できます。
|
10.
|
必要に応じて、[カラム参照の結果] パネルで [ファイルに保存] をクリックして、結果をカンマ区切り値 (*.csv) ファイルとして保存します。 |
|
11.
|
必要に応じて、関連するリソースを開いて、リソースの最初の作成者とリソースの [情報] タブを確認します。 |