ALTER SCHEMA

Utilice el comando ALTER SCHEMA para cambiar las propiedades de un esquema, como su vía de acceso, su nombre o su usuario de autorización. No se puede modificar un esquema si se está accediendo a él en otra sesión. No se puede modificar un esquema para moverlo de una base de datos a otra.

Sintaxis

Sintaxis del comando ALTER SCHEMA:

ALTER SCHEMA [<database_name>.]<schema_name> 
  { AUTHORIZATION TO <username> | 
    RENAME TO [<database_name>.]<new_name> |
    SET PATH '<schema_path>' |
    DATA_VERSION_RETENTION_TIME <number-of-days> NOCASCADE}

Entradas

El comando ALTER SCHEMA toma las siguientes entradas:

Tabla 1. Entradas de ALTER SCHEMA
Entrada	Descripción
<nombre_base_datos>	El nombre de base de datos donde se define el esquema. El valor predeterminado es la base de datos actual.
<schema_name>	El nombre del esquema.
<new_name>	Nombre de esquema cambiado. Tenga en cuenta que no puede mover el esquema a una base de datos diferente.
AUTHORIZATION TO <user_name>	El usuario de autorización, o propietario, del esquema. El nombre debe existir ya en el sistema.
RENAME TO <new_name>	Nombre nuevo del esquema.
SET PATH <schema_path>	La lista de nombres de esquema en la que busca el sistema para resolver nombres de rutina no calificados, como nombres de funciones, procedimientos almacenados y objetos definidos por el usuario, como funciones, agregados y bibliotecas. Un nombre de esquema que no sea completo (es decir, que no incluya un prefijo de base de datos) está en la base de datos actual. Si se modifica la vía de acceso en su totalidad, es necesario especificar un vía de acceso completamente nueva; no es posible añadir un esquema a la vía de acceso ni suprimir un esquema de la vía de acceso.
DATA_VERSION_RETENTION_TIME <número de días> NOCASCADE	Actualiza el valor de DATA_VERSION_RETENTION_TIME para el esquema dado. El nuevo valor no afecta a las tablas existentes en la base de datos. Pero, el nuevo valor determina el valor por defecto que es heredado por un comando CREATE TABLE posterior en el esquema que en no especifica explícitamente esta propiedad. El valor máximo permitido es de 92 días, que es el número máximo de días de un trimestre natural.

Resultados

El comando ALTER SCHEMA produce las siguientes salidas:

Tabla 2. Salidas de ALTER SCHEMA
Resultado	Descripción
`ALTER SCHEMA`	El comando se ha ejecutado correctamente.
`ERROR: ALTER SCHEMA: schema "schemaname" is being accessed by other users`	Otros usuarios están utilizando el esquema.

Privilegios

Es necesario ser el usuario administrativo o el propietario de la base de datos o el esquema en el que reside el esquema, o la cuenta debe tener el privilegio Alter para el esquema o para la clase de objeto Schema. Si se está cambiando el usuario de autorización, hay que tener el acceso List para ese usuario. El sistema Netezza Performance Server debe estar configurado para soportar múltiples esquemas. Para obtener más información sobre la activación de la compatibilidad con esquemas múltiples, consulte IBM® Netezza® System Administrator's Guide.