Mandato LIST TABLESPACES

El mandato LIST TABLESPACES lista los espacios de tabla e información sobre los espacios de tabla para la base de datos actual.

Importante: Este comando o API ha sido obsoleto y podría ser eliminado en una futura versión. En su lugar, pueden utilizarse las funciones de tabla MON_GET_TABLESPACE y MON_GET_CONTAINER, que devuelven más información. Para obtener más información, consulte Los mandatos LIST TABLESPACES y LIST TABLESPACE CONTAINERS han quedado en desuso.

La información visualizada por este mandato también está disponible en la instantánea de espacios de tablas.

Ámbito

Este mandato solo devuelve información para la partición de base de datos en la que se ejecuta.

Autorización

Una de las autorizaciones siguientes:
  • SYSADM
  • SYSCTRL
  • SYSMAINT
  • SYSMON
  • DBADM
  • Autorización LOAD

Conexión necesaria

Base de datos

Sintaxis del mandato

Read syntax diagramSkip visual syntax diagramLIST TABLESPACESSHOW DETAIL

Parámetros del mandato

SHOW DETAIL
Si no se especifica esta opción, solo se proporcionará la información básica siguiente acerca de cada espacios de tablas:
  • ID de espacio de tablas
  • Nombre
  • Tipo (espacio gestionado por el sistema o espacio gestionado por la base de datos)
  • Contenido (datos cualesquiera, datos largos o de índice o datos temporales)
  • Estado, valor hexadecimal que indica el estado actual del espacio de tablas. El estado visible externamente de un espacio de tablas se compone de la suma hexadecimal de determinados valores de estado. Por ejemplo, si el estado es "inmovilizada: EXCLUSIVE" y "Carga pendiente", el valor es 0x0004 + 0x0008, que es 0x000c. El mandato db2tbst (Obtener estado de espacios de tablas) puede utilizarse para obtener el estado de espacio de tablas que se asocia a un valor hexadecimal determinado. He aquí las definiciones de bit listadas en sqlutil.h:
       0x0          Normal
       0x1          Quiesced: SHARE
       0x2          Quiesced: UPDATE
       0x4          Quiesced: EXCLUSIVE
       0x8          Load pending
       0x10         Delete pending
       0x20         Backup pending
       0x40         Roll forward in progress
       0x80         Roll forward pending
       0x100        Restore pending
       0x100        Recovery pending (not used)
       0x200        Disable pending
       0x400        Reorg in progress
       0x800        Backup in progress
       0x1000       Storage must be defined
       0x2000       Restore in progress
       0x4000       Offline and not accessible
       0x8000       Drop pending
       0x10000      Suspend Write
       0x20000      Load in progress
       0x2000000    Storage may be defined
       0x4000000    StorDef is in 'final' state
       0x8000000    StorDef was change before roll forward
       0x10000000   DMS rebalance in progress
       0x20000000   Table space deletion in progress
       0x40000000   Table space creation in progress
    
    Nota: Db2® LOAD no establece el estado del espacio de tablas en Load pending o Delete pending.
Si se especifica esta opción, se proporciona la información adicional siguiente acerca de cada espacios de tablas:
  • Número total de páginas
  • Número de páginas utilizables
  • Número de páginas utilizadas
  • Número de páginas libres
  • marca de límite superior (en páginas)
  • Tamaño de página (en bytes)
  • Tamaño de extensión (en páginas)
  • Tamaño captación previa (en páginas)
  • Número de contenedores
  • Tiempo mínimo de recuperación (punto más alejado en el tiempo hasta el que puede avanzarse una tabla; la indicación de fecha y hora se expresa en formato de hora UTC, y solo se visualiza si no es cero)
  • ID de espacio de tablas de cambio de estado (solo se visualiza si el estado del espacio de tablas es "carga pendiente" o "supresión pendiente")
  • ID de objeto de cambio de estado (solo se visualiza si el estado del espacio de tablas es "carga pendiente" o "supresión pendiente")
  • Número de inmovilizadores (solo se visualiza si el estado del espacio de tablas es "inmovilizada: SHARE", "inmovilizada: UPDATE" o "inmovilizada: EXCLUSIVE")
  • ID de espacio de tablas e ID de objeto para cada inmovilizador (solo se visualiza si el número de inmovilizadores es mayor que cero).

ejemplos

A continuación se muestran dos ejemplos de salida de LIST TABLESPACES SHOW DETAIL.

 
           Tablespaces for Current Database
 Tablespace ID                        = 0
 Name                                 = SYSCATSPACE
 Type                                 = Database managed space
 Contents                             = Any data
 State                                = 0x0000
   Detailed explanation:
     Normal
 Total pages                          = 895
 Useable pages                        = 895
 Used pages                           = 895
 Free pages                           = Not applicable
 High water mark (pages)              = Not applicable
 Page size (bytes)                    = 4096
 Extent size (pages)                  = 32
 Prefetch size (pages)                = 32
 Number of containers                 = 1

 Tablespace ID                        = 1
 Name                                 = TEMPSPACE1
 Type                                 = System managed space
 Contents                             = Temporary data
 State                                = 0x0000
   Detailed explanation:
     Normal
 Total pages                          = 1
 Useable pages                        = 1
 Used pages                           = 1
 Free pages                           = Not applicable
 High water mark (pages)              = Not applicable
 Page size (bytes)                    = 4096
 Extent size (pages)                  = 32
 Prefetch size (pages)                = 32
 Number of containers                 = 1

 Tablespace ID                        = 2
 Name                                 = USERSPACE1
 Type                                 = Database managed space
 Contents                             = Any data
 State                                = 0x000c
   Detailed explanation:
     Quiesced: EXCLUSIVE
     Load pending
 Total pages                          = 337
 Useable pages                        = 337
 Used pages                           = 337
 Free pages                           = Not applicable
 High water mark (pages)              = Not applicable
 Page size (bytes)                    = 4096
 Extent size (pages)                  = 32
 Prefetch size (pages)                = 32
 Number of containers                 = 1
 State change tablespace ID           = 2
 State change object ID               = 3
 Number of quiescers                  = 1
   Quiescer 1:
     Tablespace ID                    = 2
     Object ID                        = 3
DB21011I  In a partitioned database server environment, only the table spaces
on the current node are listed.
 
           Tablespaces for Current Database
 Tablespace ID                        = 0
 Name                                 = SYSCATSPACE
 Type                                 = System managed space
 Contents                             = Any data
 State                                = 0x0000
   Detailed explanation:
     Normal
 Total pages                          = 1200
 Useable pages                        = 1200
 Used pages                           = 1200
 Free pages                           = Not applicable
 High water mark (pages)              = Not applicable
 Page size (bytes)                    = 4096
 Extent size (pages)                  = 32
 Prefetch size (pages)                = 32
 Number of containers                 = 1

 Tablespace ID                        = 1
 Name                                 = TEMPSPACE1
 Type                                 = System managed space
 Contents                             = Temporary data
 State                                = 0x0000
   Detailed explanation:
     Normal
 Total pages                          = 1
 Useable pages                        = 1
 Used pages                           = 1
 Free pages                           = Not applicable
 High water mark (pages)              = Not applicable
 Page size (bytes)                    = 4096
 Extent size (pages)                  = 32
 Prefetch size (pages)                = 32
 Number of containers                 = 1

Tablespace ID                         = 2
 Name                                 = USERSPACE1
 Type                                 = System managed space
 Contents                             = Any data
 State                                = 0x0000
   Detailed explanation:
     Normal
 Total pages                          = 1
 Useable pages                        = 1
 Used pages                           = 1
 Free pages                           = Not applicable
 High water mark (pages)              = Not applicable
 Page size (bytes)                    = 4096
 Extent size (pages)                  = 32
 Prefetch size (pages)                = 32
 Number of containers                 = 1

Tablespace ID                         = 3
 Name                                 = DMS8K
 Type                                 = Database managed space
 Contents                             = Any data
 State                                = 0x0000
   Detailed explanation:
     Normal
 Total pages                          = 2000
 Useable pages                        = 1952
 Used pages                           = 96
 Free pages                           = 1856
 High water mark (pages)              = 96
 Page size (bytes)                    = 8192
 Extent size (pages)                  = 32
 Prefetch size (pages)                = 32
 Number of containers                 = 2

Tablespace ID                         = 4
 Name                                 = TEMP8K
 Type                                 = System managed space
 Contents                             = Temporary data
 State                                = 0x0000
   Detailed explanation:
     Normal
 Total pages                          = 1
 Useable pages                        = 1
 Used pages                           = 1
 Free pages                           = Not applicable
 High water mark (pages)              = Not applicable
 Page size (bytes)                    = 8192
 Extent size (pages)                  = 32
 Prefetch size (pages)                = 32
 Number of containers                 = 1
DB21011I  In a partitioned database server environment, only the table spaces
on the current node are listed.

Notas de uso

En un entorno de base de datos particionada, este mandato no devuelve todos los espacios de tablas en la base de datos. Para obtener una lista de todos los espacios de tablas, consulte SYSCAT.TABLESPACES.

Cuando se emite el mandato LIST TABLESPACES SHOW DETAIL , intentará liberar todas las extensiones libres pendientes en el espacio de tablas. Si las extensiones libres pendientes se liberan correctamente, se grabará una anotación cronológica.

Durante un reequilibrado de espacios de tablas, el número de páginas utilizables incluirá páginas para el contenedor recién añadido, pero estas páginas nuevas no se reflejarán en el número de páginas libres hasta que el reequilibrado se haya completado. Cuando no haya un reequilibrado de espacio de tablas en curso, el número de páginas utilizadas más el número de páginas libres será igual al número de páginas utilizables.

Para obtener información adicional acerca de los estados de espacios de tablas, consulte la sección Enlaces relacionados.