アプリケーションプログラミングインターフェイスガイド> 組み込み手順> 手順リファレンス> GetTableProfiles
 
GetTableProfiles
公開されたテーブルまたはビューの指定されたセットに関する統計およびデータソースの系統情報を取得します。プロファイリング情報の収集を可能にするには、カーディナリティ統計を有効にしてデータソースで収集する必要があります。この手順は、「/services/database/system/profile/GetTableProfiles」にあります。
公開されたリソースに基礎となるビューがある場合、プロファイルAPIを使用する前に、キャッシュとカーディナリティの統計を有効にして収集する必要があります。プロファイル情報を収集するには、データソースレベルでカーディナリティ統計を有効にするだけでは不十分な場合があります。
Inputs(入力)
database:テーブルが属する公開済みデータベースの名前。特殊文字「*」は、任意のデータベースを示すワイルドカードとして使用できます。このパラメーターは必須です。 nullを指定すると、エラーがスローされます。
カタログ:テーブルが属する公開済みカタログの名前。特殊文字「*」は、カタログの有無を示すワイルドカードとして使用できます。このパラメーターはオプションです(つまり、カタログがないことを示すためにNULLに設定できます)。
schema:テーブルが属する公開されたスキーマの名前。特殊文字「*」は、スキーマの有無を示すワイルドカードとして使用できます。このパラメーターはオプションです(つまり、スキーマがないことを示すためにNULLに設定できます)。
table:公開されたテーブルの名前。特殊文字「*」は、任意のテーブルを示すワイルドカードとして使用できます。このパラメーターは必須です。 nullを指定すると、エラーがスローされます。
Outputs(出力)
次の列を持つ、行がテーブルプロファイルをエンコードするカーソル。
database:テーブルが属する公開済みデータベースの名前。
カタログ:テーブルが属する公開済みカタログの名前。 NULLの可能性があります。
schema:テーブルが属する公開されたスキーマの名前。 NULLの可能性があります。
table:公開されたテーブルの名前。
rowCount:行数。不明な場合はNULL。
partitionColumn:このテーブルに対するパーティションクエリを定義するために使用される列の名前。不明な場合はNULL。
dataSourceType:この公開されたテーブルがデータを取得するデータソースの名前とバージョン。基になるデータソース内で完全に実行されるパススルーリクエストを使用して、それらに対してSELECT *クエリを提供する公開済みテーブルにのみ適用できます。それ以外の場合、この値はNULLに設定されます。
message:指定されたテーブルの分析を妨げる検出された理由を指定するメッセージ。
 
例外:
 
指定されたリソースが見つからない場合、IllegalArgumentExceptionがスローされます。ユーザーが指定されたリソースを読み取る権限を持っていない場合にも、例外がスローされます。