Allowed Dbspace Transformations

Your ability to change a dbspace configuration depends on the type of alter operation and certain attributes of the dbspace. Alter operations are governed by the state of the dbspace (online or offline), the read-write status of the dbspace, and the type of dbspace.

Allowed Dbspace Configuration Transformations
State Alter Type Allowed for User Main Allowed for IQ_SHARED_TEMP, IQ_SYSTEM_MAIN, or IQ_SYSTEM_TEMP
       
Online dbspace      
  ALTER DBSPACE OFFLINE Yes, if RO No
  ALTER DBSPACE ONLINE No Yes for IQ_SYSTEM_MAIN, No for IQ_SHARED_TEMP and IQ_SYSTEM_TEMP
  ALTER DBSPACE READONLY Yes, if it is RW No
  ALTER DBSPACE READWRITE Yes, if it is RO No
  ALTER STRIPING or STRIPESIZEKB Yes Yes on simplex and on multiplex coordinator
  RENAME DBSPACE Yes No
  ADD FILE Yes Yes
  DROP FILE Yes, if empty and RO Yes, if empty and RO. Dropping files in IQ_SHARED_TEMP requires that this operation be done only on the coordinator once it is started in a single-node mode. Dropping files in IQ_SHARED_TEMP in simplex is also supported. The first file that is made RW in IQ_SHARED_TEMP must be the last file to be dropped.
  ALTER FILE READONLY Yes, if RW Yes, if RW and not the last RW dbfile. Making files in IQ_SHARED_TEMP read-only is not allowed.
  ALTER FILE READWRITE Yes, if RO Yes, if RO
  ALTER FILE SIZE Yes, if RW dbspace and dbfile Yes, if RW
  ALTER FILE RENAME LOGICAL NAME Yes Yes
  ALTER FILE RENAME PATH No Yes for IQ_SHARED_TEMP and IQ_SYSTEM_TEMP; takes effect when database restarts. No for IQ_SYSTEM_MAIN.
       
Offline dbspace      
  ALTER DBSPACE OFFLINE No N/A
  ALTER DBSPACE ONLINE Yes N/A
  ALTER DBSPACE READONLY No N/A
  ALTER DBSPACE READWRITE No N/A
  ALTER STRIPING or STRIPESIZEKB Yes N/A
  RENAME DBSPACE Yes N/A
  ADD FILE No N/A
  DROP FILE Yes, if empty N/A
  ALTER FILE RO Yes N/A
  ALTER FILE RW Yes N/A
  ALTER FILE SIZE No N/A
  ALTER FILE RENAME LOGICAL NAME Yes N/A
  ALTER FILE RENAME PATH Yes N/A
       
Dynamically offline dbspace      
  ALTER DBSPACE OFFLINE Yes, if RO N/A
  ALTER DBSPACE ONLINE Yes N/A for IQ_SYSTEM_MAIN and IQ_SYSTEM_TEMP, Yes for IQ_SHARED_TEMP
  ALTER DBSPACE READONLY Yes, if RW N/A
  ALTER DBSPACE READWRITE No N/A
  ALTER STRIPING or STRIPESIZEKB Yes N/A
  RENAME DBSPACE Yes N/A
  ADD FILE No N/A
  DROP FILE Yes, if empty N/A
  ALTER FILE READONLY No N/A
  ALTER FILE READWRITE No N/A
  ALTER FILE SIZE No N/A
  ALTER FILE RENAME LOGICAL NAME Yes N/A
  ALTER FILE RENAME PATH No N/A
       
Read-only dbspace      
  ALTER DBSPACE OFFLINE Yes, if online N/A
  ALTER DBSPACE ONLINE Yes, if offline N/A
  ALTER DBSPACE READONLY No N/A
  ALTER DBSPACE READWRITE Yes, if online N/A
  ALTER STRIPING and STRIPESIZEKB Yes N/A
  RENAME DBSPACE Yes N/A
  ADD FILE Yes N/A
  DROP FILE Yes, if empty N/A
  ALTER FILE READONLY Yes, if RW N/A
  ALTER FILE READWRITE Yes, if RO N/A
  ALTER FILE SIZE No N/A
  ALTER FILE RENAME LOGICAL NAME Yes N/A
  ALTER FILE RENAME PATH Yes, if offline N/A
       
Read-write dbspace      
  ALTER DBSPACE OFFLINE No No
  ALTER DBSPACE ONLINE Yes, if dynamically offline No for IQ_SYSTEM_MAIN and IQ_SYSTEM_TEMP, Yes if dynamically offline for IQ_SHARED_TEMP
  ALTER DBSPACE READONLY Yes No
  ALTER DBSPACE READWRITE No No
  ALTER STRIPING and STRIPESIZEKB Yes Yes
  RENAME DBSPACE Yes No
  ADD FILE Yes Yes
  DROP FILE Yes, if empty Yes, if empty and RO. Dropping files in IQ_SHARED_TEMP requires that this operation be done only on the coordinator once it is started in a single-node mode. Dropping files in IQ_SHARED_TEMP in simplex is also supported. The first file that is made RW in IQ_SHARED_TEMP must be the last file dropped.
  ALTER FILE READONLY Yes, if RW Yes, if RW. Making files in IQ_SHARED_TEMP readonly is not allowed.
  ALTER FILE READWRITE Yes, if RO Yes, if RO
  ALTER FILE SIZE Yes, if RW Yes, if RW
  ALTER FILE RENAME LOGICAL NAME Yes Yes
  ALTER FILE RENAME PATH No Yes, takes effect when database restarts
       
Read-only file      
  ALTER FILE READONLY No No
  ALTER FILE READWRITE Yes Yes
  ALTER FILE SIZE No No
  ALTER FILE RENAME LOGICAL NAME Yes Yes
  ALTER FILE RENAME PATH Yes, if offline Yes, takes effect when database restarts
       
Read-write file      
  ALTER FILE READONLY Yes Yes
  ALTER FILE READWRITE No No
  ALTER FILE SIZE Yes, if dbspace is RW and ONLINE Yes
  ALTER FILE RENAME LOGICAL NAME Yes Yes
  ALTER FILE RENAME PATH No Yes, takes effect when database restarts
Note:
  • Dynamically offline means the dbspace is marked offline in memory, as opposed to marked offline in the catalog.
  • A read-only (RO) IQ_SYSTEM_MAIN dbfile can be dynamically offline.
  • For IQ_SYSTEM_MSG, the only modification that is permitted is to rename the path, which is done using the command ALTER DBSPACE IQ_SYSTEM_MSG RENAME 'filepath'.