Oracle TimesTen In-Memory Database APIおよびSQLリファレンス・ガイド

ttOptSetColStats

説明

指定した列の統計を変更します。このプロシージャを使用すると、TimesTenが自動的に統計を計算するのではなく、アプリケーションで手動で統計を設定できます。この機能は、データが挿入される前にコマンドを準備したり、表の特性が実行計画の選択に与える影響を調べる場合に役立ちます。このプロシージャによって、COL_STATSシステム表の関連する行が変更されます。

このプロシージャは表にデータが存在する前から使用できるため、基本的な妥当性チェックは実行されますが、指定する値は実際の値とは関係のないものでもかまいません。

アクセス制御

アクセス制御がTimesTenのインスタンスに対して有効である場合、このプロシージャにはDDL権限が必要です。

構文

ttOptSetColStats (tblName, colName, numUniq, minVal,
    maxVal, invalidate, numNull)

パラメータ

ttOptSetColStatsには、次のパラメータがあります。


パラメータ	データ型	説明
tblName	Char(61) NOT NULL	アプリケーション表の名前。所有者を含めることができます。
colName	Char(30) NOT NULL	表内の列の名前。
numUniq	INTEGER NOT NULL	列内の一意値の数。
minVal	Varbinary(1024) NOT NULL	列内の最小値（切捨てられる可能性あり）。
maxVal	Varbinary(1024) NOT NULL	列内の最大値（切捨てられる可能性あり）。
invalidate	INTEGER	0（いいえ）または1（はい）。invalidateが1の場合、他のユーザーが準備したコマンドを含む、影響を受ける表を参照するすべてのコマンドは、再実行時に自動的に再準備されます。invalidateが0の場合、統計は変更されたとはみなされず、既存のコマンドは再準備されません。
numNull	INTEGER	列のNULLの総数を示します。

結果セット

ttOptSetColStatsは結果を返しません。

例

CALL ttOptSetColStats ( 'SALLY.ACCTS', 'BALANCE', 
                       400, 0x00001388, 0x000186A0, 1, 0);

注意

最小値および最大値をVARBINARYとして指定する必要があります。NULL値を最小値または最大値として指定することはできません。値は、プラットフォーム固有のエンディアン形式で格納されます。

統計は、最小値と最大値の間に均一に配分されている列値の、単一の時間隔として処理されます。