IBM PureData System for Analytics, Version 7.1

ALTER SESSION

Utilice el comando ALTER SESSION para anular la transacción activa en una sesión, para establecer la prioridad de una sesión o para añadir una etiqueta a una sesión o quitarla de ella.

Sintaxis

Sintaxis para anular una transacción en una sesión:

ALTER SESSION [<session_id>] ROLLBACK TRANSACTION

Sintaxis para establecer la prioridad de una sesión:

ALTER SESSION [<session_id>] SET PRIORITY TO <priority>

Sintaxis para añadir una etiqueta a una sesión o para eliminarla de ella:

ALTER SESSION [<session_id>] {ADD | REMOVE} TAG <tag>

Entradas

El comando ALTER SESSION toma las siguientes entradas:

Tabla 1. Entradas de ALTER SESSION
Entrada	Descripción
<session_id>	ID de una sesión activa. Si no se especifica ningún ID de sesión, el comando se aplica a la sesión actual.
<priority>	Nivel de prioridad al que se desea establecer la sesión (CRITICAL, HIGH, NORMAL o LOW).
<tag>	La etiqueta que se quiere añadir a la sesión o eliminar de ella.

Salidas

El comando ALTER SESSION produce las siguientes salidas:

Tabla 2. Salidas de ALTER SESSION
Salida	Descripción
`ALTER SESSION`	El comando se ha ejecutado correctamente.
`ERROR: permission denied`	El usuario no tiene permiso para emitir el comando para la sesión.
`ERROR: request exceeds maximum priority limit.`	El usuario ha intentado subir la prioridad de la sesión más allá del límite de prioridad máximo.
`ERROR: id '<session_id>' does not correspond to an existing session.`	No existe ninguna sesión con el ID indicado.
`ERROR: system session id '<session_id>' cannot be aborted`	El ID de sesión indicado hace referencia a una sesión del sistema. Un usuario no puede retrotraer una transacción de una sesión del sistema.
`ERROR: access denied. You must have ABORT privileges to perform this action`	El usuario no tiene permiso para retrotraer la transacción de la sesión.
`ERROR: session abort failed for session <session_id>; reason is '<reason>'`	Se ha encontrado un error en el intento de retrotraer la transacción activa de la sesión indicada por la razón indicada.

Privilegios

Cada sesión es propiedad de un usuario:

En el caso de una sesión que sea de su propiedad:
- Para retrotraer la transacción activa, establecer su prioridad al máximo o eliminar o añadir una etiqueta, no necesita ningún privilegio especial.
- Para establecer la prioridad en un nivel que supere el máximo, es necesario ser el usuario administrativo o tener el privilegio Manage System.
En el caso de una sesión que sea propiedad de otro usuario:
- Para cambiar la prioridad de la sesión o para añadir o eliminar una etiqueta, es necesario ser el usuario administrativo o tener el privilegio Manage System.
- Para retrotraer la transacción activa, es necesario tener el privilegio Abort para el propietario de la sesión.

Uso

Los ejemplos siguientes ilustran cómo:

Cambiar la prioridad de la sesión actual a CRITICAL:

   system(admin)=> ALTER SESSION SET PRIORITY TO CRITICAL;

Retrotraer la transacción activa de la sesión 16011:

   system(admin)=> ALTER SESSION 16011 ROLLBACK TRANSACTION;

Añadir la etiqueta no_more_than_2 a la sesión 16011:

   system(admin)=> ALTER SESSION 16011 ADD TAG no_more_than_2;