Doc produitsMenu

Activation de l'exécution de requête paginée pour le connecteur Database

La quantité de données à récupérer et le temps nécessaire à l'exécution d'une requête peut parfois s'avérer très long. C'est pourquoi le connecteur Database peut exécuter des requêtes dans des sous-groupes plus petits de données, ce qui permet de récupérer, par exemple, 5000 rangées par appel. Ainsi, les délais d'exécution peuvent être facilement évités.

L'exécution de requête paginée bénéficie d'une fonctionnalité que l'on retrouve dans la plupart des DBMS (Database Management System), ce qui offre la possibilité de récupérer le sous-groupe des résultats d'une requête en spécifiant la portée de rangées à analyser.

Note : Pour la parution initiale de la fonctionnalité d'exécution de requête paginée, SQL Server et Oracle sont les DBMS officiellement prises en charge qui prennent en charge ce mode d'opération.

Afin de bénéficier de l'exécution de requête paginée, vous devez bien configurer votre fichier de correspondances. Vous devez fournir une requête qui bénéficie de la fonctionnalité de pagination ainsi que deux jetons (@startRow et @endRow) qui seront dynamiquement remplacés en temps d'exécution par le connecteur avec la portée actuelle de données à récupérer. Si ces jetons sont détectés, le connecteur active automatiquement l'exécution de pagination.

Veuillez vous référer à l'exemple suivant pour voir un extrait d'un fichier de correspondances avec une requête configurée afin d'être exécutée en mode paginé sur SQL Server :

SELECT * FROM (
  SELECT MESSAGE.MID,
    MESSAGE.SENDER,
    MESSAGE.DATE_,
    MESSAGE.MESSAGE_ID,
    MESSAGE.SUBJECT,
    MESSAGE.BODY,
    MESSAGE.FOLDER,
    ROW_NUMBER() OVER (Order By MESSAGE.MID) as LINE
  FROM MESSAGE
  WHERE MESSAGE.DATE_ like '2001-04-07%') RESULTS
WHERE RESULTS.LINE between @startRow and @endRow

Toutes les requêtes d'un fichier de configuration sont indépendantes. Vous pouvez décider si vous utilisez l'exécution de requête paginée ou non.

Exemple : Une requête peut être écrite en tant que requête paginée, tandis que ses sous-requêtes peuvent être écrites sans cette fonction.

Paramètre caché pour la taille de la page (entier)

Par défaut, le connecteur est configuré afin de rechercher dans la base de données, 5000 enregistrements à la fois, si la fonctionnalité d'exécution de requête paginée est activée. Toutefois, cette valeur peut être écrasée en configurant le paramètre caché QueryPageSize dans la configuration de source. Cette valeur doit être positive et ne pas être 0.

Pour configurer le paramètre caché QueryPageSize

  1. Dans le serveur Coveo, accédez à l'Outil d'administration (voir Ouverture de l'Outil d'administration).

  2. Ajoutez le paramètre caché QueryPageSize au connecteur Database pour toutes les sources de base de données en spécifiant un type Integer et 5000 comme valeur par défaut (voir Ajout d'un paramètre de connecteur précis).

  3. Sélectionnez l'onglet Index, puis sélectionnez le menu Sources et collections.

  4. Pour chaque source de base de données dont vous souhaitez changer la valeur par défaut pour le paramètre QueryPageSize :

    1. Sous Collections, sélectionnez la collection qui renferme la source de base de données.

    2. Sous Sources, sélectionnez la source de base de données désirée.

    3. Dans le panneau de navigation situé à gauche, sélectionnez Général.

    4. Dans la boîte Taille de la page de requêtes qui apparaît dans la page, tapez la valeur désiré de taille de page pour cette source de base de données. Cette valeur doit être positive et ne pas être 0.

    5. Cliquez sur Appliquer les modifications (Apply Changes).