Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
将直方图转换为包含有关谓词选择性信息的 Microsoft Excel 图表。
dbhist [ options ] -t table-name [ excel-output-filename ]
读取来自指定的环境变量或配置文件的选项。请参见配置文件。
要保护口令或配置文件中的其它信息，可以使用文件隐藏实用程序对配置文件的内容进行模糊处理。请参见文件隐藏实用程序 (dbfhide)。
指定连接参数。请参见连接参数。
-n colname
您必须具有 MANAGE STATISTICS 系统特权。
直方图存储在 ISYSCOLSTAT 系统表中，也可以使用 sa_get_histogram 存储过程进行检索。直方图实用程序将直方图转换为 Microsoft Excel 图表，图表包含有谓词选择性的信息。直方图实用程序 (dbhist) 只能在 Windows 上运行，而且必须安装 Microsoft Excel 97 或更高版本。
表或实例化视图可能不会显示统计信息（包括直方图），例如，对于最近已删除统计信息的情况。此时，直方图实用程序会返回消息 [直方图中没有任何数据，正在中止]。在这种情况下，必须创建统计信息，然后再次运行直方图实用程序。要为表或实例化视图创建统计信息，需执行 CREATE STATISTICS 语句。
直方图中没有任何数据，正在中止
要确定关于字符串列的谓词选择性，使用 ESTIMATE 或 ESTIMATE_SOURCE 函数。尝试从字符串列中检索直方图会导致 sa_get_histogram 和直方图实用程序产生错误。
工作表以列名来命名。列名达到 24 个字符后会被截断，所有出现的 \、/、?、*、[、] 和 :（Microsoft Excel 中不允许使用这些字符）均被替换为下划线 (_)。图表名以 chart 一词为前缀，后面部分的命名约定与上面相同。重复的名称（因字符替换、截断或名称以 chart 开头的列引起）会引发 Microsoft Excel 错误，错误消息会提示不能使用重复名称。但电子表格仍会以之前创建版本的名称（Sheet1、Chart1 等等）来创建。
退出代码是零（成功）或非零（失败）。
您还可以使用 sa_get_histogram 存储过程检索直方图。
以下命令（全部在同一行输入）将为数据库 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"
语法