iAnywhere.com - dbhist コマンド・ライン・ユーティリティを使用したヒストグラムの変換

dbhist コマンド・ライン・ユーティリティを使用したヒストグラムの変換

構文

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

パラメータ

オプション	説明
@data	指定された環境変数または設定ファイルからオプションを読み出す
-c options	接続文字列
-n colname	ヒストグラムに関連付けるカラム
-t table-name	ヒストグラムを生成するテーブルの名前
-u owner	テーブル所有者
excel-output-name:	生成される Excel ファイルの名前

説明

ヒストグラムは SYSCOLSTAT システム・テーブルに格納され、sa_get_histogram ストアド・プロシージャを使用して取り出せます。ヒストグラム・ユーティリティは、ヒストグラムを Microsoft Excel チャートに変換します。これには、述部の選択性に関する情報が含まれます。このユーティリティは、Windows で動作する Excel 97 以降でのみ有効です。

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

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

sa_get_histogram ストアド・プロシージャの詳細については、sa_get_histogram システム・プロシージャを参照してください。

ヒストグラム・ユーティリティのオプション

@data

このオプションを使用して、指定された環境変数または設定ファイルからオプションを読み出します。両方が同じ名前で存在する場合は、環境変数値が使用されます。

設定ファイルの詳細については、設定ファイルの使用を参照してください。

設定ファイルに含まれるパスワードやその他の情報を保護する場合は、ファイル非表示ユーティリティを使用して、設定ファイルの内容を難読化できます。

詳細については、dbfhide コマンド・ライン・ユーティリティを使用してファイル内容を隠すを参照してください。

接続文字列を指定する (-c)

接続パラメータを指定します。

接続パラメータの詳細については、接続パラメータを参照してください。

カラムを指定する (-n)

ヒストグラムを関連付けるカラムの名前を指定します。カラムを指定しない場合は、テーブル内のヒストグラムを持っているすべてのカラムが返ります。

テーブル名を指定する (-t)

ヒストグラムを生成するテーブルの名前を指定します。

所有者を指定する (-u)

テーブルの所有者を指定します。

excel-output-name 生成される Excel ファイルの名前。名前を指定しない場合は、Excel から名前の入力を求める [名前を付けて保存] ダイアログが表示されます。

例

カラムに対してヒストグラムが作成されていると仮定します。次の文 (すべて同一行に入力) は、データベース asademo.db にあるテーブル sales_order_items のカラム prod_id の Excel チャートを生成し、それを histgram.xls として保存します。

dbhist -c "uid=DBA;pwd=SQL;dbf=asademo.db"
      -n prod_id -t sales_order_items histgram.xls

次の文は、テーブル sales_order でヒストグラムがあるすべてのカラムを対象とするチャートを生成します。asademo はすでにロードされているものとします。この文は、uid=dba と pwd=sql を使用して接続も行います。出力ファイル名を指定していないので、Excel から入力するように要求されます。

dbhist -t sales_order -c "UID=DBA;PWD=SQL"