ALTER ONLINE FEATURE TABLE

Modifica as propriedades de uma :doc:` tabela de recursos on-line </sql-reference/sql/create-online-feature-table>` existente.

Consulte também:

CREATE ONLINE FEATURE TABLE, DESCRIBE ONLINE FEATURE TABLE, DROP ONLINE FEATURE TABLE, SHOW ONLINE FEATURE TABLES

Sintaxe

ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> { SUSPEND | RESUME } ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> RENAME TO <new_name> ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> REFRESH ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> SET COMMENT = '<string_literal>' ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> SET [ TARGET_LAG = '<num> { seconds | minutes | hours | days }' ] [ WAREHOUSE = <warehouse_name> ] ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> <tagAction> 
Copy

Parâmetros

name

Especifica o identificador da tabela de recursos on-line a ser alterada.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

RENAME TO new_name

Altera o nome da tabela de recursos on-line para new_name. O novo identificador deve ser único para o esquema.

Para obter mais detalhes sobre os identificadores de, consulte Requisitos para identificadores.

Quando um objeto é renomeado, outros objetos que fazem referência a ele devem ser atualizados com o novo nome.

SUSPEND | RESUME

Especifica se as atualizações periódicas em segundo plano dos dados na tabela serão suspensas ou retomadas.

SUSPEND

Suspende as atualizações periódicas em segundo plano da tabela de recursos on-line.

RESUME

Retoma as atualizações periódicas em segundo plano da tabela de recursos on-line.

REFRESH

Especifica que a tabela de recursos on-line deve ser atualizada manualmente.

SET ...

Define uma ou mais propriedades ou parâmetros específicos para a tabela de recursos on-line:

TARGET_LAG = 'num { seconds | minutes | hours | days }'

Especifica o novo atraso de destino a ser utilizado para definir a programação das atualizações em segundo plano.

Deve ser um valor entre 10 segundos e 8 dias, inclusive.

WAREHOUSE = warehouse_name

Especifica o nome do novo warehouse que fornece os recursos de computação para atualizar a tabela de recursos on-line.

COMMENT = 'string_literal'

Adiciona um comentário ou sobrescreve um comentário existente para a tabela de recursos on-line.

tagAction

Define ou remove a tag na tabela de recursos on-line:

tagAction ::= { SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] | UNSET TAG <tag_name> [ , <tag_name> ... ] } 
Copy
SET TAG

Define a tag e o valor da tag especificados na tabela de recursos on-line.

UNSET TAG

Remove a tag especificada na tabela de recursos on-line.

Requisitos de controle de acesso

Privilégio

Objeto

Notas

OWNERSHIP

Tabela de recursos on-line

Função que tem o privilégio OWNERSHIP na tabela de recursos on-line.

USAGE

Warehouse

Necessário ao alterar o warehouse

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Exemplos

O exemplo a seguir suspende as atualizações periódicas em segundo plano para a tabela de recursos on-line chamada my_online_feature_table:

ALTER ONLINE FEATURE TABLE my_online_feature_table SUSPEND; 
Copy

O exemplo a seguir atualiza manualmente a tabela de recursos on-line chamada my_online_feature_table:

ALTER ONLINE FEATURE TABLE my_online_feature_table REFRESH; 
Copy

O exemplo a seguir altera o atraso de destino para a tabela de recursos on-line chamada my_online_feature_table:

ALTER ONLINE FEATURE TABLE my_online_feature_table SET TARGET_LAG = '1 minute'; 
Copy

O exemplo a seguir altera o nome da tabela de recursos on-line my_online_feature_table para my_new_online_feature_table:

ALTER ONLINE FEATURE TABLE my_online_feature_table RENAME TO my_new_online_feature_table; 
Copy