sp_iqdbspace Procedure

Displays detailed information about each IQ dbspace.

Syntax

sp_iqdbspace [ dbspace-name ]

Permissions

DBA authority required. Users without DBA authority must be granted EXECUTE permission to run the stored procedure.

Description

You can use the information from sp_iqdbspace to determine whether data must be moved, and for data that has been moved, whether the old versions have been deallocated. sp_iqdbspace displays this information:

sp_iqdbspace columns
Column name	Description
DBSpaceName	Name of the dbspace as specified in the CREATE DBSPACE statement. Dbspace names are always case-insensitive, regardless of the CREATE DATABASE...CASE IGNORE or CASE RESPECT specification.
DBSpaceType	Type of the dbspace (`MAIN`, `SHARED_TEMP`, or `TEMPORARY`).
Writable	T (writable) or F (not writable).
Online	T (online) or F (offline).
Usage	Percent of dbspace currently in use by all files in the dbspace.
TotalSize	Total size of all files in the dbspace in the units B (bytes), K (kilobytes), M (megabytes), G (gigabytes), T (terabytes), or P (petabytes).
Reserve	Total reserved space that can be added to all files in the dbspace.
NumFiles	Number of files in the dbspace.
NumRWFiles	Number of read/write files in the dbspace.
Stripingon	T (On) or F (Off).
StripeSize	Amount of data written to the dbspace before moving to the next dbspace, if disk striping is on.
BlkTypes	Space used by both user data and internal system structures.
OkToDrop	‘Y’ indicates the dbspace can be dropped; otherwise ‘N’.

Values of the BlkTypes block type identifiers:

sp_iqdbspace block types
Identifier	Block type
A	Active Version
B	Backup Structures
C	Checkpoint Log
D	Database Identity
F	Free list
G	Global Free list Manager
H	Header Blocks of the free list
I	Index advice storage
M	Multiplex CM*
O	Old Version
T	Table use
U	Index use
N	Column use
X	Drop at checkpoint

*The multiplex commit identity block (actually 128 blocks) exists in all IQ databases, even though it is not used by simplex databases.

For information on multiplex capability, see Using Sybase IQ Multiplex > Multiplex Reference > System Procedures > sp_iqdbspace Procedure.

Example

The following output displays information about dbspaces.

sp_iqdbspace;

Note: The following example shows objects in the iqdemo database to better illustrate output. Note that iqdemo includes a sample user dbspace named iq_main that may not be present in your own databases.

DBSpaceName	DBSpaceType	Writable	Online	Usage	Total Size	Reserve	NumFiles	NumRWFiles	Stripingon	Stripe Size	Blk Types	OkTo Drop
IQ_MAIN	MAIN	T	T	55	75M	200M	1	1	T	1K	1H, 5169A, 190	N
IQ__ SYSTEM_ MAIN	MAIN	T	T	21	300M	50M	1	1	F	8K	1H, 7648F, 32D, 128M	N
IQ_SYSTEM_ TEMP	TEMPORARY	T	T	1	100M	50M	1	1	F	8K	1H, 64F, 32A	N