ADMIN_GET_STORAGE_PATHS 表函数 - 检索自动存储器路径信息
ADMIN_GET_STORAGE_PATHS 表函数返回每个数据库存储器组的自动存储器路径的列表,包括每个存储器路径的文件系统信息。
请参阅 表 1 ,以获取可返回的完整信息列表。
语法
模式为 SYSPROC。
表函数参数
- storage_group_name
- 类型为 VARCHAR (128) 的输入参数,用于在调用此函数时指定当前连接的数据库中的有效存储器组名。 如果自变量为 NULL 或空字符串,那么将返回数据库中所有存储器组的信息。 如果指定了参数,那么仅返回所标识的存储器组的信息。
- 成员
- 类型为 INTEGER 的输入自变量,调用此函数时,此自变量指定与当前连接的数据库位于同一实例中的有效成员。
- 在 Db2® pureScale®中,指定 0。
- 在 分区数据库环境中,为当前数据库成员指定 -1 ,或为所有数据库成员指定 -2 。
权限
需要下列其中一项权限才能执行此例程:
- 对例程的 EXECUTE 特权
- DATAACCESS 权限
- DBADM 权限
- SQLADM 权限
缺省 PUBLIC 特权
无
示例
确定仍在使用哪些已删除的存储路径:
SELECT VARCHAR(STORAGE_GROUP_NAME, 30) AS STOGROUP, VARCHAR(DB_STORAGE_PATH, 40)
AS STORAGE_PATH FROM TABLE(ADMIN_GET_STORAGE_PATHS('',-1)) AS T
WHERE DB_STORAGE_PATH_STATE = 'DROP_PENDING'
以下是此查询的输出示例。STOGROUP STORAGE_PATH
------------------------------ ----------------------------------------
HOTSTORAGE /home/hotel55/hotpath1
1 record(s) selected.
列出当前连接的数据库的所有存储路径:
SELECT VARCHAR(STORAGE_GROUP_NAME, 30) AS STOGROUP, VARCHAR(DB_STORAGE_PATH, 40)
AS STORAGE_PATH FROM TABLE(ADMIN_GET_STORAGE_PATHS('',-1)) AS T
以下是此查询的输出示例。STOGROUP STORAGE_PATH
------------------------------ ----------------------------------------
IBMSTOGROUP /home/hotel55/instowner
HOTSTORAGE /home/hotel55/hotpath1
COLDSTORAGE /home/hotel55/coldpath1
3 record(s) selected.
ADMIN_GET_STORAGE_PATHS 返回的信息
列名 | 数据类型 | 描述或相应的监视元素 |
---|---|---|
storage_group_name | VARCHAR(128) | storage_group_name - 存储器组名称 |
storage_group_id | INTEGER | storage_group_id - 存储器组标识 |
DBPARTITIONNUM | SMALLINT | dbpartitionnum - 数据库分区号 |
db_storage_path | VARCHAR(256) | db_storage_path - 自动存储路径 |
DB_STORAGE_PATH_WITH_DPE | VARCHAR(256) | db_storage_path_with_dpe-带有数据库分区表达式的数据库存储路径 |
DB_STORAGE_PATH_STATE | VARCHAR(16) | db_storage_path_state - 存储路径状态 值是下列其中一项:
|
db_storage_path_id | BIGINT | db_storage_path_id - 存储路径标识 |
fs_id | VARCHAR (22) | fs_id - 唯一文件系统标识号 |
fs_total_size | BIGINT | fs_total_size - 文件系统总大小 |
fs_used_size | BIGINT | fs_used_size - 文件系统中的已用空间量 |
sto_path_free_size | BIGINT | sto_path_free_size - 自动存储路径可用空间 |