sa_disk_free_space 系统过程

报告 dbspace、事务日志、事务日志镜像和/或临时文件的可用空间信息。

语法

sa_disk_free_space( [ p_dbspace_name ] )

参数

p_dbspace_name 使用此 VARCHAR(128) 参数指定 dbspace 的名称、事务日志文件、事务日志镜像文件或临时文件。
如果有一个名为 log、mirror 或 temp 的 dbspace，则可以在关键字前面加上一个下划线。例如，若存在一个名为 log 的 dbspace，则使用 _log 可以获得有关日志文件的信息。

指定 SYSTEM 以获取有关主数据库文件的信息，指定 TEMPORARY 或 TEMP 以获取有关临时文件的信息，指定 TRANSLOG 以获取有关事务日志的信息，或指定 TRANSLOGMIRROR 以获取有关事务日志镜像的信息。请参见预定义 dbspace。

结果集

列名	数据类型	说明
dbspace_name	VARCHAR(128)	这可以是 dbspace 名称、事务日志文件、事务日志镜像文件或临时文件。
free_space	UNSIGNED BIGINT	卷上的空闲字节数。
total_space	UNSIGNED BIGINT	dbspace 所在驱动器的可用磁盘空间的总量。

注释

如果未指定 p_dbspace_name 参数或该参数为 NULL，则每个 dbspace 在结果集中都占一行，另外每个事务日志、事务日志镜像和临时文件（如果存在）也都占一行。如果指定了 p_dbspace_name，则正好返回一行或零行（如果不存在这样的 dbspace，或者指定了 log 或 mirror 但是没有日志文件或镜像文件，则返回零行）。

有关 SQL Anywhere 数据库的预定义 dbspace 的名称列表，请参见预定义 dbspace。

权限

需要 DBA 权限

副作用

无

示例

以下示例使用 sa_disk_free_space 系统过程返回一个包含可用空间信息的结果集。

CALL sa_disk_free_space( );

dbspace_name	free_space	total_space
system	10952101888	21410402304
translog	10952101888	21410402304
temporary	10952101888	21410402304