ALTER TEMPLATE - Amazon Redshift

Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del parche 198. Las UDF de Python existentes seguirán funcionando hasta el 30 de junio de 2026. Para obtener más información, consulte la publicación del blog.

ALTER TEMPLATE

Cambia la definición de una plantilla existente. Utilice este comando para cambiar el nombre de una plantilla, cambiar el propietario de una plantilla, añadir o eliminar parámetros de la definición de la plantilla, o establecer valores de parámetros.

Privilegios necesarios

Para modificar una plantilla, debe tener una de las siguientes opciones:

  • Privilegios de superusuario

  • Privilegio ALTER TEMPLATE y privilegio USAGE sobre el esquema que contiene la plantilla.

Sintaxis

ALTER TEMPLATE [database_name.][schema_name.]template_name { RENAME TO new_name | OWNER TO new_owner | ADD parameter [AS] [value] | DROP parameter | SET parameter TO value1 [, parameter2 TO value2 , ...] };

Parameters

database_name

(Opcional) El nombre de la base de datos en la que se crea la plantilla. Si no se especifica, se utiliza la base de datos actual.

schema_name

(Opcional) El nombre del esquema en el que se crea la plantilla. Si no se especifica, la plantilla se busca en la ruta de búsqueda actual.

template_name

El nombre de la plantilla que se va a modificar.

RENAME TO

Una cláusula que cambia el nombre de la plantilla.

new_name

El nuevo nombre de la plantilla. Para obtener más información acerca de los nombres válidos, consulte Nombres e identificadores.

OWNER TO

Una cláusula que cambia el propietario de la plantilla.

new_owner

El nuevo propietario de la plantilla.

ADD parameter [AS] [value]

Añade un nuevo parámetro a la plantilla.

  • Para los parámetros que solo admiten palabras clave (como CSV o GZIP), especifique únicamente el nombre del parámetro.

  • Para los parámetros que requieren valores, especifique el nombre del parámetro seguido del valor. Si lo desea, puede incluir AS entre el parámetro y el valor.

DROP parameter

Quita el parámetro especificado de la plantilla. No se pueden eliminar varios parámetros con un solo comando DROP.

SET parameter TO value1 [, parameter2 TO value2 , …]

Actualiza los valores de los parámetros de plantilla existentes. Úselo solo para los parámetros que ya tienen valores. Se pueden actualizar varios parámetros en un mismo comando.

Ejemplos

En el siguiente ejemplo, se cambia el nombre de la plantilla test_template a demo_template.

ALTER TEMPLATE test_template RENAME TO demo_template;

En el siguiente ejemplo se otorga la propiedad del esquema demo_template al usuario bob.

ALTER TEMPLATE demo_template OWNER TO bob;

En el siguiente ejemplo se agrega un parámetro CSV a la plantilla demo_template.

ALTER TEMPLATE demo_template ADD CSV;

En el siguiente ejemplo se agrega un parámetro TIMEFORMAT 'auto' a la plantilla demo_template.

ALTER TEMPLATE demo_template ADD TIMEFORMAT 'auto';

En el siguiente ejemplo se elimina el parámetro ENCRYPTED de la plantilla demo_template.

ALTER TEMPLATE demo_template DROP ENCRYPTED;

En el siguiente ejemplo, se establece el parámetro DELIMITER en '|' y el parámetro TIMEFORMAT en 'epochsecs':

ALTER TEMPLATE demo_template SET DELIMITER TO '|', TIMEFORMAT TO 'epochsecs';