ALTER TABLE

Utilice el comando ALTER TABLE para cambiar la estructura de una tabla existente. Si una consulta activa está utilizando la tabla, el comando ALTER espera hasta que se complete la consulta.

Utilice el comando ALTER TABLE para:
  • Cambiar o descartar un valor predeterminado de columna. Los valores predeterminados que se establecen solo se aplican a comandos INSERT, no a filas que ya están en la tabla.
  • Cambiar el nombre de una columna o una tabla sin cambiar el tipo de datos o el tamaño dentro de la columna o tabla. Puede omitir la columna de la palabra clave.
  • Añadir o descartar una restricción de tabla o de columna. No se puede cambiar una restricción. En lugar de eso debe descartar la restricción y crear una nueva.
  • Modificar la longitud de una columna varchar.

Si un procedimiento almacenado hace referencia a una tabla, no se permite la adición o descarte de una columna. Primero debe descartar el procedimiento almacenado antes de ejecutar el comando ALTER TABLE y, a continuación, volver a crear el procedimiento almacenado después de que se modificara la tabla.

Sintaxis

Sintaxis para modificar una tabla:
ALTER TABLE <table> <action> [ORGANIZE ON {(<columns>) | NONE}]
Donde <action> puede ser una de las siguientes opciones:
ADD COLUMN <col> <type> [<col_constraint>][,…] |
ADD <table_constraint> |
ALTER [COLUMN] <col> { SET DEFAULT <value> | DROP DEFAULT } |
DROP [COLUMN] column_name[,column_name…] {CASCADE | RESTRICT } |
DROP CONSTRAINT <constraint_name> {CASCADE | RESTRICT} |
MODIFY COLUMN (<col> VARCHAR(<maxsize>)) |
OWNER TO <user_name> |
RENAME [COLUMN] <col> TO <new_col_name> |
RENAME TO <new_table> |
SET PRIVILEGES TO <table>
Donde <col_constraint> representa:
[ CONSTRAINT <constraint_name> ] 
{NOT NULL | NULL | UNIQUE | PRIMARY KEY | DEFAULT <value> | <ref>}
[ [ [ NOT ] DEFERRABLE ] { INITIALLY DEFERRED | INITIALLY IMMEDIATE } |
[ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] [ NOT ] DEFERRABLE ]
Donde <table_constraint> representa:
[ CONSTRAINT <constraint_name> ] 
{UNIQUE (<col>[,<col>…] ) |
PRIMARY KEY (<pkcol_name>[,<pkcol_name>…] ) |
FOREIGN KEY (<fkcol_name>[,<fkcol_name>…] ) <ref>}
[ [ [ NOT ] DEFERRABLE ] { INITIALLY DEFERRED | INITIALLY IMMEDIATE } |
[ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] [ NOT ] DEFERRABLE ]
Donde <ref> representa:
REFERENCES <reftable> [ (<refcol_name>[,<refcol_name>…] ) ]
[ MATCH FULL ]
[ ON UPDATE {CASCADE | RESTRICT | SET NULL | SET DEFAULT | NO ACTION} ]
[ ON DELETE {CASCADE | RESTRICT | SET NULL | SET DEFAULT | NO ACTION} ]

Entradas

El comando ALTER TABLE toma las siguientes entradas:

Tabla 1. Entradas de ALTER TABLE
Entrada Descripción
<table> Nombre de la tabla que se quiere modificar.
<action> Acción que se quiere realizar para la tabla especificada:
ADD COLUMN
Añada una columna. Esta entrada no se puede especificar en un bloque de transacción.
ADD <table_constraint>
Añada una restricción de tabla.
ALTER [COLUMN]
Cambie o descarte un valor predeterminado de columna.
DROP [COLUMN]
Descarte una columna. Las restricciones que dependen de la columna descartada también se descartan automáticamente. Esta entrada no se puede especificar en un bloque de transacción. No se puede descartar una columna de distribución, una columna “organize on” o la última columna restante de una tabla.

Si se descarta una columna y se desea reutilizar su nombre, antes hay que ejecutar el comando GROOM TABLE <tablename> VERSIONS; si no, pueden producirse errores.

DROP CONSTRAINT
Descarte una restricción.
MODIFY COLUMN
Cambie la longitud de una columna.
OWNER TO
Cambie el propietario de la tabla.
RENAME [COLUMN]
Cambie el nombre de una columna.
RENAME TO
Cambie el nombre de la tabla.
SET PRIVILEGES TO
Establezca los privilegios de la tabla modificada como los de otra tabla.
<col> Nombre de una columna.
<user_name> Nombre de un usuario.
<new_col_name> Nuevo nombre que dar a una columna.
<new_table> Nombre nuevo de la tabla.
ORGANIZE ON En qué columnas (de una a cuatro) se va a organizar la tabla. No se puede especificar para tablas externas. Si se especifican columnas, la tabla no puede tener ninguna vista materializada, y todos los tipos de datos de columna especificados se deben poder asignar a una zona. La reorganización de datos de la tabla surte efecto cuando se ejecuta GROOM TABLE. Para obtener más información, consulte "Uso de tablas base agrupadas" en IBM® Netezza® System Administrator's Guide.
<constraint_name> Nombre que desea dar a una restricción de columna o a una restricción de tabla. Si no se especifica ningún nombre, el sistema genera uno.
NOT DEFERRABLE | DEFERRABLE Controla si la restricción se puede aplazar hasta el final de la transacción. NOT DEFERRABLE es el valor predeterminado. Netezza Performance Server no admite la comprobación de restricciones ni la integridad referencial)
INITIALLY Especifica DEFERRED (al final de la transacción) o IMMEDIATE (al final de cada sentencia).
NOT NULL | NULL Especifica si la columna tiene permitido contener valores nulos. El valor predeterminado es NULL.
UNIQUE (restricción de columna y de tabla) Define si cada valor de la columna debe ser exclusivo.
PRIMARY KEY (restricción de columna y de tabla) Define si si las columnas especificadas deben formar la clave principal de la tabla.

Esta restricción es fundamentalmente una combinación de las restricciones UNIQUE y NOT NULL, pero identificar un conjunto de columnas como clave primaria también proporciona metadatos sobre el diseño del esquema. Una clave primaria implica que otras tablas pueden confiar en este conjunto de columnas como identificador exclusivo para filas.

Solo se puede especificar una restricción de clave primaria para una tabla, ya sea una restricción de columna o bien una restricción de tabla.

El conjunto de columnas que conforma la clave primaria debe ser diferente de todos los demás conjuntos de columnas nombrados en cualquier restricción exclusiva que esté definida para esta tabla.
DEFAULT (restricción de columna) El valor predeterminado que se colocará en cada fila de esta columna.
REFERENCES (restricción de columna) Las columnas especificadas de la nueva tabla deben contener únicamente valores que coincidan con valores de las columna especificadas de la tabla especificada.
Tabla FOREIGN KEY y REFERENCES (restricción de tabla) Las columnas especificadas de la nueva tabla deben contener únicamente valores que coincidan con valores de las columna especificadas de la tabla especificada. Si no se especifica ninguna columna, el valor debe coincidir con la clave primaria de la tabla. Las columnas especificadas de la tabla referenciada deben tener una restricción exclusiva o de clave primaria en dicha tabla.
MATCH FULL MATCH FULL impide que una columna de clave foránea de varias columnas sea nula si otras partes de la clave foránea no son nulas. Este es el valor predeterminado. MATCH PARTIAL no se admite.
ON UPDATE | ON DELETE La acción que se realiza cuando la tabla o las columnas especificadas se actualicen o se supriman:
SIN ACCIÓN
Emite un error si se vulnera la clave foránea. Este es el valor predeterminado.
RESTRICT
Igual que NO ACTION.
CASCADE
Suprime cualquier fila que haga referencia a la fila suprimida.
SET NULL
Establece los valores de la columna de referencia a su valor predeterminado.
SET DEFAULT
Establece los valores de la columna de referencia a su valor predeterminado.

Resultados

El comando ALTER TABLE produce las siguientes salidas:

Tabla 2. Salidas de ALTER TABLE
Resultado Descripción
ALTER El comando se ha ejecutado correctamente.
ERROR la tabla o la columna especificada no está disponible.

Privilegios

Es necesario ser el usuario administrativo, el propietario de la tabla o el propietario de la base de datos o el esquema en el que se define la tabla, o la cuenta debe tener el privilegio Alter para la tabla o para la clase de objeto Table. Si está cambiando el propietario de la tabla, hay que tener el acceso List para la cuenta de usuario.

Uso

A continuación se proporciona el uso de muestra:
  • Descartar el valor predeterminado de la columna a:
    MYDB.SCH1(USER)=> ALTER TABLE distributors ALTER COLUMN address DROP
DEFAULT;
  • Cambiar la longitud de varchar para una columna:
    MYDB.SCH1(USER)=> ALTER TABLE t3 MODIFY COLUMN (col1 VARCHAR(6));
  • Cambiar el nombre de una columna:
    MYDB.SCH1(USER)=> ALTER TABLE distributors RENAME COLUMN address TO
city;
  • Cambiar el nombre de una tabla:
    MYDB.SCH1(USER)=> ALTER TABLE distributors RENAME TO suppliers;
  • Cambiar el propietario de la tabla:
    MYDB.SCH1(USER)=> ALTER TABLE distributors OWNER TO carmen;
  • Cambiar los privilegios a los que se hayan establecido para otra tabla:
    MYDB.SCH1(USER)=> ALTER TABLE distributors SET PRIVILEGES TO suppliers;
  • Añadir una restricción:
    MYDB.SCH1(USER)=> ALTER TABLE distributors ADD CONSTRAINT empkey
PRIMARY KEY(col1) INITIALLY IMMEDIATE;
  • Descartar una restricción:
    MYDB.SCH1(USER)=> ALTER TABLE distributors DROP CONSTRAINT empkey
CASCADE;