documentation/manual/fr/tutorials/lucene-indexing.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <!-- EN-Revision: 19807 -->
   3 <!-- Reviewed: no -->
   4 <sect1 id="learning.lucene.indexing">
   5     <title>Indexation</title>
   6
   7     <para>
   8         L'indexation s'effectue en ajoutant un nouveau document à un index existant ou à un
   9         nouvel index&#160;:
  10     </para>
  11
  12     <programlisting language="php"><![CDATA[
  13 $index->addDocument($doc);
  14 ]]></programlisting>
  15
  16     <para>
  17         Il y a deux manières de créer un objet document. La première est de le faire
  18         manuellement.
  19     </para>
  20
  21     <example id="learning.lucene.indexing.doc-creation">
  22         <title>Construction manuel de document</title>
  23
  24         <programlisting language="php"><![CDATA[
  25 $doc = new Zend_Search_Lucene_Document();
  26 $doc->addField(Zend_Search_Lucene_Field::Text('url', $docUrl));
  27 $doc->addField(Zend_Search_Lucene_Field::Text('title', $docTitle));
  28 $doc->addField(Zend_Search_Lucene_Field::unStored('contents', $docBody));
  29 $doc->addField(Zend_Search_Lucene_Field::binary('avatar', $avatarData));
  30 ]]></programlisting>
  31     </example>
  32
  33     <para>
  34         La seconde méthode est de le charger depuis un fichier <acronym>HTML</acronym> ou
  35         Microsoft Office 2007&#160;:
  36     </para>
  37
  38     <example id="learning.lucene.indexing.doc-loading">
  39         <title>Chargement de document</title>
  40
  41         <programlisting language="php"><![CDATA[
  42 $doc = Zend_Search_Lucene_Document_Html::loadHTML($htmlString);
  43 $doc = Zend_Search_Lucene_Document_Docx::loadDocxFile($path);
  44 $doc = Zend_Search_Lucene_Document_Pptx::loadPptFile($path);
  45 $doc = Zend_Search_Lucene_Document_Xlsx::loadXlsxFile($path);
  46 ]]></programlisting>
  47     </example>
  48
  49     <para>
  50         Si un document est chargé depuis l'un des formats supportés, il peut quand même être
  51         étendu manuellement avec des champs définis par l'utilisateur.
  52     </para>
  53
  54     <sect2 id="learning.lucene.indexing.policy">
  55         <title>Politique d'indexation</title>
  56
  57         <para>
  58             Vous devrez définir votre politique d'indexation au sein de la conception de
  59             l'architecture de votre application.
  60         </para>
  61
  62         <para>
  63             Vous pourriez avoir besoin d'une configuration d'indexation à la demande (quelque
  64             chose comme le système <acronym>OLTP</acronym>). Sur de test systèmes, vous ajoutez
  65             généralement un document par requête utilisateur. De cette manière, l'option
  66             <emphasis>MaxBufferedDocs</emphasis> n'affectera pas le système. D'un autre coté,
  67             <emphasis>MaxMergeDocs</emphasis> est vraiment utile, car il vous permet de limiter le
  68             temps d'exécution maximum du script. <emphasis>MergeFactor</emphasis> doit être définis
  69             par une valeur qui conserve un équilibre entre le temps moyen d'indexation (il est
  70             aussi affecté par temps d'optimisation moyen) et les performance de recherche (le
  71             niveau d'optimisation dépend du nombre de segments).
  72         </para>
  73
  74         <para>
  75             Si vous allez surtout effectuer des mises à jour d'index par lot, votre
  76             configuration devrait utiliser une option <emphasis>MaxBufferedDocs</emphasis> définis
  77             à la valeur maximum supporté par la quantité de mémoire disponible.
  78             <emphasis>MaxMergeDocs</emphasis> et <emphasis>MergeFactor</emphasis> doivent être
  79             définis à des valeurs réduisant au maximum le recours à l'auto-optimisation
  80             <footnote>
  81                 <para>Une limite additionnelle est le nombre maximum de gestionnaire de fichiers
  82                 supporter par le système d'exploitation pour les opérations concurrente
  83                 d'ouverture</para>
  84             </footnote>.
  85             Les optimisations complètes d'index doivent être appliquées après l'indexation.
  86         </para>
  87
  88         <example id="learning.lucene.indexing.optimization">
  89             <title>Optimisation d'index</title>
  90
  91             <programlisting language="php"><![CDATA[
  92 $index->optimize();
  93 ]]></programlisting>
  94         </example>
  95
  96         <para>
  97             Dans certaines configuration, il est plus efficace d'effectuer une série de mise
  98             à jour de l'index en organisant une file de requête de mise à jour et de traiter
  99             plusieurs requête de mise à jour dans une seule exécution de script. Ceci réduit la
 100             charge d'ouverture de l'index et permet d'utiliser le tampon de document de
 101             l'index.
 102         </para>
 103     </sect2>
 104 </sect1>