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> Parâmetros¶
nameEspecifica 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_nameAltera 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 | RESUMEEspecifica se as atualizações periódicas em segundo plano dos dados na tabela serão suspensas ou retomadas.
SUSPENDSuspende as atualizações periódicas em segundo plano da tabela de recursos on-line.
RESUMERetoma as atualizações periódicas em segundo plano da tabela de recursos on-line.
REFRESHEspecifica 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_nameEspecifica 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.
tagActionDefine 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> ... ] }
SET TAGDefine a tag e o valor da tag especificados na tabela de recursos on-line.
UNSET TAGRemove 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; 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; 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'; 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;