ttOptSetColStats
説明
指定した列の統計を変更します。このプロシージャを使用すると、TimesTenが自動的に統計を計算するのではなく、アプリケーションで手動で統計を設定できます。この機能は、データが挿入される前にコマンドを準備したり、表の特性が実行計画の選択に与える影響を調べる場合に役立ちます。このプロシージャによって、COL_STATSシステム表の関連する行が変更されます。
このプロシージャは表にデータが存在する前から使用できるため、基本的な妥当性チェックは実行されますが、指定する値は実際の値とは関係のないものでもかまいません。
アクセス制御
アクセス制御がTimesTenのインスタンスに対して有効である場合、このプロシージャにはDDL権限が必要です。
構文
ttOptSetColStats ('tblName', 'colName', numUniq, minVal,
maxVal, invalidate, numNull)
パラメータ
ttOptSetColStatsには、次のパラメータがあります。
パラメータ | データ型 | 説明 |
tblName | TT_Char (61) NOT NULL | アプリケーション表の名前。所有者を含めることができます。 |
colName | TT_Char (30) NOT NULL | 表内の列の名前。 |
numUniq | TT_INTEGER NOT NULL | 列内の一意値の数。 |
minVal | Varbinary(1024) NOT NULL | 列内の最小値(切り捨てられる可能性あり)。 |
maxVal | Varbinary(1024)NOT NULL | 列内の最大値(切り捨てられる可能性あり)。 |
invalidate | TT_INTEGER | 0(いいえ)または1(はい)。invalidateが1の場合、他のユーザーが準備したコマンドを含む、影響を受ける表を参照するすべてのコマンドは、再実行時に自動的に再準備されます。invalidateが0の場合、統計は変更されたとはみなされず、既存のコマンドは再準備されません。 |
numNull | TT_INTEGER | 列のNULLの総数を示します。 |
結果セット
ttOptSetColStatsは結果を返しません。
例
CALL ttOptSetColStats ( 'SALLY.ACCTS', 'BALANCE',
注意
最小値および最大値をVARBINARYとして指定する必要があります。NULL値を最小値または最大値として指定することはできません。値は、プラットフォーム固有のエンディアン形式で格納されます。
統計は、最小値と最大値の間に均一に配分されている列値の、単一の時間隔として処理されます。
関連項目
ttOptEstimateStats
ttOptGetColStats
ttOptSetColIntvlStats
ttOptSetTblStats
ttOptUpdateStats