IBM Books
(C) IBM Corp. 2000

DB2 Extension Net Search - Guide d'administration et d'utilisation

ALTER INDEX

Cette commande les caractéristiques d'un index en texte intégral, par exemple, les options de mise à jour et celles de stockage.

Autorisation

Selon les vues de catalogue DB2, l'ID utilisateur de cette commande doit disposer des droits CONTROL sur la table pour laquelle l'index en texte intégral a été créé.

Syntaxe de commande

>>-ALTER-INDEX--+-----------------+--nom-index--FOR-TEXT-------->
                '-schéma-index"."-'
 
>--+--------------------------------+--+--------------------+--->
   '-|caractéristiques-mise-à-jour|-'  '-|options-stockage|-'
 
>--+---------------------+-------------------------------------><
   '-|options-connexion|-'
 
options-stockage:
 
|--+-----------------------------+------------------------------>
   '-INDEX-DIRECTORY--répertoire-'
 
>--+---------------------------------------+-------------------->
   '-WORK-DIRECTORY--répertoire-de-travail-'
 
>--+-------------------------------------------------+---------->
   '-CACHE TABLE--+-PERSISTENT--+----------------+-+-'
                  |             '-IN--répertoire-' |
                  '-TEMPORARY----------------------'
 
>--+----------------------+------------------------------------->
   '-PCTFREE--pourcentage-'
 
>--+------------------------------------+-----------------------|
   '-MAXIMUM CACHE SIZE--taille-mémoire-'
 
caractéristiques-mise-à-jour:
 
|--+-----------------------------------------------+------------>
   '-UPDATE-FREQUENCY--+-NONE--------------------+-'
                       '-|fréquence-mise-à-jour|-'
 
>--+------------------------------------------+----------------->
   '-UPDATE-MINIMUM--nombre-min-modifications-'
 
>--+--------------------------------+---------------------------|
   '-COMMITCOUNT-FOR-UPDATE--nombre-'
 
fréquence-mise-à-jour:
 
|--D--(--+-*---------+--)--H--(--+-*----------+--)--M----------->
         | .-,-----. |           | .-,------. |
         | V       | |           | V        | |
         '---0...6-+-'           '---0...23-+-'
 
      .-,------.
      V        |
>--(----0...59-+--)---------------------------------------------|
 
options-connexion:
 
|--+-----------------------------------------------------------------------------------+--|
   '-CONNECT-TO--nom-de-base-de-données--+-------------------------------------------+-'
                                         '-USER--id-utilisateur--USING--mot-de-passe-'
 
 

Paramètres de commande

schéma-index
Schéma de l'index de texte, tel qu'il est spécifié dans la commande CREATE INDEX. Si aucun schéma n'est spécifié, l'ID utilisateur de la connexion DB2 est utilisé.

nom-index
Nom de l'index de texte, tel qu'il est spécifié dans la commande CREATE INDEX.

INDEX DIRECTORY répertoire
Chemin d'accès au répertoire dans lequel l'index de texte est stocké. Comme le répertoire est destiné à contenir les données de l'index, assurez-vous que le répertoire est accessible en lecture/écriture et exécutez les droits pour l'ID utilisateur du propriétaire d'instance DB2.

Notez que dans un environnement DB2 réparti, ce répertoire doit exister sur chaque noeud. Un sous-répertoire, NODE<nr>, est créé sous le répertoire pour distinguer les index sur des noeuds logiques d'un serveur. Tous les fichiers d'index du répertoire d'index précédent sont supprimés.

WORK DIRECTORY répertoire-de-travail
Stocke les fichiers temporaires pendant les opérations de recherche et d'administration. Vous pouvez modifier le répertoire de travail distinct indépendamment d'un nouveau répertoire d'index.

Si le répertoire n'existe pas, il est créé pour l'ID utilisateur du propriétaire d'instance DB2. S'il existe, assurez-vous que le propriétaire d'instance est doté des droits en lecture/écriture sur le répertoire sur les plateformes UNIX.

Notez que dans un environnement DB2 réparti, ce répertoire doit exister sur chaque noeud. Un sous-répertoire, NODE<nr>, est créé sous le répertoire pour distinguer les index sur des noeuds logiques d'un serveur. Tous les fichiers d'index temporaires du répertoire d'index précédent sont supprimés.

CACHE TABLE PERSISTENT IN répertoire
Indique qu'après une désactivation ou une relance du système, la table mise en cache dans CREATE INDEX est persistante. Quel que soit le cas, ceci permet une exécution rapide de ACTIVATE CACHE. La mémoire cache persistante est stockée dans le répertoire spécifié.

La mémoire cache persistante précédemment créée est déplacée vers un autre emplacement. Cet emplacement requiert toujours un index désactivé.

CACHE TABLE TEMPORARY
Indique que la table de résultats mise en cache est à présent temporaire et que toute cache persistante précédemment existante a été supprimée. Notez que cette modification requiert un index désactivé.

MAXIMUM CACHE SIZE taille-mémoire
Indique la nouvelle taille maximale de la table mise en cache devant être générée pendant la commande ACTIVATE CACHE. Un entier positif spécifie le paramètre de la taille de la mémoire en mégaoctets (Mo).

Si le nombre entier et trop petit, la commande ACTIVATE CACHE échoue. La taille de la mémoire cache réelle est calculée pendant la commande ACTIVATE CACHE. Cette modification requiert un index désactivé.

PCTFREE pourcentage
Spécifie le pourcentage de mémoire cache, gardé libre pour les documents supplémentaires. Ce pourcentage doit être un nombre entier inférieur à 100 et supérieur ou égal à 0. Notez que la mémoire cache persistante précédente est supprimée et que cette modification requiert un index désactivé. Reportez-vous à la section ACTIVATE CACHE.

UPDATE FREQUENCY
A l'aide des paramètres suivants, la fréquence de mise à jour de l'index détermine quand la mise à jour a lieu :

Si vous ne spécifiez pas le mot clé UPDATE FREQUENCY, les paramètres de fréquence restent inchangés.

UPDATE MINIMUM nombre-min-modifications
Nombre minimal de modifications autorisées sur les documents texte avant que l'index ne soit mis à jour de manière incrémentielle. Si vous ne spécifiez pas le mot clé UPDATE MINIMUM, le paramètre reste inchangé.

Notez qu'il n'est possible de modifier la valeur de UPDATE MINIMUM que si l'index n'a pas été créé à l'aide de l'option RECREATE ON UPDATE.

COMMITCOUNT FOR UPDATE nombre
Pour le traitement de la mise à jour, vous pouvez spécifier un nombre de validations. Pour plus d'informations, reportez-vous à la section UPDATE INDEX. Ceci s'applique à la commande UPDATE et à la spécification UPDATE FREQUENCY qui planifie le traitement de la mise à jour.

Notez qu'il n'est possible de modifier la valeur de COMMITCOUNT que si l'index n'a pas été créé à l'aide de l'option RECREATE ON UPDATE.

Notez également que vous ne pouvez pas modifier la valeur de COMMITCOUNT, si vous avez créé l'index avec la clause REPLICATION.

CONNECT TO nom-de-base-de-données
Nom de la base de données qui constitue la cible de cette commande. Ce paramètre peut être omis, si DB2DBDFT est défini et que l'utilisateur exécute la commande sur le serveur. Notez que l'ID utilisateur doit disposer des droits DB2 requis.

USER id-utilisateur USING mot-de-passe
Utilisez un mot de passe et un ID utilisateur pour vous connecter à la base de données. Sans spécification de votre part, la connexion est tentée sous l'ID utilisateur courant et sans mot de passe.

Usage

Il n'est pas possible d'émettre la commande si l'une des commandes suivantes est en cours d'exécution sur l'index :

Si vous créez l'index avec une option de mémoire cache, vous ne pouvez pas utiliser la commande ALTER INDEX pour le répertoire d'index lorsque l'index est activé. Vous devez d'abord désactiver la mémoire cache.

Dans un environnement DB2 réparti, un index de texte avec des options de la mémoire cache est uniquement autorisé sur un espace table à un seul noeud.

Modifications de la base de données
Modifiez les vues de catalogue DB2 Extension Net Search.

Modifications du système de fichiers


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]