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>
Copy

Paramètres

name

Spé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_name

Remplace 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 | RESUME

Spécifie si les actualisations périodiques en arrière-plan des données de la table sont suspendues ou reprises.

SUSPEND

Suspend les actualisations périodiques en arrière-plan de la table des fonctionnalités en ligne.

RESUME

Reprend les actualisations périodiques en arrière-plan de la table des fonctionnalités en ligne.

REFRESH

Spé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_name

Spé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.

tagAction

Active 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> ... ]
  }
Copy
SET TAG

Définit la balise spécifiée et la valeur de la balise sur la table des fonctionnalités en ligne.

UNSET TAG

Dé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;
Copy

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;
Copy

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';
Copy

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;
Copy