IBM Books
(C) IBM Corp. 2000

Manual de administración y del usuario de DB2 Net Search Extender

DB2EXT.TEXTSEARCH (para una búsqueda de procedimiento almacenado)

Sintaxis de la función

db2ext.TextSearch(
 
        IN      query                   VARCHAR(4096),
        IN      indexSchema             VARCHAR(128),
        IN      indexName               VARCHAR(128),
        IN      resultFirstRow          INTEGER,
        IN      resultNumberRows        INTEGER,
        IN      scoringFlag             INTEGER,
        IN      searchTermCountsFlag    INTEGER,
        OUT     searchTermCounts        VARCHAR(4096),
        OUT     totalNumberOfResults    INTEGER ) 

Parámetros de la función

Los siguientes son parámetros de entrada.

Query
Consulte el Capítulo 14, Sintaxis de los argumentos de búsqueda para obtener más información.

indexSchema, indexName
Identifica el índice donde debe buscarse. Vea CREATE INDEX.

resultFirstrow
La lista de resultados de la consulta se devuelve por partes. El parámetro describe qué fila de la lista de resultados de la consulta es la primera que aparece en el conjunto resultante del procedimiento almacenado. La primera fila de la lista de resultados de la consulta se identifica con el número 0.

resultNumberRows
Este parámetro describe cuántas filas de la lista de resultados de la consulta aparecen en el conjunto resultante del procedimiento almacenado.

No debe confundirse con la expresión "límite del resultado" de la consulta, que determina el tamaño máximo de indicación de la lista de resultados de la consulta.

El valor debe ser >= 0. Donde 0 significa que deben devolverse todos los resultados.

Nota

Si se pide un conjunto de resultados mayor, asegúrese de que está disponible un espacio de tabla de usuario temporal. Si no hay ninguno disponible, cree un espacio de tabla. En el ejemplo siguiente se crea un espacio de tabla en una plataforma UNIX:

db2 "create user temporary tablespace tempts managed by system 
            using ('/work/tempts.ts')"

scoringFlag
0 significa que no hay resultado y 1 significa que sí que lo hay. Si se requiere resultado, se devuelve una fila de adición con el valor del resultado.

searchTermCountsFlag
Controla el proceso de searchTermCounts. Si searchTermCountsFlag es 0, searchTermCounts no se calculará.

Parámetros de la función

Los siguientes son parámetros de salida.

searchTermCounts
Número de ocurrencias de cada consulta de términos de búsqueda del índice. Estos números se devuelven como una lista separada por blancos en el orden de los términos de búsqueda de la consulta.

Vea searchTermCountsFlag para obtener información.

totalNumberOfResults
Número total de resultados hallados en la lista de resultados de la consulta.

Tenga en cuenta también que cuando utilice STOP SEARCH AFTER o RESULT LIMIT conjuntamente con la sintaxis de SCORE en una consulta, este número ya no resultará fiable.

Uso

Las columnas del conjunto de resultados devueltas por el procedimiento almacenado las determina la opción RESULT COLUMNS del mandato DB2TEXT CREATE INDEX. Si scoringFlag=1, se añade una columna de tipo DOUBLE. Esta columna contiene el valor de SCORE.

Utilice las siguientes opciones para aumentar el rendimiento de una segunda consulta con la misma serie que la primera consulta. Tenga en cuenta que debe ser en una ventana de cursor distinta sin que sea necesario totalNumberOfResults:

Para asegurarse de que se conecta al nodo adecuado para realizar búsquedas, es posible que tenga que establecer la variable de entorno DB2NODE.

Para UNIX, utilice el mandato siguiente:

export DB2NODE=<no>

Tenga en cuenta la importancia que tiene que todos los nodos físicos tengan la hora sincronizada.

Para Windows, utilice:

set DB2NODE= <no>
Nota

Un ID de usuario delimitado distinto del ID de propietario de la instancia no funciona en las bases de datos particionadas.


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]