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
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.
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.
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é.
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é.
Si vous ne spécifiez pas le mot clé UPDATE FREQUENCY, les paramètres de fréquence restent inchangés.
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.
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.
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.