|
|
|
|
|
|
|
|
|
|
version 6.5 (Modifiée)
FIXER INDEX (champ; index{; mode{; *}})
| Paramètre | Type | Description | |
| champ | Champ | sous-champ |  | Champ duquel créer ou supprimer l'index |
| index | Booléen | | Créer l'index (Vrai) ou supprimer l'index |
| (Faux) | |||
| mode | Entier long | | Utiliser mode d'indexation rapide |
| (pourcentage) | |||
| * | | Indexation asynchrone si * est passé |
Description
La commande FIXER INDEX crée ou supprime l'index du champ ou sous-champ que vous avez passé dans champ.
Pour indexer le champ ou le sous-champ, passez Vrai dans index. Si l'index existe déjà, la commande ne fait rien. Pour supprimer l'index, passez Faux dans index. S'il n'existe pas d'index, la commande ne fait rien.
FIXER INDEX n'indexera pas les enregistrements verrouillés ; la commande attendra que les enregistrements soient libérés.
A compter de la version 6.5 de 4D, deux modes d'indexation sont utilisables : le mode rapide et le mode classique (pour plus d'informations sur les modes d'indexation proposés par 4D, reportez-vous au manuel Mode Structure). Vous pouvez choisir le mode d'indexation à utiliser en passant ou non le paramètre mode. Ce paramètre n'est appelé que si la commande entraîne effectivement la création de l'index (c'est-à-dire si le paramètre index est Vrai).
• Si vous ne passez pas le paramètre mode, l'indexation sera effectuée en mode classique. Dans ce cas, comme l'indexation est effectuée dans un process séparé, la base de données reste utilisable pendant l'opération. Si une action utilisant l'index est exécutée alors que l'index est en train d'être construit, il ne sera pas utilisé. Pour savoir si un champ est indexé, utilisez la commande LIRE PROPRIETES CHAMP.
• Si vous passez le paramètre mode, la commande utilisera le mode rapide. Dans ce cas, il n'est pas possible de modifier les données de la table pendant la durée de l'indexation.
Vous devez passer dans mode une valeur entière représentant un pourcentage. Cette valeur vous permet d'indiquer le type d'usage pour lequel vous souhaitez que l'index soit le plus performant. Elle doit être comprise dans l'intervalle 0 < mode < 100.
- Plus mode est proche de 0, plus l'index sera performant lors des ajouts ou des insertions d'enregistrements.
- Plus mode est proche de 100, plus l'index sera performant lors des recherches.
Le paramètre optionnel * indique une indexation asynchrone (simultanée). Une indexation asynchrone permet à la méthode appelante de poursuivre son exécution immédiatement après l'appel, que l'indexation soit terminée ou non. Cependant, l'exécution sera stoppée si une commande requiert l'index.
Exemples
(1) L'exemple suivant indexe le champ [Clients]Num avec le mode classique :
LIBERER ENREGISTREMENT([Clients]) FIXER INDEX ([Clients]Num; Vrai)
(2) Vous souhaitez indexer le champ [Clients]Nom, en mode rapide. Ce champ est principalement utilisé pour effectuer des recherches :
FIXER INDEX([Clients]Nom;Vrai;100)
(3) Vous souhaitez indexer le champ [Prospects]Nom, en mode rapide. Le champ sera utilisé en ajout et en insertion, mais également pour des recherches. Toutefois, le premier type d'utilisation restera le plus fréquent :
FIXER INDEX([Prospects]Nom;Vrai;30)
Référence
CHERCHER, LIRE PROPRIETES CHAMP, TRIER.
|
|
|
|
|
|
|
|
|
|