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