ALTER ONLINE FEATURE TABLE¶
Modifie les propriétés d’une table des fonctionnalités en ligne existante.
- Voir aussi :
CREATE ONLINE FEATURE TABLE , DESCRIBE ONLINE FEATURE TABLE, DROP ONLINE FEATURE TABLE , SHOW ONLINE FEATURE TABLES
Syntaxe¶
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>
Paramètres¶
nameSpécifie l’identificateur de la table des fonctionnalités en ligne à modifier.
Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.
Pour plus d’informations, voir Exigences relatives à l’identificateur.
RENAME TO new_nameRemplace le nom de la table des fonctionnalités en ligne par
new_name. Le nouvel identificateur doit être unique pour le schéma.Pour plus de détails sur les identificateurs, voir Exigences relatives à l’identificateur.
Lorsqu’un objet est renommé, les autres objets qui le référencent doivent être mis à jour avec le nouveau nom.
SUSPEND | RESUMESpécifie si les actualisations périodiques en arrière-plan des données de la table sont suspendues ou reprises.
SUSPENDSuspend les actualisations périodiques en arrière-plan de la table des fonctionnalités en ligne.
RESUMEReprend les actualisations périodiques en arrière-plan de la table des fonctionnalités en ligne.
REFRESHSpécifie que la table des fonctionnalités en ligne doit être actualisée manuellement.
SET ...Définit un(e) ou plusieurs propriétés ou paramètres spécifiés pour la table des fonctionnalités en ligne :
TARGET_LAG = 'num { seconds | minutes | hours | days }'Spécifie la nouvelle latence cible à utiliser pour définir la planification des actualisations en arrière-plan.
Doit être une valeur comprise entre 10 secondes et 8 jours compris.
WAREHOUSE = warehouse_nameSpécifie le nom du nouvel entrepôt qui fournit les ressources de calcul pour l’actualisation de la table des fonctionnalités en ligne.
COMMENT = 'string_literal'Ajoute un commentaire ou écrase un commentaire existant pour la table des fonctionnalités en ligne.
tagActionActive ou désactive la balise sur la table des fonctionnalités en ligne :
tagAction ::= { SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] | UNSET TAG <tag_name> [ , <tag_name> ... ] }
SET TAGDéfinit la balise spécifiée et la valeur de la balise sur la table des fonctionnalités en ligne.
UNSET TAGDésactive la balise spécifiée dans la table des fonctionnalités en ligne.
Exigences en matière de contrôle d’accès¶
Privilège |
Objet |
Remarques |
|---|---|---|
OWNERSHIP |
Table des fonctionnalités en ligne |
Rôle qui possède le privilège OWNERSHIP sur la table des fonctionnalités en ligne. |
USAGE |
Entrepôt |
Requis lors du changement de l’entrepôt |
Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.
Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.
Notes sur l’utilisation¶
Concernant les métadonnées :
Attention
Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.
Exemples¶
L’exemple suivant suspend les actualisations périodiques en arrière-plan pour la table des fonctionnalités en ligne nommée my_online_feature_table :
ALTER ONLINE FEATURE TABLE my_online_feature_table SUSPEND;
L’exemple suivant actualise manuellement la table des fonctionnalités en ligne nommée my_online_feature_table :
ALTER ONLINE FEATURE TABLE my_online_feature_table REFRESH;
L’exemple suivant modifie la latence cible de la table des fonctionnalités en ligne nommée my_online_feature_table :
ALTER ONLINE FEATURE TABLE my_online_feature_table SET TARGET_LAG = '1 minute';
L’exemple suivant modifie le nom de la table des fonctionnalités en ligne my_online_feature_table dans my_new_online_feature_table :
ALTER ONLINE FEATURE TABLE my_online_feature_table RENAME TO my_new_online_feature_table;