ALTER CORTEX SEARCH SERVICE

Modifie les propriétés d’un Cortex Search Service existant existant.

Syntaxe

ALTER CORTEX SEARCH SERVICE [ IF EXISTS ] <name>
  { SUSPEND | RESUME } [ { INDEXING | SERVING } ]

ALTER CORTEX SEARCH SERVICE [ IF EXISTS ] <name> SET
  [ TARGET_LAG = { '<num> { seconds | minutes | hours | days }' } ]
  [ WAREHOUSE = <warehouse_name> ]
  [ COMMENT = '<string_literal>' ];
Copy

Paramètres

name

Indique l’identificateur du Cortex Search Service à 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.

{ SUSPEND | RESUME } ...

Suspend ou reprend l’indexation, la diffusion ou les deux pour un Cortex Search Service. Vous pouvez spécifier l’un des mots-clés suivants pour indiquer quelle couche suspendre ou reprendre :

INDEXING

La cible qui indique la couche d’indexation du Cortex Search Service. Pour plus de détails, voir Notes sur l’utilisation.

SERVING

La cible qui indique la couche de service du Cortex Search Service. Pour plus de détails, voir Notes sur l’utilisation.

Si vous ne spécifiez aucun mot-clé, les couches d’indexation et de service sont suspendues ou reprises.

SET ...

Définit une ou plusieurs propriétés ou paramètres spécifiés à définir pour le Cortex Search Service :

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

Spécifie le délai maximum pendant lequel le contenu du Cortex Search Service doit être décalé par rapport aux mises à jour des tables de base dans la requête source.

WAREHOUSE = warehouse_name

Spécifie l’entrepôt à utiliser pour exécuter la requête source, créer l’index de recherche et le maintenir actualisé conformément à la TARGET_LAG cible.

COMMENT = 'string_literal'

Ajoute un commentaire ou remplace un commentaire existant pour le service de recherche.

Exigences en matière de contrôle d’accès

Privilège

Objet

OWNERSHIP

Cortex Search Service dont vous souhaitez modifier les propriétés.

Notez que l’exploitation d’un objet dans un schéma requiert également le privilège USAGE sur la base de données et le schéma parents.

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

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.

États INDEXING et SERVING

INDEXING est la cible qui indique la couche d’indexation du Cortex Search Service. Quand l’état actif est RUNNING, les modifications dans les tables de base référencées par la requête source du service entraîneront l’actualisation des données matérialisées stockées dans le cadre de l’index de recherche. Ces actualisations entraînent des coûts sous forme de calculs d’entrepôt et d’intégrations vectorielles. Quand l’état actif est SUSPENDED, les modifications dans les tables de base ne déclencheront pas d’actualisations et ne seront pas reflétées dans les données interrogeables du Cortex Search Service.

SERVING est la cible qui indique la couche de service du service Cortex Search Service. Cette cible doit être à l’état RUNNING pour que le service soit interrogeable. Lorsque le Cortex Search Service est suspendu, il n’entraînera pas de facturation sous la forme des coûts de service Cortex Search.

Pour des considérations détaillées sur les coûts, voir Considérations relatives aux clients.

Les couches INDEXING et SERVING du Cortex Search Service peuvent être gérées indépendamment. Par exemple, si SERVING est en cours d’exécution pendant que INDEXING est suspendu, vous pouvez toujours interroger le service. Cependant, le service ne reflétera aucun changement dans les données de base, quelle que soit la TARGET_LAG jusqu’à ce que INDEXING soit repris et une actualisation se termine.

À l’inverse, si INDEXING est en cours d’exécution pendant que SERVING est suspendu, l’index continuera à s’actualiser. Quand SERVING est repris, l’index chargé qui devient interrogeable reflétera les données sources les plus à jour.

Lorsque ni les mots-clés SERVING ou INDEXING ne sont spécifiés, les deux cibles seront impactées par l’action spécifiée.

Exemples

L’exemple suivant modifie l’entrepôt utilisé par le Cortex Search Service nommé mysvc sur my_new_wh :

ALTER CORTEX SEARCH SERVICE mysvc SET WAREHOUSE = my_new_wh;
Copy

L’exemple suivant définit le champ de commentaire du Cortex Search Service nommé mysvc sur new_comment :

ALTER CORTEX SEARCH SERVICE mysvc SET COMMENT = 'new_comment';
Copy

L’exemple suivant modifie le délai d’actualisation de la cible du Cortex Search Service nommé mysvc sur 1 hour :

ALTER CORTEX SEARCH SERVICE mysvc SET TARGET_LAG = '1 hour';
Copy

L’exemple suivant suspend la diffusion d’un Cortex Search Service nommé mysvc ;

ALTER CORTEX SEARCH SERVICE mysvc SUSPEND SERVING;
Copy
Langage: Français