ALTER TEMPLATE - Amazon Redshift
Privilégios obrigatóriosSintaxeParâmetrosExemplos

O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a publicação de blog .

ALTER TEMPLATE

Altera a definição de um modelo existente. Use esse comando para renomear um modelo, alterar o proprietário de um modelo, adicionar ou remover parâmetros da definição do modelo ou definir valores de parâmetro.

Privilégios obrigatórios

Para alterar um modelo, é necessário ter uma das seguintes opções:

  • Privilégios de superusuário.

  • O privilégio ALTER TEMPLATE e o privilégio USAGE no esquema que contém o modelo.

Sintaxe

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 , ...]
};

Parâmetros

database_name

(Opcional) O nome do banco de dados no qual o modelo é criado. Se não especificado, será usado o banco de dados atual.

schema_name

(Opcional) O nome do esquema no qual o modelo é criado. Se não for especificado, o modelo será pesquisado no caminho de pesquisa atual.

template_name

O nome do modelo a ser alterado.

RENAME TO

Uma cláusula que renomeia o modelo.

new_name

O novo nome do modelo. Para obter mais informações sobre nomes válidos, consulte Nomes e identificadores.

OWNER TO

Cláusula que altera o proprietário do modelo.

new_owner

O novo proprietário do modelo.

ADD parameter [AS] [value]

Adiciona um novo parâmetro ao modelo.

  • Para parâmetros somente de palavras-chave (como CSV ou GZIP), especifique apenas o nome do parâmetro.

  • Para parâmetros que exigem valores, especifique o nome do parâmetro seguido do valor. Opcionalmente, é possível incluir AS entre o parâmetro e o valor.

DROP parameter

Remove o parâmetro especificado do modelo. Não é possível eliminar vários parâmetros com um único comando DROP.

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

Atualiza os valores de parâmetro de modelo existentes. Use somente para parâmetros que já tenham valores. Vários parâmetros podem ser atualizados em um único comando.

Exemplos

O exemplo a seguir muda o nome do modelo test_template para demo_template.

ALTER TEMPLATE test_template
RENAME TO demo_template;

O exemplo a seguir atribui a propriedade do esquema demo_template ao usuário bob.

ALTER TEMPLATE demo_template
OWNER TO bob;

O exemplo a seguir adiciona o parâmetro CSV ao modelo demo_template.

ALTER TEMPLATE demo_template
ADD CSV;

O exemplo a seguir adiciona o parâmetro TIMEFORMAT 'auto' ao modelo demo_template.

ALTER TEMPLATE demo_template
ADD TIMEFORMAT 'auto';

O exemplo a seguir remove o parâmetro ENCRYPTED do modelo demo_template.

ALTER TEMPLATE demo_template
DROP ENCRYPTED;

O seguinte exemplo define o DELIMITER parâmetro como '|' e o parâmetro TIMEFORMAT como 'epochsecs':

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