dbhist [ options ] -t table-name [ excel-output-filename ]

MANAGE STATISTICS システム権限が必要です。

ヒストグラムは ISYSCOLSTAT システムテーブルに格納され、sa_get_histogram ストアドプロシージャを使用して取り出せます。ヒストグラムユーティリティは、ヒストグラムを Microsoft Excel チャートに変換します。これには、述部の選択性に関する情報が含まれます。ヒストグラムユーティリティ (dbhist) は Windows でのみ使用できます。このユーティリティを使用するためには、コンピュータに Microsoft Excel 97 以降がインストールされている必要があります。

たとえば、統計が最近削除された場合は、テーブルまたはマテリアライズドビューに対する統計 (ヒストグラムを含む) が存在しないことがあります。この場合、ヒストグラムユーティリティによって、「ヒストグラムにデータが含まれていないため、アボートします。」というメッセージが表示されます。このような場合は、統計情報を作成してから、再度ヒストグラムユーティリティを実行する必要があります。テーブルまたはマテリアライズドビューの統計を作成するには、CREATE STATISTICS 文を実行します。

文字列カラムに対する述部の選択性を決定するには、ESTIMATE 関数または ESTIMATE_SOURCE 関数を使用します。文字列カラムからヒストグラムを取り出そうとすると、sa_get_histogram とヒストグラムユーティリティがエラーを生成します。

シート名にはカラム名が使用されます。カラム名は、25 文字目以降がトランケートされ、\、/、?、*、[、]、: (Microsoft Excel では使用できない文字) はアンダースコア (_) に置き換えられます。チャート名は chart で始まり、上記と同じ命名規則が適用されます。名前が重複した場合は (文字の置換、トランケート、カラム名が chart で始まることなどによって)、重複した名前は使用できないことを示す Microsoft Excel エラーが発生します。ただし、スプレッドシートは作成され、以前のバージョンで作成された名前 (Sheet1、Chart1 など) が付けられます。

終了コードは、0 (成功) または 0 以外の値 (失敗) です。

sa_get_histogram ストアドプロシージャを使用して、ヒストグラムを取得することもできます。

• CREATE STATISTICS 文
• ソフトウェアコンポーネントの終了コード
• sa_get_histogram システムプロシージャ
• 選択性推定ソース
• オプティマイザの推定と統計
• ESTIMATE 関数 [その他]
• ESTIMATE_SOURCE 関数 [その他]

次のコマンド (全体を 1 つの行に入力) は、データベース demo.db にあるテーブル SalesOrderItems のカラム ProductID の Microsoft Excel チャートを生成し、それを histogram.xls として保存します。

dbhist -c "UID=DBA;PWD=sql;DBF=%SQLANYSAMP16%\demo.db" -n ProductID -t SalesOrderItems histogram.xls

次の文は、テーブル SalesOrders 内にヒストグラムがあるすべてのカラムを対象とするチャートを生成します。サンプルデータベースがすでに起動されていることを前提とします。この文では、UID=DBA と PWD=sql を使用して接続も行います。出力ファイル名を指定していないので、Microsoft Excel から入力するように要求されます。

dbhist -t SalesOrders -c "UID=DBA;PWD=sql"