(C) IBM Corp. 2000
DB2 Extension Net Search - Guide d'administration et d'utilisation
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 :
- D. Jour(s) de la semaine où l'index est
mis à jour : * (tous les jours) ou 0..6 (0=Dimanche)
- H. Heure(s) de mise à jour de
l'index : * (toutes les heures) ou 0..23
- M. Minute(s) de l'heure de mise à jour
de l'index : 0..59
- NONE. Aucune autre mise à jour de
l'index n'a lieu. Cette valeur est destinée à une colonne de
texte dans laquelle aucun autre changement n'est apporté.
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 :
- ALTER INDEX
- CLEAR EVENTS
- ACTIVATE CACHE
- DROP INDEX
- UPDATE INDEX
- DEACTIVATE 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
-
- Création des sous-répertoires NODE<nr> dans l'index et
les répertoires de travail
- Déplacement de fichiers d'index
- Création de répertoires cache persistants
- Déplacement de fichiers cache persistants
[ Début de page | Page précédente | Page suivante | Table des matières | Index ]