IBM i Versión 7.2 Negocio electrónico y servicio Web OmniFind Text Search Server for DB2 for i IBM i Versión 7.2 Negocio electrónico y servicio Web OmniFind Text Search Server for DB2 for i Aviso Antes de utilizar esta información y el producto al que hace referencia, lea la información del apartado “Avisos” en la página 157. Este documento puede contener referencias al código interno bajo licencia. El código interno bajo licencia es código de máquina cuya licencia se obtiene bajo los términos del Acuerdo de licencia de IBM para código de máquina. © Copyright IBM Corporation 2002, 2014. Contenido OmniFind Text Search Server for DB2 for i . . . . . . . . . . . . . . . . 1 Novedades de IBM i 7.2 . . . . . . . . . . 1 Archivo PDF para OmniFind Text Search Server for DB2 for i . . . . . . . . . . . . . . . 1 Introducción a OmniFind Text Search Server for DB2 for i . . . . . . . . . . . . . . . . . 2 Visión general de OmniFind Text Search Server for DB2 for i . . . . . . . . . . . . . . 2 Requisitos del sistema para la instalación de OmniFind Text Search Server for DB2 for i . . . 4 Conceptos clave . . . . . . . . . . . . . 4 Crear y actualizar un índice de búsqueda de texto 4 Indexación asíncrona y desencadenantes . . . . 5 Formatos de documento soportados . . . . . 6 Tipos de datos soportados . . . . . . . . . 7 Puntuación de texto y soporte de sinónimos . . . 7 Proceso lingüístico . . . . . . . . . . . 8 Idiomas soportados . . . . . . . . . . 8 Proceso lingüístico de documentos en chino, japonés y coreano. . . . . . . . . . . 9 Nombre de alias de servidor. . . . . . . . 11 Instalar y configurar funciones de búsqueda de texto. . . . . . . . . . . . . . . . . 12 Instalar OmniFind Text Search Server for DB2 for i . . . . . . . . . . . . . . . . . 12 Iniciar funciones de búsqueda de texto . . . . 13 Crear un índice de búsqueda de texto . . . . 14 Actualizar un índice de búsqueda de texto . . . 14 Buscar en un índice de búsqueda de texto . . . 14 Recorte de documentos . . . . . . . . . 15 Procedimientos almacenados de administración para búsqueda de texto . . . . . . . . . . . . 15 SYSPROC.SYSTS_START . . . . . . . . . 15 SYSPROC.SYSTS_STOP . . . . . . . . . 17 SYSPROC.SYSTS_CREATE . . . . . . . . 19 SYSPROC.SYSTS_ALTER . . . . . . . . . 28 SYSPROC.SYSTS_DROP . . . . . . . . . 34 SYSPROC.SYSTS_UPDATE . . . . . . . . 36 SYSPROC.SYSTS_SHUTDOWN. . . . . . . 39 Buscar con un índice de búsqueda de texto . . . . 40 CONTAINS . . . . . . . . . . . . . 40 SCORE . . . . . . . . . . . . . . . 43 Sintaxis de argumentos de búsqueda . . . . . 45 Ejemplos de consulta simple. . . . . . . 47 Operadores de búsqueda avanzada . . . . 48 Búsqueda de caracteres especiales . . . . . 50 Ejemplo de utilización de las funciones CONTAINS y SCORE . . . . . . . . . 53 Búsqueda XML . . . . . . . . . . . . 53 Soporte de espacio de nombres en búsquedas XML. . . . . . . . . . . . . . . 59 Utilizar espacios de nombres en una búsqueda 61 Ejemplo de búsqueda XML . . . . . . . 65 Gramática de consultas de búsqueda XML . . 68 © Copyright IBM Corp. 2002, 2014 Administrar un OmniFind(r) Text Search Server for DB2(r) for i . . . . . . . . . . . . . . 69 Iniciar OmniFind Text Search Server for DB2 for i 70 Detener OmniFind Text Search Server for DB2 for i . . . . . . . . . . . . . . . . . 70 Salvar y restaurar índices de búsqueda de texto 71 Salvar y restaurar un índice de búsqueda de texto sin datos . . . . . . . . . . . 71 Salvar y restaurar un índice de búsqueda de texto con datos . . . . . . . . . . . 73 Determinación de problemas . . . . . . . 74 Visualizar y guardar registros del servidor . . . 75 Herramientas de administración . . . . . . 76 Herramienta de configuración . . . . . . 76 SYSPROC.SYSTS_REMOVE . . . . . . . 78 SYSPROC.SYSTS_REPRIMEINDEX . . . . 80 SYSTS_CLEAR_INDEXES . . . . . . . 81 SYSPROC.SYSTS_VALIDITYCHECK . . . . 82 QDBTSLIB.QDBTS_ROWS_STATUS . . . . 83 Diccionarios de sinónimos . . . . . . . 85 Añadir un diccionario de sinónimos a una colección . . . . . . . . . . . . 85 Eliminar un diccionario de sinónimos de una colección . . . . . . . . . . . 86 Buscar índices huérfanos y ausentes . . . . 87 Administración avanzada. . . . . . . . 88 Herramienta ServerInstance . . . . . . . . 90 Health Checker . . . . . . . . . . . . 91 Consideraciones relativas a las ASP independientes para OmniFind Text Search Server for DB2 for i. . . . . . . . . . . 92 Alta disponibilidad . . . . . . . . . . . 93 Análisis del rendimiento . . . . . . . . . 94 Consideraciones relativas a las transacciones . . 98 Utilización de IBM Navigator for i. . . . . . 99 Trabajar con servidores de búsqueda de texto 99 Trabajar con índices de búsqueda de texto 101 Visualizar construcciones de índice de búsqueda de texto . . . . . . . . . 103 Utilizar System i Navigator. . . . . . . . 104 Trabajar con servidores de búsqueda de texto 105 Trabajar con índices de búsqueda de texto 107 Visualizar construcciones de índice de búsqueda de texto . . . . . . . . . 110 Tablas de administración de búsqueda de texto . . 111 Tabla de administración QSYS2.SYSTEXTDEFAULTS . . . . . . . 111 Tabla de administración QSYS2.SYSTEXTINDEXES . . . . . . . . 112 Tabla de administración QSYS2.SYSTEXTCOLUMNS . . . . . . . 114 Tabla de administración QSYS2.SYSTEXTSERVERS . . . . . . . . 115 Tabla de administración QSYS2.SYSTEXTCONFIGURATION . . . . . 116 iii Tabla de administración QSYS2.SYSTEXTSERVERHISTORY . . . . . Vista Índice de búsqueda de texto . . . . . Ampliaciones para indexar y buscar datos no DB2 Visión general de las ampliaciones . . . . . Crear una colección de búsqueda de texto . . . Añadir un conjunto de objetos de datos de archivo spool . . . . . . . . . . . . Eliminar un conjunto de objetos de datos de archivo spool . . . . . . . . . . . . Añadir un conjunto de objetos de datos de archivo continuo . . . . . . . . . . . Eliminar un conjunto de objetos de datos de archivo continuo . . . . . . . . . . . Añadir un conjunto de objetos de archivo físico de origen multimiembro. . . . . . . . . Eliminar un conjunto de objetos de archivo físico de origen multimiembro. . . . . . . Eliminar un conjunto de objetos . . . . . . Actualizar la colección . . . . . . . . . Volver a llenar la colección de búsqueda de texto . . . . . . . . . . . . . . . iv IBM i: OmniFind Text Search Server for DB2 for i 133 Buscar en la colección . . . . . . . . Consultar información de conjunto de objetos Recuperar estado de objetos de índices . . . Obtener objetos no indexados . . . . . . Recuperar estado de colección . . . . . . Eliminar una colección de búsqueda de texto Modificar una colección de búsqueda de texto Consideraciones sobre las ASP independientes para las colecciones de búsqueda de texto . . Consideraciones sobre la copia de seguridad y restauración de colecciones de búsqueda de texto . . . . . . . . . . . . . . Mensajes y códigos . . . . . . . . . . Mensajes de OmniFind . . . . . . . . 135 Avisos . . . . . . . . . . . . . . 157 116 117 118 118 119 124 128 131 137 138 139 140 Información de la interfaz de programación . Marcas registradas. . . . . . . . . . . . . 141 143 . 144 . 145 . 146 148 149 . 152 . 152 . 153 . 153 . 159 . 159 Índice. . . . . . . . . . . . . . . 161 OmniFind Text Search Server for DB2 for i OmniFind Text Search Server for DB2 for i permite emitir sentencias SQL que satisfagan las consultas de búsqueda de texto habituales en documentos almacenados en una base de datos DB2. Nota: Al utilizar los ejemplos de código, acepta los términos del apartado “Información sobre licencia de código y exención de responsabilidad” en la página 156. Novedades de IBM i 7.2 Información relativa a las novedades o cambios significativos realizados en el temario de OmniFind Text Search Server for DB2 for i. Las principales características nuevas son las siguientes: v “Ampliaciones para indexar y buscar datos no DB2” en la página 118 – “Añadir un conjunto de objetos de archivo físico de origen multimiembro” en la página 135 – “Añadir un conjunto de objetos de datos de archivo continuo” en la página 131 – “Modificar una colección de búsqueda de texto” en la página 149 – Eliminar conjunto de objetos por atributo - “Eliminar un conjunto de objetos de datos de archivo spool” en la página 128 - “Eliminar un conjunto de objetos de datos de archivo continuo” en la página 133 - “Eliminar un conjunto de objetos de archivo físico de origen multimiembro” en la página 137 v “Búsqueda de caracteres especiales” en la página 50 v Eliminar índices huérfanos v Concluir servidor v Comprobar el estado y el código de retorno para cada fila en estado de aviso o de error v Soporte de RCAC – Crear índice de búsqueda de texto protegido – Modificar índice de búsqueda de texto a índice protegido Cómo visualizar las novedades o cambios Para facilitar la visualización de los cambios técnicos, el Information Center utiliza: v La imagen de para marcar el inicio de información nueva o modificada. para marcar el final de la información nueva o modificada. v La imagen de En los archivos PDF, puede que observe barras de revisión (|) en el margen izquierdo de la información nueva o modificada. Para buscar otra información relativa a las novedades o cambios de este release, consulte el Memorándum para los usuarios. Archivo PDF para OmniFind Text Search Server for DB2 for i Utilice esta página para visualizar e imprimir un PDF de esta información. Para visualizar o descargar el archivo PDF de este documento, seleccione OmniFind Text Search Server for DB2 for i (aproximadamente 1192 KB). © Copyright IBM Corp. 2002, 2014 1 Otra información También puede visualizar o imprimir cualquiera de estos archivos PDF: v Preparing for and Tuning the SQL Query Engine on DB2 for i5/OS v SQL Performance Diagnosis on IBM® DB2 Universal Database for iSeries . Guardar archivos PDF Para guardar un PDF en la estación de trabajo a fin de visualizarlo o imprimirlo: 1. Pulse con el botón derecho del ratón el PDF en el navegador (pulse con el botón derecho del ratón el enlace precedente). 2. Pulse la opción que guarda el PDF localmente. 3. Vaya al directorio en el que desee guardar el PDF. 4. Pulse Guardar. Descargar Adobe Reader Es necesario tener instalado Adobe Reader en el sistema para visualizar o imprimir estos archivos PDF. Puede descargar una copia gratuita desde Adobe (http://get.adobe.com/reader/) . Introducción a OmniFind Text Search Server for DB2 for i DB2 for i utiliza OmniFind(r) Text Search Server como motor de indexación y búsqueda de los documentos almacenados en una base de datos DB2. OMNIFIND es un producto de búsqueda de texto que permite a los usuarios de IBM i realizar búsquedas en texto no estructurado almacenado en una columna de una tabla de DB2 for i. El texto almacenado en la columna puede ser texto simple de tipo carácter, un documento XML o alguno de los diversos tipos de documentos de texto enriquecido, como por ejemplo un archivo PDF o DOC. El producto permite a los usuarios indexar datos no estructurados sin necesidad de analizarlos en un formato estructurado, como por ejemplo una tabla SQL. OmniFind Text Search Server es un motor de búsqueda según contexto. Da soporte a la prestación de búsquedas aproximadas. Por ejemplo, la búsqueda de 'mice' (ratón, en inglés) descubrirá los documentos que contienen 'mice' (ratones, en inglés) o 'mouse'. El motor de búsqueda también da soporte al contexto idiomático. Por ejemplo, comprende los equivalentes de búsqueda aproximada de 'mice' y 'mouse' tanto en inglés como en español. Muchas aplicaciones pueden aprovechar esta prestación. Un buen ejemplo de ello es una base de datos de Recursos humanos. Los currículos de los candidatos pueden almacenarse en la base de datos en cualquier formato que permita someterlos. Pueden utilizarse búsquedas subsiguientes mediante OmniFind para buscar candidatos potenciales con determinadas habilidades clave. Visión general de OmniFind Text Search Server for DB2 for i OmniFind Text Search Server for DB2 for i suministra un conjunto de procedimientos almacenados administrativos y dos funciones incorporadas: CONTAINS y SCORE. Estas funciones se utilizan para realizar búsquedas en los índices de texto creados a partir de los documentos almacenados en una tabla de DB2. Los procedimientos almacenados administrativos se utilizan para habilitar e inhabilitar la búsqueda de texto y para crear, actualizar y eliminar índices de texto. 2 IBM i: OmniFind Text Search Server for DB2 for i Un índice de texto puede crearse a partir de cualquier columna de los tipos de datos siguientes: v CHAR v VARCHAR v CLOB v BLOB v v v v v v DBCLOB GRAPHIC VARGRAPHIC BINARY VARBINARY XML Los datos pueden contener texto sin formato, HTML, XML o diversos tipos de documentos enriquecidos, como por ejemplo archivos PDF. Los datos se leen de la columna de texto y se convierten a Unicode (CCSID 1208) antes de indexarlos. Los índices de texto no son índices DB2 típicos. No se mantienen automáticamente, no pueden registrarse por diario ni puede realizarse una copia de seguridad de los mismos mediante los métodos típicos de copia de seguridad y restauración. Los índices de texto se crean y almacenan en un servidor de búsqueda de texto. Por omisión, el servidor de búsqueda de texto se crea en el mismo sistema que los datos almacenados en la base de datos DB2. Sin embargo, un servidor de búsqueda de texto puede crearse en otro servidor que ejecute IBM i, Linux, UNIX, AIX o Windows. El servidor de búsqueda de texto contiene una colección de términos significativos extraídos de cada fila de la columna. Para la comunicación con el servidor de búsqueda de texto, se utiliza una conexión TCP/IP. CONTAINS y SCORE son funciones incorporadas integradas en DB2 for i. DB2 for i utiliza OmniFind(r) Text Search Server como motor de indexación y búsqueda de los documentos almacenados en una base de datos DB2. OMNIFIND admite varias colecciones. Una colección contiene un índice de búsqueda de texto y las opciones específicas del índice para analizar, indexar y buscar. OMNIFIND tiene una interfaz gráfica de usuario para la administración de servidores e índices de texto. El servidor de búsqueda de texto también suministra procedimientos almacenados SQL y herramientas de línea de mandatos que pueden utilizarse para tareas habituales. Estas tareas habituales incluyen la configuración y administración del servidor de búsqueda de texto, la creación de un diccionario de sinónimos para una colección y el diagnóstico de problemas. Conceptos relacionados: “Procedimientos almacenados de administración para búsqueda de texto” en la página 15 Puede iniciar y detener funciones de búsqueda de texto y crear, eliminar y actualizar índices de búsqueda de texto mediante un conjunto de procedimientos almacenados SQL de administración. Estos procedimientos pueden invocarse desde cualquier interfaz de SQL. No puede llamar a estos procedimientos desde una línea de mandatos de IBM i mediante mandatos CL. Referencia relacionada: “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que OmniFind Text Search Server 3 indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. Requisitos del sistema para la instalación de OmniFind Text Search Server for DB2 for i Antes de instalar OmniFind Text Search Server for DB2 for i, asegúrese de que el sistema cumple todos los requisitos de hardware, software y sistema operativo. Al instalar OmniFind Text Search Server for DB2 for i, el programa de instalación crea un servidor de búsqueda de texto para IBM i. Puede instalar servidores de búsqueda de texto en servidores remotos que ejecuten Linux o Windows. Estos servidores forman parte de DB2 Accessories Suite for z/OS (5655-R14) (http://www-01.ibm.com/software/data/db2imstools/db2tools/accessories-suite/) contiene información relativa a la descarga de la suite. . El enlace Requisitos de software Asegúrese de que el sistema cumple los siguientes requisitos mínimos de software: v 5770JV1 IBM Developer Kit for Java™ – Uno de los siguientes: - 5770JV1 Opción 11 Java SE 6 32 bits - 5770JV1 Opción 12 Java SE 6 64 bits v DB2 Universal Java Driver instalado y configurado en el servidor de búsqueda de texto v Para IBM i, deben estar instalados los programas siguientes: – 5770SS1 Opción 30 Qshell – 5770SS1 Opción 33 IBM i Portable Application Solutions Environment (IBM i PASE) – 5770SS1 Opción 39 International Components for Unicode – Haber aplicado al sistema el PTF de grupo más reciente para IBM DB2 for i. Conceptos clave La comprensión de los conceptos clave acerca de las funciones de búsqueda de texto le ayudará a aprovechar las ventajas de OmniFind Text Search for DB2 for i. Los conceptos clave son los tipos de documentos y los idiomas soportados. Crear y actualizar un índice de búsqueda de texto Puede crear un índice de búsqueda de texto definiendo y declarando las propiedades del mismo. Puede actualizar un índice de búsqueda de texto añadiendo al mismo datos nuevos de una tabla de DB2. También puede actualizar un índice de búsqueda de texto cambiando los datos existentes en el mismo. Para cada índice de búsqueda de texto que cree, se creará una colección en OmniFind Text Search Server for DB2 for i. Tras la creación inicial, el índice de búsqueda de texto no contiene datos. Los datos se añaden al índice de búsqueda de texto llamando al procedimiento almacenado SYSPROC.SYSTS_UPDATE. El primer proceso de actualización añade todos los documentos de texto de la columna de texto al índice de búsqueda de texto. Este proceso se conoce como actualización inicial. Las actualizaciones subsiguientes son incrementales. Cuando se crea un índice de búsqueda de texto, se crean o actualizan los objetos siguientes: 4 IBM i: OmniFind Text Search Server for DB2 for i v La tabla intermedia se crea en la biblioteca QSYS2. v Los desencadenantes INSERT, DELETE y UPDATE se añaden a la tabla base. v Se crea una vista SQL con el nombre del índice de búsqueda de texto en el esquema del índice de búsqueda de texto. Esta vista contiene información acerca del índice de texto. Por ejemplo, la vista puede utilizarse para obtener el nombre de la tabla base y el nombre de la tabla intermedia. La vista también muestra el número de cambios pendientes realizados en la tabla base que aún no se han reflejado en el índice de búsqueda de texto. v Los catálogos de índice de búsqueda de texto (SYSTEXTINDEXES y SYSTEXTCOLUMNS) de la biblioteca QSYS2 se actualizan añadiendo una entrada para el nuevo índice de búsqueda de texto. Consideraciones relativas a la tabla intermedia: v No realice ninguna operación de base de datos en la tabla intermedia, excepto salvar y restaurar el archivo o cambiar autorizaciones. v Si está cambiando las autorizaciones sobre la tabla base, cambie también las autorizaciones sobre la tabla intermedia. Consideraciones relativas a la tabla base: v No elimine los desencadenantes DELETE, UPDATE e INSERT que se han añadido al crear un índice de búsqueda de texto. v Al eliminar el índice de búsqueda de texto, se eliminan los desencadenantes. v No modifique ni elimine el valor de ROWID, clave primaria o columna exclusiva utilizado como clave en el índice de búsqueda de texto. v La modificación de los datos de columna de la tabla base que provocan truncamiento de datos pueden dar como resultado falsas coincidencias positivas en el índice de búsqueda de texto. Referencia relacionada: “SYSPROC.SYSTS_UPDATE” en la página 36 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. “Tabla de administración QSYS2.SYSTEXTINDEXES” en la página 112 Puede visualizar información acerca de cada índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTINDEXES. Cada índice de búsqueda de texto tiene un nombre, un nombre de esquema y un nombre de colección asociada en el servidor de búsqueda de texto. “Tabla de administración QSYS2.SYSTEXTCOLUMNS” en la página 114 Puede visualizar información acerca de las columnas de texto de un índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTCOLUMNS. Cada índice de búsqueda de texto tiene un ID de índice, nombres de columna de texto y el nombre de esquema de la tabla base. Indexación asíncrona y desencadenantes Puede actualizar el índice de búsqueda de texto en OmniFind Text Search Server for DB2 for i manualmente o planificarlo para que se ejecute automáticamente. El índice de búsqueda de texto que se conserva en OmniFind Text Search Server for DB2 for i no se actualiza síncronamente cuando se actualiza la tabla de DB2. La actualización de un índice de búsqueda de texto es una operación extensa. En lugar de ello, existen desencadenantes que capturan los cambios realizados en la columna de la tabla de DB2 en una tabla de registro local. Esta tabla de registro también se denomina tabla intermedia. Estos desencadenantes almacenan automáticamente la información relativa a los documentos nuevos, cambiados y suprimidos en una tabla de registro. Cada tabla de registro está asociada a un índice de búsqueda de texto. La aplicación del contenido de la tabla de registro a su índice de búsqueda de texto correspondiente se denomina actualización incremental. OmniFind Text Search Server 5 Debe actualizar periódicamente el índice de búsqueda de texto para que los cambios se reflejen en las consultas. Puede actualizar el índice de búsqueda de texto manualmente llamando al procedimiento almacenado SYSPROC.SYSTS_UPDATE. Las actualizaciones también pueden planificarse para que se produzcan automáticamente especificando la cláusula UPDATE FREQUENCY en el procedimiento SYSPROC.SYSTS_CREATE al crear el índice de texto. Referencia relacionada: “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. “SYSPROC.SYSTS_UPDATE” en la página 36 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. Formatos de documento soportados Los datos de una columna de texto pueden ser texto sin formato, un documento HTML, un XML o cualquier documento que el motor de búsqueda reconozca. OmniFind Text Search Server for DB2 for i analiza los documentos para extraer las partes relevantes y hacer disponibles para las búsquedas. Por ejemplo, los códigos y metadatos de un documento HTML no se indexan. Está soportado el análisis de los formatos de documento siguientes: v TEXT: texto sin formato v HTML: lenguaje de marcado de hipertexto v XML: lenguaje de códigos ampliable v INSO: OmniFind Text Search Server for DB2 for i utiliza filtros para detectar el formato de los documentos de texto. Están soportados los siguientes formatos de documento INSO: – XML – HTML – JustSystems Ichitaro – Lotus 123 – Lotus Freelance – Lotus WordPro – Microsoft Excel – Microsoft PowerPoint – Microsoft Rich Text Format – Microsoft Visio – Microsoft Word – Microsoft Write – Portable Document Format (PDF) – Quattro Pro – Rich Text RTF – StarOffice Calc y OpenOffice Calc 6 IBM i: OmniFind Text Search Server for DB2 for i Todos los documentos de una columna de texto indexado deben tener el mismo formato (TEXT, HTML, XML o INSO). Datos XML La estructura XML de los datos XML se indexa en OmniFind Text Search Server for DB2 for i después de analizar los datos por medio de un analizador XML. A continuación, puede utilizar la sintaxis de consulta de búsquedas XML soportada para recuperar los resultados. Conceptos relacionados: “Búsqueda XML” en la página 53 Puede indexar y realizar búsquedas en documentos XML. La gramática de búsqueda XML utiliza un subconjunto del lenguaje W3 XPath con ampliaciones para búsqueda de texto. Las ampliaciones dan soporte a búsquedas de rango de valores numéricos, de fecha (Date) y fecha y hora (DateTime) asociados con un atributo o elemento XML. Los elementos estructurales pueden utilizarse por separado o combinarse con texto sin formato en las consultas. Tipos de datos soportados Los datos de las columnas de texto que desea indexar y en las que realizar búsquedas pueden ser datos binarios o datos de tipo carácter. Los tipos de datos siguientes son datos binarios: v BINARY v VARBINARY v BLOB Además, OMNIFIND maneja los tipos de datos siguientes de forma similar a los datos binarios: v CHAR FOR BIT DATA v VARCHAR FOR BIT DATA Los tipos de datos siguientes son datos de tipo carácter: v CHAR FOR SBCS DATA o FOR MIXED DATA v VARCHAR FOR SBCS DATA o FOR MIXED DATA v CLOB v DBCLOB v GRAPHIC v VARGRAPHIC v XML Si los datos son binarios, puede especificar el CCSID (identificador de juego de caracteres codificados) utilizado para crear el índice de búsqueda de texto. Para datos de tipo carácter, la base de datos DB2 conoce la codificación; por tanto, si especifica explícitamente un CCSID, dicha especificación se ignora. Puntuación de texto y soporte de sinónimos Puede utilizar sinónimos para mejorar los resultados de una consulta. Puede utilizar una puntuación de texto para averiguar el grado de exactitud con el que un resultado coincide con la consulta. Puntuación de texto Una puntuación de texto se calcula como parte de la búsqueda y puede incluirse en los resultados de la consulta. Una puntuación de texto es un valor de 0 a 1, de hasta tres dígitos decimales; por ejemplo, OmniFind Text Search Server 7 0,000 a 1,000. Una puntuación de texto indica el grado de exactitud con el que un resultado coincide con la consulta en relación a todos los demás documentos del índice de búsqueda de texto. OMNIFIND compone la puntuación de texto a partir de diversos factores, tales como la importancia genérica de los términos de búsqueda y la proximidad de apariciones de los términos de búsqueda. La importancia general se basa en la frecuencia de los términos de cada documento y en el desplazamiento de la frecuencia de los términos en todos los documentos. Soporte de sinónimos OmniFind Text Search Server for DB2 for i admite la utilización de sinónimos para modificar los resultados de una consulta. La utilización de sinónimos puede aumentar el número de resultados de consulta haciendo que más documentos coincidan con una consulta. Sin embargo, el uso de sinónimos también puede disminuir la precisión de una consulta y dificultar la búsqueda de un número menor de documentos que coincidan con los criterios de búsqueda exactos. Por omisión, no se utilizan sinónimos para una consulta. Para utilizar sinónimos en una consulta, cree un diccionario de sinónimos y añádalo a una colección mediante la herramienta de sinónimos. Para obtener más información acerca de los sinónimos, consulte el apartado “Diccionarios de sinónimos” en la página 85. Referencia relacionada: “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. Proceso lingüístico OmniFind Text Search Server for DB2 for i suministra paquetes de diccionarios para dar soporte al proceso lingüístico de documentos y consultas que no están en inglés. Como alternativa a la segmentación de palabras basada en diccionarios, OmniFind Text Search Server for DB2 for i utiliza soporte de segmentación n-gram para idiomas tales como el chino, el japonés y el coreano. La segmentación n-gram es un método de análisis que considera las secuencias solapadas de un número de caracteres determinado como una sola palabra. Como alternativa, la segmentación de espacio en blanco basada en Unicode utiliza un espacio en blanco para delimitar las palabras. Si un documento de texto se encuentra en uno de los idiomas soportados, el proceso lingüístico se lleva a cabo cuando el texto se analiza para generar señales. Para los idiomas no soportados, se devuelve un código de error. Al realizar una búsqueda en un índice de búsqueda de texto, se indica una coincidencia que contiene variantes lingüísticas de los términos de consulta. Las variantes de una palabra dependen del idioma de la consulta. Idiomas soportados Puede especificar que los documentos de texto se procesen mediante un idioma específico. Puede especificar el idioma de los datos de texto indexados en el procedimiento almacenado de administración SYSPROC.SYSTS_CREATE. Si establece el valor en AUTO, OmniFind Text Search Server for DB2 for i intentará determinar el idioma. Para documentos breves, la detección automática puede no ser exacta y no es recomendable. El idioma predeterminado para el proceso lingüístico es el inglés (en_US). 8 IBM i: OmniFind Text Search Server for DB2 for i La tabla siguiente muestra los códigos de idioma de cinco caracteres correspondientes a los idiomas soportados. Tabla 1. Códigos de idioma de cinco caracteres correspondientes a los idiomas soportados Código de idioma Idioma ar_AA Árabe cs_CZ Checo da_DK Danés de_CH Alemán (Suiza) de_DE Alemán (Alemania) el_GR Griego en_AU Inglés (Australia) en_GB Inglés (Reino Unido) en_US Inglés (Estados Unidos) es_ES Español (España) fi_FI Finés fr_CA Francés (Canadá) fr_FR Francés (Francia) it_IT Italiano ja_JP Japonés ko_KR Coreano nb_NO Noruego Bokmal nl_NL Holandés nn_NO Noruego Nynorsk pl_PL Polaco pt_BR Portugués de Brasil pt_PT Portugués (Portugal) ru_RU Ruso sv_SE Sueco zh_CN Chino Simplificado zh_TW Chino Tradicional Referencia relacionada: “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. Proceso lingüístico de documentos en chino, japonés y coreano Los documentos escritos en chino, japonés y coreano pueden procesarse mediante segmentación basada en diccionario o mediante segmentación n-gram. Para un motor de búsqueda, la obtención de buenos resultados de búsqueda depende en gran medida de las técnicas utilizadas para procesar el texto. Después de extraer el texto del documento, el primer pasos del proceso de texto consiste en identificar las palabras individuales del texto. La identificación de las palabras individuales del texto se denomina segmentación. Para la mayoría de idiomas, puede utilizare el OmniFind Text Search Server 9 espacio en blanco (blancos, el final de una línea y determinados caracteres de puntuación) para reconocer los límites de palabra. Sin embargo, el chino, el japonés y el coreano no utilizan el espacio en blanco entre caracteres para separar las palabras, por lo que deben utilizarse otras técnicas. OmniFind Text Search Server for DB2 for i suministra los dos métodos siguientes para dar soporte al proceso lingüístico del chino, el japonés y el coreano: v Segmentación de palabras basada en diccionario (también denominada análisis morfológico) v Segmentación N-gram Segmentación de palabras basada en diccionario La segmentación de palabras basada en diccionario utiliza un diccionario específico de idioma para identificar las palabras en la secuencia de caracteres del documento. Esta técnica proporciona resultados de búsqueda precisos, ya que los diccionarios se utilizan para identificar los límites de palabra. Sin embargo, la segmentación de palabras basada en diccionario puede no detectar resultados de coincidencia específicos. Segmentación N-gram La segmentación N-gram evita el problema de identificar los límites de palabra, y en su lugar indexa pares de caracteres solapados. Dado que OmniFind Text Search Server for DB2 for i utiliza dos caracteres, esta técnica también se denomina segmentación bi-gram. La segmentación n-gram siempre devuelve todos los documentos coincidentes que contienen los términos de búsqueda; sin embargo, esta técnica puede devolver a veces documentos que no coinciden con la consulta. Por omisión, OmniFind Text Search Server for DB2 for i se suministra con un índice preconfigurado que utiliza segmentación n-gram para los idiomas chino, japonés y coreano. Para observar cómo funcionan ambos tipos de proceso lingüístico, examine el texto siguiente de un documento: elección del gobernador de la prefectura de Kanagawa. En japonés, este texto contiene ocho caracteres. En este ejemplo, los ocho caracteres se representan como A B C D E F G H. Una consulta de ejemplo que los usuarios podrían especificar podría ser elección del gobernador, que tiene cuatro caracteres representados como E F G H. (El texto del documento y la consulta de ejemplo comparten caracteres similares). Si se utiliza el proceso por segmentación n-gram: Una vez indexado el documento, el motor de búsqueda segmenta el texto elección del gobernador de la prefectura de Kanagawa en los siguientes conjuntos de caracteres: AB BC CD DE EF FG GH La consulta de ejemplo elección del gobernador se segmenta en los siguientes conjuntos de caracteres: DE EF FG GH. Si realiza una búsqueda con la consulta de ejemplo elección del gobernador, se encontrará el documento. La razón es que las señales tanto para el texto del documento como para la consulta aparecen en el mismo orden. Si habilita la segmentación n-gram, es posible que visualice más resultados, pero posiblemente éstos sean menos precisos. Por ejemplo, en japonés, si realiza una búsqueda con la consulta Kyoto y un documento del índice contiene el texto Ciudad de Tokyo, se encontrará el documento. La razón es que Ciudad de Tokyo y Kyoto comparten dos de los mismos caracteres del japonés. Si no se utiliza el proceso por segmentación n-gram: Una vez indexado el documento, el motor de búsqueda segmenta el texto elección del gobernador de la prefectura de Kanagawa en los siguientes conjuntos de caracteres: ABC DEF GH. 10 IBM i: OmniFind Text Search Server for DB2 for i La consulta de ejemplo elección del gobernador se segmenta en los siguientes conjuntos de caracteres: EF GH. Los caracteres EF no aparecen en las señales del texto del documento. (Aunque el documento no contiene EF, sí contiene DEF). El texto del documento contiene DEF, pero la consulta sólo contiene EF. Por tanto, es menos probable que el documento se encuentre mediante la consulta de ejemplo. Si no habilita la segmentación n-gram, probablemente recibirá resultados más precisos, aunque posiblemente su número sea menor. Nombre de alias de servidor Puede utilizar un nombre de alias de servidor para asignar un nombre significativo a un servidor. Cada servidor de búsqueda de texto se identifica de forma exclusiva en la columna SERVERID del catálogo QSYS2.SYSTEXTSERVERS. La columna SERVERID es un entero generado incrementalmente por la base de datos. La columna ALIASNAME de QSYS2.SYSTEXTSERVERS se suministra para permitir la asignación de un nombre de alias significativo a cada servidor. Los nombres de alias de servidor pueden utilizarse para hacer referencia a los servidores en los procedimientos SYSTS_START, SYSTS_STOP y SYSTS_CREATE, SYSTS_SHUTDOWN y SYSTS_CLEAR_INDEXES. Nota: El nombre de alias de servidor puede cambiarse directamente en la tabla de catálogo QSYS2.SYSTEXTSERVERS actualizando el valor ALIASNAME. Asignar el número de servidor 1 como nombre de alias de "PRIMARY_LOCAL_SERVER". UPDATE QSYS2.SYSTEXTSERVERS SET ALIASNAME = ’PRIMARY_LOCAL_SERVER’ WHERE SERVERID = 1 Para eliminar un nombre de alias de un servidor, establezca la columna en NULL. Eliminar un nombre de alias del número de servidor 1. UPDATE QSYS2.SYSTEXTSERVERS SET ALIASNAME = NULL WHERE SERVERID = 1 Referencia relacionada: “Tabla de administración QSYS2.SYSTEXTSERVERS” en la página 115 Puede visualizar dónde están instalados los servidores de búsqueda de texto mediante la tabla de administración QSYS2.SYSTEXTSERVERS. “SYSPROC.SYSTS_START” en la página 15 Puede habilitar funciones de búsqueda de texto de DB2 llamando al procedimiento almacenado SYSPROC.SYSTS_START. “SYSPROC.SYSTS_STOP” en la página 17 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_STOP para detener las funciones de búsqueda de texto de DB2. Este procedimiento almacenado establece el valor SERVERSTATUS del catálogo QSYS2.SYSTEXTSERVERS en 1 (detenido). “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. OmniFind Text Search Server 11 “SYSPROC.SYSTS_SHUTDOWN” en la página 39 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_SHUTDOWN para concluir las funciones de búsqueda de texto de DB2®. Este procedimiento almacenado establece el valor SERVERSTATUS del catálogo QSYS2.SYSTEXTSERVERS en 1 (detenido) y también finaliza los trabajos del servidor de búsqueda de texto del sistema host. “SYSTS_CLEAR_INDEXES” en la página 81 Puede eliminar índices huérfanos con el procedimiento almacenado SQL SYSPROC. SYSTS_CLEAR_INDEXES. Otra forma implícita es invocar SYSTS_START directamente, que intenta borrar índices huérfanos automáticamente. Instalar y configurar funciones de búsqueda de texto Puede instalar y configurar OmniFind Text Search Server for DB2 for i. También puede crear y actualizar un índice de búsqueda de texto para poder empezar a utilizar funciones de búsqueda de texto en una columna de una tabla. Instalar OmniFind Text Search Server for DB2 for i Instale OmniFind Text Search Server for DB2 for i mediante los procedimientos de instalación estándar de un programa bajo licencia de IBM i. Se creará un servidor de texto predeterminado y la tabla QSYS2.SYSTEXTSERVERS se llenará con la información del servidor predeterminado. Opcionalmente, puede añadir servidores de búsqueda de texto adicionales después de la instalación. Llenar la tabla QSYS2.SYSTEXTSERVERS OmniFind Text Search Server for DB2 for i es el programa bajo licencia 5733-OMF de IBM. Consulte el apartado Instalar programas bajo licencia adicionales para obtener detalles acerca de la instalación de un programa bajo licencia. Para buscar este producto, especifique GO LICPGM en la línea de mandatos y seleccione la opción 10 (Visualizar programas bajo licencia instalados). Se visualizará en la lista de programas bajo licencia. La tabla QSYS2.SYSTEXTSERVERS contiene información acerca de los IBM OmniFind Text Search Servers instalados y disponibles para DB2 for i. Cundo se instala por primera vez el producto OmniFind Text Search Server for DB2 for i, se crea un servidor de búsqueda de texto predeterminado en el sistema IBM i. La tabla QSYS.SYSTEXTSERVERS también se llena con información del servidor predeterminado. Crear servidores de búsqueda de texto adicionales Si está utilizando servidores de búsqueda de texto en un sistema IBM remoto o si está utilizando servidores no IBM, como por ejemplo un servidor Windows o Linux, llene explícitamente esta tabla emitiendo una sentencia SQL INSERT. Si desea llenar la tabla QSYS2.SYSTEXTSERVERS con servidores adicionales, siga estos pasos en la sentencia SQL INSERT: 1. Especifique el número de puerto y el nombre del servidor para cada servidor de búsqueda de texto en las columnas SERVERPORT y SERVERNAME de la tabla QSYS2.SYSTEXTSERVERS emitiendo una sentencia SQL INSERT. 2. Especifique la señal de autenticación de cada servidor de búsqueda de texto en la columna SERVERAUTHTOKEN de la tabla QSYS2.SYSTEXTSERVERS en la sentencia SQL INSERT. Cuando la base de datos DB2 se comunica con un servidor de búsqueda de texto, es necesaria una señal de autenticación. Esta señal se genera en el servidor de búsqueda de texto durante la instalación. 3. Especifique la clave de servidor de cada servidor de búsqueda de texto en la columna SERVERMASTERKEY de la tabla QSYS2.SYSTEXTSERVERS en la sentencia SQL INSERT. 12 IBM i: OmniFind Text Search Server for DB2 for i 4. OPCIONAL: especifique un nombre de alias (ALIASNAME) para el servidor en la columna ALIASNAME. Este ALIASNAME puede utilizarse para hacer referencia al servidor en las operaciones posteriores. Ejemplo El ejemplo siguiente de sentencia SQL INSERT copia la información necesaria para un servidor de búsqueda de texto en las columnas de la tabla QSYS2.SYSTEXTSERVERS: INSERT INTO QSYS2.SYSTEXTSERVERS(SERVERNAME, SERVERADRINFO, SERVERPORT, SERVERTYPE, SERVERAUTHTOKEN, SERVERMASTERKEY, SERVERPATH, ALIASNAME) VALUES(’127.0.0.1’, VARBINARY(X’0000’), 49200, 0, ’AH2X4w==’, ’b1YhcR9O858ArwxLJeIY/Q==’, ’/QOpenSys/QIBM/ProdData/TextSearch/server1/bin/’, ’LOCALSERVER2’); Los valores de ejemplo deben sustituirse por los valores reales del servidor. Conceptos relacionados: “Nombre de alias de servidor” en la página 11 Puede utilizar un nombre de alias de servidor para asignar un nombre significativo a un servidor. Referencia relacionada: “Tabla de administración QSYS2.SYSTEXTSERVERS” en la página 115 Puede visualizar dónde están instalados los servidores de búsqueda de texto mediante la tabla de administración QSYS2.SYSTEXTSERVERS. Iniciar funciones de búsqueda de texto Antes de empezar a utilizar las funciones de búsqueda de texto, llame al procedimiento almacenado SYSPROC.SYSTS_START. Al llamar a este procedimiento, podrá iniciar todos los servidores de producción que ha definido como locales con respecto al sistema. El soporte de búsqueda de texto incluye sentencias SQL que utilizan la función CONTAINS, la función SCORE y los siguientes procedimientos almacenados de administración: v SYSPROC.SYSTS_CREATE v SYSPROC.SYSTS_UPDATE v SYSPROC.SYSTS_DROP Referencia relacionada: “SYSPROC.SYSTS_START” en la página 15 Puede habilitar funciones de búsqueda de texto de DB2 llamando al procedimiento almacenado SYSPROC.SYSTS_START. “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. “SYSPROC.SYSTS_UPDATE” en la página 36 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de OmniFind Text Search Server 13 búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. “SYSPROC.SYSTS_DROP” en la página 34 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_DROP para eliminar un índice de búsqueda de texto definido mediante el procedimiento almacenado SYSPROC.SYSTS_CREATE. “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. Crear un índice de búsqueda de texto Puede crear un índice de búsqueda de texto llamando al procedimiento almacenado SYSPROC.SYSTS_CREATE. La tabla base de DB2 debe contener una columna ROWID, una clave exclusiva o una clave primaria. Para crear un índice de búsqueda de texto en una tabla de DB2 existente con una columna que contiene texto: Llame al procedimiento almacenado SYSPROC.SYSTS_CREATE. El índice de búsqueda de texto estará vacío hasta que el índice se actualice por primera vez. Referencia relacionada: “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. Actualizar un índice de búsqueda de texto Puede actualizar un índice de búsqueda de texto llamando al procedimiento almacenado SYSPROC.SYSTS_UPDATE. La llamada a SYSTS_UPDATE se utiliza para llenar inicialmente el índice de búsqueda de texto. También se utiliza cuando cambia el contenido de las tablas de DB2 y el usuario desea sincronizar el índice de búsqueda de texto con dichos cambios. Una vez realizada una actualización del índice de búsqueda de texto, puede realizar consultas de búsqueda en el índice de búsqueda de texto. La columna de búsqueda de texto de la tabla base puede cambiarse después de la actualización. En ese caso, los resultados de la consulta de búsqueda no reflejarán dichos cambios hasta la próxima vez que se ejecute una actualización del índice de búsqueda de texto. Referencia relacionada: “SYSPROC.SYSTS_UPDATE” en la página 36 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. Buscar en un índice de búsqueda de texto Puede buscar en un índice de búsqueda de texto mediante una sentencia SQL con una función CONTAINS o SCORE. En la función se especifican los criterios del argumento de búsqueda. 14 IBM i: OmniFind Text Search Server for DB2 for i El usuario que realiza las consultas de texto en una tabla de DB2 debe tener establecido el privilegio estándar necesario para cualquier formato de consulta, según lo especificado en DB2 SQL Reference. Referencia relacionada: “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. Recorte de documentos OmniFind Text Search Server for DB2 for i limita el número de caracteres que pueden indexarse para cada documento de texto. A veces, esta limitación de caracteres provoca el recorte de documentos de texto grandes en el índice de búsqueda de texto. El servidor de búsqueda de texto puede recortar los documentos que contienen más de 10 millones de caracteres Unicode. En el caso de un documento de texto enriquecido, este límite se aplica después de transformar el documento a texto sin formato. So un documentos de texto se recorta durante la fase de análisis, el usuario recibe un aviso que indica que algunos documentos no se han proceso totalmente. El aviso aparece en el registro de trabajo. El documento se indexa parcialmente. El texto que se encuentra en el documento una vez alcanzado el límite no se indexa y no se tiene en cuenta durante las búsquedas. Puede que sea conveniente eliminar del índice de búsqueda de texto el documento recortado para evitar un comportamiento inesperado durante el proceso de búsqueda. Puede eliminar el documento eliminando el registro correspondiente de la tabla de DB2 o cambiado el valor del documento a vacío o nulo. Procedimientos almacenados de administración para búsqueda de texto Puede iniciar y detener funciones de búsqueda de texto y crear, eliminar y actualizar índices de búsqueda de texto mediante un conjunto de procedimientos almacenados SQL de administración. Estos procedimientos pueden invocarse desde cualquier interfaz de SQL. No puede llamar a estos procedimientos desde una línea de mandatos de IBM i mediante mandatos CL. Al examinar los catálogos de sistema mediante STRSQL, puede visualizar el contenido de las columnas estableciendo el trabajo con un CCSID distinto de 65535. SYSPROC.SYSTS_START Puede habilitar funciones de búsqueda de texto de DB2 llamando al procedimiento almacenado SYSPROC.SYSTS_START. Las funciones de búsqueda de texto incluyen soporte para consultas SQL que utilizan la función CONTAINS, la función SCORE y los procedimientos almacenados de administración utilizados para el mantenimiento de los índices de búsqueda de texto. Ejecute el procedimiento almacenado SYSPROC.SYSTS_START cada vez que se añada o cambie un servidor de la tabla QSYS2.SYSTEXTSERVERS. OmniFind Text Search Server 15 Si las funciones de búsqueda de texto no se inician, la base de datos devuelve el SQLCODE -20424 con el código de razón 4 para las funciones CONTAINS y SCORE. Los procedimientos administrativos SYSPROC.SYSTS_CREATE y SYSPROC.SYSTS_UPDATE también fallarán con el SQLCODE -20424 si el servidor no se ha iniciado. Para los servidores de búsqueda de texto que se encuentran en la tabla QSYS2.SYSTEXTSERVERS, se resuelven nombres TCP/IP. Varias llamadas al procedimiento almacenado SYSPROC.SYSTS_START no se consideran un error. Este proceso permite comprobar la resolución de direcciones de la tabla QSYS2.SYSTEXTSERVERS. Si el servidor es local, esta llamada al procedimiento almacenado inicia el servidor, si aún no lo ha hecho. Si el servidor es remoto, la llamada al procedimiento comprueba que el servidor está activo, pero no lo inicia realmente. Requisitos previos Antes de llamar al procedimiento almacenado SYSPROC.SYSTS_START, compruebe que la tabla QSYS2.SYSTEXTSERVERS contiene como mínimo una entrada. Autorización El ID de usuario bajo el que se invoca este procedimiento almacenado debe tener los siguientes privilegios: v Autorización *EXECUTE sobre el procedimiento. v Privilegios SELECT y UPDATE sobre la tabla SYSTXTSRVR. v Autorización *EXECUTE sobre la biblioteca QSYS2 del archivo SYSTXTSRVR. v Autorización *JOBCTL o utilización de la función especial de seguridad QIBM_DB_SQLADM. Para obtener información acerca de las autorizaciones del sistema correspondientes a los privilegios SQL, consulte el apartado GRANT (Privilegios de tabla o vista). Sintaxis SYSPROC.SYSTS_START ( ) idservidor nombrealias El calificador de esquema es SYSPROC. Parámetro idservidor o nombrealias Especifica el identificador del servidor que debe iniciarse. Un idservidor o un nombrealias de servidor es una serie de caracteres. Si no se especifica ningún identificador, el valor predeterminado es iniciar todos los servidores. La serie del identificador debe ser un idservidor válido existente en la columna SERVERID o un nombrealias de servidor válido existente en la columna ALIASNAME de la tabla QSYS2.SYSTEXTSERVERS. Si el identificador puede convertirse a un valor entero, se interpreta como idservidor. Si el identificador no puede convertirse a un valor entero, se interpreta como nombrealias de servidor. El tipo de datos de este parámetro es VARCHAR(128). Nota: Si no se especifica ningún valor para idservidor o nombrealias, sólo se inician los servidores identificados como servidores de producción. Los servidores de producción se identifican mediante el 16 IBM i: OmniFind Text Search Server for DB2 for i parámetro SERVERCLASS = 0 en la tabla QSYS2.SYSTEXTSERVERS. Los servidores de prueba deben iniciarse especificando el idservidor o nombrealias asociado con ellos. Para iniciar todos los servidores de producción: CALL SYSPROC.SYSTS_START(). Para iniciar un servidor con el ID 1: CALL SYSPROC.SYSTS_START(1) Para iniciar un servidor con el nombre de alias "LOCAL_SERVER": CALL SYSPROC.SYSTS_START('LOCAL_SERVER') Para iniciar un servidor con el nombre de alias "local_server": CALL SYSPROC.SYSTS_START('"local_server"') Conceptos relacionados: “Nombre de alias de servidor” en la página 11 Puede utilizar un nombre de alias de servidor para asignar un nombre significativo a un servidor. Tareas relacionadas: “Iniciar OmniFind Text Search Server for DB2 for i” en la página 70 Puede iniciar OmniFind Text Search Server for DB2 for i llamando al procedimiento SYSPROC.SYSTS_START. Referencia relacionada: “Tabla de administración QSYS2.SYSTEXTSERVERS” en la página 115 Puede visualizar dónde están instalados los servidores de búsqueda de texto mediante la tabla de administración QSYS2.SYSTEXTSERVERS. “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. SYSPROC.SYSTS_STOP Puede llamar al procedimiento almacenado SYSPROC.SYSTS_STOP para detener las funciones de búsqueda de texto de DB2. Este procedimiento almacenado establece el valor SERVERSTATUS del catálogo QSYS2.SYSTEXTSERVERS en 1 (detenido). Una vez completado este procedimiento almacenado, las consultas SQL que utilicen las funciones CONTAINS o SCORE o los procedimientos almacenados de administración utilizados para el mantenimiento de los índices devolverán una anomalía sin intentar contactar con un servidor de búsqueda de texto. Nota: Los procedimientos administrativos y las consultas SQL que utilizan las funciones incorporadas CONTAINS o SCORE que se estuvieran ejecutando al invocar SYSTS_STOP podrán finalizar. Los cambios en la tabla base del índice se siguen registrando aunque el servidor esté detenido. Sin embargo, las actualizaciones planificadas del índice no se producirán hasta que se haya invocado a SYSPROC.SYSTS_START. OmniFind Text Search Server 17 Autorización El ID de usuario bajo el que se invoca este procedimiento almacenado debe tener los siguientes privilegios: v Autorización *EXECUTE sobre el procedimiento. v Privilegios SELECT y UPDATE sobre la tabla SYSTEXTSERVERS. v Autorización *EXECUTE sobre la biblioteca QSYS2 del archivo SYSTEXTSERVERS. v Autorización *JOBCTL o utilización de la función especial de seguridad QIBM_DB_SQLADM. Para obtener información acerca de las autorizaciones del sistema correspondientes a los privilegios SQL, consulte el apartado GRANT (Privilegios de tabla o vista). Sintaxis SYSTS_STOP ( ) idservidor nombrealias El calificador de esquema es SYSPROC. Parámetro idservidor o nombrealias Especifica el identificador del servidor que debe detenerse. Un idservidor o un nombrealias de servidor es una serie de caracteres. Si no se especifica ningún identificador, el valor predeterminado es detener todos los servidores. La serie del identificador debe ser un idservidor válido existente en la columna SERVERID o un nombrealias de servidor válido existente en la columna ALIASNAME de la tabla QSYS2.SYSTEXTSERVERS. Si el identificador puede convertirse a un valor entero, se interpreta como idservidor. Si el identificador no puede convertirse a un valor entero, se interpreta como nombrealias de servidor. El tipo de datos de este parámetro es VARCHAR(128). Para detener todos los servidores de producción: CALL SYSPROC.SYSTS_STOP(). Para detener un servidor con el ID 1: CALL SYSPROC.SYSTS_STOP(1) Para detener un servidor con el nombre de alias "LOCAL_SERVER": CALL SYSPROC.SYSTS_STOP('LOCAL_SERVER') Para detener un servidor con el nombre de alias "local_server": CALL SYSPROC.SYSTS_STOP('"local_server"') Conceptos relacionados: “Nombre de alias de servidor” en la página 11 Puede utilizar un nombre de alias de servidor para asignar un nombre significativo a un servidor. Referencia relacionada: “Tabla de administración QSYS2.SYSTEXTSERVERS” en la página 115 Puede visualizar dónde están instalados los servidores de búsqueda de texto mediante la tabla de administración QSYS2.SYSTEXTSERVERS. 18 IBM i: OmniFind Text Search Server for DB2 for i “SYSPROC.SYSTS_START” en la página 15 Puede habilitar funciones de búsqueda de texto de DB2 llamando al procedimiento almacenado SYSPROC.SYSTS_START. “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. SYSPROC.SYSTS_CREATE Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. El índice de búsqueda de texto se crea en uno de los servidores de búsqueda de texto listados en la tabla QSYS2.SYSTEXTSERVERS. El índice de búsqueda de texto no se actualiza síncronamente cuando se actualiza la tabla de DB2. En lugar de ello, existen desencadenantes que capturan un registro de los cambios realizados en la columna de la tabla de DB2, que se coloca en una tabla intermedia. Nota: este procedimiento almacenado sólo define el índice de búsqueda de texto. El índice de búsqueda de texto no contiene datos hasta que se ha realizado la primera invocación del procedimiento almacenado SYSPROC.SYSTS_UPDATE para el nuevo índice de búsqueda de texto. El índice de búsqueda de texto se crea después de llenar inicialmente la tabla. Mediante la creación del índice de búsqueda de texto una vez llenada inicialmente la tabla, se evita la activación de desencadenantes de cambios antes de una actualización de índice inicial. Requisitos previos Antes de la llamada al procedimiento almacenado SYSPROC.SYSTS_CREATE, compruebe los siguientes requisitos previos: v Que se han iniciado las funciones de búsqueda de texto de DB2, invocando el procedimiento almacenado SYSPROC.SYSTS_START, y que existe como mínimo un servidor de búsqueda de texto en ejecución. v Que la tabla incluye una columna definida como clave primaria, índice exclusivo o ROWID. v Que la tabla QSYS2.SYSTEXTSERVERS contiene como mínimo una entrada. Autorización Los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v El privilegio de creación en el esquema. Para obtener más información, consulte el apartado Autorización, privilegios y propiedad de objetos. v Autoridad administrativa Los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v Las siguientes autorizaciones del sistema: – *USE sobre el mandato Crear archivo lógico (CRTLF) OmniFind Text Search Server 19 – *CHANGE sobre el diccionario de datos si la biblioteca en la que se crea el índice de texto es un esquema SQL con un diccionario de datos v Autoridad administrativa Los privilegios detentados por el ID de autorización de la sentencia también deben incluir como mínimo uno de los siguientes: v Para la tabla referenciada: – El privilegio INDEX sobre la tabla – La autorización del sistema *EXECUTE sobre la biblioteca que contiene la tabla v Autoridad administrativa v Si se especifican nombres SQL y existe un perfil de usuario que tiene el mismo nombre que la biblioteca en la que se crea el índice de texto, y dicho nombre es diferente del ID de autorización de la sentencia, los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los privilegios siguientes: – Autorización del sistema *ADD sobre el perfil de usuario con ese nombre – Autoridad administrativa Si se hace referencia a un tipo distinct, los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v Para cada tipo distinct identificado en la sentencia: – El privilegio USAGE sobre el tipo distinct, y – La autorización del sistema *EXECUTE sobre la biblioteca que contiene el tipo distinct v Autoridad administrativa Si la columna sobre la que se ha creado el índice de búsqueda de texto contiene un procedimiento de campo, el ID de autorización debe tener v Autorización *EXECUTE sobre el programa y v Autorización *EXECUTE sobre la biblioteca que contiene el programa O bien v Autoridad administrativa Para obtener información acerca de las autorizaciones del sistema correspondientes a los privilegios SQL, consulte el apartado GRANT (Privilegios de tabla o vista). Sintaxis SYSTS_CREATE ( esquemaÍndice nulo , nombreÍndice , origenTexto , opciones ) El calificador de esquema es SYSPROC. Parámetros esquemaÍndice Identifica el esquema del índice de búsqueda de texto. Si este parámetro es nulo, se utiliza el valor del registro especial CURRENT SCHEMA correspondiente al invocante. Este valor debe ser un nombre SQL válido. Nota: especifique los nombres entre comillas dobles si los nombres entran en conflicto con palabras clave SQL o palabras clave de OmniFind que puedan utilizarse. 20 IBM i: OmniFind Text Search Server for DB2 for i El tipo de datos de este parámetro es VARCHAR(128). nombreÍndice Identifica el nombre del índice de búsqueda de texto. El nombre del índice de búsqueda de texto, junto con el esquema del índice, identifican de forma exclusiva el índice de texto en el subsistema DB2. Debe especificar un valor no nulo en este parámetro. Este valor debe ser un nombre SQL válido. Nota: especifique los nombres entre comillas dobles si los nombres entran en conflicto con palabras clave SQL o palabras clave de OmniFind que puedan utilizarse. El tipo de datos de este parámetro es VARCHAR(128). origenTexto Identifica la especificación de tabla y columna para el origen de texto del documento. Este parámetro puede incluir funciones definidas por el usuario. Debe especificar un valor no nulo en este parámetro. El tipo de datos de este parámetro es VARCHAR(1024). origenTexto: esquemaTabla. nombreTabla ( nombre-columna-texto ) nombre-función esquema-función ( nombre-columna-texto ) . esquemaTabla Identifica el esquema de la tabla en que se crea el índice de búsqueda de texto. Nota: especifique los nombres entre comillas dobles si los nombres entran en conflicto con palabras clave SQL o palabras clave de OmniFind que puedan utilizarse. nombreTabla Identifica el nombre de la tabla de texto que contiene la columna sobre la que se crea el índice de búsqueda de texto externo. Notas: v Las vistas y archivos lógicos no están soportados. v Un alias debe señalar hacia una tabla o hacia un único miembro de un archivo físico. v Especifique los nombres entre comillas dobles si los nombres entran en conflicto con palabras clave SQL o palabras clave de OmniFind. nombre-columna-texto Identifica el nombre de la columna que contiene el texto utilizado para crear el índice de búsqueda de texto. Esta columna debe ser de tipo CHAR, CHAR FOR BIT DATA, BINARY, VARCHAR, VARCHAR FOR BIT DATA, VARBINARY, CLOB, DBCLOB, BLOB, XML, GRAPHIC o VARGRAPHIC. Si el tipo de datos no pertenece a uno de los anteriores, puede especificar una función externa que devuelva un tipo de datos soportado. Notas: v Sólo se permite un índice de búsqueda de texto para una columna. Si existe un índice de búsqueda de texto para la columna, se devuelve el SQLCODE-20427. v Especifique los nombres entre comillas dobles si los nombres entran en conflicto con palabras clave SQL o palabras clave de OmniFind. esquema-función. nombre-función Identifica el esquema y el nombre de una función incorporada o definida por usuario. La función puede utilizarse para modificar un documento de texto almacenado en la columna. La función también puede utilizarse para acceder a documentos de texto que se encuentran OmniFind Text Search Server 21 en una columna que no es de un tipo de datos soportado. O bien puede utilizarse para acceder a un documento almacenado en otro lugar. La función tiene un parámetro de entrada para el tipo de datos de columna de texto. Por ejemplo, un entero que actúa como clave foránea del contenido del documento de otro tabla. La función devuelve un valor de uno de los tipos de datos soportados por OmniFind Text Search for DB2 for i. La función transforma el contenido de la columna de texto en el contenido del documento indexado. Notas: v Las funciones de conversión de tipo de datos y las funciones con más de un argumento no están permitidas. v especifique los nombres entre comillas dobles si los nombres entran en conflicto con palabras clave SQL o palabras clave de OmniFind que puedan utilizarse. opciones Serie de caracteres que especifica las diversas opciones que están disponibles para este procedimiento almacenado. El tipo de datos de este parámetro es VARCHAR(32000). opciones: información-predeterminada-texto características-actualización opciones-configuración-índice información-predeterminada-texto: CCSID ccsid LANGUAGE idioma FORMAT formato información-predeterminada-texto Especifica el identificador de juego de caracteres codificados utilizado al indexar documentos de texto binarios. También especifica el idioma utilizado al procesar documentos y el formato de los documentos de texto de la columna. CCSID ccsid Especifica el identificador de juego de caracteres codificados utilizado para un índice de búsqueda de texto en una columna con un tipo de datos binarios. El valor predeterminado es 1208 (UTF-8), que se toma de la tabla QSYS2.SYSTEXTDEFAULTS. En este parámetro se permiten todos los CCSID soportados para la conversión a UTF-8 por los servicios de conversión de IBM i. Este parámetro se ignora para un índice de búsqueda de texto en una columna con un tipo de datos no binarios. Las columnas de texto heredan el CCSID de la especificación de tabla. El valor de ccsid se ignora cuando el valor de formato se establece en INSO. LANGUAGE idioma Especifica el idioma que OmniFind Text Search Server for DB2 for i utiliza para el proceso lingüístico de los documentos de texto. El valor predeterminado es en_US (inglés). Si especifica AUTO como valor de este parámetro, OmniFind Text Search Server for DB2 for i intentará determinar el idioma. Importante: Si el idioma de los documentos no es el inglés, no utilice el valor predeterminado en_US. Cambie el valor al idioma de los documentos; de lo contrario, el proceso lingüístico no funcionará según lo esperado. FORMAT formato identifica el formato de los documentos de texto de la columna, como por ejemplo HTML. OmniFind Text Search Server for DB2 for i necesita conocer el formato, o tipo de contenido, 22 IBM i: OmniFind Text Search Server for DB2 for i de los documentos de texto que tiene previsto indexar y en los que va a realizar búsquedas. Si no especifica el parámetro formato, el valor predeterminado se toma de la columna FORMAT de la tabla QSYS2.SYSTEXTDEFAULTS. Los valores de formato soportados son TEXT, HTML, XML e INSO. El valor de formato INSO permite a OmniFind Text Search Server for DB2 for i determinar el formato. En este caso, el valor de ccsid se ignora. Si OmniFind Text Search Server for DB2 for i no puede determinar el formato del documento, el procedimiento almacenado SYSPROC.SYSTS_UPDATE anota un error de documento en el registro de trabajo durante el proceso. Nota: Si no especifica el parámetro formato al crear el índice sobre una columna de tipo de datos XML, el valor predeterminado es XML. Si especifica el parámetro formato como TEXT o INSO, la prestación de búsqueda XML no estará disponible para este índice. Además, aparecerá un mensaje de aviso en el registro de trabajo. características-actualización: NONE < frecuencia-actualización> UPDATE FREQUENCY UPDATE MINIMUM mín_cambios características-actualización Especifica la frecuencia de las actualizaciones automáticas en el índice de búsqueda de texto. También especifica el número mínimo de cambios que deben realizarse en los documentos de texto antes de que el índice de búsqueda de texto se actualice incrementalmente a la hora especificada. UPDATE FREQUENCY frecuencia-actualización Especifica cuándo realizar actualizaciones automáticas en el índice de búsqueda de texto. El valor predeterminado es NONE. Esta opción puede ser de utilidad para una columna de texto en la que no haya más cambios. El formato de la opción frecuencia-actualización admite dos formatos. frecuencia-actualización (Formato 1): NONE D ( * ) H ( * , ) M ( * , 0..6 0..23 0..6 ) , 0..59 0..23 0..59 NONE Si se especifica NONE, no se realizan más actualizaciones de índice. La actualización debe iniciarse manualmente. Esta opción puede ser de utilidad para una columna de texto en la que no haya más cambios planificados. D Especifica el día o días de la semana en los que se actualiza el índice. Un asterisco (*) indica todos los días. 0 indica el Domingo. H Especifica la hora u horas en las que se actualiza el índice. Un asterisco (*) indica todas las horas. M Especifica el minuto o minutos en los que se actualiza el índice. No puede especificarse un asterisco (*). La frecuencia de actualización mínima es de 5 minutos. Ejemplo: este ejemplo especifica que la actualización de índice debe ejecutarse cada 30 minutos. UPDATE FREQUENCY D(*) H(*) M(0,30) OmniFind Text Search Server 23 frecuencia-actualización (Formato 2, cronológico): < minuto> < hora> <díaDelMes> <mesDelAño> <díaDeLaSemana> El formato de la opción frecuencia-actualización (cronológica) es una lista de cinco valores separados por espacios en blanco. Los cinco valores representan los minutos, horas, días del mes, meses del año y días de la semana empezando por el Domingo. Si especifica un intervalo de valores o un asterisco (*), puede especificar un valor de recorrido utilizando una barra inclinada (/) al final del intervalo definido. Ejemplo: este ejemplo especifica que la actualización de índice debe ejecutarse cada cuarto de hora (0,15,30,45) en las horas pares entre las 8 a.m. y las 6:45 p.m. (8-18/2 es equivalente a 8,10,12,14,16,18), de Lunes a Viernes todos los meses del año (* * 1-5). 0,15,30,45 8-18/2 * * 1-5 minuto Especifica los minutos de la hora en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para un intervalo de cada 5 minutos o un entero de 0 a 59. No pueden repetirse valores. La frecuencia de actualización mínima es de 5 minutos. Un valor de 1, 4 u 8 no es válido. frecuencia-actualización (minuto): * / 0...59 , 0...59 - 0...59 / 0...59 0...59 hora Especifica las horas del día en las que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada hora o un entero de 0 a 23. No pueden repetirse valores. frecuencia-actualización (hora): * / 0...23 , 0...23 - 0...23 / 0...23 0...23 díaDelMes Especifica los días del mes en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada día o un entero de 1 a 31. No pueden repetirse valores. frecuencia-actualización (díaDelMes): * / 1...31 , 1...31 - 1...31 / 1...31 1...31 24 IBM i: OmniFind Text Search Server for DB2 for i mesDelAño Especifica los meses del año en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada mes o un entero de 1 a 12. No pueden repetirse valores. frecuencia-actualización (mesDelAño): * / 1...12 , 1...12 - 1...12 / 1...12 1...12 díaDeLaSemana Especifica los días de la semana en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada día o un entero de 0 a 7. Tanto 0 como 7 son valores válidos para el Domingo. No pueden repetirse valores. frecuencia-actualización (díaDeLaSemana): * / 0...7 , 0...7 - 0...7 / 0...7 0...7 UPDATE MINIMUM mín_cambios Especifica el número mínimo de cambios de registro realizados en la tabla subyacente antes de que el índice de búsqueda de texto se actualice incrementalmente a la hora especificada en la opción frecuencia-actualización. El valor debe ser un entero de 1 a 2147483647. El valor predeterminado se toma de la columna UPDATEMINIMUM de la tabla QSYS2.SYSTEXTDEFAULTS. Esta opción se ignora al actualizar el índice de búsqueda de texto, a menos que especifique la opción USING UPDATE MINIMUM en el procedimiento almacenado SYSPROC.SYSTS_UPDATE. opciones-configuración-índice: , INDEX CONFIGURATION ( opción valor ) ROW_COLUMN_ACCESS: NOT SECURED SECURED opciones-configuración-índice Especifica valores adicionales específicos de índice en forma de pares de opción y valor. Debe especificar los valores tipo serie entre comillas simples. Un comilla simple dentro de un valor tipo serie debe representarse mediante dos comillas simples consecutivas. OmniFind Text Search Server 25 CJKSEGMENTATION Especifica el método de segmentación que debe utilizarse al indexar documentos para idiomas CJK (chino, japonés, coreano). Los valores soportados son MORPHOLOGICAL y NGRAM. Si no se especifica el valor CJKSEGMENTATION, se utiliza el valor predeterminado. El valor predeterminado se especifica en la columna DEFAULTNAME de la tabla QSYS2.SYSTEXTDEFAULTS. COMMENT Especifica un comentario que se almacena en la columna REMARKS de la tabla de administración QSYS2.SYSTEXTINDEXES y como descripción de la colección de OmniFind Text Search Server for DB2 for i. El valor de esta opción es un valor tipo serie inferior o igual a 512 bytes. IGNOREEMPTYDOCS Especifica si deben representarse los documentos vacíos en el índice de búsqueda de texto. Los documentos vacíos son aquellos con una serie vacía o un valor nulo. Los valores soportados para esta opción son 0 (cero) y 1. El valor predeterminado es 1. Si esta opción se establece en 1, los documentos vacíos no estarán representados en el índice de búsqueda de texto. Si utiliza esta opción y cambia el contenido del documento a vacío, la próxima actualización incremental suprimirá los documentos del índice de búsqueda de texto. KEYCOLUMN Especifica el nombre de una columna exclusiva que debe utilizarse como columna de clave en el índice de texto. La columna de clave se utiliza para asociar datos del índice de texto a un documento o fila de la tabla base. La columna especificada debe tener una restricción de clave primaria o índice exclusivo. Si no se especifica KEYCOLUMN, se utiliza la columna ROWID de la tabla, si existe. De lo contrario, se utiliza la clave primaria definida en la tabla. SERVER Especifica el ID o nombre de alias del servidor que debe utilizarse para almacenar el índice de búsqueda de texto. Si se utiliza un ID, el valor es un entero que debe existir en la columna SERVERID del catálogo QSYS2.SYSTEXTSERVERS. Si se utiliza un nombre de alias, el valor es una serie que debe existir en la columna ALIASNAME del catálogo QSYS2.SYSTEXTSERVERS. Si no se especifica SERVER, el valor predeterminado es seleccionar el servidor con menos índices de búsqueda de texto entre los servidores de la tabla QSYS2.SYSTEXTSERVERS en los que el parámetro SERVERSTATUS está establecido en 0 (cero), lo que indica que el servidor está disponible. UPDATEAUTOCOMMIT Especifica la frecuencia con la que se realiza una operación de confirmación al extraer documentos durante una actualización de índice. El valor 0 (cero) indica que una operación de confirmación sólo se realiza al final del proceso. El valor debe ser un entero entre 0 (cero) y 2147483647. El valor predeterminado es 100. Sugerencia de rendimiento: el valor de UPDATEAUTOCOMMIT puede tener un impacto significativo sobre el rendimiento de las actualizaciones de índice. La operación de confirmación que tiene lugar con el intervalo especificado garantiza un punto de comprobación coherente desde el que reiniciar la actualización de índice, si se interrumpe. Sin embargo, la confirmación también suspende temporalmente el proceso de actualización. Aumentar el valor de UPDATEAUTOCOMMIT (o establecerlo en 0) puede mejorar significativamente el rendimiento de la actualización, especialmente de la inicial. El valor que especifique debe buscar el equilibrio entre las necesidades de rendimiento y las de recuperabilidad, en función de la frecuencia de las actualizaciones del índice. ROW_COLUMN_ACCESS Especifica si el índice de búsqueda de texto se considera seguro para el control de acceso a filas y el control de acceso a columnas. 26 IBM i: OmniFind Text Search Server for DB2 for i NOT_SECURED Especifica que el índice de búsqueda de texto no se considera seguro para el control de acceso a filas y el control de acceso a columnas. Este es el valor predeterminado. La tabla base para el índice no debe tener un permiso o máscara activa. SECURED Especifica que el índice se considera seguro para el control de acceso a filas y el control de acceso a columnas. Un índice de búsqueda de texto debe estar definido como seguro para poder crearse sobre una tabla con una máscara de columna o permiso activo. Si una función está referenciada para acceder o modificar datos de una columna enmascarados, la función debe definirse como segura. El ID de autorización debe tener la autorización DB_SECADMIN para crear un índice de búsqueda de texto con el atributo SECURED. Cuando un índice de búsqueda de texto se crea sobre información confidencial, existen consideraciones adicionales: El administrador de bases de datos debe ser consciente de que los datos especificados como columnas de clave para el índice de búsqueda de texto se almacenarán en una tabla intermedia de QSYS2 y se enviarán al servidor de búsqueda de texto utilizando protocolos de red. El administrador de bases de datos debe ser consciente de que los datos indexados por un índice de búsqueda de texto se envían al servidor de búsqueda de texto utilizando protocolos de red y se almacenan fuera de DB2 en el servidor de búsqueda de texto. Valores predeterminados del parámetro opciones Al instalar OmniFind Text Search for DB2 for i, se crea la tabla QSYS2.SYSTEXTDEFAULTS y se llena con valores predeterminados para el parámetro opciones del procedimiento almacenado SYSPROC.SYSTS_CREATE. En la tabla siguiente se indican las opciones, los valores predeterminados y las descripciones de las opciones. Tabla 2. Valores predeterminados del parámetro opciones Opción Valor predeterminado Descripción CCSID 1208 Especifica el identificador de juego de caracteres codificados utilizado al indexar documentos de texto binarios. CJKSEGMENTATION NGRAM Especifica el método de segmentación que debe utilizarse al indexar documentos para idiomas CJK (chino, japonés, coreano). LANGUAGE en_US Especifica el idioma utilizado para procesar documentos de texto. FORMAT TEXT Identifica el formato de los documentos de texto de la columna. El formato predeterminado es texto sin formato, a menos que el tipo de datos sea XML. UPDATEFREQUENCY NONE Indica que no hay actualizaciones automáticas planificadas. UPDATEMINIMUM 1 Si un documento como mínimo ha cambiado desde la última actualización del índice, el procedimiento almacenado SYSPROC.SYSTS_UPDATE inicia el proceso. OmniFind Text Search Server 27 Tabla 2. Valores predeterminados del parámetro opciones (continuación) Opción Valor predeterminado Descripción IGNOREEMPTYDOCS 1 Especifica que los documentos vacíos (aquellos con una serie vacía o un valor nulo) no están representados en el índice de búsqueda de texto. Los campos de metadatos para estos documentos no están disponibles para la búsqueda. UPDATEAUTOCOMMIT 100 Especifica la frecuencia con la que se realiza una operación de confirmación al extraer documentos durante una actualización de índice. MINIMUMUPDATEINTERVAL 5 Especifica los intervalos de la opción UPDATEFREQUENCY. Los intervalos no pueden ser inferiores a 5 minutos. ROW_COLUMN_ACCESS NOT_SECURED Especifica si el índice se crea como protegido. USEREXITTHREADS 0 Reservada Conceptos relacionados: “Formatos de documento soportados” en la página 6 Los datos de una columna de texto pueden ser texto sin formato, un documento HTML, un XML o cualquier documento que el motor de búsqueda reconozca. “Tipos de datos soportados” en la página 7 Los datos de las columnas de texto que desea indexar y en las que realizar búsquedas pueden ser datos binarios o datos de tipo carácter. Referencia relacionada: “Tabla de administración QSYS2.SYSTEXTSERVERS” en la página 115 Puede visualizar dónde están instalados los servidores de búsqueda de texto mediante la tabla de administración QSYS2.SYSTEXTSERVERS. “Tabla de administración QSYS2.SYSTEXTINDEXES” en la página 112 Puede visualizar información acerca de cada índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTINDEXES. Cada índice de búsqueda de texto tiene un nombre, un nombre de esquema y un nombre de colección asociada en el servidor de búsqueda de texto. “Tabla de administración QSYS2.SYSTEXTDEFAULTS” en la página 111 Puede visualizar los parámetros y valores predeterminados en la tabla de administración QSYS2.SYSTEXTDEFAULTS. Esta tabla se crea al instalar OmniFind Text Search for DB2 for i. “SYSPROC.SYSTS_UPDATE” en la página 36 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. “SYSPROC.SYSTS_START” en la página 15 Puede habilitar funciones de búsqueda de texto de DB2 llamando al procedimiento almacenado SYSPROC.SYSTS_START. “Idiomas soportados” en la página 8 Puede especificar que los documentos de texto se procesen mediante un idioma específico. SYSPROC.SYSTS_ALTER Puede llamar al procedimiento almacenado SYSPROC.SYSTS_ALTER para modificar los atributos de un índice creado por SYSPROC.SYSTS_CREATE. Sólo se cambiarán los atributos especificados explícitamente en este procedimiento. Todos los demás atributos del índice permanecerán sin cambios. Este procedimiento resulta de utilidad si necesita cambiar los atributos del índice, como por ejemplo la frecuencia de actualización, una vez que éste se ha creado. 28 IBM i: OmniFind Text Search Server for DB2 for i Requisitos previos Antes de llamar al procedimiento almacenado SYSPROC.SYSTS_ALTER, compruebe el siguiente requisito previo: v El índice de búsqueda de texto debe haberse creado (por invocación del procedimiento almacenado SYSPROC.SYSTS_CREATE). Autorización Los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v El privilegio de creación en el esquema. Para obtener más información, consulte el apartado Autorización, privilegios y propiedad de objetos. v Autoridad administrativa Los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v Las siguientes autorizaciones del sistema: – *USE sobre el mandato Crear archivo lógico (CRTLF) – *CHANGE sobre el diccionario de datos si la biblioteca en la que se crea el índice de texto es un esquema SQL con un diccionario de datos v Autoridad administrativa Los privilegios detentados por el ID de autorización de la sentencia también deben incluir como mínimo uno de los siguientes: v Para la tabla referenciada: – El privilegio INDEX sobre la tabla – La autorización del sistema *EXECUTE sobre la biblioteca que contiene la tabla v Autoridad administrativa v Si se especifican nombres SQL y existe un perfil de usuario que tiene el mismo nombre que la biblioteca en la que se crea el índice de texto, y dicho nombre es diferente del ID de autorización de la sentencia, los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo una de las autorizaciones siguientes: – Autorización del sistema *ADD sobre el perfil de usuario con ese nombre – Autoridad administrativa Si se hace referencia a un tipo distinct, los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v Para cada tipo distinct identificado en la sentencia: – El privilegio USAGE sobre el tipo distinct, y – La autorización del sistema *EXECUTE sobre la biblioteca que contiene el tipo distinct v Autoridad administrativa Para obtener información acerca de las autorizaciones del sistema correspondientes a los privilegios SQL, consulte el apartado GRANT (Privilegios de tabla o vista). Sintaxis SYSTS_ALTER ( esquemaÍndice , nombreÍndice , opciones ) OmniFind Text Search Server 29 El calificador de esquema es SYSPROC. Parámetros esquemaÍndice Identifica el esquema del índice de búsqueda de texto. Si este parámetro es nulo, se utiliza el valor del registro especial CURRENT SCHEMA correspondiente al invocante. El tipo de datos de este parámetro es VARCHAR(128). nombreÍndice Identifica el nombre del índice de búsqueda de texto. El nombre del índice de búsqueda de texto, junto con el esquema del índice, identifica de forma exclusiva el índice de texto en el subsistema DB2. Debe especificar un valor no nulo en este parámetro. El tipo de datos de este parámetro es VARCHAR(128). opciones Serie de caracteres que especifica las diversas opciones que están disponibles para este procedimiento almacenado. El tipo de datos de este parámetro es VARCHAR(32000). El valor del parámetro no puede ser NULL. Opciones: información-redenominar-función características-actualización opciones-configuración-índice información-redenominar-función: RENAME FUNCTION nombre-función esquema-función . Especifica la función definida por el usuario que debe redenominarse. esquema-función.nombre-función Especifica el esquema y el nombre de una función definida por el usuario. Esta opción se utiliza para cambiar una función que se ha especificado al crear un índice. Si se modifica la función, SYSTS_UPDATE utilizará la función nueva para indexar la columna de texto. Si la función se ha cambiado, SYSTS_UPDATE no cambiará los datos existentes del índice. Sólo se procesarán los datos nuevos cambiados después de la última actualización. características-actualización: UPDATE FREQUENCY NONE frecuencia-actualización UPDATE MINIMUM mín_cambios características-actualización Especifica la frecuencia de las actualizaciones automáticas en el índice de búsqueda de texto. También especifica el número mínimo de cambios que deben realizarse en los documentos de texto antes de que el índice de búsqueda de texto se actualice incrementalmente a la hora especificada. UPDATE FREQUENCY frecuencia-actualización Especifica la frecuencia de las actualizaciones automáticas en el índice de búsqueda de texto. 30 IBM i: OmniFind Text Search Server for DB2 for i El valor predeterminado es NONE. Esta opción puede ser de utilidad para una columna de texto en la que no haya más cambios. El formato de la opción frecuencia-actualización admite dos formatos. frecuencia-actualización (Formato 1): NONE D ( * ) H ( * , ) M ( * , 0..6 0..23 0..6 ) , 0..59 0..23 0..59 NONE Si se especifica NONE, no se realizan más actualizaciones de índice. La actualización debe iniciarse manualmente. Esta opción puede ser de utilidad para una columna de texto en la que no haya más cambios planificados. D Especifica el día o días de la semana en los que se actualiza el índice. Un asterisco (*) indica todos los días. 0 indica el Domingo. H Especifica la hora u horas en las que se actualiza el índice. Un asterisco (*) indica todas las horas. M Especifica el minuto o minutos en los que se actualiza el índice. No puede especificarse un asterisco (*). La frecuencia de actualización mínima es de 5 minutos. Ejemplo: este ejemplo especifica que la actualización de índice debe ejecutarse cada 30 minutos. UPDATE FREQUENCY D(*) H(*) M(0,30) frecuencia-actualización (Formato 2, cronológico): < minuto> < hora> <díaDelMes> <mesDelAño> <díaDeLaSemana> El formato de la opción frecuencia-actualización (cronológica) es una lista de cinco valores separados por espacios en blanco. Los cinco valores representan los minutos, horas, días del mes, meses del año y días de la semana empezando por el Domingo. Si especifica un intervalo de valores o un asterisco (*), puede especificar un valor de recorrido utilizando una barra inclinada (/) al final del intervalo definido. Ejemplo: este ejemplo especifica que la actualización de índice debe ejecutarse cada cuarto de hora (0,15,30,45) en las horas pares entre las 8 a.m. y las 6:45 p.m. (8-18/2 es equivalente a 8,10,12,14,16,18), de Lunes a Viernes todos los meses del año (* * 1-5). 0,15,30,45 8-18/2 * * 1-5 minuto Especifica los minutos de la hora en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para un intervalo de cada 5 minutos o un entero de 0 a 59. No pueden repetirse valores. La frecuencia de actualización mínima es de 5 minutos. Un valor de 1, 4 u 8 no está permitido. OmniFind Text Search Server 31 frecuencia-actualización (minuto): * / 0...59 , 0...59 - 0...59 / 0...59 0...59 hora Especifica las horas del día en las que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada hora o un entero de 0 a 23. No pueden repetirse valores. frecuencia-actualización (hora): * / 0...23 , 0...23 - 0...23 / 0...23 0...23 díaDelMes Especifica los días del mes en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada día o un entero de 1 a 31. No pueden repetirse valores. frecuencia-actualización (díaDelMes): * / 1...31 , 1...31 - 1...31 / 1...31 1...31 mesDelAño Especifica los meses del año en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada mes o un entero de 1 a 12. No pueden repetirse valores. frecuencia-actualización (mesDelAño): * / 1...12 , 1...12 - 1...12 / 1...12 1...12 díaDeLaSemana Especifica los días de la semana en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada día o un entero de 0 a 7. Tanto 0 como 7 son valores válidos para el Domingo. No pueden repetirse valores. 32 IBM i: OmniFind Text Search Server for DB2 for i frecuencia-actualización (díaDeLaSemana): * / 0...7 , 0...7 - 0...7 / 0...7 0...7 UPDATE MINIMUM mín_cambios Especifica el número mínimo de cambios de registro realizados en la tabla subyacente antes de que el índice de búsqueda de texto se actualice incrementalmente a la hora especificada en la opción frecuencia-actualización. El valor debe ser un entero de 1 a 2147483647. opciones-configuración-índice: , INDEX CONFIGURATION ( opción valor ) ROW_COLUMN_ACCESS: NOT SECURED SECURED COMMENT Especifica un comentario que se almacena en la columna REMARKS de la tabla de administración QSYS2.SYSTEXTINDEXES y como descripción de la colección de OmniFind Text Search Server for DB2 for i. El valor de esta opción es un valor tipo serie inferior o igual a 512 bytes. UPDATEAUTOCOMMIT Especifica la frecuencia con la que se realiza una operación de confirmación al extraer documentos durante una actualización de índice. El valor 0 (cero) indica que una operación de confirmación sólo se realiza al final del proceso. El valor debe ser un entero entre 0 (cero) y 2147483647. Sugerencia de rendimiento: el valor de UPDATEAUTOCOMMIT puede tener un impacto significativo sobre el rendimiento de las actualizaciones de índice. La operación de confirmación que tiene lugar con el intervalo especificado garantiza un punto de comprobación coherente desde el que reiniciar la actualización de índice, si se interrumpe. Sin embargo, la confirmación también suspende temporalmente el proceso de actualización. Aumentar el valor de UPDATEAUTOCOMMIT (o establecerlo en 0) puede mejorar significativamente el rendimiento de la actualización, especialmente de la inicial. El valor que especifique debe buscar el equilibrio entre las necesidades de rendimiento y las de recuperabilidad, en función de la frecuencia de las actualizaciones del índice. ROW_COLUMN_ACCESS Especifica si el índice de búsqueda de texto se considera seguro para el control de acceso a filas y el control de acceso a columnas. NOT_SECURED Especifica que el índice de búsqueda de texto no se considera seguro para el control de acceso a filas y el control de acceso a columnas. Este es el valor predeterminado. La tabla base para el índice no debe tener un permiso o máscara activa. OmniFind Text Search Server 33 SECURED Especifica que el índice se considera seguro para el control de acceso a filas y el control de acceso a columnas. Un índice de búsqueda de texto debe estar definido como seguro para poder crearse sobre una tabla con una máscara de columna o permiso activo. Si una función está referenciada para acceder o modificar datos de una columna enmascarados, la función debe definirse como segura. El ID de autorización debe tener la autorización DB_SECADMIN para crear un índice de búsqueda de texto con el atributo SECURED. Cuando un índice de búsqueda de texto se crea sobre información confidencial, existen consideraciones adicionales: El administrador de bases de datos debe ser consciente de que los datos especificados como columnas de clave para el índice de búsqueda de texto se almacenarán en una tabla intermedia de QSYS2 y se enviarán al servidor de búsqueda de texto utilizando protocolos de red. El administrador de bases de datos debe ser consciente de que los datos indexados por un índice de búsqueda de texto se envían al servidor de búsqueda de texto utilizando protocolos de red y se almacenan fuera de DB2 en el servidor de búsqueda de texto. Consejos: si los usuarios alteran un índice de SECURED a NOT SECURED, los usuarios deben asegurarse de que la tabla base no tenga una máscara de permiso activa. De lo contrario, se producirá un error. Referencia relacionada: “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. “SYSPROC.SYSTS_UPDATE” en la página 36 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. “Tabla de administración QSYS2.SYSTEXTINDEXES” en la página 112 Puede visualizar información acerca de cada índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTINDEXES. Cada índice de búsqueda de texto tiene un nombre, un nombre de esquema y un nombre de colección asociada en el servidor de búsqueda de texto. SYSPROC.SYSTS_DROP Puede llamar al procedimiento almacenado SYSPROC.SYSTS_DROP para eliminar un índice de búsqueda de texto definido mediante el procedimiento almacenado SYSPROC.SYSTS_CREATE. Es aconsejable eliminar un índice de búsqueda de texto mediante el procedimiento almacenado SYSPROC.SYSTS_DROP antes de eliminar la tabla. Al eliminar la vista que representa el índice de búsqueda de texto, incluso como resultado de una sentencia DROP TABLE CASCADE, se intenta eliminar el índice de búsqueda de texto. Sin embargo, dado que el índice de búsqueda de texto no puede eliminarse bajo control de compromiso, la vista SQL no puede eliminarse bajo control de compromiso. Si no puede accederse al servidor de búsqueda de texto, la colección del servidor puede quedar huérfana. Si eso ocurre, la colección deberá suprimirse manualmente. Cuando el servidor esté nuevo disponible, utilice la herramienta de administración de OmniFind Text Search Server for DB2 for i para suprimir la colección del servidor. 34 IBM i: OmniFind Text Search Server for DB2 for i En el apartado “Herramientas de administración” en la página 76 encontrará información acerca de las herramientas que puede utilizar para identificar índices huérfanos y el procedimiento almacenado STSPROC.SYSTS_REMOVE o SYSPROC.SYSTS_CLEAR_INDEXES para suprimirlos. Requisitos previos Antes de llamar al procedimiento almacenado SYSPROC.SYSTS_DROP, compruebe los siguientes requisitos previos: v Que se han iniciado las funciones de búsqueda de texto de DB2 llamando al procedimiento almacenado SYSPROC.SYSTS_START. v El índice de búsqueda de texto debe haberse creado (por invocación del procedimiento almacenado SYSPROC.SYSTS_CREATE). v Asegúrese de que los siguientes procedimientos almacenados no estén en ejecución para el índice de búsqueda de texto que desea eliminar: SYSPROC.SYSTS_CREATE, SYSPROC.SYSTS_UPDATE y SYSPROC.SYSTS_DROP. Autorización Los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v Las siguientes autorizaciones del sistema: – Las autorizaciones del sistema *OBJOPR y *OBJEXIST sobre el índice de texto que debe eliminarse – La autorización del sistema *EXECUTE sobre la biblioteca que contiene el índice de texto que debe eliminarse v Autoridad administrativa Para obtener información acerca de las autorizaciones del sistema correspondientes a los privilegios SQL, consulte el apartado GRANT (Privilegios de tabla o vista). Sintaxis SYSTS_DROP ( esquemaÍndice nulo , nombreÍndice ) El calificador de esquema es SYSPROC. Parámetros esquemaÍndice Identifica el esquema del índice de búsqueda de texto. Si este parámetro es nulo, se utiliza el valor del registro especial CURRENT SCHEMA correspondiente al invocante. El tipo de datos de este parámetro es VARCHAR(128). nombreÍndice Identifica el nombre del índice de búsqueda de texto. El nombre del índice de búsqueda de texto, junto con el esquema del índice, identifica de forma exclusiva el índice de texto en el subsistema DB2. Debe especificar un valor no nulo en este parámetro. El tipo de datos de este parámetro es VARCHAR(128). Referencia relacionada: “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan OmniFind Text Search Server 35 las funciones CONTAINS o SCORE. “SYSPROC.SYSTS_START” en la página 15 Puede habilitar funciones de búsqueda de texto de DB2 llamando al procedimiento almacenado SYSPROC.SYSTS_START. “SYSPROC.SYSTS_UPDATE” Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. “SYSPROC.SYSTS_REMOVE” en la página 78 Puede eliminar índices huérfanos con el procedimiento almacenado SQL SYSPROC.SYSTS_REMOVE. “SYSTS_CLEAR_INDEXES” en la página 81 Puede eliminar índices huérfanos con el procedimiento almacenado SQL SYSPROC. SYSTS_CLEAR_INDEXES. Otra forma implícita es invocar SYSTS_START directamente, que intenta borrar índices huérfanos automáticamente. SYSPROC.SYSTS_UPDATE Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. Dado que la actualización de un índice de búsqueda de texto es una operación amplia, el índice de búsqueda de texto no se actualiza síncronamente cuando se actualiza la tabla de DB2. En lugar de ello, los cambios de la columna de la tabla de DB2 se capturan mediante un desencadenante y se graban en una tabla intermedia. El índice de búsqueda de texto se actualizará la próxima vez que se invoque el procedimiento almacenado SYSPROC.SYSTS_UPDATE o cuando la opción UPDATE FREQUENCY indique que se actualiza. Por tanto, es posible que algunas solicitudes de búsqueda no reflejen las actualizaciones recientes de la tabla. Este procedimiento almacenado sólo efectúa el retorno una vez finalizado todo el proceso de actualización del índice de búsqueda de texto en OmniFind Text Search Server for DB2 for i. La duración depende del número de entradas de la tabla intermedia en el momento de llamar a SYSTS_UPDATE. Durante el proceso de actualización, sigue siendo posible realizar búsquedas en el índice de búsqueda de texto. Si se ha producido un problema al indexar un documento de la tabla base, la columna de la tabla intermedia con TOBEDELETED tendrá un valor establecido en E (error) o W (aviso). La columna ERRORMSG tiene valor para registrar mensajes de error. Puede recuperar estos registros con un procedimiento almacenado que incluya la consulta siguiente: SELECT s.TOBEDELETED, s.ERRORMSG, columnas_base FROM tabla_base t INNER JOIN QSYS2.tablasintermedias ON (QQQ_TEXTSEARCH_KEY(t.k1, t.k2, t.k3, ...) = s.KEYID) WHERE s.TOBEDELETED IN(’E’,’W’) En este caso, columnas_base es la lista de columnas que es necesario visualizar de la tabla_base. tabla_base es la tabla que se indexa. tabla intermedia es la tabla intermedia indicada en los catálogos del índice de búsqueda de texto. k1, k2, k3, ... es la lista de columnas de clave de la clave primaria, ID de fila o clave exclusiva utilizada para construir el índice de búsqueda de texto. ERRORMSG es una columna que registra los mensajes de error al indexar este documento. Una vez corregidos los errores de esos documentos, ejecute de nuevo la actualización. Si se solicita una actualización de índice al mismo tiempo que ya se está realizando una actualización para dicho índice, se devuelve un error. Sólo se permite una actualización a la vez para un índice determinado. Si se crea un índice como SECURED, los datos no enmascarados se recupera de la tabla base y se indexan, como si no hubiera ninguna máscara o permiso creados en esta tabla. 36 IBM i: OmniFind Text Search Server for DB2 for i Si hay procedimientos de campo creados en la tabla base, se indexan los datos originales sin enmascarar. Requisitos previos Antes de llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE, compruebe los siguientes requisitos previos: v El índice de búsqueda de texto debe haberse creado (por invocación del procedimiento almacenado SYSPROC.SYSTS_CREATE). v Los siguientes procedimientos almacenados no deben estar en ejecución para el índice de búsqueda de texto que desea actualizar: SYSPROC.SYSTS_CREATE, SYSPROC.SYSTS_UPDATE y SYSPROC.SYSTS_DROP. v El servidor de búsqueda de texto en el que reside el índice debe haberse iniciado mediante el procedimiento almacenado SYSTS_START. La columna SERVERSTATUS de QSYS2.SYSTEXTSERVERS debe tener el valor '0' (iniciado). Autorización Los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v El privilegio de creación en el esquema. Para obtener más información, consulte el apartado Autorización, privilegios y propiedad de objetos. v Autoridad administrativa Los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v Las siguientes autorizaciones del sistema: – *USE sobre el mandato Crear archivo lógico (CRTLF) – *CHANGE sobre el diccionario de datos si la biblioteca en la que se crea el índice de texto es un esquema SQL con un diccionario de datos v Autoridad administrativa Los privilegios detentados por el ID de autorización de la sentencia también deben incluir como mínimo uno de los siguientes: v Para la tabla referenciada: – El privilegio INDEX sobre la tabla – La autorización del sistema *EXECUTE sobre la biblioteca que contiene la tabla v Autoridad administrativa v Si se especifican nombres SQL y existe un perfil de usuario que tiene el mismo nombre que la biblioteca en la que se crea el índice de texto, y dicho nombre es diferente del ID de autorización de la sentencia, los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los privilegios siguientes: – Autorización del sistema *ADD sobre el perfil de usuario con ese nombre – Autoridad administrativa Si se hace referencia a un tipo distinct, los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v Para cada tipo distinct identificado en la sentencia: – El privilegio USAGE sobre el tipo distinct, y – La autorización del sistema *EXECUTE sobre la biblioteca que contiene el tipo distinct v Autoridad administrativa OmniFind Text Search Server 37 Si el índice se ha creado mediante SYSTS_CREATE como índice SECURED, el ID de autorización debe tener la autorización DB_SECADMIN. Para obtener información acerca de las autorizaciones del sistema correspondientes a los privilegios SQL, consulte el apartado GRANT (Privilegios de tabla o vista). Sintaxis SYSTS_UPDATE ( esquemaÍndice nulo , nombreÍndice , opciones ) El calificador de esquema es SYSPROC. Parámetros esquemaÍndice Identifica el esquema del índice de búsqueda de texto. Si este parámetro es nulo, se utiliza el valor del registro especial CURRENT SCHEMA correspondiente al invocante. El tipo de datos de este parámetro es VARCHAR(128). nombreÍndice Identifica el nombre del índice de búsqueda de texto. El nombre del índice de búsqueda de texto, junto con el esquema del índice, identifica de forma exclusiva el índice de texto completo en el subsistema DB2. Debe especificar un valor no nulo en este parámetro. El tipo de datos de este parámetro es VARCHAR(128). Opciones Serie de caracteres que especifica la opción que está disponible para este procedimiento almacenado. La opción disponible es USING UPDATE MINIMUM. Esta opción utiliza los valores USING UPDATE MINIMUM que ha especificado para el procedimiento almacenado SYSPROC.SYSTS_CREATE. Inicia una actualización incremental sólo si se ha alcanzado el número de cambios especificado. El valor predeterminado es iniciar incondicionalmente el proceso de actualización. USING UPDATE MINIMUM: USING UPDATE MINIMUM Conceptos relacionados: “Recorte de documentos” en la página 15 OmniFind Text Search Server for DB2 for i limita el número de caracteres que pueden indexarse para cada documento de texto. A veces, esta limitación de caracteres provoca el recorte de documentos de texto grandes en el índice de búsqueda de texto. Referencia relacionada: “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. “SYSPROC.SYSTS_START” en la página 15 Puede habilitar funciones de búsqueda de texto de DB2 llamando al procedimiento almacenado SYSPROC.SYSTS_START. “SYSPROC.SYSTS_DROP” en la página 34 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_DROP para eliminar un índice de búsqueda 38 IBM i: OmniFind Text Search Server for DB2 for i de texto definido mediante el procedimiento almacenado SYSPROC.SYSTS_CREATE. SYSPROC.SYSTS_SHUTDOWN Puede llamar al procedimiento almacenado SYSPROC.SYSTS_SHUTDOWN para concluir las funciones de búsqueda de texto de DB2®. Este procedimiento almacenado establece el valor SERVERSTATUS del catálogo QSYS2.SYSTEXTSERVERS en 1 (detenido) y también finaliza los trabajos del servidor de búsqueda de texto del sistema host. Una vez completado este procedimiento almacenado, las consultas SQL que utilicen las funciones CONTAINS o SCORE o los procedimientos almacenados de administración utilizados para el mantenimiento de los índices devolverán una anomalía sin intentar contactar con un servidor de búsqueda de texto. Los cambios en la tabla base del índice se siguen registrando aunque el servidor haya concluido. Sin embargo, las actualizaciones planificadas del índice no se producirán hasta que se haya invocado a SYSPROC.SYSTS_START. Autorización El ID de usuario bajo el que se invoca este procedimiento almacenado debe tener los siguientes privilegios: v Autorización *EXECUTE sobre el procedimiento. v Privilegios SELECT y UPDATE sobre la tabla SYSTEXTSERVERS. v Autorización *EXECUTE sobre la biblioteca QSYS2 del archivo SYSTEXTSERVERS. v Autorización *JOBCTL o utilización de la función especial de seguridad QIBM_DB_SQLADM. Para obtener información acerca de las autorizaciones del sistema correspondientes a los privilegios SQL, consulte el apartado GRANT (Privilegios de tabla o vista). Sintaxis >>-SYSTS_SHUTDOWN--(--+-----------+--)----------------------------->< +-id_servidor--+ ’-nombre_alias-’ Parámetros id_servidor o nombre_alias Especifica el identificador del servidor cuyos índices huérfanos deben borrarse. Un idservidor o un nombrealias de servidor es una serie de caracteres. Si no se proporciona ningún identificador, el valor predeterminado es borrar los índices huérfanos de todos los servidores. La serie del identificador debe ser un id_servidor válido que exista en la columna SERVERID o un nombre de alias de servidor válido que exista en la columna ALIASNAME de la tabla QSYS2.SYSTEXTSERVERS. Si el identificador puede convertirse a un valor entero, se interpreta como idservidor. Si el identificador no puede convertirse a un valor entero, se interpreta como nombrealias de servidor. El tipo de datos de este parámetro es VARCHAR(128). Ejemplo v Para concluir todos los servidores de producción: CALL SYSPROC.SYSTS_SHUTDOWN(). v Para concluir un servidor con el ID 1: CALL SYSPROC.SYSTS_SHUTDOWN(1) v Para concluir un servidor con el nombre de alias "LOCAL_SERVER": CALL SYSPROC.SYSTS_SHUTDOWN(’LOCAL_SERVER’) OmniFind Text Search Server 39 v Para concluir un servidor con el nombre de alias "local_server": CALL SYSPROC.SYSTS_SHUTDOWN(’local_server’) Conceptos relacionados: “Nombre de alias de servidor” en la página 11 Puede utilizar un nombre de alias de servidor para asignar un nombre significativo a un servidor. Referencia relacionada: “Tabla de administración QSYS2.SYSTEXTSERVERS” en la página 115 Puede visualizar dónde están instalados los servidores de búsqueda de texto mediante la tabla de administración QSYS2.SYSTEXTSERVERS. “SYSPROC.SYSTS_START” en la página 15 Puede habilitar funciones de búsqueda de texto de DB2 llamando al procedimiento almacenado SYSPROC.SYSTS_START. “CONTAINS” Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. Buscar con un índice de búsqueda de texto Puede utilizar las funciones CONTAINS y SCORE en una consulta SQL con OMNIFIND. CONTAINS y SCORE se utilizan para realizar búsquedas en un índice de búsqueda de texto utilizando los criterios especificados en un argumento de búsqueda. También puede indexar y realizar búsquedas en documentos XML. CONTAINS Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. (1) CONTAINS ( ) nombre-columna , argumento-búsqueda , constante-serie Notas: 1 La constante-serie debe ajustarse a las normas de las opciones de argumento-búsqueda. opciones-argumento-búsqueda: (1) QUERYLANGUAGE = valor RESULTLIMIT = valor OFF SYNONYM = ON Notas: 1 No puede especificarse la misma cláusula más de una vez. 40 IBM i: OmniFind Text Search Server for DB2 for i El esquema es QSYS2. nombre-columna Especifica un nombre calificado o no calificado de una columna que contiene un índice de búsqueda de texto en el que debe buscarse. La columna debe existir en la tabla o vista identificada en la cláusula FROM de la sentencia. La columna de la tabla o la columna de la tabla base subyacente de la vista debe tener un índice de búsqueda de texto asociado (SQLSTATE 38H12). La expresión subyacente de la columna de una vista debe ser una referencia de columna simple a la columna de una tabla subyacente, directamente o a través de otra vista anidada. argumento-búsqueda Especifica una expresión que devuelve un valor tipo serie que contiene los términos utilizados en la búsqueda. La expresión no puede estar formada sólo por espacios en blanco ni ser la serie vacía (SQLSTATE 38H14). La longitud real de la serie no puede sobrepasar los 32704 bytes. Esta longitud puede quedar aún más limitada por el valor soportado por el servidor de búsqueda de texto (SQLSTATE 38H10). El valor se convierte a Unicode antes de utilizarlo para realizar búsquedas en el índice de búsqueda de texto. constante-serie Identifica una constante de tipo serie que especifica las opciones de argumento de búsqueda en vigor para la función. Las opciones que pueden especificarse como parte de las opciones-argumento-búsqueda son las siguientes: QUERYLANGUAGE=valor Especifica el idioma de la consulta. El valor puede ser cualquiera de los códigos de idioma soportados. Si no se especifica la opción QUERYLANGUAGE, el valor predeterminado es el valor de idioma del índice de búsqueda de texto utilizado cuando se invoca la función. Si el valor de idioma del índice de búsqueda de texto es AUTO, el valor predeterminado para QUERYLANGUAGE es en_US. RESULTLIMIT=valor Especifica el número máximo de resultados que el motor de búsqueda subyacente puede devolver. El valor puede ser un entero de 1 a 2 147 483 647. Si no se especifica la opción RESULTLIMIT, no habrá ningún límite de resultados en vigor para la consulta. Es posible que no pueda llamarse a esta función escalar para cada fila de la tabla de resultados, dependiendo del plan elegido por el optimizador. Esta función puede llamarse una vez para toda la consulta al motor de búsqueda subyacente. Se devuelve un conjunto de resultados de todas las claves primarias coincidentes. A continuación, este conjunto de resultados se une a la tabla que contiene la columna para identificar las filas de resultados. En este caso, el valor RESULTLIMIT actúa como FETCH FIRST ?? ROWS desde el motor de búsqueda de texto subyacente, y puede utilizarse como optimización. Si se llama al motor de búsqueda para cada fila del resultado debido a que este es el mejor plan, la opción RESULTLIMIT se ignora. SYNONYM = OFF o SYNONYM = ON Especifica si debe utilizarse un diccionario de sinónimos asociado con el índice de búsqueda de texto. Puede añadir un diccionario de sinónimos a una colección mediante la herramienta de sinónimos. OFF OFF es el valor predeterminado. ON Se utiliza el diccionario de sinónimos que está asociado con el índice de búsqueda de texto. El resultado de la función es un entero grande. Si el segundo argumento puede ser nulo, el resultado puede ser nulo. Si el segundo argumento es nulo, el resultado es el valor nulo. OmniFind Text Search Server 41 El resultado es 1 si el documento contiene una coincidencia con los criterios de búsqueda especificados en el argumento de búsqueda. De lo contrario, el resultado es 0. Si la columna es nula, el resultado también es 0. Si el argumento de búsqueda es nulo, el resultado es el valor nulo. CONTAINS es una función no determinística. Ejemplo 1 La sentencia siguiente busca todos los empleados cuyo currículum contiene COBOL. SELECT EMPNO FROM EMP_RESUME WHERE RESUME_FORMAT = ’ascii’ AND CONTAINS(RESUME, ’COBOL’) = 1 Ejemplo 2 El argumento de búsqueda no tiene que ser necesariamente una constante de tipo serie. El argumento de búsqueda puede ser cualquier expresión de serie SQL, incluida una serie contenida en una variable host. La sentencia siguiente busca el término exacto "ate" en la columna COMMENT. Nota: El término "ate" debe delimitarse mediante comillas dobles para que se busque sólo el término exacto sin tener en cuenta las variantes lingüísticas. char search_arg[100]; /* variable host de entrada */ ... EXEC SQL DECLARE C3 CURSOR FOR SELECT CUSTKEY FROM K55ADMIN.CUSTOMERS WHERE CONTAINS(COMMENT, :search_arg)= 1 ORDER BY CUSTKEY; strcpy(search_arg, "\"ate\""’); EXEC SQL OPEN C3; ... Ejemplo 3 La sentencia siguiente busca aleatoriamente 10 estudiantes que hayan escrito artículos en línea que contengan la frase "fossil fuel" en español, es decir, "combustible fósil". Estos estudiantes están destinados a una entrevista radiofónica. Utilice el diccionario de sinónimos que se ha creado para el índice de búsqueda de texto asociado. Dado que sólo son necesarios 10 estudiantes, optimice la consulta mediante la opción RESULTLIMIT para limitar el número de resultados del servidor de búsqueda de texto subyacente. SELECT FIRSTNME, LASTNAME FROM STUDENT_ESSAYS WHERE CONTAINS(TERM_PAPER, ’combustible fósil’, ’QUERYLANGUAGE= es_ES RESULTLIMIT = 10 SYNONYM=ON’) = 1 Tareas relacionadas: “Buscar en un índice de búsqueda de texto” en la página 14 Puede buscar en un índice de búsqueda de texto mediante una sentencia SQL con una función CONTAINS o SCORE. En la función se especifican los criterios del argumento de búsqueda. Referencia relacionada: “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. 42 IBM i: OmniFind Text Search Server for DB2 for i “Sintaxis de argumentos de búsqueda” en la página 45 Puede especificar un argumento de búsqueda como condición de una búsqueda de términos en documentos de texto. Consta de parámetros de búsqueda y uno o más términos de búsqueda. Las funciones escalares de búsqueda de texto SQL que utilizan argumentos de búsqueda son CONTAINS y SCORE. SCORE Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. (1) SCORE ( nombre-columna , argumento-búsqueda ) , constante-serie Notas: 1 La constante-serie debe ajustarse a las normas de las opciones de argumento-búsqueda. opciones-argumento-búsqueda: (1) QUERYLANGUAGE = valor RESULTLIMIT = valor OFF SYNONYM = ON Notas: 1 No puede especificarse la misma cláusula más de una vez. El esquema es QSYS2. nombre-columna Especifica un nombre calificado o no calificado de una columna que contiene un índice de búsqueda de texto en el que debe buscarse. La columna debe existir en la tabla o vista identificada en la cláusula FROM de la sentencia. La columna de la tabla o la columna de la tabla base subyacente de la vista debe tener un índice de búsqueda de texto asociado (SQLSTATE 38H12). La expresión subyacente de la columna de una vista debe ser una referencia de columna simple a la columna de una tabla subyacente, directamente o a través de otra vista anidada. argumento-búsqueda Especifica una expresión que devuelve un valor tipo serie que contiene los términos utilizados en la búsqueda. La expresión no puede estar formada sólo por espacios en blanco ni ser la serie vacía (SQLSTATE 38H14). La longitud real de la serie no puede sobrepasar los 32704 bytes. Esta longitud puede quedar aún más limitada por el valor soportado por el servidor de búsqueda de texto (SQLSTATE 38H10). El valor se convierte a Unicode antes de utilizarlo para realizar búsquedas en el índice de búsqueda de texto. Si el argumento de búsqueda es nulo, el resultado es el valor nulo. constante-serie Identifica una constante de tipo serie que especifica las opciones de argumento de búsqueda en vigor para la función. Las opciones que pueden especificarse como parte de las opciones-argumento-búsqueda son las siguientes: QUERYLANGUAGE=valor Especifica el idioma de la consulta. El valor puede ser cualquiera de los códigos de idioma OmniFind Text Search Server 43 soportados. Si no se especifica la opción QUERYLANGUAGE, el valor predeterminado es el valor de idioma del índice de búsqueda de texto utilizado cuando se invoca la función. Si el valor de idioma del índice de búsqueda de texto es AUTO, el valor predeterminado para QUERYLANGUAGE es en_US. RESULTLIMIT=valor Especifica el número máximo de resultados que el motor de búsqueda subyacente puede devolver. El valor puede ser un entero de 1 a 2 147 483 647. Si no se especifica la opción RESULTLIMIT, no habrá ningún límite de resultados en vigor para la consulta. Es posible que no pueda llamarse a esta función escalar para cada fila de la tabla de resultados, dependiendo del plan elegido por el optimizador. Esta función puede llamarse una vez para toda la consulta al motor de búsqueda subyacente. Se devuelve un conjunto de resultados de todas las claves primarias coincidentes. A continuación, este conjunto de resultados se une a la tabla que contiene la columna para identificar las filas de resultados. En este caso, el valor RESULTLIMIT actúa como FETCH FIRST ?? ROWS desde el motor de búsqueda de texto subyacente, y puede utilizarse como optimización. Si se llama al motor de búsqueda para cada fila del resultado debido a que este es el mejor plan, la opción RESULTLIMIT se ignora. SYNONYM = OFF o SYNONYM = ON Especifica si debe utilizarse un diccionario de sinónimos asociado con el índice de búsqueda de texto. Puede añadir un diccionario de sinónimos a una colección mediante la herramienta de sinónimos. OFF OFF es el valor predeterminado. ON Se utiliza el diccionario de sinónimos que está asociado con el índice de búsqueda de texto. El resultado de la función es un número de coma flotante de precisión doble. Si el segundo argumento puede ser nulo, el resultado puede ser nulo. Si el segundo argumento es nulo, el resultado es el valor nulo. El resultado es mayor que 0 pero menor que 1 si la columna contiene una coincidencia con los criterios de búsqueda especificados por el argumento de búsqueda. Cuanto mayor sea la frecuencia con la que se encuentre una coincidencia, mayor será el valor del resultado. Si la columna no contiene ninguna coincidencia, el resultado será 0. La puntuación también será 0 si la columna es nula. SCORE es una función no determinística. Ejemplo La sentencia siguiente genera una lista de empleados ordenada por el grado de coincidencia de sus currículums con programador AND (java OR cobol). Además, se devuelve un valor de relevancia normalizado entre 0 (cero) y 100. SELECT EMPNO, INTEGER(SCORE(RESUME, ’programador AND (java OR cobol)’) * 100) AS RELEVANCE FROM EMP_RESUME WHERE RESUME_FORMAT = ’ascii’ ORDER BY RELEVANCE DESC Tareas relacionadas: “Buscar en un índice de búsqueda de texto” en la página 14 Puede buscar en un índice de búsqueda de texto mediante una sentencia SQL con una función CONTAINS o SCORE. En la función se especifican los criterios del argumento de búsqueda. Referencia relacionada: 44 IBM i: OmniFind Text Search Server for DB2 for i “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. “Sintaxis de argumentos de búsqueda” Puede especificar un argumento de búsqueda como condición de una búsqueda de términos en documentos de texto. Consta de parámetros de búsqueda y uno o más términos de búsqueda. Las funciones escalares de búsqueda de texto SQL que utilizan argumentos de búsqueda son CONTAINS y SCORE. Sintaxis de argumentos de búsqueda Puede especificar un argumento de búsqueda como condición de una búsqueda de términos en documentos de texto. Consta de parámetros de búsqueda y uno o más términos de búsqueda. Las funciones escalares de búsqueda de texto SQL que utilizan argumentos de búsqueda son CONTAINS y SCORE. En cualquier proceso específico de idioma durante una búsqueda, puede especificar un valor para el parámetro QUERYLANGUAGE como opción de argumento de búsqueda. El valor puede ser cualquiera de los códigos de idioma soportados. Si no se especifica el parámetro QUERYLANGUAGE, el valor predeterminado es el valor de idioma del índice de búsqueda de texto utilizado cuando se llama a esta función. Si el valor de idioma del índice de búsqueda de texto es AUTO, el valor predeterminado para QUERYLANGUAGE es en_US. Limitaciones No pueden utilizarse las funciones CONTAINS y SCORE en una restricción SQL o definición de índice. Puede utilizarlas en definiciones de vista y sentencias de consulta SQL con las restricciones siguientes: v Si una vista, expresión de tabla anidada o expresión de tabla común suministra una columna de búsqueda de texto para una función escalar CONTAINS o SCORE, y si la vista, expresión de tabla anidada o expresión de tabla común en cuestión contiene una cláusula DISTINCT en la sentencia SELECT más externa, la lista de SELECT debe contener todos los campos de clave correspondientes del índice de búsqueda de texto. De lo contrario, se devuelve el mensaje SQL 38H12. v Si una vista, expresión de tabla anidada o expresión de tabla común suministra una columna de búsqueda de texto para una función escalar CONTAINS o SCORE, la vista, expresión de tabla anidada o expresión de tabla común en cuestión no pueden contener una sentencia UNION, EXCEPT o INTERSECT en el nivel más externo de SELECT. De lo contrario, se devuelve el mensaje SQL 38H12. v Si una expresión de tabla común suministra una columna de búsqueda de texto para una función escalar CONTAINS o SCORE, la expresión de tabla común puede referenciarse de nuevo en toda la consulta sólo si la referencia no suministra una columna de búsqueda de texto para una función escalar CONTAINS o SCORE. De lo contrario, se devuelve el mensaje SQL 38H12. v No puede crearse una función cuyo origen sean las funciones escalares CONTAINS o SCORE. De lo contrario, se devuelve el mensaje SQL SQL0457. v La consulta puede ejecutarse mediante el motor de consultas SQL (SQE). OmniFind Text Search Server 45 Búsqueda simple Para realizar una búsqueda simple de palabras clave, especifique una o varias palabras clave en la consulta. El motor de búsqueda devuelve los documentos que contienen todas las palabras clave especificadas o variantes de las mismas. Por ejemplo, si especifica rey, el motor de búsqueda devolverá todos los documentos que contienen la palabra rey o reyes. Si especifica la consulta rey lear, el motor de búsqueda devolverá los documentos que contienen los términos rey y lear. Para visualizar resultados más precisos, utilice palabras clave más específicas. Por ejemplo, especifique café irlandés en lugar de café, o senderismo en Kauai en lugar de vacaciones en Hawai. Si una búsqueda simple de palabras clave devuelve demasiados documentos que no corresponden a lo que está buscando, puede utilizar operadores para refinar la búsqueda. Exclusión de términos de una búsqueda Para excluir términos se utiliza el signo menos (-). Por ejemplo, si desea buscar los documentos que contienen el término lear, pero no eduardo, especifique la consulta lear -eduardo. El signo menos (-) también se aplica a un término y a sus variantes. Por ejemplo, la consulta -eduardo excluye los documentos que contienen la palabra eduardiano. Búsqueda de frases Si desea asegurarse de que los términos se visualicen exactamente en el orden en que los ha especificado, puede utilizar comillas dobles. Por ejemplo, si desea visualizar los documentos que contienen exactamente el término rey lear, pero no frases relacionadas, tales como real lear o rey y reina lear, especifique "rey lear". La búsqueda no distingue entre mayúsculas y minúsculas, pero las variantes terminológicas no se consideran coincidencias. Carácter comodín en una búsqueda El carácter comodín (*) ayuda a encontrar documentos cuando no se conoce la palabra completa o si se desea buscar variantes del término. Por ejemplo, la consulta chec* devuelve los documentos que contienen los términos checo, checoslovaquia, checoslovaco, república checa y otros resultados posibles. También puede utilizar el carácter comodín en una búsqueda de frase. Por ejemplo, la consulta "John * Kennedy" devuelve los documentos que contienen los términos John Fitzgerald Kennedy y John F Kennedy, pero no John Kennedy. La consulta Mi*l Gorbachev devuelve Mikhail Gorbachev. La adición de un carácter comodín al principio de una consulta (por ejemplo, *hec) puede provocar que el motor de búsqueda tarde más tiempo en devolver resultados. Búsquedas de uno de los términos como mínimo El operador lógico OR especifica que debe visualizarse como mínimo uno de los términos de una consulta en el documento devuelto. Por ejemplo, la consulta (othello OR otelo) devuelve los documentos que contienen el término othello u otelo. También puede utilizar los operadores lógicos AND, OR y NOT en combinaciones utilizando paréntesis. Por ejemplo, la consulta cougar OR (jaguar AND NOT coche) devuelve los documentos que contienen los términos cougar o jaguar, pero no coche. 46 IBM i: OmniFind Text Search Server for DB2 for i Debe especificar los operadores lógicos AND, OR y NOT en mayúsculas. Utilice los paréntesis para especificar agrupaciones. Conceptos relacionados: “Búsqueda XML” en la página 53 Puede indexar y realizar búsquedas en documentos XML. La gramática de búsqueda XML utiliza un subconjunto del lenguaje W3 XPath con ampliaciones para búsqueda de texto. Las ampliaciones dan soporte a búsquedas de rango de valores numéricos, de fecha (Date) y fecha y hora (DateTime) asociados con un atributo o elemento XML. Los elementos estructurales pueden utilizarse por separado o combinarse con texto sin formato en las consultas. Referencia relacionada: “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. Ejemplos de consulta simple Las consultas simples de las funciones CONTAINS y SCORE buscan una o varias palabras en un índice de búsqueda de texto. El motor de búsqueda ignora los espacios en blanco entre caracteres. La serie de búsqueda no debe estar vacía ni contener sólo espacios en blanco (SQLSTATE 38H14). La tabla siguiente muestra algunos ejemplos de consultas de búsqueda simples. Tabla 3. Ejemplos de consulta simple Tipos de palabras de búsqueda Ejemplos Resultados de consulta Palabra única rey Devuelve todos los documentos que contienen la palabra rey o reyes. Esta consulta compara diferentes formularios de superficie y no es sensible a las mayúsculas y minúsculas. Varias palabras rey lear Devuelve todos los documentos que contienen la palabra rey y lear. El operador predeterminado es el operador lógico AND. Los operadores AND y + están implícitos en todas las consultas. Por ejemplo, la consulta Rey Lear devuelve los mismos resultados que Rey AND Lear o Rey + Lear. Debe especificar los operadores lógicos NOT, AND y OR en mayúsculas. Referencia relacionada: “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia OmniFind Text Search Server 47 que mide hasta que punto un documento coincide con la consulta. Operadores de búsqueda avanzada Puede utilizar operadores de búsqueda avanzada para refinar los resultados de búsqueda de las funciones CONTAINS y SCORE. En la tabla siguiente, la primera columna describe el operador que puede utilizarse en una consulta de búsqueda. Debe especificar los operadores lógicos NOT, AND u OR en mayúsculas. La segunda columna muestra una consulta de ejemplo que puede especificarse. La tercera columna describe los tipos de resultados que puede observar en la consulta de ejemplo. Tabla 4. Operadores de búsqueda avanzada y ejemplos de consultas complejas Operadores Ejemplos Resultados de consulta AND "Rey Lear" AND "Otelo" Cualquier consulta devolverá los documentos que contengan ambos términos, Rey Lear y Otelo. AND es el operador de conjunción predeterminado. Si no hay ningún operador lógico entre los dos términos, se utiliza el operador AND. Por ejemplo, la consulta Rey Lear es igual a la consulta Rey AND Lear. "Rey Lear" "Otelo" OR "Rey Lear" OR Lear Devuelve los documentos que contienen Rey Lear o sólo Lear. El operador OR enlaza los dos términos y busca un documento coincidente si alguno de los dos términos existe en un documento. NOT "Rey Lear" NOT "Norman Lear" Devuelve los documentos que contienen Rey Lear, pero no Norman Lear. "" Primera consulta: La primera consulta devuelve la frase exacta Rey Lear. "Rey Lear" (Coincidencia exacta) Segunda consulta: "rey" * test* te*t Devuelve los documentos que pueden coincidir con las posibles combinaciones, como por ejemplo test, tests y tester, o test y text. Primera consulta: La primera consulta fuerza a los documentos que contienen la frase Rey Lear a visualizarse más arriba en la lista de resultados de búsqueda. (Carácter comodín) ^ La segunda consulta devuelve sólo la palabra rey sin otras variantes, tales como reyes o reyezuelo. "Rey Lear"^4 "Ricardo III" (Factor de coincidencia de puntuación) Segunda consulta: número^de alguna palabra o frase title: (descarga de software)^5 pdf viewer -shipping La segunda consulta fuerza a un documento titulado descarga de software a visualizarse más arriba en la lista de resultados. Aunque un factor de coincidencia (boost factor) debe ser positivo, puede ser inferior a 1. Por ejemplo, puede ser de 0,2. El número del factor de coincidencia no tiene límite. + +Lear Rey (Includes) 48 IBM i: OmniFind Text Search Server for DB2 for i Devuelve todos los documentos que contienen Lear y Rey, que es lo mismo que la consulta Lear AND Rey. Tabla 4. Operadores de búsqueda avanzada y ejemplos de consultas complejas (continuación) Operadores Ejemplos Resultados de consulta - "Rey Lear" -"Lear Jet" Devuelve los documentos que contienen Rey Lear, pero no Lear Jet. () (Rey OR Lear) AND obras Devuelve los documentos que contienen Rey o Lear y obras. Los paréntesis garantizan que se encuentre obras y el término Rey o Lear esté presente. \ \(1\+1\)\:2 Devuelve los documentos que contienen (1+1):2. Use \ como carácter de escape para poder utilizar caracteres especiales que normalmente forman parte de la sintaxis de consulta. Si un carácter especial va precedido del carácter de escape, el carácter especial se analiza como parte de la consulta. Los caracteres especiales son: +, -, &&, ||, !, (, ), {, }, [, ], ^, ", ~, *, ?, : y \. Si se borra un carácter especial, éste se analiza como parte de la consulta. log %file Devuelve los documentos que incluyen el término log y opcionalmente incluyen el término file. analytics~ analytics~0.8 La primera consulta devuelve los documentos que incluyen los términos analytics, analyze, analysis, etc. (Excludes) (Carácter de escape) % Términos opcionales ~ Búsqueda difusa Una consulta de búsqueda difusa busca secuencias de caracteres que no sólo son iguales sino similares al término de consulta. Utilice el símbolo de tilde (~) al final de un término para realizar una búsqueda difusa. Puede añadir un parámetro opcional para especificar la similitud necesaria. Especifique un valor superior a 0 e inferior a 1. El valor debe ir precedido de un 0 y coma decimal, por ejemplo, 0,8. Un valor más cercano a 1 hace coincidir los términos con una similitud mayor. Si no se especifica el parámetro, el valor predeterminado es 0,5. Restricción: los caracteres especiales no están soportados en las consultas de búsqueda de proximidad. OmniFind Text Search Server 49 Tabla 4. Operadores de búsqueda avanzada y ejemplos de consultas complejas (continuación) Operadores Ejemplos Resultados de consulta ~ "IBM WebSphere"~7 Devuelve los documentos que contienen "IBM" y "WebSphere" con siete palabras entre sí. Búsquedas de proximidad Una búsqueda de proximidad busca los documentos que contienen términos dentro de un número especificado de palabras entre sí. Utilice el símbolo de tilde (~) para realizar una búsqueda de proximidad. La búsqueda de proximidad está soportada para términos individuales, no para frases. Además, tenga en cuenta que una palabra después de una interrupción de frase no se considera adyacente a las palabras de la frase anterior. Restricción: los caracteres especiales no están soportados en las consultas de búsqueda de proximidad. Referencia relacionada: “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. Búsqueda de caracteres especiales OmniFind admite la indexación y búsqueda de caracteres especiales. Puede buscar caracteres especiales como otros términos de consulta. Para encontrar un carácter especial en un documento, incluya dicho carácter en la expresión de consulta. En algunos casos, es necesario salir de caracteres especiales con un carácter de escape. Escape de caracteres especiales Los caracteres especiales pueden desempeñar distintas funciones en la sintaxis de la consulta. Por ejemplo, los signos de interrogación (?) pueden utilizarse como caracteres comodín. Para buscar un carácter especial que tiene una función especial en la sintaxis de la consulta, debe salir del carácter especial añadiendo una barra inclinada invertida antes del mismo, por ejemplo: v Para buscar la serie “where?”, especifique un escape para el signo de interrogación de la manera siguiente: “where\?” v Para buscar la serie “c:\temp,” especifique un escape para los dos puntos y la barra invertida de este modo:“c\:\\temp” Si no especifica un escape para estos caracteres especiales, es posible que se produzcan errores de sintaxis. 50 IBM i: OmniFind Text Search Server for DB2 for i Tabla 5. Caracteres especiales que deben especificarse con escape para poder realizar una búsqueda Carácter especial Notas sobre el comportamiento si no se especifica escape Ampersand (&) Asterisco (*) Se utiliza como carácter comodín. Signo de arroba (@) Se genera un error de sintaxis cuando el carácter de arroba es el primer carácter de una consulta. En expresiones xmlxp, el signo de arroba se utiliza para hacer referencia a un atributo. Corchetes [ ] Se utiliza en expresiones xmlxp para buscar en el contenido de elementos y atributos. Llaves { } Genera un error de sintaxis. Barra inclinada invertida (\) Signo de intercalación (^) Se utiliza para ponderar (aumentar) términos. Dos puntos (:) Se utilizan para realizar búsquedas en el contenido de los campos. Signo de igualdad (=) Genera un error de sintaxis. Signo de exclamación (!) Se devuelve un error de sintaxis cuando el signo de instalación es el primer carácter de una consulta. Barra inclinada (/) En expresiones xmlxp, una barra inclinada se utiliza como separador de elementos de vía de acceso. Símbolo Mayor que (>); Símbolo Menor que (<) Se utiliza en expresiones xmlxp para comparar el valor de un atributo. De lo contrario, estos caracteres generan errores de sintaxis. Signo menos (-) Cuando un signo menos es el primer carácter de un término, sólo se devuelven los documentos que no contienen el término. Paréntesis ( ) Se utilizan para agrupación. Signo de porcentaje (%) Especifica que un término de búsqueda es opcional. Signo más (+) Signo de interrogación (?) Se maneja como carácter comodín. Punto y coma (;) Comillas simples (‘) Las comillas simples se utilizan para contener expresiones xmlxp. Tilde (~) Se maneja como operadores de búsqueda difusa y proximidad Barra vertical (|) El escape de caracteres especiales que no desempeñan ninguna función especial en la sintaxis de la consulta es opcional. En la siguiente tabla se muestran algunos ejemplos de caracteres especiales que no requieren escape. Tabla 6. Ejemplos de caracteres especiales que no requieren escape. Carácter especial Notas sobre el comportamiento si no se especifica escape Coma (,) Signo de dólar ($) OmniFind Text Search Server 51 Tabla 6. Ejemplos de caracteres especiales que no requieren escape. (continuación) Carácter especial Punto (.) Notas sobre el comportamiento si no se especifica escape En expresiones xmlxp, un punto se utiliza para buscar el contenido de los elementos. Signo de almohadilla (#) Subrayado (_) Caracteres especiales adyacentes a términos de consulta Cuando existe un carácter especial adyacente a un término de la consulta, se devuelven los documentos que contienen el carácter especial y la palabra en el mismo orden. Por ejemplo, si busca “30$”, se encuentran documentos que contienen “30$”, pero no documentos que contengan “$30”. No obstante, si busca “30 $” (con un espacio), se encuentran todos los documentos que contienen “30” y “$” en cualquier lugar del documento, incluidos “30$” y “$30”. Cuando un carácter especial está adyacente a una palabra vacía de la consulta, la palabra vacía no se elimina de la consulta. Por ejemplo, si busca “at&t”, la palabra vacía “at” no se elimina. En cambio, si busca “at & t” con espacio, se elimina la palabra “at”. Cuando un carácter especial separa dos palabras, la secuencia de símbolos se busca como secuencia. Por ejemplo, si busca “jack_jones”, se encuentran documentos que contienen “jack_jones”, pero no documentos que contienen “jack_and_jones”. Las palabras adyacentes a caracteres especiales se lematizan. Por ejemplo, si busca “cats&dogs” en inglés, se encuentran documentos que contienen “cat&dog”. Puede utilizar caracteres en expresiones de búsqueda con caracteres comodín. Por ejemplo, si busca “ja*_”, se encuentran documentos que contienen “jack_jones”. No obstante, no pueden utilizarse caracteres comodín para encontrar caracteres especiales. Por ejemplo, la búsqueda “ca*s” encontrará los documentos que contienen “cats”, “categories” o “cas”, pero no los documentos que contienen “ca_s”. Indexación de caracteres especiales Durante la simbolización y el proceso idiomático, el servidor OmniFind identifica e indexa los caracteres especiales como signos de puntuación. Los caracteres especiales son delimitadores de símbolos. Por ejemplo, “jack_jones” tiene como unidades léxicas tres símbolos distintos: “jack”, “_” y “jones”. Los correos electrónicos, URL y vías de acceso de archivo se desglosan en unidades léxicas, por ejemplo: v Jack_jones@ibm.com tiene las unidades léxicas jack _ jones @ ibm . com v http://www.ibm.com tiene las unidades léxicas http :// www . ibm . com Los caracteres especiales no ocupan una posición de símbolo en el archivo. Por ejemplo, "jack_jones" se indexa con el carácter de subrayado en la misma posición de símbolo que "jack". Los caracteres especiales tampoco ocupan ninguna posición de símbolo si se incluyen espacios. Por ejemplo, “jack_jones” se indexa del mismo modo que “jack _ jones”. La posición del símbolo se utiliza para la búsqueda de frases exactas y para la búsqueda de proximidad. Por ejemplo, si un documento contiene la expresión jack_jones, al buscar la frase exacta ““jack jones”” se encuentra este documento. 52 IBM i: OmniFind Text Search Server for DB2 for i Cuando una secuencia de caracteres especiales se indexa por separado, dichos caracteres no se buscan en ningún orden especial. Por ejemplo, al buscar “#$” también se encuentran los documentos que contienen “$#”. Caracteres especiales en idiomas CJK Para buscar una secuencia de caracteres que incluya caracteres especiales, la expresión de consulta debe incluir los caracteres especiales. Si omite los caracteres especiales de la expresión de consulta, es posible que la secuencia de caracteres no se encuentre. En idiomas no CJK, la secuencia de caracteres se encuentra siempre, aunque la expresión de consulta omita los caracteres especiales. Por ejemplo, si un documento indexado contiene john_smith, puede buscar john_smith o "john smith" (coincidencia exacta, sin el carácter de subrayado) y ambas consultas devuelven el documento que contiene john_smith. Restricción: no puede buscar los siguientes caracteres especiales en documentos CJK: ? * \ Ejemplo de utilización de las funciones CONTAINS y SCORE Puede utilizar las funciones CONTAINS y SCORE en la misma consulta. La consulta busca en un índice de búsqueda de texto y devuelve si y con qué frecuencia el documento de texto coincide con los criterios del argumento de búsqueda. El ejemplo de la tabla siguiente utiliza datos de la tabla base BOOKS con las columnas ISBN (VARCHAR(20)), ABSTRACT (VARCHAR(10000)) y PRICE (INTEGER). Tabla 7. La tabla base BOOKS ISBN ABSTRACT PRICE i1 "a b c" 7 i2 "a b d" 10 i3 "a e a" 8 Ejecute la consulta siguiente: SELECT ISBN, SCORE(ABSTRACT,’"b"’) FROM BOOKS WHERE CONTAINS (ABSTRACT,’"b"’) = 1 Esta consulta devuelve las dos filas siguientes: i1, 0.3 i3, 0.4 Los valores de puntuación pueden diferir en función del contenido de la columna de texto. Referencia relacionada: “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. Búsqueda XML Puede indexar y realizar búsquedas en documentos XML. La gramática de búsqueda XML utiliza un subconjunto del lenguaje W3 XPath con ampliaciones para búsqueda de texto. Las ampliaciones dan OmniFind Text Search Server 53 soporte a búsquedas de rango de valores numéricos, de fecha (Date) y fecha y hora (DateTime) asociados con un atributo o elemento XML. Los elementos estructurales pueden utilizarse por separado o combinarse con texto sin formato en las consultas. Los documentos deben indexarse para que incluyan el código XML para poder realizar búsquedas en el índice mediante la sintaxis de consulta xmlxp. La indexación de documentos se realiza mediante la opción “FORMAT XML” durante la creación del índice. Los índices creados en un release anterior pueden utilizarse para realizar búsquedas. Sin embargo, los documentos indexados en un release anterior no contienen la información necesaria para utilizar todas las prestaciones de búsqueda XML disponibles en un release más reciente. Los documentos añadidos o actualizados en el índice de búsqueda de texto después de la actualización al nuevo release incluyen la información adicional. Es posible que, como resultado de una actualización, los documentos indexados en el release anterior no se incluyan en algunos resultados de búsqueda. Puede utilizarse el procedimiento almacenado SYSPROC.SYSTS_REPRIMEINDEX para reconstruir el índice y resolver este problema. Para utilizar las funciones incorporadas CONTAINS y SCORE de OMNIFIND para buscar datos XML, la serie de búsqueda debe empezar por el prefijo de búsqueda @xmlxp:. El prefijo va seguido de una expresión de consulta de búsqueda XML válida. El prefijo de término 'opaco' @xmlxp indica que una búsqueda se realiza utilizando la expresión de vía de acceso de consulta. Por ejemplo: CONTAINS(columnname, '@xmlxp:’’expresión_consulta’’ '). Las comillas simples ' ’ que entrecomillan la expresión_consulta deben ser dobles, ya que se encuentran dentro de una serie SQL, siendo en realidad una serie dentro de otra serie. El prefijo de término opaco @xpath: utilizado en releases anteriores de OmniFind Text Search Server for DB2 for i está soportado a efectos de compatibilidad con versiones anteriores. Sin embargo, ha quedado en desuso y no es aconsejable utilizarlo. A continuación figura una lista donde se resaltan las características clave de la búsqueda XML: Búsqueda estructural XML Mediante la inclusión de términos XML opacos especiales en las consultas, puede buscar en documentos XML elementos estructurales y texto cuyo ámbito sea el de dichos elementos. Los elementos estructurales son nombres de códigos, nombres de atributos y valores de atributos. Los nombres de elementos y códigos son sensibles a las mayúsculas y minúsculas. Señalización de consultas XML La señalización es el proceso de analizar la entrada para generar señales. El texto sin formato de los términos de consulta XML se señaliza del mismo modo que el texto de los términos de consulta no XML. Una excepción son los términos opacos anidados, que no están soportados. La búsqueda de texto sin formato no es sensible a las mayúsculas y minúsculas. Esquema XML y DTD Los esquemas XML asociados con el documento XML no se descargan, y los valores predeterminados no se indexan. Valores numéricos Los predicados que comparan valores de atributos o elementos con números están soportados. 54 IBM i: OmniFind Text Search Server for DB2 for i Valores de elementos Los predicados que comparan valores de elementos con números o fechas están soportados. El elemento que contiene la fecha o el número debe ser un elemento XML que contenga sólo el número o la fecha. Los espacios en blanco iniciales y finales se ignoran. Valores de tipo serie La utilización del operador = para un argumento de tipo serie en un predicado requiere la coincidencia completa de todas las palabras clave de la serie con las señales del ámbito de texto identificado. El orden de las señales no es significativo al realizar la comparación. Valores DateTime Los predicados que comparan atributos o elementos de tipo Date o DateTime están soportados. Expresiones de vía de acceso: Tabla 8. Expresiones de vía de acceso: Expresión @xmlxp Descripción TagName Selecciona un código denominado TagName y todos los hijos de dicho código. @AttributeName Selecciona un atributo denominado @AttributeName. / Realiza una selección del nodo raíz. // Selecciona los códigos y atributos coincidentes que descienden de la posición actual y coinciden con la expresión. . Self: el nodo de elemento o código actual. Tabla 9. Ejemplos de expresiones de vía de acceso: Expresión @xmlxp Resultado /Document Devuelve todos los documentos con un código de nivel superior Document. //Document Devuelve todos los documentos con un código Document en cualquier nivel. /Document/Child1 Devuelve todos los documentos con un código de nivel superior Document que tienen un código hijo directo Child1. /Document//Child1 Devuelve todos los documentos con un código de nivel superior Document que tienen un código descendiente Child1 en cualquier nivel. /Root/@attr1 Devuelve todos los documentos con un código de nivel superior Root con un atributo attr1. /Root//@attr1 Devuelve todos los documentos con un código de nivel superior Root con un atributo attr1 en dicho código raíz o en cualquier código descendiente. //@attr1 Devuelve todos los documentos que tienen un atributo @attr1 en cualquier nivel. Nota: La expresión de búsqueda XML debe tener un código o nombre de atributo real en la expresión de vía de acceso relativa. / y // no son por sí mismos consultas de búsqueda válidas. OmniFind Text Search Server 55 Las expresiones de vía de acceso sólo se permiten hacia adelante, y sólo en un único eje. Es aconsejable que una expresión de vía de acceso empiece por un carácter / o //. Esto indica que el contexto inicial de la expresión es el nodo raíz del documento. Si se omite el carácter inicial / o //, la expresión se compara en cualquier nivel. Por ejemplo, 'Sentences' se trata como ’//Sentences’. El comportamiento está definido de esta manera para que sea compatible con releases anteriores y no sigue el estándar de W3 o SQL/XML. Soporte de comodín de expresiones de vía de acceso En la expresión de vía de acceso, puede utilizarse el carácter comodín especial * para indicar exactamente un código con cualquier nombre. Los comodines finales de expresión de vía de acceso se ignoran. Las siguientes utilizaciones de comodines de expresión de vía de acceso no están soportadas y provocarán un error: v Una expresión que haga referencia sólo a comodines y no a elementos o atributos específicos. v Un atributo de comodín en cualquier nivel: /Tag/@*. v Un comodín que preceda inmediatamente a una expresión de predicado: /Root/*[//anytag]. v v v v Un Un Un Un comodín utilizado en una comparación de predicados: /Root[* > 5]. comodín como prefijo de espacio de nombres XML: //*:tagname. comodín con un espacio de nombres XML como prefijo: //ns:*. carácter comodín utilizado como parte de un nombre de código: /start*. Tabla 10. Ejemplos de comodines de expresión de vía de acceso: Expresión @xmlxp Resultado /Root/*/T1 Todos los documentos que tengan un código de nivel superior Root que tenga un código descendiente T1 con un nivel intermedio. /Root/*//T1 Todos los documentos que tengan un código de nivel superior Root que tenga un código descendiente T1 con uno o más niveles intermedios. Predicados Los predicados se utilizan para especificar un valor o condición que un nodo de elemento o atributo debe cumplir. Los predicados se especifican siempre entre corchetes cuadrados: []. Tabla 11. Ejemplos de predicados: Expresión @xmlxp Resultado /Book[Sentences] El código de nivel superior es Book y debe tener un hijo directo Sentences. /Book[.//Sentences and .//Author] El código de nivel superior es Book y debe tener los descendientes Sentences y Author. Cada descendiente puede estar a cualquier nivel por debajo de Book. Dado que las expresiones de vía de acceso siempre se especifican hacia adelante y están limitadas a un único acceso, las expresiones de vía de acceso en predicados deben ser relativas al nodo actual. /Book[/Root] y /Book[//Root] no son válidas, ya que en ambos casos la expresión de vía de acceso del predicado empieza por el código de nivel superior ‘Root' en lugar del nodo actual. 56 IBM i: OmniFind Text Search Server for DB2 for i Comparaciones numéricas OMNIFIND admite los operadores =, <=, >=, >, < y != para comparaciones de elementos y atributos con valores enteros y de coma flotante. Si se trata de elementos simples, sólo se indexan sus valores numéricos. No pueden contener caracteres adicionales (aparte del espacio en blanco) ni tener elementos descendientes. Los elementos complejos se indexan sólo como texto. Tabla 12. Ejemplos de comparación numérica: Expresión @xmlxp Resultado /Book[@id_num = 12345] El código de nivel superior es Book y debe tener un atributo id_num con el valor 12345. /Book[Cost <= 100,50] El código de nivel superior es Book. Book tiene el elemento hijo directo Cost cuyo valor numérico es inferior o igual a 100,50. Comparaciones de Date y DateTime OMNIFIND admite los operadores =, <=, >=, >, < y != para comparaciones de elementos y atributos con valores de tipo Date y DateTime. En los elementos simples, sólo se indexan sus valores DateTime. Estos elementos no pueden contener caracteres adicionales (aparte del espacio en blanco) ni tener elementos descendientes. Los elementos complejos se indexan sólo como texto. Durante la indexación, se examinan los valores de atributo y el texto contenidos dentro de códigos XML simples. Si se determina que el texto coincide con un formato ISO de fecha (Date) o de fecha y hora (DateTime), se indexa como un valor Date o DateTime que puede buscarse en un predicado. Durante una búsqueda, el valor Date o DateTime debe incluirse en una llamada a una función xs:date() o xs:dateTime() para que se reconozca como el tipo de datos correcto. Un tipo de datos XML DateTime de un documento XML puede especificar un valor de huso horario. Sin embargo, al indexar un valor DateTime, el servidor de búsqueda de texto trunca los valores de huso horario. Por tanto, los husos horarios no se tienen en cuenta durante las búsquedas XML que implican a tipos de datos Date o DateTime. Además, un valor DateTime con la hora 24 sólo se permite si los minutos y los segundos son cero. Se tratará como un valor entre el último instante del día y el primer instante del día siguiente. Cuando se especifica un valor Date o DateTime en un predicado de búsqueda XML, se produce un error de sintaxis si se especifica un huso horario en el valor. El tipo de datos DateTime admite un máximo de 12 dígitos de segundos fraccionarios. Tabla 13. Ejemplos de comparación con Date y DateTime: Expresión @xmlxp Resultado /Book[@publishDate > xs:date(“2000-01-01”)] El código de nivel superior es Book. Book tiene un atributo publishDate que es mayor que la fecha 2000-01-01. /Book[purchaseTime > xs:dateTime(“2009-0520T13:00:00”)] El código de nivel superior es Book. Book tiene un hijo directo purchaseTime que es una expresión DateTime mayor que 2009-05-20T13:00:00.000000. OmniFind Text Search Server 57 Funciones contains y excludes en el código XML Las funciones contains y excludes se utilizan para realizar búsquedas de texto completas en el código XML. La función contains devuelve true si la consulta se encuentra dentro del nodo destino; excludes devuelve true si la consulta No se encuentra dentro del nodo destino. Por ejemplo, podemos buscar todos los documentos con un código de nivel superior denominado email y un descendiente directo denominado body que contenga variantes de la frase “Presupuesto de departamento”. @xnkxo:’’/email[body contains (“presupuesto de departamento”)]’’ El texto sin formato pasado a la función contains o excludes se maneja del mismo modo que cualquier otra búsqueda de texto sin formato. La búsqueda no distingue entre mayúsculas y minúsculas y se tienen en cuenta las variantes lingüísticas. La consulta anterior encontrará “presupuestos de departamentos” y también “presupuesto para el departamento”. La búsqueda puede restringirse a una coincidencia exacta mediante las comillas tradicionales, por ejemplo, @xmlxp:’’/email[body contains(“””presupuesto de departamento”””)] ’’. Las comillas que indican una coincidencia exacta deben ser dobles para que no se interpreten como el final de la serie de texto sin formato de contains. Tabla 14. Ejemplos de funciones contains y excludes: Expresión @xmlxp Resultado /Book[abstract contains(“gato AND perro”)] Código de nivel superior Book que tiene un código hijo abstract que contiene variantes lingüísticas de los términos gato y perro. /Book[abstract contains(“gato AND perro”)] /Book/@title[. contains(“gato OR perro”)] Código de nivel superior Book que tiene un atributo title que contiene variantes lingüísticas de gato o perro. /Book/Title[. contains(“””Todos los buenos perros van al cielo”””)] Código de nivel superior Book con un hijo directo Title que contiene todos los buenos perros van al cielo por orden, y sin tener en cuenta las variantes lingüísticas. /Book[abstract excludes(“gato AND perro”)] Código de nivel superior Book que tiene un código hijo abstract que no contiene variantes lingüísticas de los términos gato y perro. Operador de comparación de series completas El operador = con un argumento de tipo serie en un predicado requiere la coincidencia completa de todas las señales de la serie con todas las señales del ámbito de texto identificado. Los equivalentes lingüísticos no se tienen en cuenta. El orden de los términos buscados no es significativo. No es obligatorio que el elemento o atributo contengan sólo el texto buscado. Tabla 15. Ejemplos de operador de comparación de series completas: Expresión @xmlxp /Book[@author = /Book[author = 58 Resultado “Nicholas Lawrence”] “””Nicholas Lawrence”””] IBM i: OmniFind Text Search Server for DB2 for i Código de nivel superior Book que tiene un atributo author. El atributo author debe contener los términos Nicholas Lawrence. Las variantes lingüísticas de esos términos no se consideran coincidencias. Código de nivel superior Book que tiene un descendiente directo author. El atributo author debe contener los términos Nicholas Lawrence por orden. Las variantes lingüísticas de esos términos no se consideran coincidencias. Operadores lógicos Pueden utilizarse los operadores lógicos and y or en los predicados. Tabla 16. Ejemplos de operadores lógicos: Expresión @xmlxp Resultado /Book[@author = “””Nicholas Lawrence”””]/Price[. < 1000 and @unit = “dollars”] Código de nivel superior Book que tiene un atributo author. El atributo author debe contener los términos Nicholas Lawrence por orden. Las variantes lingüísticas de esos términos no se consideran coincidencias. Book debe tener un hijo directo Price con el valor <1000. El nodo Price debe tener un atributo @unit que tenga el valor dollars. Precedencia de operadores En los predicados de búsqueda XML, los operadores de contención y comparación tienen preferencia sobre los operadores lógicos, y todos los operadores lógicos tienen la misma preferencia. v Los operadores de contención son contains y excludes. v Los operadores de comparación son =, !=, <, >, <= y >=. v Los operadores lógicos son and y or. Puede utilizar paréntesis para garantizar la precedencia deseada. Referencia relacionada: “Sintaxis de argumentos de búsqueda” en la página 45 Puede especificar un argumento de búsqueda como condición de una búsqueda de términos en documentos de texto. Consta de parámetros de búsqueda y uno o más términos de búsqueda. Las funciones escalares de búsqueda de texto SQL que utilizan argumentos de búsqueda son CONTAINS y SCORE. “SYSPROC.SYSTS_REPRIMEINDEX” en la página 80 Puede ajustar (reprime) el índice e iniciar una actualización inicial mediante el procedimiento almacenado SYSPROC.SYSTS_REPRIMEINDEX. Utilice este procedimiento almacenado cuando desee restaurar datos desde la tabla base. “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. Soporte de espacio de nombres en búsquedas XML Puede utilizar un espacio de nombres para establecer el ámbito de los elementos y atributos de un documento. Los espacios de nombres resultan de utilidad para restringir la búsqueda de consultas a los elementos significativos del documento. Visión general En XML, el desarrollador elige los nombres de elementos y atributos. Estos nombres pueden crear conflictos cuando se mezclan documentos XML procedentes de aplicaciones diferentes. OmniFind Text Search Server 59 Por tanto, resulta de utilidad restringir la búsqueda de consultas a los elementos significativos del documento, especialmente cuando pueden indexarse varios tipos de documentos diferentes. La restricción de la búsqueda puede realizarse mediante espacios de nombres. Los espacios de nombres proporcionan el ámbito de los elemento y atributoss del documento para garantizar la interpretación correcta de los valores. Los espacios de nombres se describen con un nombre largo (URI) y, opcionalmente, un nombre abreviado denominado Qname (nombre calificado). <?xml version=’1.0’?> <doc xmlns:x="http://example.com/ns/abc"> <x:p/> </doc> http://example.com/ns/abc es el nombre largo del espacio de nombres y x es el prefijo de Qname. Un prefijo de Qname resulta de utilidad como abreviatura del espacio de nombres de cada referencia de elemento. El elemento p está calificado por el espacio de nombres http://example.com/ns/abc. El espacio de nombres predeterminado Puede especificarse un espacio de nombres predeterminado para los elementos XML. El espacio de nombres predeterminado se aplica al código actual y a los códigos descendientes. Cualquier código sin calificar del espacio de trabajo hereda el espacio de nombres predeterminado. <?xml version=’1.0’?> <doc xmlns="http://example.com/ns/abc"> <p/> </doc> En este caso, tanto el elemento doc como el elemento p se encuentran en el espacio de nombres http://example.com/ns/abc. Espacios de nombres de atributos Un atributo puede tener un espacio de nombres diferente del de su elemento asociado. Elemento y atributo calificados: <dog xmlns:an="http://example.org/animals" xmlns:sz=”http://example.org/sizes”> <an:breed sz:size=”Medium”>Mutt</an:breed> </dog> Los elementos y atributos heredan el espacio de nombres de forma diferente, cuando éste no se especifica explícitamente. Los elementos sin calificar recogen el espacio de nombres predeterminado del ámbito en el que se encuentran. Los atributos sin calificar no tienen espacio de nombres. Elemento y atributo sin calificar: <dog xmlns:an="http://example.org/animals"> <breed size=”Medium”>Mutt</an:breed> </dog> En este ejemplo, el elemento breed tiene el espacio de nombres http://example.org/animals. Sin embargo, el atributo size no tiene ningún espacio de nombres asociado. Para obtener más información acerca de los espacios de nombres de XML, consulte la recomendación W3C para espacios de nombres en XML, que se encuentra en el sitio de World Wide Web Consortium(W3C) (http://www.w3.org) 60 IBM i: OmniFind Text Search Server for DB2 for i . Prefijos de Qname reservados Los siguientes prefijos de Qname están reservados y no deben utilizarse para calificar elementos o atributos definidos por usuario: xml, xs, xsi, fn, local. Utilizar espacios de nombres en una búsqueda Los prefijos QName y los espacios de nombres de elemento predeterminados deben definirse en el prólogo de consulta @xmlxp del término de búsqueda. Ejemplo de prólogo que correlaciona el espacio de nombres ns1 con el URI "http://miempresa.com" declare namespace ns1 = "http://miempresa.com"; Ejemplo de prólogo que especifica que todos los elementos sin calificar están calificados por el URI "http://miempresa.com": declare default element namespace "http://miempresa.com" Si una consulta no declara ningún prefijo QName de espacio de nombres o espacio de nombres de elementos predeterminado, los espacios de nombres no se tienen en cuenta en la consulta. Un elemento o atributo se considera coincidente si existe en algún espacio de nombres. Si se declara algún prefijo QName o espacio de nombres predeterminado, los nombres de elemento o atributo sólo se consideran coincidentes si existen en el espacio de nombres especificado. La sintaxis declare default element namespace "”; no podría utilizarse para indicar que los códigos sin calificar no se encuentran en ningún espacio de nombres. No es necesario que los prefijos QName utilizados en la serie de búsqueda XML coincidan con el prefijo QName utilizado en el documento XML. Las coincidencias se basan únicamente en el URI de nombre largo. Ejemplos: Restringir la búsqueda al atributo attr del elemento test, estando el elemento test correlacionado con el espacio de nombres (namespace) "http://posample.org", y attr no se encuentra en ningún espacio de nombre (namespace). Utilizar el namespace predeterminado para simplificar la sintaxis. CONTAINS(myxmlcol, ’@xmlxp:’’declare default element namespace “http://myexample.org”; /test[@attr > xs:date(“2005-01-01”)]’’’) Restringir la búsqueda al atributo attr del elemento test, donde el elemento test tiene el namespace "http://myexample.org". Utilizar sintaxis de namespace explícito mediante el prefijo QName abc. CONTAINS(myxmlcol, ’@xmlxp:’’declare namespace abc = /abc:test[@attr < xs:date(“2009-01-01”)]’’’) “http://myexample.org”; Restringir la búsqueda a los elementos hijos shipTo name y billTo name del elemento purchaseOrder, que está correlacionado explícitamente con namespace "http://myexample.org" mediante el prefijo QName ns1. También se define un espacio de nombres predeterminado ("http://mastsample.org"), que se aplica a shipTo, name y billTo. CONTAINS(myxmlcol, ’@xmlxp:’’ declare default namespace "http://mastsample.org"; declare namespace ns1 = "http://posample.org"; /ns1:purchaseOrder[shipTo/name = "Jane" and billTo/name = "Jason"]’’’) Restringir la búsqueda al atributo name (definido explícitamente en el espacio de nombres "http://posample.org") del elemento shipTo (del espacio de nombres predeterminado OmniFind Text Search Server 61 "http://mastsample.org"), que es un elemento hijo del elemento purchaseOrder (definido explícitamente en el espacio de nombres "http://posample.org"). El espacio de nombres predeterminado "http://mastsample.org" se aplica a los elementos shipTo, billTo y name. CONTAINS(myxmlcol, ’@xmlxp:’’ declare default namespace "http://mastsample.org"; declare namespace ns1 = "http://posample.org"; /ns1:purchaseOrder/shipTo[@ns1:name = "Jane" and billTo/name = "Jason"]’’’) Ejemplo de búsqueda XML v Cree una tabla XML_DOCUMENTS en el esquema XMLTEST para almacenar los documentos XML: CREATE TABLE XMLTEST.XML_DOCUMENTS (ID INT, XML_DATA XML, PRIMARY KEY (ID)); v Cree un índice de búsqueda de texto denominado XML_INDEX sobre la columna XML: call SYSPROC.SYSTS_CREATE(’XMLTEST’, ’XML_INDEX’, ’XMLTEST.XML_DOCUMENTS(XML_DATA)’, ’’); v Inserte algunos documentos XML: INSERT INTO XMLTEST.XML_DOCUMENTS (ID, XML_DATA) VALUES(1, ’<BOOK publication_date="2009-01-01">’ || ’ <TITLE> OmniFind Text Search Server for DB2 </TITLE>’ || ’ <ID_NUMBER> 1 ></ID_NUMBER>’ || ’ <CHAPTER>’ || ’ <NUMBER> 1 </NUMBER>’ || ’ <TITLE> Introducción </TITLE>’ || ’ <ABSTRACT> Este capítulo presentará al lector las prestaciones de OmniFind for DB2 for IBM i </ABSTRACT>’ || ’ </CHAPTER>’|| ’ <CHAPTER>’ || ’ <NUMBER> 2 </NUMBER>’ || ’ <TITLE> Crear un índice de búsqueda de texto </TITLE>’ || ’ <ABSTRACT> Este capítulo describirá cómo crear un índice de búsqueda de texto </ABSTRACT>’ || ’ </CHAPTER>’ || ’</BOOK>’); INSERT INTO XMLTEST.XML_DOCUMENTS (ID, XML_DATA) VALUES(2, ’<BOOK publication_date="2010-02-01">’ || ’ <TITLE> Utilizar el tipo de datos XML para DB2 for IBM i </TITLE>’ || ’ <ID_NUMBER> 2 ></ID_NUMBER>’ || ’ <CHAPTER>’ || ’ <NUMBER> 1 </NUMBER>’ || ’ <TITLE> Introducción </TITLE>’ || ’ <ABSTRACT> Este capítulo presentará al lector el tipo de datos XML de DB2 </ABSTRACT>’ || ’ </CHAPTER> ’ || ’ <CHAPTER>’ || ’ <NUMBER> 2 </NUMBER>’ || ’ <TITLE> Insertar datos XML en una tabla de DB2 </TITLE>’ || ’ <ABSTRACT> Este capítulo describirá cómo insertar datos XML en una tabla de DB2 </ABSTRACT>’ || ’ </CHAPTER>’ || ’ <CHAPTER>’ || ’ <NUMBER> 3 </NUMBER>’ || ’ <TITLE> Buscar datos XML </TITLE>’ || ’ <ABSTRACT> Este capítulo describirá cómo consultar datos de columnas XML mediante las UDFS CONTAINS y SCORE </ABSTRACT>’ || ’ </CHAPTER>’ || ’</BOOK>’); INSERT INTO XMLTEST.XML_DOCUMENTS (ID, XML_DATA) VALUES(3, ’<BOOK xmlns="http://www.ibm.com/digital_media_library"’ || ’ publication_date="2010-02-01">’ || ’ <TITLE> Utilizar espacios de nombres con OmniFind Text Search Server for DB2 for IBM i </TITLE>’ || ’ <ID_NUMBER> 2 </ID_NUMBER>’ || ’ <CHAPTER>’ || ’ <NUMBER> 1 </NUMBER>’ || ’ <TITLE> Introducción </TITLE>’ || ’ <ABSTRACT> Este capítulo presentará al lector los espacios de nombres XML </ABSTRACT>’ || 62 IBM i: OmniFind Text Search Server for DB2 for i ’ </CHAPTER>’ || ’ <CHAPTER>’ || ’ <NUMBER> 2 </NUMBER>’ || ’ <TITLE> Utilizar espacios de nombres predeterminados </TITLE>’ || ’ <ABSTRACT> Este capítulo describirá cómo utilizar un espacio de nombres en una búsqueda XML </ABSTRACT>’ || ’ </CHAPTER>’ || ’</BOOK>’); v Actualice el índice: CALL SYSPROC.SYSTS_UPDATE(’XMLTEST’, ’XML_INDEX’, ’’); Consultas de ejemplo Ejemplo 1: Buscar todos los documentos que tienen un elemento raíz BOOK con un descendiente directo TITLE que contiene DB2. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’/BOOK/TITLE[. contains("DB2")]’’ ’) = 1; Dado que no se ha especificado un prólogo de espacio de nombres en el término de búsqueda, no se tiene en cuenta ningún espacio de nombres para la búsqueda. Tabla 17. Resultado ID 1 2 3 Ejemplo 2: Buscar todos los documentos que tienen un elemento raíz BOOK con un descendiente directo TITLE que contiene DB2. Utilizar un espacio de nombres de elemento predeterminado para indicar que BOOK y TITLE deben estar en el espacio de nombres "http://www.ibm.com/digital_media_library”. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’declare default element namespace "http://www.ibm.com/digital_media_library"; /BOOK/TITLE[. contains("DB2")]’’ ’) = 1; Tabla 18. Resultado ID 3 Ejemplo 3: Buscar todos los documentos que tienen un elemento raíz BOOK que tiene un atributo publication_date posterior a "2010-01-01" y un elemento hijo TITLE que contiene DB2. Restringir la búsqueda para que los códigos BOOK y TITLE no deban existir en ningún espacio de nombres. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’declare default element namespace ""; /BOOK[@publication_date > xs:date("2010-01-01")]/TITLE[. contains("DB2")]’’ ’) = 1; OmniFind Text Search Server 63 Tabla 19. Resultado ID 2 Ejemplo 4: Buscar todos los documentos con un elemento raíz BOOK (que no esté en ningún espacio de nombres) que tengan un descendiente directo CHAPTER (tampoco en un espacio de nombres) que contenga información acerca de la inserción de datos en una tabla XML. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’declare default element namespace ""; /BOOK/CHAPTER[. contains("insertar datos XML en una tabla")]’’ ’) = 1; Nota: v El texto contenido en CHAPTER incluye el texto contenido en los elementos ABSTRACT y TITLE que son descendientes de CHAPTER. v La serie de búsqueda no distingue entre mayúsculas y minúsculas y se tienen en cuenta las variantes lingüísticas de las palabras de búsqueda. Tabla 20. Resultado ID 2 Ejemplo 5: Buscar todos los documentos con un elemento raíz BOOK (en el espacio de nombres “http://www.ibm.com/ digital_media_library”) que tengan un descendiente directo CHAPTER (también en el espacio de nombres “http://www.ibm.com/digital_media_library”). CHAPTER debe tener un descendiente directo NUMBER (en el espacio de nombres “http://www.ibm.com/digital_media_library") con el valor 1, y también contener información de texto acerca de la búsqueda en un espacio de nombres XML. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’declare namespace ns1 = "http://www.ibm.com/digital_media_library"; /ns1:BOOK/ns1:CHAPTER[. contains("búsqueda XML mediante un espacio de nombres") and NUMBER = 1]’’ ’) = 1; El documento #3 es el único con códigos en el espacio de nombres correcto, pero sólo tiene coincidencias de palabras clave en un capítulo con el valor de número 2 (no 1). No se devuelve ninguna fila. Tabla 21. Resultado ID Ejemplo 6: Buscar todos los documentos con un elemento raíz BOOK (en el espacio de nombres “http://www.ibm.com/ digital_media_library”) que tengan un descendiente directo CHAPTER (en el espacio de nombres “http://www.ibm.com/digital_media_library”). CHAPTER debe tener un descendiente directo NUMBER (en el espacio de nombres “http://www.ibm.com/digital_media_library”) con el valor 1. BOOK debe tener un 64 IBM i: OmniFind Text Search Server for DB2 for i descendiente CHAPTER (no necesariamente con un descendiente NUMBER) que contenga información de texto acerca de la búsqueda en un espacio de nombres XML. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’declare namespace ns1 = "http://www.ibm.com/digital_media_library"; /ns1:BOOK[ns1:CHAPTER contains("búsqueda XML mediante un espacio de nombres")]/ns1:CHAPTER[ns1:NUMBER = 1]’’ ’) = 1; El documento 3 tiene un elemento CHAPTER que coincide con los criterios de CONTAINS, y también un elemento CHAPTER con un descendienteNUMBER que tiene el valor 1. Por tanto, el documento 3 coincide con esta consulta. Tabla 22. Resultado ID 3 Referencia relacionada: “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. “SYSPROC.SYSTS_UPDATE” en la página 36 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. Ejemplo de búsqueda XML Este ejemplo incluye una tabla de documentos XML, un índice de búsqueda de texto sobre una columna XML de la tabla y seis búsquedas de texto SQL que utilizan CONTAINS. Nota: Al utilizar los ejemplos de código, acepta los términos del apartado “Información sobre licencia de código y exención de responsabilidad” en la página 156. v Cree una tabla XML_DOCUMENTS en el esquema XMLTEST para almacenar los documentos XML: CREATE TABLE XMLTEST.XML_DOCUMENTS (ID INT, XML_DATA XML, PRIMARY KEY (ID)); v Cree un índice de búsqueda de texto denominado XML_INDEX sobre la columna XML: call SYSPROC.SYSTS_CREATE(’XMLTEST’, ’XML_INDEX’, ’XMLTEST.XML_DOCUMENTS(XML_DATA)’, ’’); v Inserte algunos documentos XML: INSERT INTO XMLTEST.XML_DOCUMENTS (ID, XML_DATA) VALUES(1, ’<BOOK publication_date="2009-01-01">’ || ’ <TITLE> OmniFind Text Search Server for DB2 </TITLE>’ || ’ <ID_NUMBER> 1 ></ID_NUMBER>’ || ’ <CHAPTER>’ || ’ <NUMBER> 1 </NUMBER>’ || ’ <TITLE> Introducción </TITLE>’ || ’ <ABSTRACT> Este capítulo presentará al lector las prestaciones de OmniFind for DB2 for IBM i </ABSTRACT>’ || ’ </CHAPTER>’|| ’ <CHAPTER>’ || ’ <NUMBER> 2 </NUMBER>’ || ’ <TITLE> Crear un índice de búsqueda de texto </TITLE>’ || ’ <ABSTRACT> Este capítulo describirá cómo crear un índice de búsqueda de texto </ABSTRACT>’ || ’ </CHAPTER>’ || ’</BOOK>’); OmniFind Text Search Server 65 INSERT INTO XMLTEST.XML_DOCUMENTS (ID, XML_DATA) VALUES(2, ’<BOOK publication_date="2010-02-01">’ || ’ <TITLE> Utilizar el tipo de datos XML para DB2 for IBM i </TITLE>’ || ’ <ID_NUMBER> 2 ></ID_NUMBER>’ || ’ <CHAPTER>’ || ’ <NUMBER> 1 </NUMBER>’ || ’ <TITLE> Introducción </TITLE>’ || ’ <ABSTRACT> Este capítulo presentará al lector el tipo de datos XML de DB2 </ABSTRACT>’ || ’ </CHAPTER> ’ || ’ <CHAPTER>’ || ’ <NUMBER> 2 </NUMBER>’ || ’ <TITLE> Insertar datos XML en una tabla de DB2 </TITLE>’ || ’ <ABSTRACT> Este capítulo describirá cómo insertar datos XML en una tabla de DB2 </ABSTRACT>’ || ’ </CHAPTER>’ || ’ <CHAPTER>’ || ’ <NUMBER> 3 </NUMBER>’ || ’ <TITLE> Buscar datos XML </TITLE>’ || ’ <ABSTRACT> Este capítulo describirá cómo consultar datos de columnas XML mediante las UDFS CONTAINS y SCORE </ABSTRACT>’ || ’ </CHAPTER>’ || ’</BOOK>’); INSERT INTO XMLTEST.XML_DOCUMENTS (ID, XML_DATA) VALUES(3, ’<BOOK xmlns="http://www.ibm.com/digital_media_library"’ || ’ publication_date="2010-02-01">’ || ’ <TITLE> Utilizar espacios de nombres con OmniFind Text Search Server for DB2 for IBM i </TITLE>’ || ’ <ID_NUMBER> 2 </ID_NUMBER>’ || ’ <CHAPTER>’ || ’ <NUMBER> 1 </NUMBER>’ || ’ <TITLE> Introducción </TITLE>’ || ’ <ABSTRACT> Este capítulo presentará al lector los espacios de nombres XML </ABSTRACT>’ || ’ </CHAPTER>’ || ’ <CHAPTER>’ || ’ <NUMBER> 2 </NUMBER>’ || ’ <TITLE> Utilizar espacios de nombres predeterminados </TITLE>’ || ’ <ABSTRACT> Este capítulo describirá cómo utilizar un espacio de nombres en una búsqueda XML </ABSTRACT>’ || ’ </CHAPTER>’ || ’</BOOK>’); v Actualice el índice: CALL SYSPROC.SYSTS_UPDATE(’XMLTEST’, ’XML_INDEX’, ’’); Consultas de ejemplo Búsqueda 1: Buscar todos los documentos que tienen un elemento raíz BOOK con un descendiente directo TITLE que contiene DB2. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’/BOOK/TITLE[. contains("DB2")]’’ ’) = 1; Dado que no se ha especificado un prólogo de espacio de nombres en el término de búsqueda, no se tiene en cuenta ningún espacio de nombres para la búsqueda. Tabla 23. Resultado ID 1 2 3 66 IBM i: OmniFind Text Search Server for DB2 for i Búsqueda 2: Buscar todos los documentos que tienen un elemento raíz BOOK con un descendiente directo TITLE que contiene DB2. Utilizar un espacio de nombres de elemento predeterminado para indicar que BOOK y TITLE deben estar en el espacio de nombres "http://www.ibm.com/digital_media_library”. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’declare default element namespace "http://www.ibm.com/digital_media_library"; /BOOK/TITLE[. contains("DB2")]’’ ’) = 1; Tabla 24. Resultado ID 3 Búsqueda 3: Buscar todos los documentos que tienen un elemento raíz BOOK que tiene un atributo publication_date posterior a "2010-01-01" y un elemento hijo TITLE que contiene DB2. Restringir la búsqueda para que los códigos BOOK y TITLE no deban existir en ningún espacio de nombres. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’declare default element namespace ""; /BOOK[@publication_date > xs:date("2010-01-01")]/TITLE[. contains("DB2")]’’ ’) = 1; Tabla 25. Resultado ID 2 Búsqueda 4: Buscar todos los documentos con un elemento raíz BOOK (que no esté en ningún espacio de nombres) que tengan un descendiente directo CHAPTER (tampoco en un espacio de nombres) que contenga información acerca de la inserción de datos en una tabla XML. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’declare default element namespace ""; /BOOK/CHAPTER[. contains("insertar datos XML en una tabla")]’’ ’) = 1; Nota: v El texto contenido en CHAPTER incluye el texto contenido en los elementos ABSTRACT y TITLE que son descendientes de CHAPTER. v La serie de búsqueda no distingue entre mayúsculas y minúsculas y se tienen en cuenta las variantes lingüísticas de las palabras de búsqueda. Tabla 26. Resultado ID 2 Búsqueda 5: Buscar todos los documentos con un elemento raíz BOOK (en el espacio de nombres “http://www.ibm.com/ digital_media_library”) que tengan un descendiente directo CHAPTER (también en el espacio de nombres OmniFind Text Search Server 67 “http://www.ibm.com/digital_media_library”). CHAPTER debe tener un descendiente directo NUMBER (en el espacio de nombres “http://www.ibm.com/digital_media_library") con el valor 1, y también contener información de texto acerca de la búsqueda en un espacio de nombres XML. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’declare namespace ns1 = "http://www.ibm.com/digital_media_library"; /ns1:BOOK/ns1:CHAPTER[. contains("búsqueda XML mediante un espacio de nombres") and NUMBER = 1]’’ ’) = 1; El documento #3 es el único con códigos en el espacio de nombres correcto, pero sólo tiene coincidencias de palabras clave en un capítulo con el valor de número 2 (no 1). No se devuelve ninguna fila. Tabla 27. Resultado ID Búsqueda 6: Buscar todos los documentos con un elemento raíz BOOK (en el espacio de nombres “http://www.ibm.com/ digital_media_library”) que tengan un descendiente directo CHAPTER (en el espacio de nombres “http://www.ibm.com/digital_media_library”). CHAPTER debe tener un descendiente directo NUMBER (en el espacio de nombres “http://www.ibm.com/digital_media_library”) con el valor 1. BOOK debe tener un descendiente CHAPTER (no necesariamente con un descendiente NUMBER) que contenga información de texto acerca de la búsqueda en un espacio de nombres XML. SELECT ID FROM XMLTEST.XML_DOCUMENTS WHERE CONTAINS(XML_DATA, ’@xmlxp:’’declare namespace ns1 = "http://www.ibm.com/digital_media_library"; /ns1:BOOK[ns1:CHAPTER contains("búsqueda XML mediante un espacio de nombres")]/ns1:CHAPTER[ns1:NUMBER = 1]’’ ’) = 1; El documento 3 tiene un elemento CHAPTER que coincide con los criterios de CONTAINS, y también un elemento CHAPTER con un descendienteNUMBER que tiene el valor 1. Por tanto, el documento 3 coincide con esta consulta. Tabla 28. Resultado ID 3 Gramática de consultas de búsqueda XML La gramática de la búsqueda XML se basa en un subconjunto del lenguaje XPath, definido por la gramática EBNF (Extended Backus-Naur Form). El analizador de consultas rechazará las consultas que no se ajusten a la gramática soportada. La gramática EBNF se ha simplificado en los siguientes aspectos: v No permitiendo nombres de vía de acceso absoluta en expresiones de predicado. v Reconociendo sólo un eje (código) y sólo hacia adelante. v Aplicando restricciones semánticas adicionales al uso del carácter comodín (consulte la sección anterior dedicada al soporte de comodines en las expresiones de vía de acceso, del apartado “Búsqueda XML” en la página 53. v Exigiendo la especificación de la declaración de espacio de nombres en la serie de búsqueda antes de cualquier utilización, implícita o explícita, del espacio de nombres. Si no se incluye la declaración de espacio de nombres, los espacios de nombres no se tienen en cuenta en la búsqueda. 68 IBM i: OmniFind Text Search Server for DB2 for i v Las expresiones de vía de acceso relativa deben tener un nombre de atributo o código incluido en la expresión. La consulta ‘/' para seleccionar el nodo raíz y ‘//' para seleccionar todos los nodos no son expresiones válidas. La tabla siguiente muestra la gramática soportada en la notación EBNF. Tabla 29. Gramática de consultas soportada en la notación EBNF Símbolo Producción XMLQuery ::= QueryPrefix NameSpaceDeclaration QueryString | QueryPrefix QueryString QueryPrefix ::= @xmlxp: QueryString ::= "'" PathExpr "'" PathExpr ::= RelativePathExpr | "/" RelativePathExpr? | "//" RelativePathExpr RelativePathExpr ::= StepExpr ( ( "/" | "//" ) StepExpr )* StepExpr ::= ( "." | AbbrevForwardStep ) Predicate? AbbrevForwardStep ::= "@"? (QName | "*") Predicate ::= "[" PredicateExpr "]" PredicateExpr ::= Expr | PredicateExpr ( "and" | "or" ) | "(" PredicateExpr ")" Expr ::= ComparisonExpr | ContainmentExpr ComparisonExpr ::= PathExpr ComparisonOp Literal ComparisonOp ::= "=" | "<" | ">" | "!=" | "<=" | ">=" Literal ::= StringLiteral | NumericLiteral | DateLiteral ContainmentExpr ::= PathExpr "contains" "(" StringLiteral ")" | PathExpr "excludes" "(" StringLiteral ")" StringLiteral ::= "\"" [^"]* "\"" | "'" [^']* "'" DateLiteral ::= "xs:date(\"" xmlDate "\")" | "xs:dateTime(\"" xmlDateTime "\")" xmlDate ::= aaaa"-"mm"-"dd xmlDateTime ::= aaaa"-"mm"-"dd [T] hh":"mm":"ss"."uuuuuu NameSpaceDeclaration ::= defaultNameSpace (NameSpacePrefixDeclaration)* defaultNameSpace ::= “declare default element namespace “ StringLiteral “;” NameSpacePrefixDeclaration ::= “declare namespace” StringLiteral “;” NameSpacePrefix ::= [^”:]+ NameSpacePrefix “=” Administrar un OmniFind(r) Text Search Server for DB2(r) for i Puede administrar OmniFind Text Search Server for DB2 for i mediante las siguientes técnicas y herramientas. OmniFind Text Search Server 69 Iniciar OmniFind Text Search Server for DB2 for i Puede iniciar OmniFind Text Search Server for DB2 for i llamando al procedimiento SYSPROC.SYSTS_START. OMNIFIND inicia automáticamente el servidor de búsqueda de texto cuando es necesario, siempre y cuando el valor de SERVERSTATUS de QSYS2.SYSTEXTSERVERS sea 0. Esta política permite iniciar automáticamente el servidor de búsqueda de texto cuando se inicia el sistema host. Sin embargo, puede iniciar el servidor manualmente si es necesario. Para iniciar el servidor: CALL SYSPROC.SYSTS_START(idservidor) Si la llamada es satisfactoria, el valor de SERVERSTATUS de QSYS2.SYSTEXTSERVERS se establece en 0 después de llamar al procedimiento. Si el servidor es local, los trabajos siguientes estarán activos en segundo plano: v QJVAEXEC QDBTS BCI 0.0 JVM-com.ibm.es v QJVAEXEC QDBTS BCI 0.0 PGM-textExtrac v QJVAEXEC QDBTS BCI 0.0 PGM-textExtrac v QJVAEXEC QDBTS BCI 0.0 PGM-textExtrac v QJVAEXEC QDBTS BCI 0.0 PGM-textExtrac donde QDBTS es el perfil de usuario de OmniFind creado durante la instalación del producto. Puede que deban transcurrir unos minutos antes de que todos estos trabajos estén activos y el servidor de texto pueda utilizarse. Referencia relacionada: “SYSPROC.SYSTS_START” en la página 15 Puede habilitar funciones de búsqueda de texto de DB2 llamando al procedimiento almacenado SYSPROC.SYSTS_START. “Tabla de administración QSYS2.SYSTEXTSERVERS” en la página 115 Puede visualizar dónde están instalados los servidores de búsqueda de texto mediante la tabla de administración QSYS2.SYSTEXTSERVERS. Detener OmniFind Text Search Server for DB2 for i Puede detener OmniFind Text Search Server for DB2 for i manualmente mediante el script de conclusión que se suministra. Si ha instalado OmniFind Text Search Server for DB2 for i como servicio, el servidor de búsqueda de texto se detiene automáticamente cada vez que se concluye el sistema host. Sin embargo, puede detener el servidor manualmente aunque haya instalado OmniFind Text Search Server for DB2 for i como servicio. Para detener OmniFind Text Search Server for DB2 for i: 1. Indique en el catálogo SYSTEXTSERVER que el servidor se detiene llamando a SYSPROC.SYSTS_STOP. v Para detener todos los servidores: CALL SYSPROC.SYSTS_STOP(). v Para detener un servidor específico: a. Consulte el catálogo de servidores para obtener el idservidor que desea detener: SELECT SERVERID,SERVERPORT,SERVERSTATUS,SERVERPATH FROM QSYS2.SYSTEXTSERVERS 70 IBM i: OmniFind Text Search Server for DB2 for i Nota: SERVERPATH identifica al servidor. SERVERSTATUS indica si el servidor está actualmente activo (0) o inactivo (1). b. Llame a SYSPROC.SYSTS_STOP, especificando el idservidor numérico o el nombre de alias del servidor que desea detener. CALL SYSPROC.SYSTS_STOP(idservidor). 2. Indique en el catálogo SYSTEXTSERVER que el servidor se detiene llamando a SYSPROC.SYSTS_SHUTDOWN. Además de establecer SERVERSTATUS en inactivo(1), este procedimiento también finalizará los trabajos de servidor de búsqueda de texto en el sistema host. v Para concluir todos los servidores: CALL SYSPROC.SYSTS_SHUTDOWN(). v Para concluir un servidor específico: a. Consulte el catálogo de servidores para obtener el idservidor que desea concluir: SELECT SERVERID,SERVERPORT,SERVERSTATUS,SERVERPATH FROM QSYS2.SYSTEXTSERVERS Nota: SERVERPATH identifica al servidor. SERVERSTATUS indica si el servidor está actualmente activo (0) o inactivo (1). b. Llame a SYSPROC.SYSTS_SHUTDOWN, especificando el idservidor numérico o el nombre de alias del servidor que desea concluir. CALL SYSPROC.SYSTS_SHUTDOWN(idservidor). 3. (Opcional) Detenga el servidor en sí llamando al script de conclusión. Al detener el servidor, se detienen todos los trabajos del servidor de búsqueda de texto del sistema host. Detenga el servidor en el entorno Qshell. Para concluir el servidor local, especifique el mandato siguiente en la línea de mandatos: QSH CMD(’cd /QOpenSys/QIBM/ProdData/TextSearch/server1/bin; shutdown.sh’) . Si el servidor que debe concluirse no es el servidor local predeterminado creado por el proceso de instalación, debe obtener el valor correcto de SERVERPATH de QSYS2.SYSTEXTSERVERS. Utilice ese valor de SERVERPATH en lugar de /QOpenSys/QIBM/ProdData/TextSearch/server1/bin. Si detiene el servidor mediante el script de conclusión, el catálogo SERVERSTATUS no cambia a estado Inactivo (1). La próxima vez que se llame a los procedimientos almacenados SYSTS_CREATE, SYSTS_UPDATE y SYSTS_DROP, o cuando se invoque una función incorporada CONTAINS o SCORE como parte de una consulta SQL, el servidor se iniciará automáticamente. Referencia relacionada: “SYSPROC.SYSTS_STOP” en la página 17 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_STOP para detener las funciones de búsqueda de texto de DB2. Este procedimiento almacenado establece el valor SERVERSTATUS del catálogo QSYS2.SYSTEXTSERVERS en 1 (detenido). “SYSPROC.SYSTS_SHUTDOWN” en la página 39 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_SHUTDOWN para concluir las funciones de búsqueda de texto de DB2®. Este procedimiento almacenado establece el valor SERVERSTATUS del catálogo QSYS2.SYSTEXTSERVERS en 1 (detenido) y también finaliza los trabajos del servidor de búsqueda de texto del sistema host. “Tabla de administración QSYS2.SYSTEXTSERVERS” en la página 115 Puede visualizar dónde están instalados los servidores de búsqueda de texto mediante la tabla de administración QSYS2.SYSTEXTSERVERS. Salvar y restaurar índices de búsqueda de texto Puede salvar y restaurar los índices de búsqueda de texto con o sin datos. Salvar y restaurar un índice de búsqueda de texto sin datos Puede salvar y restaurar una estructura de índice de búsqueda de texto sin los datos de índice. El proceso de salvar y restaurar puede realizarse mediante los mandatos CL SAVOBJ y SAVLIB. OmniFind Text Search Server 71 Cuando se crea un índice de búsqueda de texto mediante SYSTS_CREATE, se crea una vista de DB2 utilizando el esquema y el nombre del índice como nombre de la vista. La vista actúa como mecanismo para salvar y restaurar la estructura del índice. El usuario puede salvar la vista mediante los mismos métodos utilizados para salvar tablas y vistas de base de datos. (Consulte los mandatos CL SAVOBJ o SAVLIB). Al salvar la vista automáticamente, se salva la información adicional necesaria para volver a crear el índice durante la restauración. La vista puede restaurarse mediante los mandatos CL RSTOBJ o RSTLIB. DB2 for i reconoce que la vista representa un índice de búsqueda de texto y vuelve a crear el índice. Una vez recreada la estructura del índice, se someterá una actualización a un trabajo en segundo plano para volver a llenar los datos del índice. Durante el proceso de restauración deben tenerse en cuenta consideraciones adicionales: 1. Si el servidor de búsqueda de texto no puede iniciarse o un producto necesario no está instalado en el sistema, la restauración fallará. Consulte los Requisitos de software para obtener una lista de los productos necesarios. 2. Si el índice de búsqueda de texto existe en el sistema, se realizan las acciones siguientes. a. Si la información de índice existente coincide exactamente con el índice que se restaura, la restauración será satisfactoria. El índice no se reconstruye. b. Si la información de índice existente no coincide con el índice que se restaura y no puede modificarse para que coincida sin volver a crear el índice, la restauración fallará. c. Si la información de índice existente no coincide con el índice que se restaura, pero puede modificarse para que coincida mediante SYSTS_ALTER, el índice existente se modificará para que coincida con el índice que se ha salvado. El índice no se reconstruye. 3. El índice se restaura para utilizar el mismo servidor de búsqueda de texto utilizado en el momento de realizar la operación de salvar. Si el servidor utilizado cuando se realizó la operación de salvar no está definido, se seleccionará un servidor disponible en ese momento. Si el servidor salvado está definido pero no está disponible, la restauración fallará. 4. Si el índice de búsqueda de texto no puede crearse por alguna otra razón, como por ejemplo una columna incompatible en la tabla base, la restauración fallará. 5. El nombre de la tabla intermedia en QSYS2, los nombres de desencadenantes que se añaden a la tabla base y el nombre de colección en el servidor de búsqueda de texto pueden cambiar, ya que los genera el sistema. 6. Los sinónimos añadidos al diccionario de sinónimos del índice de búsqueda de texto no se conservan. 7. Si el índice existe en los catálogos del sistema durante la restauración y la vista no existe actualmente en el sistema, sólo se restaura la vista. La tabla intermedia, la colección del servidor de búsqueda de texto y los desencadenantes de la tabla base no se crean. En este caso, se presupone que el índice de búsqueda de texto forma parte de una restauración mayor en la que el usuario ha salvado explícitamente las partes individuales del índice, y ahora se restauran todas ellas (como por ejemplo al restaurar todo el sistema). Todas las partes necesarias del índice deben restaurarse para que funcione el índice. Es responsabilidad del usuario asegurarse de que todas las partes del índice estén sincronizadas. Los índices de búsqueda de texto están soportados por el mandato Restaurar objetos diferidos (RSTDFROBJ). Es aconsejable utilizar el parámetro DFRID en los mandatos CL RSTOBJ y RSTLIB. Este parámetro permite restaurar índices de búsqueda de texto mediante el mandato RSTDFROBJ después de corregir condiciones habituales que impiden la creación del índice. Son ejemplos de condiciones que provocan el diferimiento del índice: v Un producto necesario que no está instalado. v Un servidor de búsqueda de texto no está disponible o definido. 72 IBM i: OmniFind Text Search Server for DB2 for i v La tabla base no existía. Referencia relacionada: “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. “SYSPROC.SYSTS_ALTER” en la página 28 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_ALTER para modificar los atributos de un índice creado por SYSPROC.SYSTS_CREATE. Sólo se cambiarán los atributos especificados explícitamente en este procedimiento. Todos los demás atributos del índice permanecerán sin cambios. Información relacionada: Salvar objeto (SAVOBJ) Salvar biblioteca (SAVLIB) Restaurar objeto (RSTOBJ) Restaurar biblioteca (RSTLIB) Restaurar objetos diferidos (RSTDFROBJ) Salvar y restaurar un índice de búsqueda de texto con datos Salvar y restaurar un índice de búsqueda de texto con datos es una operación más compleja que hacerlo sin datos. Debe salvar los objetos siguientes: v El índice de búsqueda de texto (almacenado en el sistema de archivos integrado). v La tabla intermedia utilizada como archivo de registro que realiza el seguimiento de los cambios de registro de la tabla base (sobre la cual se ha creado el índice). La tabla intermedia se encuentra en la biblioteca QSYS2. Su nombre empieza por QDBTS, por ejemplo, QDBTS00001. v La vista, que es el objeto de base de datos que representa el índice de texto. La vista tiene el mismo nombre que el índice de texto. v La tabla base a partir de la cual se ha construido el índice. v Los catálogos SQL que almacenan la información destinada a realizar el seguimiento del índice. Para salvar los índices de búsqueda de texto, siga estos pasos: 1. Recomendado: actualice los índices realizando primero operaciones de actualización (SYSTS_UPDATE) para los índices de búsqueda de texto. 2. Salve la tabla base y la vista mediante técnicas de salvación estándar, como por ejemplo el mandato SAVOBJ. 3. Salve las tablas intermedias que se encuentran en QSYS2 mediante técnicas de salvación estándar. Por ejemplo, SAVOBJ LIB(QSYS2) OBJ(QDBTS*). 4. Salve los catálogos de índice de búsqueda de texto en QSYS2: Todos los nombres de catálogo empiezan por SYSTXT, por ejemplo, SYSTXTSRVR. Al igual que los demás catálogos SQL de QSYS2, es responsabilidad del usuario asegurarse de que se haya salvado y esté disponible una copia de seguridad. Esta copia de seguridad puede realizarse de dos maneras: a. Puede salvarse toda la biblioteca como parte del mandato SAVLIB, especificando *ALLUSR o *IBM en el parámetro LIB. b. Pueden salvarse los catálogos de búsqueda de texto específicos mediante el mandato SAVOBJ, especificando LIB(QSYS2) y OBJ((SYSTXT*)). 5. Salve la información del índice de búsqueda de texto en el sistema de archivos integrado. Esta información incluye todo el contenido del directorio config bajo la vía de acceso del servidor de texto. OmniFind Text Search Server 73 La vía de acceso del servidor de texto puede determinarse consultando la columna SERVERPATH del catálogo SYSTXTSRVR del servidor en cuestión. La vía de acceso del servidor contiene un directorio añadido al final, que debe sustituirse por el directorio config. Una técnica habitual de salvar es utilizar el mandato SAV, aunque funcionará cualquier tipo de compresión de salvado. Nota: Esta información de salvar sólo es aplicable a los servidores de texto ejecutados en IBM i. Ejemplo: Supongamos que desea salvar todos los índices de texto asociados con el servidor de texto predeterminado creado por OMNIFIND. Tiene una tabla QGPL/MYDOCS con el índice de texto QGPL/MYDOCIX construido a partir de ella. En este ejemplo, los soportes de salvar son archivos. Siga estos pasos: 1. Salve todas las tablas intermedias y los catálogos de OMNIFIND de QSYS2: SAVOBJ OBJ(QDBTS* SYSTXT*) LIB(QSYS2) DEV(*SAVF) SAVF(QGPL/SAVFQSYS2) 2. Salve la tabla base y la vista: SAVOBJ OBJ(MYDOCS MYDOCIX) LIB(QGPL) DEV(*SAVF) SAVF(QGPL/SAVFMYFILE) 3. Mediante SQL, obtenga el nombre de vía de acceso del servidor de texto. En este ejemplo, serverid = 2: SELECT SERVERPATH FROM systxtsrvr WHERE serverid=2 El valor de SERVERPATH devuelto es /QOpenSys/QIBM/ProdData/TextSearch/server1/bin/. Nota: Compruebe que está consultando el servidor correcto. 4. Especifique config en lugar de bin/ y salve los índices de texto: SAV DEV(’/QSYS.LIB/QGPL.LIB/SAVIFS.FILE’) OBJ((’/QOpenSys/QIBM/ProdData/TextSearch/server1/ config’)) Los índices de texto se salvarán ahora en los archivos de salvar QGPL/SAVFMYFILE, QGPL/SAVFQSYS2 y QGPL/SAVIFS. La operación de restaurar los índices de texto debe realizarse en el mismo orden que la operación de salvar. Los catálogos de QSYS2 DEBEN restaurarse en primer lugar. Referencia relacionada: “SYSPROC.SYSTS_UPDATE” en la página 36 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. Información relacionada: Salvar objeto (SAVOBJ) Salvar biblioteca (SAVLIB) Determinación de problemas Puede utilizar los mensajes del sistema y de rastreo registrados para determinar el origen de los problemas que puedan surgir. El registro del servidor OmniFind Text Search Server for DB2 for i se encuentra en el directorio <DIRECTORIO_INICIAL_INSTALACIÓN>/log. El registro de servidor predeterminado creado durante la instalación se encuentra en el directorio /QOpenSys/QIBM/ProdData/TextSearch/server1/log. 74 IBM i: OmniFind Text Search Server for DB2 for i Por omisión, el registro cronológico de rastreo está desactivado, y el nivel de registro del sistema está establecido en informativo. Puede utilizar la herramienta de configuración para cambiar las opciones de rastreo y nivel de registro. Los archivos de registro del servidor se rotan por tamaño. Se almacenan las cinco copias más recientes de los archivos de registro del servidor que no superan los 8 MB. Puede visualizar y guardar los registros del servidor mediante el script que se suministra. En IBM i o en un servidor Linux, el script es logformatter.sh. En un servidor Windows, el script es logformatter.bat. Opciones El script tiene las opciones siguientes. -f logfile Especifica el archivo de registro del servidor que desea formatear. -l locale Especifica el entorno local que debe utilizarse al grabar los mensajes reformateados. Por ejemplo, especifique en_US para el inglés o ja_JP para el japonés. Este valor es opcional. El valor predeterminado es en_US. -o outputfile Especifica el archivo de salida en el que deben grabarse los mensajes de registro reformateados mediante la codificación UTF-8. Este valor es opcional. Si no especifica esta opción, se utilizará un archivo de salida estándar. -? Imprime el mensaje de ayuda. Este valor es opcional. -v Especifica la modalidad de visualización de los mensajes de depuración. Este valor es opcional. Visualizar y guardar registros del servidor Puede utilizar los scripts que se suministran para visualizar y guardar los registros del servidor. Estos registros pueden ayudar a determinar el origen de los problemas. Para visualizar y guardar un registro del servidor: 1. Para visualizar el registro del servidor, ejecute uno de los mandatos siguientes: Opción Descripción En IBM i (dentro del entorno QSH) bin/logformatter.sh -f log/System.0.log En un servidor Linux bin/logformatter.sh -f log/System.0.log En un servidor Windows bin/logformatter.bat -f log/System.0.log 2. Para guardar el registro del servidor en un archivo para poder leerlo en un editor de archivos, ejecute uno de los mandatos siguientes: Opción Descripción En IBM i (dentro del entorno QSH) bin/logformatter.sh -f log/System.0.log –o <nombre de archivo de salida> En un servidor Linux bin/logformatter.sh -f log/System.0.log –o <nombre de archivo de salida> OmniFind Text Search Server 75 Opción Descripción En un servidor Windows bin/logformatter.bat -f log/System.0.log –o <nombre de archivo de salida> Herramientas de administración OMNIFIND suministra herramientas que pueden utilizarse para tareas habituales. Estas tareas incluyen la configuración y administración de un servidor de búsqueda de texto adicional y la adición de un diccionario de sinónimos a una colección. Estas herramientas son scripts de shell en lugar de mandatos CL. Pueden invocarse dentro del entorno de scripts que se inicia mediante los mandatos CL Iniciar QSH (STRQSH) o QSH (QSH). Estas herramientas no autentican ID de usuario. Sin embargo, sólo un usuario que tenga acceso válido al servidor de búsqueda de texto puede ejecutarlas. Información relacionada: Iniciar QSH (STRQSH) Iniciar QSH (QSH) Herramienta de configuración La herramienta de configuración se utiliza para personalizar valores de configuración después de instalar OmniFind Text Search Server for DB2 for i. Para personalizar la mayoría de los valores de configuración, es necesario detener el servidor de búsqueda de texto antes de ejecutar la herramienta de configuración. Sin embargo, mientras el servidor está en ejecución puede visualizar las opciones siguientes: v la señal de autenticación actual v el puerto del servidor v las propiedades actuales del sistema La herramienta configServerAndDB2 La herramienta configServerAndDB2 (configServerAndDB2.sh) se encuentra en el directorio del sistema de archivos integrado /QOpenSys/QIBM/ProdData/TextSearch. Esta herramienta puede utilizarse para crear o modificar entradas del archivo de catálogo de DB2 SYSTEXTSERVERS. También puede utilizarse para configurar la señal de autenticación o el número de puerto asociados con un servidor específico. La herramienta modifica o establece los valores de SERVERAUTHTOKEN y SERVERPORT en el archivo de catálogo de DB2 SYSTEXTSERVERS. Si desea crear un servidor adicional que se ejecute localmente en el sistema, utilice la “Herramienta ServerInstance” en la página 90. La herramienta configServerAndDB2 (configServerAndDB2.sh) se invoca con cinco parámetros: 1. El primer parámetro es generateToken o configureHTTPListener. 2. El segundo parámetro es -serverPath. 3. El tercer parámetro es la vía de acceso al nodo raíz del sistema de archivos integrado donde se almacena la información relacionada con el servidor. Ejemplo: /QOpenSys/QIBM/ProdData/TextSearch/ server2. 4. El cuarto y quinto parámetros varían en función del valor del primer parámetro. 76 IBM i: OmniFind Text Search Server for DB2 for i v Si el primer parámetro es generateToken, el cuarto parámetro es -seed seguido de un entero (por ejemplo, 1) como quinto parámetro. v Si el primer parámetro es configureHTTPListener, el cuarto parámetro es -adminHTTPPort. El quinto parámetro es un valor entero que se utiliza como puerto de socket del servidor. A continuación se muestran dos ejemplos: v STRQSH cd /QOpenSys/QIBM/ProdData/TextSearch configServerAndDB2.sh generateToken -serverPath /QOpenSys/QIBM/ProdData/TextSearch/server2 -seed 1 v STRQSH cd /QOpenSys/QIBM/ProdData/TextSearch configServerAndDB2.sh configureHTTPListener -serverPath /QOpenSys/QIBM/ProdData/TextSearch/server2 -adminHTTPPort 9997 El script configTool El script configTool.sh está disponible para cada servidor local. No es aconsejable utilizarlo para modificar entradas de servidor. Puede utilizarlo para imprimir la información del servidor (como, por ejemplo, printAll y printToken). Tabla 30. Mandatos de ejecución de la herramienta de configuración En IBM i: configTool.sh <opción_mandato_obligatoria> <argumentos_globales_obligatorios> <argumentos_globales_opcionales> <opciones_mandato_opcionales> En un servidor Linux configTool.sh <opción_mandato_obligatoria> <argumentos_globales_obligatorios> <argumentos_globales_opcionales> <opciones_mandato_opcionales> En un servidor Windows configTool.bat <opción_mandato_obligatoria> <argumentos_globales_obligatorios> <argumentos_globales_opcionales> <opciones_mandato_opcionales> Opciones de mandato La herramienta de configuración admite las siguientes opciones de mandato: configureParams Especifica los parámetros del sistema que puede configurar. Puede configurar los parámetros siguientes: -configPath Especifica la vía de acceso absoluta a la carpeta de configuración que contiene el archivo config.xml. -adminHTTPPort Especifica el número de puerto HTTP de administración. Si se produce un error, se devuelve el código de error -3. -logPath Especifica la vía de acceso absoluta al directorio de registros. OmniFind Text Search Server 77 -temDirPath Especifica la vía de acceso absoluta al directorio temporal. -numberOfIndexers Especifica el número de subsistemas de indexación de búsqueda de texto simultáneos. -numberOfTokenizers Especifica el número de subsistemas simultáneos utilizados para analizar la entrada a fin de generar señales. -maxDocumentSize Especifica el número máximo de caracteres que deben indexarse para un documento. Si se produce un error, se devuelve el código de error -3. -logLevel Especifica el nivel de registro de los mensajes del sistema en el archivo de registro. El nivel predeterminado es informativo. Las opciones adicionales son aviso y grave. -maxHeapSize Inicia y detiene el tamaño de almacenamiento dinámico en un formato aceptado por la máquina virtual Java. Si se produce un error, se devuelve el código de error -5. printToken Imprime la señal de autenticación y la clave de cifrado actuales. printAll Imprime todos los valores actuales para las opciones que pueden configurarse con esta herramienta. printAdminHTTPPort Imprime el valor actual del puerto HTTP de administración. generateToken Genera la señal de autenticación. Argumentos globales -configPath Especifica la vía de acceso absoluta a la carpeta de configuración que contiene el archivo config.xml. Este argumento global es obligatorio. -locale Especifica el valor de entorno local de cinco caracteres para la escritura de mensajes en el archivo de rastreo. Si no especifica este valor, se utilizará el valor predeterminado, -en_US. Ejemplo En un servidor Linux, especifique el mandato siguiente para imprimir la señal de autenticación actual: configTool.sh printToken -configPath <vía_acceso> <argumentos_globales_opcionales> Información relacionada: Iniciar QSH (QSH) SYSPROC.SYSTS_REMOVE Puede eliminar índices huérfanos con el procedimiento almacenado SQL SYSPROC.SYSTS_REMOVE. Autorización El nombre de colección de los índices huérfanos posibles puede identificarse mediante la función de tabla definida por usuario (UDTF) QDBTS_LISTINXSTS. Los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: 78 IBM i: OmniFind Text Search Server for DB2 for i v Autoridad *JOBCTL v Utilización de la función especial de seguridad QIBM_DB_SQLADM Sintaxis >>-SYSPROC.SYSTS_REMOVE (nombre-colección) ->< Parámetro nombre-colección Especifica un literal de tipo serie que identifica el nombre de la colección que debe eliminarse. Nota: Este procedimiento utiliza el script de shell adminTool.sh para eliminar el directorio de colección. Para utilizar este script de shell, el servidor debe encontrarse en funcionamiento. Si el servidor no se ha iniciado, este procedimiento devolverá un mensaje de error. SQL para SYSTS_REMOVE CREATE PROCEDURE SYSPROC.SYSTS_REMOVE( IN COLLECTIONNAME VARCHAR(255) CCSID 1208) EXTERNAL NAME QDBTSLIB.DSN5RMCOLL DYNAMIC RESULT SETS 0 LANGUAGE C++ PARAMETER STYLE SQL PROGRAM TYPE MAIN COMMIT ON RETURN NO INHERIT SPECIAL REGISTERS; Ejemplos v Para eliminar un índice huérfano con el nombre de colección 0_65_2815_2008_06_02_11_58_22_901726 del grupo de ASP *SYSBASE, especifique el mandato siguiente en cualquier interfaz SQL: CALL SYSPROC.SYSTS_REMOVE(’0_65_2815_2008_06_02_11_58_22_901726’) El procedimiento almacenado SYSTS_REMOVE comprueba si la información de índice se encuentra en la tabla de catálogo QSYS2.SYSTEXTINDEXES. Si es verdadero (true), se devuelve el mensaje de error DSX_INDEX_EXIST; si no es así, el procedimiento busca en el directorio config/collections del servidor 65. Si la colección no existe, se devolverá el mensaje de error DSX_COLLECTION_NOT_FOUND; si la colección existe, el procedimiento llamará a adminTool.sh para eliminar la colección. A continuación, el procedimiento comprobará de nuevo el directorio para ver si la colección se ha eliminado. Si la colección no se ha eliminado, se devolverá al usuario el mensaje de error DSX_REMOVE_COLLECTION_FAILED. Nota: Cuando la colección del servidor de búsqueda de texto se encuentra en un grupo de ASP independientes, la hebra que llama al procedimiento almacenado SYSTS_REMOVE debe ejecutarse en el espacio de nombres de la ASP independiente. Utilice el mandato Establecer grupo de agrupaciones de almacenamiento auxiliar (SETASPGRP). v Para eliminar un índice huérfano con el nombre de colección 33_7_26_2008_06_18_21_28_39_407824 de la ASP independiente iaspXXX, puede utilizar los mandatos siguientes: CL: SETASPGRP(iaspXXX) SQL: CALL SYSPROC.SYSTS_REMOVE(’ 33_7_26_2008_06_18_21_28_39_407824’) Nota: Si utiliza System i Navigator, pulse con el botón derecho del ratón el nombre de base de datos de la ASP independiente y ejecute los scripts SQL. OmniFind Text Search Server 79 Referencia relacionada: “Tabla de administración QSYS2.SYSTEXTINDEXES” en la página 112 Puede visualizar información acerca de cada índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTINDEXES. Cada índice de búsqueda de texto tiene un nombre, un nombre de esquema y un nombre de colección asociada en el servidor de búsqueda de texto. “Buscar índices huérfanos y ausentes” en la página 87 Puede buscar índices huérfanos y ausentes mediante una función de tabla definida por usuario (UDTF) SQL denominada QDBTS_LISTINXSTS. SYSPROC.SYSTS_REPRIMEINDEX Puede ajustar (reprime) el índice e iniciar una actualización inicial mediante el procedimiento almacenado SYSPROC.SYSTS_REPRIMEINDEX. Utilice este procedimiento almacenado cuando desee restaurar datos desde la tabla base. Si se restauran los datos de la tabla base, el contenido actualizado de la tabla base no puede indexarse mientras se llama al procedimiento almacenado SYSTS_UPDATE. En este caso, puede llamarse al procedimiento almacenado SYSPROC.SYSTS_REPRIMEINDEX para ajustar el índice. Nota: Si se ha creado un diccionario de sinónimos para el índice de búsqueda de texto, este proceso elimina el diccionario. Sintaxis >>-SYSPROC.SYSTS_REPRIMEINDEX( indexSchema, indexName, options) ->< El calificador de esquema es SYSPROC. Parámetros indexSchema Identifica el esquema del índice de búsqueda de texto. Si este parámetro es nulo, se utiliza el valor del registro especial CURRENT SCHEMA correspondiente al invocante. El tipo de datos de este parámetro es VARCHAR(128). indexName Identifica el nombre del índice de búsqueda de texto. El nombre del índice de búsqueda de texto, junto con el esquema del índice, identifica de forma exclusiva el índice de texto completo en el subsistema DB2. Debe especificar un valor que no sea nulo para este parámetro. El tipo de datos de este parámetro es VARCHAR(128). options Serie de caracteres que especifica opciones que pueden añadirse en el futuro a este procedimiento almacenado. Importante: Debe especificar un valor no nulo para el parámetro options. De lo contrario, pueden generarse errores. Observe el ejemplo siguiente para saber cómo especificar el parámetro opciones. SQL para SYSTS_REPRIMEINDEX CREATE PROCEDURE SYSPROC.SYSTS_REPRIMEINDEX( IN INDEXSCHEMA VARCHAR(128) CCSID 1208, IN INDEXNAME VARCHAR(128) CCSID 1208, IN OPTIONS VARCHAR(32000) CCSID 1208) EXTERNAL NAME QDBTSLIB.DSN5RPMIDX DYNAMIC RESULT SETS 0 LANGUAGE C PARAMETER STYLE SQL 80 IBM i: OmniFind Text Search Server for DB2 for i MODIFIES SQL DATA PROGRAM TYPE MAIN COMMIT ON RETURN NO INHERIT SPECIAL REGISTERS Ejemplo v Para ajustar (reprime) un índice desde cualquier interfaz SQL, especifique el mandato siguiente desde cualquier interfaz de SQL: CALL SYSPROC.SYSTS_REPRIMEINDEX('indexSchema1’,’indexName1’,’’) Referencia relacionada: “SYSPROC.SYSTS_UPDATE” en la página 36 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. SYSTS_CLEAR_INDEXES Puede eliminar índices huérfanos con el procedimiento almacenado SQL SYSPROC. SYSTS_CLEAR_INDEXES. Otra forma implícita es invocar SYSTS_START directamente, que intenta borrar índices huérfanos automáticamente. Autorización Los índices huérfanos posibles pueden identificarse mediante la función de tabla definida por usuario (UDTF) QDBTS_LISTINXSTS. Los privilegios detentados por el ID de autorización de la sentencia deben incluir como mínimo uno de los siguientes: v Autoridad *JOBCTL v Utilización de la función especial de seguridad QIBM_DB_SQLADM Sintaxis >>- SYSTS_CLEAR_INDEXES --(--+-----------+--)----------------------------->< +-id_servidor--+ ’-nombre_alias-’ Parámetros id_servidor o nombre_alias Especifica el identificador del servidor cuyos índices huérfanos deben borrarse. Un idservidor o un nombrealias de servidor es una serie de caracteres. Si no se proporciona ningún identificador, el valor predeterminado es borrar los índices huérfanos de todos los servidores. La serie del identificador debe ser un id_servidor válido que exista en la columna SERVERID o un nombre de alias de servidor válido que exista en la columna ALIASNAME de la tabla QSYS2.SYSTEXTSERVERS. Si el identificador puede convertirse a un valor entero, se interpreta como idservidor. Si el identificador no puede convertirse a un valor entero, se interpreta como nombrealias de servidor. El tipo de datos de este parámetro es VARCHAR(128). Ejemplo v Borrar todos los índices huérfanos: Call SYSPROC.SYSTS_CLEAR_INDEXES(); v Borrar los índices huérfanos de un servidor específico con el ID 50: Call SYSPROC.SYSTS_CLEAR_INDEXES(50); Call SYSPROC.SYSTS_CLEAR_INDEXES(’50’); v Borrar los índices huérfanos de un servidor específico con el nombre de alias “Local_server”: OmniFind Text Search Server 81 Call SYSPROC.SYSTS_CLEAR_INDEXES(’Local_server’); v Borrar implícitamente índices huérfanos: CALL SYSPROC.SYSTS_START(); CALL SYSPROC.SYSTS_START(50); Nota: cuando la colección del servidor de búsqueda de texto se encuentra en un grupo de ASP independientes, la hebra que llama al procedimiento almacenado SYSTS_CLEAR_INDEXES debe ejecutarse en el espacio de nombres de la ASP independiente. Utilice el mandato Establecer grupo de agrupaciones de almacenamiento auxiliar (SETASPGRP). Para eliminar un índice huérfano de una ASP independiente iaspXXX, puede utilizar los siguientes mandatos: CL: SETASPGRP(isapXXX) SQL: CALL SYSPROC.SYSTS_CLEAR_INDEXES( ) Nota: si utiliza System i® Navigator, pulse con el botón derecho del ratón el nombre de base de datos de la ASP independiente y ejecute los scripts SQL. Conceptos relacionados: “Nombre de alias de servidor” en la página 11 Puede utilizar un nombre de alias de servidor para asignar un nombre significativo a un servidor. Referencia relacionada: “Tabla de administración QSYS2.SYSTEXTINDEXES” en la página 112 Puede visualizar información acerca de cada índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTINDEXES. Cada índice de búsqueda de texto tiene un nombre, un nombre de esquema y un nombre de colección asociada en el servidor de búsqueda de texto. “Buscar índices huérfanos y ausentes” en la página 87 Puede buscar índices huérfanos y ausentes mediante una función de tabla definida por usuario (UDTF) SQL denominada QDBTS_LISTINXSTS. SYSPROC.SYSTS_VALIDITYCHECK Puede comprobar la validez de elementos de índice mediante el procedimiento almacenado SQL SYSPROC.SYSTS_VALIDITYCHECK. Sintaxis Este procedimiento almacenado puede arreglar algunos elementos que no son válidos si se especifica el parámetro autoFix. >>-SYSPROC.SYSTS_VALIDITYCHECK (indexSchema, indexName, autoFix) ->< El calificador de esquema es SYSPROC. Parámetros indexSchema Identifica el esquema del índice de búsqueda de texto. Si este parámetro es nulo, se utiliza el valor del registro especial CURRENT SCHEMA correspondiente al invocante. El tipo de datos de este parámetro es VARCHAR(128). indexName Identifica el nombre del índice de búsqueda de texto. El nombre del índice de búsqueda de texto, junto con el esquema del índice, identifica de forma exclusiva el índice de texto completo en el subsistema DB2. Debe especificar un valor que no sea nulo para este parámetro. 82 IBM i: OmniFind Text Search Server for DB2 for i El tipo de datos de este parámetro es VARCHAR(128). autoFix Identifica si es necesario un arreglo automático. El valor de este parámetro sólo puede ser 0 o 1. Los significados de estos valores son los siguientes: 0 Sólo se comprueba la validez del índice. 1 Se comprueba la validez del índice y se arreglan los elementos que no son válidos. Nota: Si se especifican valores que no son 0 o 1, se consideran 0. El tipo de datos de este parámetro es INTEGER. Restricciones: si tanto indexSchema como indexName se especifican como *NONE, el procedimiento almacenado sólo comprueba la validez de los componentes comunes del producto. SQL para SYSTS_VALIDITYCHECK CREATE PROCEDURE SYSPROC.SYSTS_VALIDITYCHECK (IN INDEXSCHEMA VARCHAR(128) CCSID 1208, IN INDEXNAME VARCHAR(128) CCSID 1208, IN AUTOFIX INTEGER) EXTERNAL NAME QDBTSLIB.DSN5VALCHK DYNAMIC RESULT SETS 0 LANGUAGE C PARAMETER STYLE SQL MODIFIES SQL DATA PROGRAM TYPE MAIN COMMIT ON RETURN NO INHERIT SPECIAL REGISTERS Ejemplos v Para comprobar la validez de un índice, especifique el mandato siguiente desde cualquier interfaz de SQL: CALL SYSPROC.SYSTS_VALIDITYCHECK('indexSchema1’,’indexName1’,0) v Para comprobar y arreglar un índice automáticamente: CALL SYSPROC.SYSTS_VALIDITYCHECK('indexSchema1’,’indexName1’,1) QDBTSLIB.QDBTS_ROWS_STATUS Los usuarios pueden comprobar qué documentos no se han indexado satisfactoriamente utilizando el procedimiento almacenado SQL QDBTSLIB.QDBTS_ROWS_STATUS después de llamar a SYSTS_UPDATE. Con este procedimiento almacenado, los usuarios pueden obtener un conjunto de resultados que presenta los documentos que no se han indexado satisfactoriamente. Los usuarios también pueden optar por generar una nueva tabla para almacenar información relacionada de los documentos que no se han indexado satisfactoriamente. Sintaxis >>-QDBTSLIB.QDBTS_ROWS_STATUS (EsquemaÍndice, NombreÍndice, IndicadorConjuntoResultados, EsquemaTabla, NombreTabla) ->< El calificador de esquema es QDBTSLIB. OmniFind Text Search Server 83 Parámetro Grupo de parámetros obligatorios EsquemaÍndice Identifica el esquema del índice de búsqueda de texto. Debe especificar un valor que no sea nulo para este parámetro. El tipo de datos de este parámetro es VARCHAR(128). NombreÍndice Identifica el nombre del índice de búsqueda de texto. El nombre del índice de búsqueda de texto con el esquema de índice identifica de forma exclusiva el índice de texto completo en el subsistema DB2®. Debe especificar un valor que no sea nulo para este parámetro. El tipo de datos de este parámetro es VARCHAR(128). Grupo de parámetros opcionales IndicadorConjuntoResultados Identifica si debe devolverse directamente el usuario el conjunto de resultados. Si el IndicadorConjuntoResultados no se pasa o está establecido en cero, el conjunto de resultados se devuelve al interlocutor. Si el IndicadorConjuntoResultados se especifica y NO está establecido en cero, no se devuelve ningún conjunto de resultados y el interlocutor puede consultar la tabla especificada por EsquemaTabla y NombreTabla. El tipo de datos de este parámetro es INTEGER. EsquemaTabla Identifica el esquema de tabla de la tabla. Si IndicadorConjuntoResultados se especifica y NO es cero, este esquema debe existir. NombreTabla Identifica el nombre de tabla generado por este procedimiento almacenado. Si IndicadorConjuntoResultados se especifica y NO es cero, este procedimiento almacenado creará una tabla con este nombre de tabla. Conjunto de resultados o estructura de tabla TIME TIMESTAMP STATUS INTEGER TEXT_STATUSVARCHAR(50) MESSAGE VARCHAR(1024) KEYCOLUMNNAMES Depende de las columnas de clave definidas en la tabla base TIME Momento en que se ha lanzado el error/aviso. .. STATUS, TEXT_STATUS 30 WARNING este registro se ha indexado pero hay aviso acerca de él 40 ERROR este registro no se ha indexado satisfactoriamente debido a algunos errores 50 FATAL ERROR este registro devuelve un error muy grave e interrumpe la indexación 84 IBM i: OmniFind Text Search Server for DB2 for i MESSAGE Muestra el código de error y el mensaje de error. De acuerdo con esta columna, los usuarios pueden saber por qué el registro no se ha indexado satisfactoriamente. KEYCOLUMNNAMES Puede haber más de una columnas de clave especificada. Si es así, se devolverán todas las columnas de clave. Cada nombre de columna de clave tendrá un prefijo 'PK_'. Ejemplos v Para comprobar si el índice contiene un documento que no se indexado satisfactoriamente: CALL QDBTSLIB.QDBTS_ROWS_STATUS(’indexSchema1’,’indexName1’) El conjunto de resultados se devolverá directamente al interlocutor. v Para generar una nueva tabla para almacenar el resultado: CALL QDBTSLIB.QDBTS_ROWS_STATUS(’indexSchema1’,’indexName1’,1,’TableSchema’,’ResultTable’) A continuación, los usuarios pueden consultar la tabla de resultados para obtener más información. SELECT * FROM TABLESCHEMA.RESULTTABLE; Supongamos que hay 2 columnas (K1, K2) de la tabla base que deben indexarse. Para obtener las filas no indexadas de la usuario, los usuarios pueden utilizar la siguiente sentencia SQL. SELECT b.*,r.MESSAGE FROM TABLESCHEMA.RESULTTABLE r LFET JOIN BASETABLESCHEMA.BASETABLE b on r.PK_K1=b.K1 and r.PK_K2=b.K2; A continuación, los usuarios pueden actualizar esa fila en función del mensaje devuelto y luego invocar de nuevo SYSTS_UPDATE para indexar la nueva fila modificada. Diccionarios de sinónimos Un diccionario de sinónimos puede mejorar la calidad de los resultados de búsqueda. Puede añadir un diccionario de sinónimos a una colección en cualquier momento. Un diccionario de sinónimos consta de grupos de sinónimos que el usuario define en un archivo XML. Por ejemplo: <?xml version="1.0" encoding="UTF-8"?> <synonymgroups version="1.0"> <synonymgroup> <synonym>Paixão</synonym> <synonym>amor</synonym> <synonym>flor</synonym> <synonym>linda</synonym> </synonymgroup> <synonymgroup> <synonym>worldwide patent tracking system</synonym> <synonym>wpts</synonym> </synonymgroup> </synonymgroups> Añadir un diccionario de sinónimos a una colección: La especificación de los grupos de sinónimos en un diccionario de sinónimos mejora la calidad de los resultados de búsqueda de texto. El administrador de OMNIFIND tiene la autoridad y los privilegios adecuados para ejecutar la herramienta de sinónimos e IBM Navigator for i. v Para añadir un diccionario de sinónimos a una colección con la herramienta de sinónimos, siga estos pasos: 1. Cree un archivo XML de sinónimos especificando los grupos de sinónimos, como se muestra en el ejemplo siguiente: <?xml version="1.0" encoding="UTF-8"?> <synonymgroups version="1.0"> <synonymgroup> OmniFind Text Search Server 85 <synonym>Paixão</synonym> <synonym>amor</synonym> <synonym>flor</synonym> <synonym>linda</synonym> </synonymgroup> <synonymgroup> <synonym>worldwide patent tracking system</synonym> <synonym>wpts</synonym> </synonymgroup> </synonymgroups> 2. Copie el archivo XML de sinónimos en el servidor de búsqueda de texto. 3. Utilice la herramienta de sinónimos para añadir el diccionario de sinónimos a una colección. Puede añadir un diccionario de sinónimos en modalidad de adición o en modalidad de sustitución. Si añade un diccionario de sinónimos en modalidad de adición, los sinónimos nuevos se añadirán al diccionario de sinónimos existente. Si añade un diccionario de sinónimos en modalidad de sustitución, los sinónimos existentes se sustituirán por los sinónimos nuevos que ha definido para el índice de búsqueda de texto. Opción Descripción En IBM i, especifique el mandato siguiente (dentro de la interfaz QSH): synonymTool.sh importSynonym -synonymFile <vía de acceso absoluta al archivo XML de sinónimos> -collectionName <nombre de colección> -replace <[true|false]> -configPath <vía de acceso absoluta a la carpeta de configuración> En un servidor Linux, especifique el mandato siguiente: synonymTool.sh importSynonym -synonymFile <vía de acceso absoluta al archivo XML de sinónimos> -collectionName <nombre de colección> -replace <[true|false]> -configPath <vía de acceso absoluta a la carpeta de configuración> En un servidor Windows, especifique el mandato siguiente: synonymTool.bat importSynonym -synonymFile <vía de acceso absoluta al archivo XML de sinónimos> -collectionName <nombre de colección> -replace <[true|false]> -configPath <vía de acceso absoluta a la carpeta de configuración> Si el formato del archivo XML no es válido o si está vacío, se devolverá un código de error. v Para importar un diccionario de sinónimos a una colección desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > OmniFind > Lista de colecciones. 3. Pulse la colección con el botón derecho del ratón y seleccione Importar diccionario de sinónimos. Eliminar un diccionario de sinónimos de una colección: Utilice el script que se suministra para eliminar un diccionario de sinónimos de una colección. El administrador de OMNIFIND debe recuperar el nombre de la colección de la que debe eliminarse el diccionario de sinónimos. Ejecute el script para eliminar un diccionario de sinónimos de una colección. 86 IBM i: OmniFind Text Search Server for DB2 for i Opción Descripción En IBM i, especifique el mandato siguiente (dentro de la interfaz QSH): removeSynonym.sh -collectionName <nombre de colección> -configPath <vía de acceso absoluta a la carpeta de configuración> En un servidor Linux, especifique el mandato siguiente: removeSynonym.sh -collectionName <nombre de colección> -configPath <vía de acceso absoluta a la carpeta de configuración> En un servidor Windows, especifique el mandato siguiente: removeSynonym.bat -collectionName <nombre de colección> -configPath <vía de acceso absoluta a la carpeta de configuración> Si una base de datos tiene varios índices de búsqueda de texto, debe realizar esta tarea para cada una de las colecciones correspondientes. Buscar índices huérfanos y ausentes Puede buscar índices huérfanos y ausentes mediante una función de tabla definida por usuario (UDTF) SQL denominada QDBTS_LISTINXSTS. Un índice puede quedar huérfano si se llama a un procedimiento almacenado SYSTS_DROP y el servidor se detiene en el momento de ejecutar el procedimiento. La función QDBTS_LISTINXSTS combina todos los índices de catálogo y colecciones del sistema de archivos integrado del espacio de nombres actual en una sola tabla. La función decide qué agrupación de almacenamiento auxiliar (ASP) independiente o *SYSBASE se establece. A continuación, explora el directorio de colección de cada servidor de la ASP independiente o de *SYSBASE. Para *SYSBASE, se comprueba cada uno de los directorios de servidor que se encuentran bajo /QOpenSys/QIBM/ProdData/TextSearch. Para las ASP independientes, se comprueba cada uno de los directorios de servidor que se encuentran bajo /el número de ASP/QOpenSys/QIBM/ProdData/TextSearch. Por ejemplo, si el número de ASP independiente es 67, se comprueba cada uno de los directorios de servidor situados bajo /67/QOpenSys/QIBM/ProdData/TextSearch. Para la información de índice de catálogo, los datos se obtienen de la tabla de catálogo QSYS2.SYSTEXTINDEXES. Si desea comprobar los servidores de una ASP independiente, emita el mandato Establecer grupo de agrupaciones de almacenamiento auxiliar (SETASPGRP) antes de llamar a esta función. Si desea eliminar posibles índices huérfanos del sistema de archivos integrado una vez identificados, utilice los procedimientos almacenados SYSPROC.SYSTS_REMOVE o SYSPROC. SYSTS_CLEAR_INDEXES o la herramienta “Administración avanzada” en la página 88 (adminTool.sh). Términos Índice huérfano Existe una colección (índice) en el directorio del sistema de archivos integrado del servidor, pero no hay ningún índice correspondiente registrado en el catálogo QSYS2.SYSTEXTINDEXES. Índice ausente Existen índices de registro en el catálogo QSYS2.SYSTEXTINDEXES, pero no existe el directorio de colección correspondiente. OmniFind Text Search Server 87 Sintaxis >>-QDBTS_LISTINXSTS(--null--)--->< Formato de retorno La función QDBTS_LISTINXSTS devuelve la información de los índices detectados en una tabla. Consulte el mandato SQL siguiente, utilizado para crear la UDTF. SQL para LISTINXSTS UDTF CREATE FUNCTION QDBTSLIB.QDBTS_LISTINXSTS() RETURNS TABLE(COLLECTIONNAME VARCHAR(255), INDEXID INTEGER, INDEXSCHEMA VARCHAR(128), INDEXNAME VARCHAR(128), SERVERID INTEGER) SPECIFIC qdbts_listinxsts SCRATCHPAD NO FINAL CALL LANGUAGE C++ PARAMETER STYLE DB2SQL EXTERNAL NAME ’QDBTSLIB/QDBTSSP(checkIndex)’; Ejemplos v Detectar todos los índices huérfanos: SELECT COLLECTIONNAME, SERVERID FROM TABLE(QDBTSLIB.QDBTS_LISTINXSTS()) AS T WHERE T.INDEXSCHEMA IS NULL AND T.INDEXNAME IS NULL v Detectar todos los índices ausentes: SELECT INDEXSCHEMA, INDEXNAME FROM TABLE(QDBTSLIB. QDBTS_LISTINXSTS()) AS T WHERE T.COLLECTIONNAME is NULL v Detectar los índices huérfanos en serverid = 2 de la ASP independiente iaspXXX: CONNECT TO iaspXXX SQL: SELECT T.COLLECTIONNAME, S.SERVERPATH FROM TABLE(QDBTSLIB.QDBTS_LISTINXSTS()) AS T LEFT OUTER JOIN QSYS2.SYSTEXTSERVERS S ON (T.SERVERID = S.SERVERID) WHERE T.INDEXSCHMEA IS NULL AND T.INDEXNAME IS NULL AND T.SERVERID = 2 Referencia relacionada: “SYSPROC.SYSTS_DROP” en la página 34 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_DROP para eliminar un índice de búsqueda de texto definido mediante el procedimiento almacenado SYSPROC.SYSTS_CREATE. “SYSPROC.SYSTS_REMOVE” en la página 78 Puede eliminar índices huérfanos con el procedimiento almacenado SQL SYSPROC.SYSTS_REMOVE. “SYSTS_CLEAR_INDEXES” en la página 81 Puede eliminar índices huérfanos con el procedimiento almacenado SQL SYSPROC. SYSTS_CLEAR_INDEXES. Otra forma implícita es invocar SYSTS_START directamente, que intenta borrar índices huérfanos automáticamente. “Tabla de administración QSYS2.SYSTEXTINDEXES” en la página 112 Puede visualizar información acerca de cada índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTINDEXES. Cada índice de búsqueda de texto tiene un nombre, un nombre de esquema y un nombre de colección asociada en el servidor de búsqueda de texto. Administración avanzada Puede utilizar la herramienta de administración para la administración avanzada. 88 IBM i: OmniFind Text Search Server for DB2 for i OmniFind Text Search Server for DB2 for i puede estar en ejecución cuando se utiliza la herramienta de administración. Puede utilizar la herramienta de administración para realizar las tareas siguientes: v Comprobar el estado de las colecciones, como por ejemplo averiguar cuántos documentos están presentes v Suprimir colecciones huérfanas v Notificar la versión del servidor v Notificar todas las colecciones que se encuentran en el servidor de búsqueda de texto Mandatos El mandato emitido para ejecutar la herramienta de administración dependerá del sistema operativo en el que esté instalado el servidor de búsqueda de texto. El mandato también depende de la tarea que se desea realizar. Tabla 31. Mandatos destinados a comprobar el estado de las colecciones y a suprimir colecciones huérfanas En IBM i (dentro de la interfaz QSH) En un servidor Linux En un servidor Windows adminTool.sh -[delete|status] –collectionName <nombre colección> -configPath <vía de acceso absoluta a la carpeta de configuración> adminTool.sh -[delete|status] –collectionName <nombre colección> -configPath <vía de acceso absoluta a la carpeta de configuración> adminTool.bat -[delete|status] –collectionName <nombre colección> -configPath <vía de acceso absoluta a la carpeta de configuración> Tabla 32. Mandatos destinados a visualizar la versión del servidor y a notificar todas las colecciones En IBM i (dentro de la interfaz QSH) En un servidor Linux En un servidor Windows adminTool.sh -[version] adminTool.sh -[version|reportAll] adminTool.bat -[version|reportAll] -configPath <vía de acceso absoluta -configPath <vía de acceso absoluta -configPath <vía de acceso absoluta a la carpeta de configuración> a la carpeta de configuración> a la carpeta de configuración> Opciones status Comprueba el estado de la colección. delete Especifica que el usuario desea suprimir la colección huérfana. version Visualiza la versión del servidor. reportAll Notifica todas las colecciones que se encuentran en el servidor de búsqueda de texto. Ejemplo Para averiguar la versión del servidor, especifique el mandato siguiente en un servidor Linux: adminTool.sh –version -s <vía de acceso absoluta al archivo config.xml del servidor> Si utiliza un servidor Windows, se le suministrará un script .bat correspondiente. OmniFind Text Search Server 89 Herramienta ServerInstance Puede utilizar la herramienta ServerInstance para crear o suprimir servidores de *SYSBASE o de una agrupación de almacenamiento auxiliar (ASP) independiente. También puede utilizar la herramienta ServerInstance para enlazar archivos de un servidor con el servidor en el que está instalado OmniFind Text Search Server for DB2 for i. Por omisión, OmniFind Text Search Server for DB2 for i se instala en el directorio /QOpenSys/QIBM/ ProdData/TextSearch/server1. Puede utilizar la herramienta ServerInstance para realizar las tareas siguientes antes de utilizarla para detener server1 en *SYSBASE: v Crear un servidor en *SYSBASE o en ASP independientes v Suprimir un servidor de *SYSBASE o de ASP independientes v Enlazar archivos de un servidor con server1 Sintaxis ServerInstance.sh –[create|delete|relink] –servernum <número_servidor> (-port <puerto>) (-device <nombre_dispositivo>) Opciones de mandato create Crea un servidor. delete Suprime un servidor. relink Enlaza archivos de un servidor con server1. Nota: Esta opción no es necesaria una vez instalado el arreglo temporal de programa (PTF) SI31548 en el sistema. El sistema procesa automáticamente la operación de enlace si tiene instalado este PTF. Parámetros número_servidor Especifica el número de servidor. Por ejemplo, si se crea un servidor con el número 3, el directorio del servidor será /QOpenSys/QIBM/ProdData/TextSearch/server3. puerto Especifica el puerto del servidor. Este parámetro sólo es necesario al crear un servidor. dispositivo Especifica el nombre de la ASP independiente. Este parámetro sólo es necesario cuando la operación se realiza en la ASP independiente. Ejemplos v Para crear un servidor con el número de servidor 2 y el número de puerto 50000 en *SYSBASE: ServerInstance.sh -create -servernum 2 -port 50000 v Para crear un servidor con el número de servidor 3 y el número de puerto 50001 en la ASP independiente iasp1: ServerInstance.sh -create -servernum 3 -port 50001 -device iasp1 v Para suprimir un servidor con el número de servidor 2 de *SYSBASE: ServerInstance.sh -delete -servernum 2 v Para suprimir un servidor con el número de servidor 3 de la ASP independiente iasp1: 90 IBM i: OmniFind Text Search Server for DB2 for i ServerInstance.sh -delete -servernum 3 -device iasp1 v Para enlazar archivos de un servidor con el número de servidor 2 de *SYSBASE: ServerInstance.sh -relink -servernum 2 v Para enlazar archivos de un servidor con el número de servidor 3 de la ASP independiente iasp1: ServerInstance.sh -relink -servernum 3 -device iasp1 Health Checker Health Checker es una herramienta de verificación de entorno que puede utilizarse para diagnosticar cualquier problema de configuración de OmniFind Text Search Server for DB2 for i. Puede utilizarse para verificar que los índices y servidores de texto de OmniFind Text Search Server for DB2 for i están funcionando correctamente y generará un informe con avisos o errores de los posibles problemas encontrados. Requisitos previos El comprobador de funcionamiento de OmniFind Text Search Server for DB2 for i se basa en ARE (Application Runtime Expert for i, producto 5770-ARE). Por tanto, ARE debe estar instalado para poder ejecutar esta herramienta. Procedimientos de Health Checker Health checker se invoca mediante una serie de procedimientos almacenados SQL de DB2. Los procedimientos pueden invocarse a través de cualquier interfaz SQL, incluyendo lenguajes de alto nivel como RPG y COBOL. Toda la información, incluidos los avisos o errores, se devuelve a través de un conjunto de resultados correspondiente. SYSPROC.SYSTS_HC_GENERAL() Este procedimiento almacenado se utiliza para comprobar el estado general del producto OmniFind Text Search Server for DB2 for i. El procedimiento comprueba la configuración del producto. Este es un ejemplo que devuelve todos los mensajes de aviso y de error relacionados con la información de configuración general de OmniFind Text Search Server for DB2 for i: > CALL SYSPROC.SYSTS_HC_GENERAL(); SYSPROC.SYSTS_HC_USR_AUTH() Este procedimiento almacenado se utiliza para identificar los problemas de autorización del usuario invocante que podrían impedirle utilizar OmniFind Text Search Server for DB2 for i para las búsquedas. Este es un ejemplo que devuelve los avisos o errores relativos a las autorizaciones del usuario invocante: > CALL SYSPROC.SYSTS_HC_USR_AUTH(); SYSPROC.SYSTS_HC_IDX() Este procedimiento almacenado se utiliza para comprobar todos los índices de texto de OmniFind Text Search Server for DB2 for i para asegurarse de que están en un estado válido. Nota: si utiliza un grupo de IASP (agrupación de almacenamiento auxiliar independiente), esto sólo se aplica al grupo de IASP actualmente activo en el trabajo. SYSSTS.HC_SVR() Este procedimiento almacenado se utiliza para comprobar el estado de todos los servidores de texto locales de OmniFind Text Search Server for DB2 for i que se han definido. OmniFind Text Search Server 91 Información adicional Encontrará más información sobre el comprobador de estado de OmniFind Text Search Server for DB2 for i, incluidas diversas opciones adicionales de procedimientos almacenados, así como una interfaz de QShell, en developerWorks OmniFind Text Search Server for DB2 for i bajo el artículo ’Health Checker’. Consideraciones relativas a las ASP independientes para OmniFind Text Search Server for DB2 for i Puede administrar un índice de búsqueda de texto en una agrupación de almacenamiento auxiliar (ASP) independiente. La ASP puede conmutarse entre varios sistemas, por lo que existen consideraciones adicionales. Durante la instalación de OMNIFIND, se crea un servidor de búsqueda de texto local. En el caso de las ASP independientes, un administrador crea un servidor de texto local mediante la herramienta ServerInstance (ServerInstance.sh) una vez creado el grupo de ASP independientes. Después de crear un servidor de búsqueda de texto local en la ASP independiente, los datos de índice existen en el sistema de archivos de la ASP independiente. Los datos están disponibles si la ASP independiente se conmuta a otro sistema. El administrador sólo necesita crear un servidor de búsqueda de texto local una vez para cada grupo de ASP independientes. Los índices de búsqueda de texto que se encuentran en la ASP independiente deben estar contenidos en servidores de búsqueda de texto definidos en la ASP independiente. No es posible visualizar un servidor de búsqueda de texto definido en otro grupo de ASP independientes o en la ASP del sistema cuando el trabajo está conectado a la ASP independiente. Para crear un servidor de búsqueda de texto en una ASP independiente denominada miiasp, siga estos pasos: 1. Active la ASP independiente con el mandato CL Trabajar con estado de configuración (WRKCFGSTS) o mediante System i Navigator. 2. Conéctese al espacio de nombres del grupo de ASP independientes mediante el mandato CL Establecer grupo de agrupaciones auxiliares (SETASPGRP). 3. Utilice el script ServerInstance.sh para crear un servidor de búsqueda de texto. A continuación figura un ejemplo del mandato QSH que debe utilizarse: /QOpenSys/QIBM/ProdData/TextSearch/ServerInstance.sh -create -servernum 2 -port nnnnn -device miiasp En el mandato, nnnnn es un número de puerto disponible para el servidor. Este número de puerto debe estar disponible en todos los sistemas a los que el grupo de ASP independientes pueda conmutarse. Una vez definido un servidor de búsqueda de texto para el grupo de ASP independientes, pueden utilizarse los procedimientos almacenados administrativos para iniciar y detener el servidor de búsqueda de texto. Los procedimientos almacenados también pueden utilizarse para crear, eliminar y actualizar índices de búsqueda de texto. Nota: Cuando se activa la ASP independiente, se añaden entradas de planificador de trabajos para los índices con actualizaciones planificadas existentes en la ASP independiente. Las entradas del planificador de trabajos permiten continuar con las actualizaciones planificadas aunque la ASP independiente se conmute entre sistemas. 92 IBM i: OmniFind Text Search Server for DB2 for i Restricciones de utilización de índices de búsqueda de texto y ASP independientes v Todos los sistemas a los que la ASP independiente puede conmutarse deben tener instalado OmniFind Text Search Server for DB2 for i y estar al mismo nivel de arreglo temporal de programa (PTF). v No cree índices de búsqueda de texto en una ASP que no sea aquella sobre la que se ha creado el índice de tabla. v Los catálogos de sistema SYSTEXTSERVERS, SYSTEXTINDEXES, SYSTEXTDEFAULTS, SYSTEXTCOLUMNS y SYSTEXTCONFIGURATION no contienen registros para índices y servidores definidos en un grupo de ASP diferente, incluida la ASP del sistema. Los catálogos contienen sólo filas para índices y servidores definidos para el grupo de ASP independientes al que el trabajo está conectado. v Los procedimientos almacenados administrativos sólo pueden utilizarse para realizar funciones en servidores de búsqueda de texto e índices definidos en el grupo de ASP independientes al que el trabajo está conectado. Nota: Puede utilizar las sentencias SQL CONTAINS y SCORE cuando un trabajo esté conectado a un grupo de ASP independientes, aunque la columna esté basada en una tabla existente en la ASP del sistema. Alta disponibilidad Puede implementar una solución de alta disponibilidad que incluya índices de búsqueda de texto utilizando API y mandatos existentes. Ahora, DB2 for IBM i reconoce los índices de búsqueda de texto y realiza acciones especiales durante las operaciones de DB2 que afectan a dichos índices. Consideraciones especiales relativas a índices de búsqueda de texto, alta disponibilidad y administración de bases de datos v Un mandato de supresión de archivo (mandato CL DLTF) o una sentencia SQL DROP VIEW ejecutados con respecto a la vista que representa el índice de búsqueda de texto provoca la eliminación del mismo. La eliminación falla si se ejecuta bajo control de compromiso. v Al restaurar una tabla o archivo físico que se ha salvado con un índice de búsqueda de texto a partir de una columna no habilita los desencadenantes creados para el índice de búsqueda de texto antes de la operación de salvar. Si más adelante se restaura o crea el índice de búsqueda de texto, los desencadenantes se añaden como parte de la creación del índice. Este método permite que las aplicaciones funcionen aunque el índice de búsqueda de texto construido originariamente a partir de la tabla no se restaure o cree. Reproducción de entradas de diario para procedimientos almacenados administrativos de OmniFind v La reproducción de la entrada de diario (API QDBRPLAY) para la creación de la vista que representa el índice de búsqueda de texto provoca la creación del índice de búsqueda de texto. v La adición y eliminación de los desencadenantes en la tabla base durante las llamadas a los procedimientos SYSTS_CREATE o SYSTS_DROP no provoca el registro de entradas de diario. v Una llamada al procedimiento almacenado SYSTS_UPDATE o SYSTS_REPRIMEINDEX da como resultado el registro de una entrada de diario con respecto a la vista del índice de búsqueda de texto. Una repetición de esta entrada de diario mediante la API QDBRPLAY provoca la repetición de la llamada al procedimiento correcto. v Las actualizaciones planificadas automáticamente NO dan como resultado entradas de diario para el índice y no pueden reproducirse. v Una llamada a SYSTS_ALTER provoca un cambio de entrada de diario en la vista. Una repetición de la entrada de diario mediante la API QDBRPLAY provoca la repetición de la llamada a SYSTS_ALTER. Recomendaciones con respecto a la alta disponibilidad OmniFind Text Search Server 93 Si desea implementar una solución de alta disponibilidad, tenga en cuenta las siguientes recomendaciones: v Después de crear el índice de búsqueda de texto en el sistema primario, puede utilizarse la API QDBRPLAY para repetir la creación en el sistema de copia de seguridad. v El sistema de copia de seguridad contiene ahora un índice duplicado, con actualizaciones planificadas que se producen con la misma frecuencia que en el sistema primario. v A medida que los cambios de registro se reproducen en los sistemas de copia de seguridad basados en la tabla, se registran en la tabla intermedia del sistema de copia de seguridad. v Las llamadas a SYSTS_UPDATE, SYSTS_REPRIMEINDEX y SYSTS_ALTER en el sistema primario generan entradas de diario que pueden reproducirse en el sistema de copia de seguridad. v NO es necesario que los clientes registren por diario y repliquen los archivos IFS para los índices de búsqueda de texto. v Es necesario asegurarse de que los desencadenantes que se han añadido como parte de SYSTS_CREATE estén habilitados para registrar los cambios en la tabla base. Estos desencadenantes pueden identificarse mediante el prefijo especial "QDBTS" en el nombre del desencadenante. Mandato CL Aplicar cambios de diario (APYJRNCHG) Puede utilizarse el mandato CL Aplicar cambios de diario (APYJRNCHG) para reproducir sucesos de OmniFind. Los usuarios que deseen utilizar este mandato deben considerar cuidadosamente el orden en que se reproducen las entradas de diario. La tabla intermedia de QSYS2 debe sincronizarse exactamente con la tabla base en el momento de reproducir o invocar SYSTS_UPDATE. Los cambios de registro que se aplican a la tabla base NO se registran en la tabla intermedia durante el proceso de APYJRNCHG. En algunos casos puede ser necesario llamar al procedimiento almacenado SYSTS_REPRIMEINDEX para reconstruir el índice después de utilizar este mandato. Referencia relacionada: “SYSPROC.SYSTS_REPRIMEINDEX” en la página 80 Puede ajustar (reprime) el índice e iniciar una actualización inicial mediante el procedimiento almacenado SYSPROC.SYSTS_REPRIMEINDEX. Utilice este procedimiento almacenado cuando desee restaurar datos desde la tabla base. Análisis del rendimiento El análisis de rendimiento de OMNIFIND incluye la elección de la definición de índice correcta, el manejo eficiente de los documentos y la especificación de una búsqueda selectiva. Segundo plano El proceso de OmniFind es una combinación de tareas en un trabajo 'cliente' de componente frontal y de tareas en un trabajo 'servidor' de segundo plano, que se intercomunican. La comunicación se realiza mediante conexiones de socket estándar. El trabajo cliente lee los registros de la tabla de base de datos adecuada durante las construcciones y el mantenimiento del índice. Procesa el registro de los cambios de tabla, envía los documentos para el proceso y maneja las solicitudes de búsqueda de texto mediante las funciones SQL CONTAINS o SCORE. El trabajo cliente es aquel en el que se ejecuta el procedimiento, por ejemplo SYSTS_CREATE o SYSTS_UPDATE, o la consulta con CONTAINS o SCORE. El rendimiento del trabajo cliente depende de la rapidez de proceso de las acciones de base de datos y la recuperación y transporte eficientes de documentos de texto al trabajo servidor. El trabajo servidor analiza los documentos enviados desde el trabajo cliente, mantiene el índice de texto asociado con las inserciones y supresiones y maneja las solicitudes de búsqueda dentro del índice. El rendimiento del trabajo servidor depende de su capacidad para comunicarse con los trabajos cliente y 94 IBM i: OmniFind Text Search Server for DB2 for i para manejar los documentos de forma eficiente. Generalmente hay un único trabajo servidor que da servicio a varios trabajos cliente. En consecuencia, el trabajo servidor es un trabajo multihebra para que pueda manejar varios clientes. Un índice de texto no se actualiza inmediatamente con los cambios realizados en la tabla de base de datos subyacente. En lugar de ello, los cambios de registro de la tabla se registran mediante una combinación de un desencadenante de base de datos y una tabla intermedia. La tabla intermedia registra el tipo de actualización (inserción, actualización o supresión) junto con una indicación de qué registro de la tabla de base de datos ha cambiado. En el archivo de registro no se captura el texto cambiado; sólo la información que identifica el registro que ha cambiado. Los cambios en los registros de la tabla no se reflejan en el índice de texto, y en consecuencia tampoco en las búsquedas con CONTAINS o SCORE, hasta la próxima operación SYSTS_UPDATE satisfactoria. Las actualizaciones de un índice de texto posteriores a la actualización inicial se denominan actualizaciones incrementales. Estas actualizaciones añaden o suprimen documentos del índice de texto en función de los cambios de registro efectuados en la tabla subyacente desde la última actualización. Los cambios realizados en la tabla base se registran en una tabla intermedia. En una actualización incremental, la tabla intermedia se utiliza para determinar qué registros de la tabla base han cambiado. Dichos registros se leen más adelante de la tabla base y su contenido actualizado se refleja en el índice. La actualización inicial es un proceso más eficiente, por fila, que una actualización incremental. La tabla base se procesa sin necesidad de procesar también la tabla intermedia. Por tanto, es una técnica aconsejable de cara al rendimiento realizar la actualización inicial en el índice de texto después de llenar inicialmente la tabla subyacente. Esta técnica minimiza el tiempo necesario para llenar el índice con los documentos. Una opción de configuración importante relacionada con el rendimiento es UPDATEAUTOCOMMIT. Este valor define la frecuencia con la que el trabajo cliente de la base de datos interrumpe el proceso de documentos. El cliente espera a que el trabajo servidor confirme que ha procesado todos los documentos que se le han enviado actualmente. UPDATEAUTOCOMMIT se utiliza como método de punto de comprobación para que la base de datos pueda establecer límites de trabajo finalizado. Si la actualización del índice se interrumpe y prosigue más adelante, el proceso se reinicia en el límite del punto de comprobación. Al igual que en cualquier interrupción, un límite de punto de comprobación obliga a la suspensión del flujo de documentos y a la eliminación de los documentos de la interconexión entre el cliente y el servidor; en otras palabras, se vacía de documentos. Este proceso de inicio y detención puede tener un efecto negativo considerable sobre el rendimiento. El valor predeterminado de UPDATEAUTOCOMMIT es 100, que proporciona puntos de comprobación frecuentes. Si se establece en un valor superior, generalmente se produce un rendimiento de tiempo de respuesta mejor para las llamadas a SYSTS_UPDATE. Sin embargo, un valor superior no implica un tiempo de recuperación mayor si la actualización se cancela y se reinicia. El establecimiento de UPDATEAUTOCOMMIT es un número superior (o en cero, que significa que no se producirán puntos de comprobación) proporciona el mejor rendimiento de tiempo de respuesta. Sin embargo, si se cancela la actualización inicial, OmniFind debe reiniciarse desde el principio del índice construido, debido a que no existe ningún punto de comprobación. Para algunos clientes, un valor entre 5000 y 20000 ofrece un equilibrio razonable entre el rendimiento y la recuperabilidad de puntos de comprobación. OmniFind Text Search Server 95 Elegir la definición de índice correcta Un índice de texto puede especificarse en cuatro tipos de configuración FORMAT: TEXT, HTML, XML e INSO. 1. TEXT es generalmente el formato más eficiente. El texto se lee del registro de base de datos y se envía al servidor de texto, que lo procesa directamente. 2. HTML se utiliza cuando se sabe que los documentos se encuentran en el formato de HyperText Markup Language. El texto se procesa ignorando los valores de control de marcación del documento. 3. XML se utiliza cuando se sabe que los documentos se encuentran en el formato de Extensible Markup Language. Se toma en especial consideración la naturaleza estructural del contenido de los documentos, con seguimiento de elementos, atributos y la jerarquía interna del documento. La marcación de un índice como XML ofrece la posibilidad de realizar búsquedas XML mediante el lenguaje de búsqueda xmlxp (xpath) en las funciones CONTAINS y SCORE. 4. INSO se utiliza cuando el documento debe procesarse al revés (INSide Out). En este formato, se presupone que el contenido de cada documento es más que texto simple. Cada documento se preanaliza para determinar de qué tipo de documento se trata y, a continuación, se convierte a texto sin formato. Los documentos INSO son generalmente documentos de tratamiento de texto enriquecido generados por programas de tratamiento de texto. Desde la perspectiva del rendimiento, el trabajo para indexar un documento aumenta al pasar del formato TEXT al formato INSO. Aunque el formato INSO maneja texto simple, genera más carga global que el formato TEXT, ya que tiene lugar un proceso de interpretación. Utilice TEXT cuando el documento sea de texto simple en la columna de base de datos. La opción de configuración LANGUAGE no es estrictamente necesaria, ya que OmniFind determina el lenguaje del documento en función de la exploración. Sin embargo, si se conoce el lenguaje de los documentos, el hecho de especificarlo en la opción LANGUAGE puede mejorar el rendimiento. Esto limitará el volumen de interpretación que debe realizarse. Manejar documentos de forma eficiente Los trabajos cliente y servidor comunican la información del documento mediante UTF (Unicode Transformation Format). Para convertir el documento a este formato, el cliente lo lee de la base de datos y convierte los datos resultantes a UTF-8, también denominado CCSID 1208. Todos el texto se convierte a UTF-8 antes de enviarlo al servidor. Para mejorar el rendimiento, establezca la columna de texto que se indexa en el CCSID 1208 para evitar esta conversión, mejorando con ello la eficiencia del proceso de manejo de documentos. Utilizar SYSTS_REPRIMEINDEX en lugar de SYSTS_UPDATE para obtener una posible mejora de rendimiento SYSTS_REPRIMEINDEX y SYSTS_UPDATE se utilizan para actualizar el índice de búsqueda de texto. SYSTS_REPRIMEINDEX se utiliza para volver a crear el índice. SYSTS_UPDATE se utiliza para actualizar el índice con los cambios incrementales utilizados después de la última actualización satisfactoria. En algunos casos, SYSTS_REPRIMEINDEX puede funcionar mejor que SYSTS_UPDATE. Para determinar si SYSTS_REPRIMEINDEX funcionará mejor que SYSTS_UPDATE, compruebe la columna PENDINGCOUNT de la vista Índice de búsqueda de texto. La columna PENDINGCOUNT indicará cuántas filas tendrán que modificarse para el próximo proceso de actualización. Si el usuario ha actualizado el mismo registro en la tabla base 10 veces, la columna PENDINGCOUNT se incrementará en 10. Por tanto, si el usuario actualiza la tabla base con frecuencia, la columna PENDINGCOUNT aumentará. En la mayoría de los casos, si la columna PENDINGCOUNT es mayor que el número total de la tabla base, el procedimiento SYSTS_REPRIMEINDEX será la mejor opción en lugar de SYSTS_UPDATE. 96 IBM i: OmniFind Text Search Server for DB2 for i Especificar una búsqueda selectiva Las búsquedas de texto se realizan mediante las funciones CONTAINS o SCORE dentro de una sentencia de consulta SQL. Estas búsquedas comparan los criterios de búsqueda de la función con los documentos asociados con la columna en la que se busca. Los registros coincidentes se identifican y seleccionan. El trabajo cliente envía la solicitud de búsqueda al servidor y recibe la respuesta con respecto a si se ha encontrado una coincidencia. Al igual que en todos los criterios de búsqueda, cuanto más selectiva sea la búsqueda, más eficiente resultará. La búsqueda de frases habituales, como por ejemplo el artículo 'the' en el idioma inglés, produce numerosas coincidencias y puede afectar negativamente al rendimiento. En la práctica, es improbable que una búsqueda de este tipo proporcione información significativa. La especificación de frases de búsqueda más selectivas producirá menos coincidencias más significativas. Generalmente, la utilización de CONTAINS en la cláusula WHERE de una sentencia SQL ofrece un mejor rendimiento que utilizar AND para otros criterios. Por ejemplo: SELECT bn, pubdate, description FROM myBooks WHERE CONTAINS(description,’Alladin’) = 1 AND Pubdate > '2004-01-01’ Utilizar CONTAINS y SCORE El optimizador puede mejorar el rendimiento de las funciones CONTAINS y SCORE combinando internamente y sustituyendo estas funciones incorporadas por una función de tabla definido por el usuario (UDTF). La UDTF devuelve una lista de documentos coincidentes en un resultado. En muchos casos, este proceso de UDTF ofrece un mejor rendimiento que el proceso alternativo consistente en invocar la función incorporada para cada registro para determinar si existe una coincidencia. Para habilitar el optimizador para realizar la reescritura de la UDTF, la función CONTAINS debe: v residir en la cláusula WHERE de la sentencia SQL v estar conectada mediante "AND" a cada predicado adicional de la cláusula WHERE v ser una comparación con el valor 1. Por ejemplo, la cláusula: WHERE CONTAINS(MyDocuments, ’java performance’) = 1 podría reescribirse mediante el optimizador en el formato de UDTF. Sin embargo, la cláusula: WHERE CONTAINS(MyDocuments, ’java performance’) = 1 OR price >100 no podría reescribirse debido a que se aplica OR a CONTAINS para otros predicados. Nota: cuando se habilita una reescritura de UDTF, el optimizador sigue utilizando la comparación de coste para elegir el plan óptimo. Referencia relacionada: “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. OmniFind Text Search Server 97 “SYSPROC.SYSTS_UPDATE” en la página 36 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_UPDATE para actualizar el índice de búsqueda de texto a fin de reflejar el contenido actual de la columna de texto. “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. Consideraciones relativas a las transacciones Tenga en cuenta el entorno al decidir la frecuencia con la que va a actualizar los índices de texto a partir de los datos subyacentes de las tablas de base de datos. Una consideración de amplio espectro para los usuarios de bases de datos tradicionales es el concepto de límites de transacción y proceso de transacción. Un ejemplo clásico de ello es una transacción bancaria, en la que se transfiere dinero de una cuenta a otra. La transferencia se considera una única transacción, independientemente de que se realice o no. El cliente no deseará que el dinero se elimine de una cuenta sin que aparezca en la otra hasta transcurrido algún tiempo. A su vez, el banco no desea que el dinero aparezca en ambas cuentas durante algún tiempo hasta que la transacción se haya completado. La idea es que, si se realiza un cambio, éste se refleje inmediatamente. En gestión de la información existen muchos ejemplos en los que los retardos son más aceptables e incluso esperados. En un diseño de depósito de datos tradicional, el contenido del depósito de datos carece con frecuencia de los datos operativos durante horas, o incluso más tiempo. Esta aceptación del retardo se basa en una combinación de expectativas realistas de un depósito de datos y el deseo de contar con datos coherentes y previsibles. Las búsquedas de texto no estructurado se sitúan en algún punto entre estos extremos. En la práctica, la indexación de documentos de texto es un proceso intensivo consistente en analizar y dividir el significado subyacente de las palabras del documento. Las búsquedas de texto permiten que una búsqueda de ‘mice' (ratones, en inglés) encuentre los documentos que contienen ‘mouse' (ratón, en inglés). Este resultado de búsqueda se produce debido a la capacidad de la técnica de indexación para separar las palabras en sus significados subyacentes. Este análisis se realiza en el momento de indexar un documento para que las búsquedas subsiguientes sean lo más rápidas posible. Los usuarios de índices de bases de datos tradicionales esperan que el índice refleje el estado de los datos en la tabla de base de datos. Esta expectativa no se cumple en el caso de un índice de texto. El contenido del índice de texto refleja el estado de la tabla en función del momento en que se realizó la última actualización (SYSTS_UPDATE). En un entorno altamente cambiante, es improbable que el índice de texto refleje el estado actual de la tabla en un momento dado. Sin embargo, en un entorno más previsible, en el que la tabla de base de datos se actualice con menor frecuencia o se realice en modalidad de proceso por lotes, las actualizaciones del índice de texto pueden temporizarse para que se realicen después de la actualización de la tabla, reflejando exactamente el estado de ésta. Es importante que las expectativas con respecto a un índice de texto sean adecuadas. Utilice la opción UPDATE FREQUENCY en los procedimientos “SYSPROC.SYSTS_CREATE” en la página 19 o “SYSPROC.SYSTS_UPDATE” en la página 36 del índice de texto o llame explícitamente al procedimiento SYSTS_UPDATE para actualizar adecuadamente el contenido del índice de texto. Para entornos más estáticos, como por ejemplo cargas de datos masivas, es aconsejable temporizar la actualización del índice de texto para que se produzca una vez realizada la carga masiva. En entornos más orientados a transacciones, puede establecerse el valor UPDATE FREQUENCY en una duración más 98 IBM i: OmniFind Text Search Server for DB2 for i corta o invocarse con frecuencia el procedimiento SYSTS_UPDATE. Normalmente, cuanto mayor es la frecuencia de actualización, mayor es la carga de trabajo a la que se somete la máquina. Referencia relacionada: “Tabla de administración QSYS2.SYSTEXTINDEXES” en la página 112 Puede visualizar información acerca de cada índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTINDEXES. Cada índice de búsqueda de texto tiene un nombre, un nombre de esquema y un nombre de colección asociada en el servidor de búsqueda de texto. Utilización de IBM Navigator for i Puede administrar los servidores de búsqueda de texto e índices de búsqueda de texto de OmniFind mediante IBM Navigator for i. 1. En la ventana de IBM Navigator for i, expanda el sistema que desea utilizar. 2. Expanda Bases de datos. 3. Expanda la base de datos con la que desee trabajar. 4. Seleccione Búsqueda de texto de OmniFind. Trabajar con servidores de búsqueda de texto Puede iniciar y detener los servidores de búsqueda de texto de OmniFind y crear un índice de búsqueda de texto mediante IBM Systems Director Navigator for i. Visualizar el estado de los Servidores de texto de OmniFind: 1. Seleccione la carpeta Servidores de texto en el panel derecho. 2. Visualice el estado de los servidores de búsqueda de texto configurados actualmente en el sistema en el panel derecho. 3. Seleccione Renovar para renovar la lista de servidores. OmniFind Text Search Server 99 Iniciar y detener los Servidores de texto de OmniFind: 1. Seleccione el recuadro situado junto al ID de servidor seleccionado en el panel derecho. 2. En el menú Acciones, seleccione una de las acciones siguientes: v Iniciar servidor v Detener servidor v Crear un índice de búsqueda de texto Crear un índice de búsqueda de texto: 100 IBM i: OmniFind Text Search Server for DB2 for i Trabajar con índices de búsqueda de texto Puede realizar operaciones sobre cualquier índice de búsqueda de texto de un sistema mediante IBM Systems Director Navigator for i. Visualizar los índices de texto de OmniFind para un servidor de texto: 1. 2. 3. 4. 5. En la ventana de IBM Systems Director Navigator, expanda el sistema que desee utilizar. Expanda Bases de datos. Expanda la base de datos con la que desee trabajar. Seleccione Búsqueda de texto de OmniFind. Seleccione Servidores de texto. 6. Seleccione el servidor de texto con el que desee trabajar. Los índices correspondientes a ese servidor se visualizarán en el panel derecho. OmniFind Text Search Server 101 Visualizar los índices de texto de OmniFind para este sistema: 1. Seleccione Búsqueda de texto de OmniFind. 2. Seleccione Índices de texto. Estos índices son todos los índices de búsqueda de texto correspondientes a este sistema en la partición actual. Realizar operaciones sobre un índice de texto: 102 IBM i: OmniFind Text Search Server for DB2 for i 1. Seleccione en el panel derecho el recuadro correspondiente al índice con el que desee trabajar. 2. Pulse Seleccionar acción en el recuadro situado en la parte superior del panel. v Definición v Actualización v Reinicialización v Supresión v Descripción Visualizar los índices de texto de OmniFind para un esquema: 1. En la ventana de IBM Systems Director Navigator, expanda el sistema que desee utilizar. 2. Expanda Bases de datos. 3. Expanda la base de datos con la que desee trabajar. 4. Expanda Esquemas. 5. Expanda el esquema con el que desee trabajar. 6. Seleccione Índices de texto de OmniFind. Estos índices son todos los índices de búsqueda de texto correspondientes a este esquema. Visualizar construcciones de índice de búsqueda de texto: Puede visualizar los índices de texto que la base de datos está construyendo mediante IBM Systems Director Navigator. Esta vista resulta de utilidad para determinar cuándo quedan disponibles los índices de búsqueda de texto para las aplicaciones. Para visualizar los índices de búsqueda que se están construyendo, siga estos pasos: 1. En la ventana de IBM Systems Director Navigator, expanda el sistema que desee utilizar. OmniFind Text Search Server 103 2. 3. 4. 5. Expanda Bases de datos. Expanda la base de datos con la que desee trabajar. Seleccione Mantenimiento de base de datos. Seleccione Construcciones de índice de texto. Este panel sólo muestra las actualizaciones de índice de búsqueda de texto en proceso. Si no hay actualizaciones o ajustes ejecutados actualmente en el sistema, estará vacío. Utilizar System i Navigator Puede administrar los servidores de búsqueda de texto e índices de búsqueda de texto de OmniFind mediante System i Navigator. 1. En la ventana de System i Navigator, expanda el sistema que desee utilizar. 2. Expanda Bases de datos. 3. Expanda la base de datos con la que desee trabajar. 4. Seleccione Búsqueda de texto de OmniFind. 104 IBM i: OmniFind Text Search Server for DB2 for i Trabajar con servidores de búsqueda de texto Puede iniciar y detener los servidores de búsqueda de texto de OmniFind y crear un índice de búsqueda de texto mediante System i Navigator. Visualizar el estado de los Servidores de texto de OmniFind: 1. Seleccione la carpeta Servidores de texto en el panel derecho. 2. Visualice el estado de los servidores de búsqueda de texto configurados actualmente en el sistema en el panel derecho. 3. Seleccione F5 para renovar la lista de servidores. OmniFind Text Search Server 105 Iniciar y detener los Servidores de texto de OmniFind: 1. Seleccione el ID de servidor seleccionado en el panel derecho. 2. Pulse el botón derecho del ratón para visualizar las opciones: v Iniciar servidor v Detener servidor v Crear un índice de búsqueda de texto Crear un índice de búsqueda de texto: 106 IBM i: OmniFind Text Search Server for DB2 for i Trabajar con índices de búsqueda de texto Puede realizar operaciones sobre cualquier índice de búsqueda de texto de un sistema mediante System i Navigator. Visualizar los índices de texto de OmniFind para un servidor de texto: 1. 2. 3. 4. 5. 6. En la ventana de System i Navigator, expanda el sistema que desee utilizar. Expanda Bases de datos. Expanda la base de datos con la que desee trabajar. Seleccione Búsqueda de texto de OmniFind. Seleccione Servidores de texto. Seleccione el servidor de texto con el que desee trabajar. Los índices correspondientes a ese servidor se visualizarán en el panel derecho. OmniFind Text Search Server 107 Visualizar los índices de texto de OmniFind para este sistema: 1. Seleccione Búsqueda de texto de OmniFind. 2. Seleccione Índices de texto. Los índices mostrados son todos los índices de búsqueda de texto correspondientes a este sistema en la partición actual. 108 IBM i: OmniFind Text Search Server for DB2 for i Realizar operaciones sobre un índice de texto: 1. Seleccione en el panel derecho un índice con el que desee trabajar. 2. Pulse el índice con el botón derecho del ratón. 3. Seleccione una operación: v actualizar v v v v v ajustar suprimir ver descripción ver definición modificar definición Visualizar los índices de texto de OmniFind para un esquema: 1. En la ventana de System i Navigator, expanda el sistema que desee utilizar. 2. 3. 4. 5. 6. Expanda Bases de datos. Expanda la base de datos con la que desee trabajar. Expanda Esquemas. Expanda el esquema con el que desee trabajar. Seleccione Índices de texto de OmniFind. Estos índices son todos los índices de búsqueda de texto correspondientes a este esquema. OmniFind Text Search Server 109 Visualizar construcciones de índice de búsqueda de texto: Puede visualizar los índices de texto que la base de datos está construyendo mediante System i Navigator. Esta vista resulta de utilidad para determinar cuándo quedan disponibles los índices de búsqueda de texto para las aplicaciones. Para visualizar los índices de búsqueda que se están construyendo, siga estos pasos: 1. 2. 3. 4. 5. En la ventana de System i Navigator, expanda el sistema que desee utilizar. Expanda Bases de datos. Expanda la base de datos con la que desee trabajar. Expanda Mantenimiento de base de datos. Seleccione Construcciones de índice de texto. Este panel sólo muestra las actualizaciones de índice de búsqueda de texto en proceso. Si no hay actualizaciones o ajustes ejecutados actualmente en el sistema, estará vacío. 110 IBM i: OmniFind Text Search Server for DB2 for i Tablas de administración de búsqueda de texto Puede dar soporte a los servidores e índices de búsqueda de texto mediante las tablas de administración de QSYS2. Tabla de administración QSYS2.SYSTEXTDEFAULTS Puede visualizar los parámetros y valores predeterminados en la tabla de administración QSYS2.SYSTEXTDEFAULTS. Esta tabla se crea al instalar OmniFind Text Search for DB2 for i. La tabla siguiente muestra el contenido de la tabla de administración QSYS2.SYSTEXTDEFAULTS. Tabla 33. Contenido de la tabla de administración QSYS2.SYSTEXTDEFAULTS Nombre de columna Tipo de datos Capacidad para nulos NAME VARCHAR(30) No Nombre de un parámetro predeterminado de la base de datos para la búsqueda de texto. VALUE VARCHAR(512) No Valor del parámetro predeterminado para la búsqueda de texto. TYPE INTEGER No Reservada. Descripción OmniFind Text Search Server 111 Tabla de administración QSYS2.SYSTEXTINDEXES Puede visualizar información acerca de cada índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTINDEXES. Cada índice de búsqueda de texto tiene un nombre, un nombre de esquema y un nombre de colección asociada en el servidor de búsqueda de texto. La tabla siguiente muestra el contenido de la tabla de administración QSYS2.SYSTEXTINDEXES. La clave exclusiva de esta tabla es la columna INDEXSCHEMA con la columna INDEXNAME. La clave primaria es la columna INDEXID. Tabla 34. Contenido de la tabla de administración QSYS2.SYSTEXTINDEXES Nombre de columna Tipo de datos Capacidad para nulos INDEXID INTEGER No ID de índice del índice de búsqueda de texto generado de forma exclusiva. INDEXSCHEMA VARCHAR(128) No Nombre de esquema del índice de búsqueda de texto. INDEXNAME VARCHAR(128) No Nombre no calificado del índice de búsqueda de texto. TABLESCHEMA VARCHAR(128) No Nombre de esquema de la tabla base. TABLENAME VARCHAR(128) No Nombre no calificado de la tabla base. TABLEIASP SMALLINT No ASP independiente de la tabla base. COLLECTIONNAME VARCHAR(255) No Nombre de la colección asociada en el servidor de búsqueda de texto. SERVERID INTEGER No ID de servidor del índice de búsqueda de texto. TAKEOVERSERVERID INTEGER Sí Reservada para uso futuro. TAKEOVERSERVERPULSE TIMESTAMP Sí Reservada para uso futuro. SEARCHARGS VARBINARY(1024) Sí Reservada para uso futuro. ALIASSCHEMA VARCHAR(128) No El alias del esquema de la tabla base utilizada en el procedimiento almacenado SYSPROC.SYSTS_CREATE. Si no se utiliza ningún alias, este valor es idéntico a TABLESCHEMA. ALIASNAME VARCHAR(128) No El alias del nombre de la tabla base utilizada en el procedimiento almacenado SYSPROC.SYSTS_CREATE. Si no se utiliza ningún alias, este valor es idéntico a TABLENAME. STAGINGTABLENAME VARCHAR(128) Sí El nombre de la tabla de registro para el índice de búsqueda de texto. EVENTTABLENAME VARCHAR(128) No El nombre de la tabla de sucesos para el índice de búsqueda de texto. OFINDEXTABLENAME VARCHAR(128) No El nombre de la tabla para el índice de búsqueda de texto en OmniFind Text Search Server for DB2 for i. UPDATEMINIMUM INTEGER No Número mínimo de entradas de la tabla de registro antes de realizar una actualización incremental del índice de búsqueda de texto. 112 IBM i: OmniFind Text Search Server for DB2 for i Descripción Tabla 34. Contenido de la tabla de administración QSYS2.SYSTEXTINDEXES (continuación) Nombre de columna Tipo de datos Capacidad para nulos UPDATEFREQUENCY VARCHAR(512) No Frecuencia de actualización del índice de búsqueda de texto según lo especificado en el procedimiento almacenado SYSPROC.SYSTS_CREATE. UPDATEMODE INTEGER No Indica la modalidad de actualización del índice de búsqueda de texto. El entero 0 (cero) indica la actualización inicial del índice de búsqueda de texto. El valor 1 indica actualizaciones incrementales posteriores. REORGANIZATIONMODE INTEGER No Indica la modalidad de reorganización del índice de búsqueda de texto. CREATETIME TIMESTAMP No Hora de creación del índice de búsqueda de texto. LASTUPDATETIME TIMESTAMP Sí Hora de última actualización del índice de búsqueda de texto. LASTUPDATESTATUS CHAR Sí Indica el estado interno para optimizar el proceso de limpieza después de una actualización inicial o incremental del índice de búsqueda de texto. Los valores típicos son: Descripción v (Nulo) indica que el índice nunca se ha actualizado. v 'C' indica que se ha iniciado una actualización inicial. Si la modalidad de actualización no es incremental, la actualización inicial sigue en proceso o no ha finalizado. v 'N' indica que se ha realizado satisfactoriamente una actualización incremental. Durante el proceso de actualización se utilizan otros códigos internamente. El proceso de actualización utiliza dichos códigos para determinar las acciones de recuperación específicas que pueden realizarse si la actualización no puede realizarse. SCHEDULERTASKID INTEGER Sí Reservada para uso futuro. EXPRESSIONLISTS CLOB (32 K) Sí Reservada para uso futuro. EXPRESSIONNUMBERS VARBINARY(32) Sí Reservada para uso futuro. USEREXITFUNCTION VARCHAR(18) Sí Reservada para uso futuro. REMARKS VARCHAR(2000) Sí Indicaciones realizadas en la opción COMMENTS del parámetro opciones-configuración-índice del procedimiento almacenado SYSPROC.SYSTS_CREATE. OmniFind Text Search Server 113 Tabla 34. Contenido de la tabla de administración QSYS2.SYSTEXTINDEXES (continuación) Nombre de columna Tipo de datos Capacidad para nulos TABLEMBR VARCHAR(10) Sí Descripción El miembro de tabla a partir del cual se ha construido el índice de texto. Se utiliza para realizar el seguimiento del miembro específico que se indexa si el archivo es multimiembro. Si el valor es nulo, es miembro es el primero y único de la tabla. Conceptos relacionados: “Nombre de alias de servidor” en la página 11 Puede utilizar un nombre de alias de servidor para asignar un nombre significativo a un servidor. Tabla de administración QSYS2.SYSTEXTCOLUMNS Puede visualizar información acerca de las columnas de texto de un índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTCOLUMNS. Cada índice de búsqueda de texto tiene un ID de índice, nombres de columna de texto y el nombre de esquema de la tabla base. La tabla siguiente muestra el contenido de la tabla de administración QSYS2.SYSTEXTCOLUMNS. La clave primaria de esta tabla es la columna INDEXID con la columna COLUMNNAME. La clave foránea es la columna INDEXID. Tabla 35. Contenido de la tabla de administración QSYS2.SYSTEXTCOLUMNS Nombre de columna Tipo de datos Capacidad para nulos INDEXID INTEGER No ID de índice del índice de búsqueda de texto generado de forma exclusiva. COLUMNNAME VARCHAR(128) No Nombre no calificado de la columna de texto. TABLESCHEMA VARCHAR(128) No Nombre de esquema de la tabla base. TABLENAME VARCHAR(128) No Nombre no calificado de la tabla base. LANGUAGE VARCHAR(5) No El idioma que el servidor de búsqueda de texto utiliza para el proceso lingüístico de los documentos de texto. El valor predeterminado es en_US (inglés). FUNCTIONSCHEMA VARCHAR(128) Sí El esquema de una función definida por el usuario utilizada por OMNIFIND para acceder a documentos de texto que se encuentran en una columna que no es de un tipo de datos soportado o que están almacenados en otro lugar. FUNCTIONNAME VARCHAR(18) Sí El nombre de una función definida por el usuario utilizada por OMNIFIND para acceder a documentos de texto que se encuentran en una columna que no es de un tipo de datos soportado o que están almacenados en otro lugar. 114 IBM i: OmniFind Text Search Server for DB2 for i Descripción Tabla 35. Contenido de la tabla de administración QSYS2.SYSTEXTCOLUMNS (continuación) Nombre de columna Tipo de datos Capacidad para nulos CCSID INTEGER No Identificador de juego de caracteres codificados utilizado para un índice de búsqueda de texto en una columna con un tipo de datos binarios. FORMAT VARCHAR(30) No El formato de los documentos de texto de la columna. Los valores de formato soportados son TEXT, HTML, XML e INSO. KEYCOLUMNCOUNT INTEGER No El recuento de columnas de clave para el índice de búsqueda de texto. KEYCOLUMNNAMES VARCHAR(1200) No Los nombres de columnas de clave para el índice de búsqueda de texto. Descripción Tabla de administración QSYS2.SYSTEXTSERVERS Puede visualizar dónde están instalados los servidores de búsqueda de texto mediante la tabla de administración QSYS2.SYSTEXTSERVERS. La tabla siguiente muestra el contenido de la tabla de administración QSYS2.SYSTEXTSERVERS. La clave exclusiva de esta tabla es la columna SERVERNAME con la columna SERVERPORT. La clave primaria es la columna SERVERID. Tabla 36. Contenido de la tabla de administración QSYS2.SYSTEXTSERVERS Nombre de columna Tipo de datos Capacidad para nulos SERVERID INTEGER No ID del servidor de búsqueda de texto generado de forma exclusiva. SERVERNAME VARCHAR(128) No Nombre o dirección IP del host del servidor de búsqueda de texto. SERVERADRINFO VARBINARY(3000) Sí Representación interna de SERVERNAME y SERVERPORT según lo determinado por el procedimiento almacenado SYSPROC.SYSTS_START. SERVERPORT INTEGER No Número de puerto del servidor de búsqueda de texto. SERVERPATH VARCHAR(512) No Vía de acceso del servidor de búsqueda de texto. SERVERTYPE INTEGER No Tipo del servidor de búsqueda de texto. El valor 0 (cero) indica un servidor de búsqueda de texto IBM i. El valor 1 indica un servidor de búsqueda de texto Linux. El valor 2 indica un servidor de búsqueda de texto Windows. SERVERAUTHTOKEN VARCHAR(256) No Señal de autenticación para el servidor de búsqueda de texto. SERVERMASTERKEY VARCHAR(36) No Clave de servidor del servidor de búsqueda de texto. Descripción OmniFind Text Search Server 115 Tabla 36. Contenido de la tabla de administración QSYS2.SYSTEXTSERVERS (continuación) Nombre de columna Tipo de datos Capacidad para nulos SERVERCLASS INTEGER No Clase de servidor del servidor de búsqueda de texto. El valor 0 (cero) indica un servidor de producción, disponible para selección automática. El valor 9 indica un servidor de prueba, nunca asignado automáticamente. SERVERSTATUS INTEGER No Indica si el servidor puede utilizarse como servidor de búsqueda de texto para crear índices de búsqueda de texto. El valor predeterminado es 0 (cero), que indica que el servidor puede utilizarse. ALIASNAME VARCHAR(128) Sí El nombre de alias es exclusivo cuando no es nulo y es sensible a las mayúsculas y minúsculas. Descripción Conceptos relacionados: “Nombre de alias de servidor” en la página 11 Puede utilizar un nombre de alias de servidor para asignar un nombre significativo a un servidor. Tabla de administración QSYS2.SYSTEXTCONFIGURATION Puede visualizar los parámetros de configuración del índice de búsqueda de texto pasados por el procedimiento almacenado SYSPROC.SYSTS_CREATE en la tabla de administración QSYS2.SYSTEXTCONFIGURATION. La tabla siguiente muestra el contenido de la tabla de administración QSYS2.SYSTEXTCONFIGURATION. La clave primaria es la columna INDEXID con la columna PARAMETER. La clave foránea es la columna INDEXID. Tabla 37. Contenido de la tabla de administración QSYS2.SYSTEXTCONFIGURATION Nombre de columna Tipo de datos Capacidad para nulos Descripción INDEXID INTEGER No ID de índice del índice de búsqueda de texto generado de forma exclusiva. PARAMETER VARCHAR(30) No Parámetros especificados para el índice de búsqueda de texto en el procedimiento almacenado SYSPROC.SYSTS_CREATE. VALUE VARCHAR(512) No Valores de los parámetros especificados. Referencia relacionada: “SYSPROC.SYSTS_CREATE” en la página 19 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_CREATE para crear un índice de búsqueda de texto. Este procedimiento almacenado habilita una columna de texto para la indexación de búsqueda de texto. A continuación, el índice de búsqueda de texto puede utilizarse en consultas SQL que contengan las funciones CONTAINS o SCORE. Tabla de administración QSYS2.SYSTEXTSERVERHISTORY Puede ver el historial de los servidores utilizados para el procedimiento almacenado SYSPROC.SYSTS_DROP visualizando la tabla auxiliar QSYS2.SYSTEXTSERVERHISTORY. 116 IBM i: OmniFind Text Search Server for DB2 for i La tabla siguiente muestra el contenido de la tabla de administración QSYS2.SYSTEXTSERVERHISTORY. La clave exclusiva de esta tabla es la columna INDEXID con la columna SERVERID. La clave foránea es la columna INDEXID. Tabla 38. Contenido de la tabla de administración QSYS2.SYSTEXTSERVERHISTORY Nombre de columna Tipo de datos Capacidad para nulos INDEXID INTEGER No ID de índice de un índice de búsqueda de texto creado. SERVERID INTEGER No ID del servidor donde debe descartarse un índice de búsqueda de texto en SYSPROC.SYSTS_DROP. Descripción Referencia relacionada: “SYSPROC.SYSTS_DROP” en la página 34 Puede llamar al procedimiento almacenado SYSPROC.SYSTS_DROP para eliminar un índice de búsqueda de texto definido mediante el procedimiento almacenado SYSPROC.SYSTS_CREATE. Vista Índice de búsqueda de texto Si se crea un índice de búsqueda de texto con SYSTS_CREATE, se creará una vista que representa el índice. Consultar la vista del índice de búsqueda de texto puede ayudar al usuario a obtener el estado del índice. El nombre de la vista del índice de búsqueda de texto es el mismo nombre que el nombre de índice de búsqueda de texto que se ha especificado al crear el índice con SYSTS_CREATE. La tabla siguiente muestra el contenido de la vista de índice de búsqueda de texto. Tabla 39. Contenido de la vista creada por SYSTS_CREATE Nombre de columna Tipo de datos CCSID Capacidad para nulos TABLESCHEMA VARCHAR(128) 1208 No Nombre de esquema de la tabla base. TABLENAME VARCHAR(128) 1208 No Nombre no calificado de la tabla base. COLUMNNAME VARCHAR(128) 1208 No Nombre no calificado de la columna de texto de la tabla base. SERVERID INTEGER No ID de servidor exclusivo de SYSTEXTSERVERS. SERVERNAME VARCHAR(128) 1208 No Nombre no calificado del servidor de búsqueda de texto. SERVERSTATUS VARCHAR(32) 1208 No v ‘STARTED’ – El servidor está en ejecución. Descripción v ‘STOPPED’ – El servido está detenido. STAGINGTABLENAME VARCHAR(128) LASTUPDATETIME TIMESTAMP 1208 No Nombre no calificado de la tabla de registro para el índice de búsqueda de texto. Sí Hora de última actualización del índice de búsqueda de texto. OmniFind Text Search Server 117 Tabla 39. Contenido de la vista creada por SYSTS_CREATE (continuación) Nombre de columna Tipo de datos CCSID Capacidad para nulos LASTUPDATESTATUS VARCHAR(30) 1208 Sí Descripción v ’NEVER UPDATED’ – El índice no se ha actualizado antes. v ‘UP TO DATE’ – Última actualización satisfactoria y no hay ningún cambio pendiente. v ‘CHANGES PENDING’ – Última actualización satisfactoria, pero todavía hay nuevos cambios que actualizar. v ‘FAILED’ – Última actualización anómala. UPDATEMINIMUM INTEGER UPDATEFREQUENCY VARCHAR(512) PENDINGCOUNT INTEGER 1208 No Número mínimo de entradas de la tabla de registro antes de realizar una actualización incremental del índice de búsqueda de texto. No Frecuencia de actualización del índice de búsqueda de texto según lo especificado en el procedimiento almacenado SYSPROC.SYSTS_CREATE. No Indica cuántas filas deben indexarse en el próximo proceso de actualización. Ampliaciones para indexar y buscar datos no DB2 La OmniFind Text Search for DB2 for i proporciona un conjunto adicional de los procedimientos almacenados para crear, administrar y buscar colecciones de búsqueda de texto. Visión general de las ampliaciones OmniFind Text Search Server for DB2 for i proporciona un conjunto adicional de procedimientos almacenados para crear, administrar y buscar en colecciones de búsqueda de texto. Una colección de búsqueda de texto se utiliza para indexar datos asociados con objetos del sistema, como por ejemplo archivos spool de una cola de salida o datos de archivo continuo del sistema de archivos integrado. Una colección de búsqueda de texto describe uno o más conjuntos de objetos del sistema cuyos datos de texto asociados se indexarán y buscarán. Por ejemplo, una colección puede contener un conjunto de objetos de todos los archivos spool de la cola de salida QUSRSYS/QEZJOBLOG y/o un conjunto de objetos de todos los archivos continuos del directorio '/home/alice/text_data'. La colección de búsqueda de texto a la que se hace referencia en esta documentación no debe confundirse con un esquema de DB2 (a veces también llamado colección) o una colección de Lucene (parte de la estructura interna de un índice de búsqueda de texto de DB2). 118 IBM i: OmniFind Text Search Server for DB2 for i Cuando se crea una colección de búsqueda de texto, se crean varios objetos de DB2 en el sistema en un esquema SQL. Los objetos siguientes se crearán en el esquema: v Catálogos para el seguimiento de la configuración de la colección. v Catálogos para el seguimiento de los objetos que se han indexado. v Procedimientos almacenados SQL para administrar y buscar en la colección. v Un índice de búsqueda de texto de DB2 para indexar el texto asociado. Se suministran procedimientos almacenados para la administración de la colección, la mayoría de los cuales se crean en el esquema. Puede encontrar una descripción de otras mejoras de OmniFind Text Search Server for DB2 for i en: Mejoras de OmniFind Text Search Server for DB2 for i. Crear una colección de búsqueda de texto Este procedimiento crea una colección de búsqueda vacía. Se creará un esquema SQL en el sistema para contener información acerca de la colección. El esquema contendrá objetos DB2 necesarios para rastrear e indexar objetos. SYSPROC.SYSTS_CRTCOL y SYSPROC.SYSTS_CREATE_COLLECTION Autorización SYSTS_CRTCOL y SYSTS_CREATE_COLLECTION se suministrarán con la autorización *EXECUTE otorgada de modo público. Estos procedimientos no adoptarán ninguna autorización adicional y se ejecutarán bajo el perfil de invocación. Para crear una colección de búsqueda de texto, el invocador debe tener: v Autorización para crear un esquema DB2 v Autorización/capacidad para crear un índice de búsqueda de texto Los objetos de DB2 creados como parte de la colección, incluidos los procedimientos almacenados administrativos, se crean con la autorización pública *EXCLUDE. El perfil de usuario que crea la colección es propietario de todos los objetos de la misma. Un usuario puede otorgar autorización sobre un procedimiento específico a otros usuarios con el fin de permitir que otro usuario administre y busque en la colección de búsqueda de texto. Sintaxis SYSTS_CRTCOL ( nombre_colección ) , opciones , nombre_dispositivo_asp Sintaxis SYSTS_CREATE_COLLECTION ( nombre_colección ) , opciones , nombre_dispositivo_asp El calificador de esquema es SYSPROC. OmniFind Text Search Server 119 Parámetros nombre_colección Nombre de la colección. Este nombre identifica de forma exclusiva la colección y debe ser una serie no nula. Se creará un esquema del nombre especificado para el nombre de la colección para que contenga los objetos DB2 asociados. Nota: especifique los nombres entre comillas dobles si los nombres entran en conflicto con palabras clave SQL o palabras clave de OmniFind que puedan utilizarse. El parámetro de nombre de colección seguirá las reglas de SQL para los nombres de esquema. El nombre de colección no debe coincidir con el nombre de un perfil de usuario existente. El tipo de datos de este parámetro es VARCHAR(128). opciones Serie de caracteres que especifica las diversas opciones que están disponibles para este procedimiento almacenado. El tipo de datos de este parámetro es VARCHAR(32000). opciones: información-predeterminada-texto características-actualización opciones-configuración-índice información-predeterminada-texto: LANGUAGE idioma FORMAT formato información-predeterminada-texto Especifica el idioma utilizado al procesar documentos y el formato de los documentos de texto de la columna. LANGUAGE idioma Especifica el idioma que OmniFind Text Search Server for DB2 for i utiliza para el proceso lingüístico de los documentos de texto. El valor predeterminado es en_US (inglés). Si especifica AUTO como valor de este parámetro, OmniFind Text Search Server for DB2 for i intentará determinar el idioma. Importante: Si el idioma de los documentos no es el inglés, no utilice el valor predeterminado en_US. Cambie el valor al idioma de los documentos; de lo contrario, el proceso lingüístico no funcionará según lo esperado. FORMAT formato Identifica el formato de los documentos de texto que se van a indexar, como por ejemplo TEXT o INSO. OmniFind Text Search Server for DB2 for i necesita conocer el formato, o tipo de contenido, de los documentos de texto que tiene previsto indexar y en los que va a realizar búsquedas. Si no especifica el parámetro formato, el valor predeterminado es TEXT. El valor de formato INSO permite a OmniFind Text Search Server for DB2 for i determinar el formato. Si OmniFind Text Search Server for DB2 for i no puede determinar el formato del documento, el procedimiento almacenado UPDATE anota un error de documento en el registro de trabajo durante el proceso. 120 IBM i: OmniFind Text Search Server for DB2 for i características-actualización: NONE < frecuencia-actualización> UPDATE FREQUENCY características-actualización Especifica la frecuencia de las actualizaciones automáticas de la colección de búsqueda de texto. El proceso de actualización de una colección de búsqueda de texto implica tanto la indexación de los datos de texto como el rastreo de los objetos del sistema para detectar datos nuevos o cambiados. UPDATE FREQUENCY frecuencia-actualización Especifica cuándo deben realizarse actualizaciones automáticas en la colección de búsqueda de texto. El valor predeterminado es NONE. frecuencia-actualización (Formato 1): NONE D ( * ) H ( * , ) M ( * , 0..6 0..23 0..6 ) , 0..59 0..23 0..59 NONE Si se especifica NONE, no se realizan más actualizaciones de índice. La actualización debe iniciarse manualmente. D Especifica el día o días de la semana en los que se actualiza el índice. Un asterisco (*) indica todos los días. 0 indica el Domingo. H Especifica la hora u horas en las que se actualiza el índice. Un asterisco (*) indica todas las horas. M Especifica el minuto o minutos en los que se actualiza el índice. No puede especificarse un asterisco (*). La frecuencia de actualización mínima es de 5 minutos. Ejemplo: este ejemplo especifica que la actualización de índice debe ejecutarse cada 30 minutos. UPDATE FREQUENCY D(*) H(*) M(0,30) frecuencia-actualización (Formato 2, cronológico): < minuto> < hora> <díaDelMes> <mesDelAño> <díaDeLaSemana> El formato de la opción frecuencia-actualización (cronológica) es una lista de cinco valores separados por espacios en blanco. Los cinco valores representan los minutos, horas, días del mes, meses del año y días de la semana empezando por el Domingo. Si especifica un intervalo de valores o un asterisco (*), puede especificar un valor de recorrido utilizando una barra inclinada (/) al final del intervalo definido. Ejemplo: este ejemplo especifica que la actualización de índice debe ejecutarse cada cuarto de hora (0,15,30,45) en las horas pares entre las 8 a.m. y las 6:45 p.m. (8-18/2 es equivalente a 8,10,12,14,16,18), de Lunes a Viernes todos los meses del año (* * 1-5). 0,15,30,45 8-18/2 * * 1-5 minuto Especifica los minutos de la hora en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para un intervalo de cada 5 minutos o un OmniFind Text Search Server 121 entero de 0 a 59. No pueden repetirse valores. La frecuencia de actualización mínima es de 5 minutos. Un valor de 1, 4 u 8 no es válido. frecuencia-actualización (minuto): * / 0...59 , 0...59 - 0...59 / 0...59 0...59 hora Especifica las horas del día en las que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada hora o un entero de 0 a 23. No pueden repetirse valores. frecuencia-actualización (hora): * / 0...23 , 0...23 - 0...23 / 0...23 0...23 díaDelMes Especifica los días del mes en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada día o un entero de 1 a 31. No pueden repetirse valores. frecuencia-actualización (díaDelMes): * / 1...31 , 1...31 - 1...31 / 1...31 1...31 mesDelAño Especifica los meses del año en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada mes o un entero de 1 a 12. No pueden repetirse valores. frecuencia-actualización (mesDelAño): * / 1...12 , 1...12 - 1...12 / 1...12 1...12 díaDeLaSemana Especifica los días de la semana en los que debe actualizarse el índice de búsqueda 122 IBM i: OmniFind Text Search Server for DB2 for i de texto. Puede especificar un asterisco (*) para cada día o un entero de 0 a 7. Tanto 0 como 7 son valores válidos para el Domingo. No pueden repetirse valores. frecuencia-actualización (díaDeLaSemana): * / 0...7 , 0...7 - 0...7 / 0...7 0...7 opciones-configuración-índice: , INDEX CONFIGURATION ( opción valor ) opciones-configuración-índice Especifica valores adicionales específicos de índice en forma de pares de opción y valor. Debe especificar los valores tipo serie entre comillas simples. Un comilla simple dentro de un valor tipo serie debe representarse mediante dos comillas simples consecutivas. CJKSEGMENTATION Especifica el método de segmentación que debe utilizarse al indexar documentos para idiomas CJK (chino, japonés, coreano). Los valores soportados son MORPHOLOGICAL y NGRAM. Si no se especifica el valor CJKSEGMENTATION, se utiliza el valor predeterminado. El valor predeterminado se especifica en la columna DEFAULTNAME de la tabla QSYS2.SYSTEXTDEFAULTS. SERVER Especifica el ID o nombre de alias del servidor que debe utilizarse para almacenar el índice de búsqueda de texto. Si se utiliza un ID, el valor es un entero que debe existir en la columna SERVERID del catálogo QSYS2.SYSTEXTSERVERS. Si se utiliza un nombre de alias, el valor es una serie que debe existir en la columna ALIASNAME del catálogo QSYS2.SYSTEXTSERVERS. Si no se especifica SERVER, el valor predeterminado es seleccionar el servidor con menos índices de búsqueda de texto entre los servidores de la tabla QSYS2.SYSTEXTSERVERS en los que el parámetro SERVERSTATUS está establecido en 0 (cero), lo que indica que el servidor está disponible. UPDATEAUTOCOMMIT Especifica la frecuencia con la que se realiza una operación de confirmación al extraer documentos durante una actualización de índice. El valor 0 (cero) indica que una operación de confirmación sólo se realiza al final del proceso. El valor debe ser un entero entre 0 (cero) y 2147483647. El valor predeterminado es 100. Sugerencia de rendimiento: el valor de UPDATEAUTOCOMMIT puede tener un impacto significativo sobre el rendimiento de las actualizaciones de índice. La operación de confirmación que tiene lugar con el intervalo especificado garantiza un punto de comprobación coherente desde el que reiniciar la actualización de índice, si se interrumpe. Sin embargo, la confirmación también suspende temporalmente el proceso de actualización. Aumentar el valor de UPDATEAUTOCOMMIT (o establecerlo en 0) puede mejorar significativamente el rendimiento de la actualización, especialmente de la inicial. El valor que especifique debe buscar el equilibrio entre las necesidades de rendimiento y las de recuperabilidad, en función de la frecuencia de las actualizaciones del índice. OmniFind Text Search Server 123 nombre_dispositivo_asp Este parámetro, si se especifica y no es nulo, determina la agrupación de almacenamiento auxiliar en la que se crea la colección. Este parámetro está opcionalmente disponible para la coincidencia con la prestación CREATE SCHEMA para crear los objetos de DB2 en un dispositivo ASP específico. Si se especifica un valor para este parámetro, debe indicar el nombre de una agrupación de discos del grupo de ASP primario del espacio de nombres actual o una unidad de ASP básica si el espacio de nombres es sólo la ASP del sistema. El tipo de datos de este parámetro es VARCHAR(10). Ejemplos 1. CALL SYSTS_CRTCOL(‘mycollection'); Se crea la colección MYCOLLECTION. 2. CALL SYSTS_CRTCOL(‘”mycollection”', “UPDATE FREQUENCY D(*) H(*) M(0)”) Se crea la colección mycollection (minúsculas sin incluir los delimitadores). La colección de búsqueda de texto tendrá una frecuencia de actualización diaria, al principio de cada hora. 3. CALL SYSTS_CRTCOL(‘ur_collection',‘UPDATE FREQUENCY NONE ‘ || ‘ LANGUAGE zh_CN INDEX CONFIGURATION( ‘ || ‘ CJKSEGMENTATION MORPHOLOGICAL) ‘, ‘23') Se crea la colección UR_COLLECTION. La colección tiene ninguna frecuencia de actualización. El idioma de la colección es chino simplificado, utilizando análisis lingüístico de diccionario (morfológico). El esquema de SQL se crea en la ASP básica #23. Cuando se crea la colección de búsqueda de texto, se crean procedimientos en el esquema de DB2 para administrar la colección. Para crear una colección desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > Omnifind > Crear colección. Añadir un conjunto de objetos de datos de archivo spool El procedimiento almacenado se encuentra en el esquema de DB2 para añadir un conjunto de objetos de datos de archivo spool. Nota: sólo se admiten datos de serie de caracteres SNA (SCS). Los archivos spool que contienen otros tipos de datos no pueden indexarse y provocarán un error a nivel de documento cuando se encuentren. El error se registrará en las anotaciones de trabajo y la indexación continuará con el archivo spool siguiente. Puede utilizarse el procedimiento GET_OBJECTS_NOT_INDEXED para determinar qué archivos de spool no se han incluido en el proceso de indexación. ADD_SPLF_OBJECT_SET Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. Se suministrará con la autorización *EXECUTE otorgada de modo público. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. 124 IBM i: OmniFind Text Search Server for DB2 for i Sintaxis Añadir un conjunto de objetos de archivo spool: ADD_SPLF_OBJECT_SET ( biblioteca_cola_salida nulo nombre_trabajo_cal nulo , usuario_trabajo_cal nulo indicación_fecha_hora_inicial nulo , , , nombre_cola_salida nulo número_trabajo_cal nulo indicación_fecha_hora_final nulo , , nombre_usuario nulo datos_usuario nulo , , ) , id_conjunto_salida Las siguientes versiones simplificadas del procedimiento de adición de conjunto de objetos de archivo spool pueden utilizarse a efectos de comodidad. Seleccionar archivos spool sólo por cola de salida: ADD_SPLF_OBJECT_SET ( biblioteca_cola_salida nulo , nombre_cola_salida nulo ) Seleccionar archivos spool sólo por cola de salida y nombre de usuario: ADD_SPLF_OBJECT_SET ( biblioteca_cola_salida nulo , nombre_cola_salida nulo , nombre_usuario nulo ) El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros biblioteca_cola_salida Nombre del sistema para la biblioteca de la cola de salida. Un valor nulo o una serie vacía indica que se incluirán en el índice las colas de salida de todas las bibliotecas. El tipo de datos de este parámetro es VARCHAR(10) [Consulte los convenios de nombres del sistema] [Consulte las restricciones adicionales] nombre_cola_salida Nombre del sistema para el nombre de cola de salida. Un valor nulo o una serie vacía indica que se incluirá en el índice cualquier cola de salida. El tipo de datos de este parámetro es VARCHAR(10) [Consulte los convenios de nombres del sistema] [Consulte las restricciones adicionales] nombre_usuario Nombre del sistema para el usuario propietario del archivo spool. Un valor nulo o una serie vacía indica que no se realizará ningún filtrado sobre el nombre de usuario. El tipo de datos de este parámetro es VARCHAR(10) OmniFind Text Search Server 125 [Consulte los convenios de nombres del sistema] [Consulte las restricciones adicionales] nombre-trabajo_cal Nombre del sistema para la biblioteca de la cola de salida. Un valor nulo o una serie vacía indica que no se realizará ningún filtrado sobre el nombre de trabajo. El tipo de datos de este parámetro es VARCHAR(10) [Consulte los convenios de nombres del sistema] usuario_trabajo_cal Nombre del sistema para el nombre de perfil de usuario del trabajo asociada con el archivo spool. Un valor nulo o una serie vacía indica que no se realizará ningún filtrado sobre el usuario de trabajo. El tipo de datos de este parámetro es VARCHAR(10) Es obligatorio un valor no nulo y no vacío para este parámetro si se ha especificado NOMBRE_TRABAJO_CALIFICADO. Si NOMBRE_TRABAJO_CALIFICADO es una serie vacía o NULL, este parámetro también debe ser nulo o una serie vacía. [Consulte los convenios de nombres del sistema] [Consulte las restricciones adicionales] número_trabajo_cal Serie de seis caracteres que representa el número de trabajo. (Debe estar formada por los dígitos 0-9) Un valor nulo o una serie vacía indica que no se realizará ningún filtrado sobre el número de trabajo. El tipo de datos de este parámetro es VARCHAR(6) Es obligatorio un valor no nulo y no vacío para este parámetro si se ha especificado NOMBRE_TRABAJO_CALIFICADO. Si NOMBRE_TRABAJO_CALIFICADO es una serie vacía o NULL, este parámetro también debe ser nulo o una serie vacía. [Consulte los convenios de nombres del sistema] [Consulte las restricciones adicionales] datos_usuario Serie de diez caracteres que el usuario asocia con un archivo spool. Esta serie no se convierte a mayúsculas y debe coincidir exactamente con los datos de usuario asociados a un archivo spool para que se considere una coincidencia. Nota: un valor de 'abc' es distinto de 'ABC' Un valor nulo o una serie vacía indicará que no se realizará ningún filtrado sobre los datos de usuario. El tipo de datos de este parámetro es VARCHAR(10) indicación_fecha_hora_inicial Valor de indicación de fecha y hora que indica la hora de creación más antigua que se incluirá en la colección. Los archivos en spool creados antes de esta indicación de fecha y hora no se indexarán. Puede especificarse un valor NULL para indicar que debe indexarse cualquier archivo spool creado antes del valor de indicación de fecha y hora final. Si INDICACIÓN_FECHA_HORA_FINAL también es nulo, no se realizarán ningún filtrado sobre la indicación de fecha y hora de creación. El tipo de datos de este parámetro es TIMESTAMP 126 IBM i: OmniFind Text Search Server for DB2 for i indicación_fecha_hora_final Valor de indicación de fecha y hora que indica la hora de creación más reciente que se incluirá en la colección. Los archivos spool creados después de esta fecha no se indexarán. Puede especificarse un valor NULL para indicar que debe indexarse cualquier archivo spool creado después de la INDICACIÓN_FECHA_HORA_INICIAL. Si INDICACIÓN_FECHA_HORA_INICIAL también es nulo, no se realizarán ningún filtrado sobre la indicación de fecha y hora de creación. El tipo de datos de este parámetro es TIMESTAMP id_conjunto_salida Valor entero de salida que devuelve el ID de conjunto del conjunto de objetos que se ha añadido. Este valor puede utilizarse para eliminar el conjunto de objetos en un momento posterior. Este parámetro es opcional. El tipo de datos de este parámetro es INTEGER Convenios de denominación del sistema Los parámetros que requieren nombres del sistema como entrada deben ser nombres del sistema válidos; de lo contrario, se producirá un error. Estos parámetros se procesarán de la misma manera que el analizador de mandatos procesa los nombres en los mandatos CL. Consulte las Reglas de denominación de objetos para obtener más información acerca de los nombres del sistema. call nick12345.add_splf_object_set('ntl', 'justtext', 'ntl', '', '', '', '', NULL, NULL); La información de filtro que se pasa al procedimiento será una cola de salida NTL/JUSTTEXT para el usuario NTL (convertido a mayúsculas) A diferencia de los nombres de SQL, en un nombre del sistema los delimitadores permanecerán en el nombre, pero sólo si es necesario. call nick12345.add_splf_object_set('"ntl"', '"justtext"', '"NTL"', '', '', '', '', NULL, NULL); La información de filtro pasada a la API será la cola de salida "ntl"/"justtext" para el usuario NTL (sin comillas alrededor del usuario NTL) Nota: El procedimiento almacenado tiene un límite de diez caracteres en la interfaz y no admite comillas dobles innecesarias que hacen que se supere este límite. Los nombres del sistema no válidos provocarán un error. Restricciones adicionales v Los nombres genéricos no están soportados. En otras palabras, no es posible indexar todas las colas de salida que empiezan por MYOUT añadiendo un conjunto de objetos para MYOUT* v El nombre de la biblioteca de la cola de salida y el nombre de la cola de salida deben ser ambos nulos (o una serie vacía) tener ambos nombres del sistema válidos. No es posible filtrar todas las colas de salida de la biblioteca xyz o filtrar todas las colas de salida denominadas 'abc' de cualquier biblioteca. v Si se especifican un nombre de cola de salida y una biblioteca específicos, dicha cola de salida debe existir en el momento de añadir el conjunto de objetos. No existe ninguna lógica para impedir la supresión de la cola de salida en algún momento posterior, pero el conjunto de objetos pasará a estar efectivamente 'vacío'. v Si tanto NOMBRE_USUARIO como USUARIO_TRABAJO_CALIFICADO son valores no nulos y no vacíos, deben ser iguales. Un propietario de archivo spool siempre coincidirá con el usuario de trabajo calificado, y, por lo tanto, estos valores nunca pueden ser diferentes cuando ambos se utilizan como filtro. OmniFind Text Search Server 127 Autorizaciones para objetos indexados Al añadir un conjunto de objetos de archivo spool, considere cuidadosamente los requisitos de autorización para recuperar el texto de los archivos spool. Estas autorizaciones serán un factor a tener en cuenta cuando se invoque el procedimiento almacenado UPDATE. Consulte la documentación del procedimiento almacenado de actualización para obtener más información sobre los requisitos de autorización para objetos indexados. Ejemplos Añadir un conjunto de objetos a la colección nick789 para todos los archivos spool de la cola de salida NTL/MYOUTQ. > call nick789.add_splf_object_set(’NTL’, ’MYOUTQ’); Añadir un conjunto de objetos a la colección nick123 para indexar todos los archivos spool propiedad del usuario NTL. > call nick123.add_splf_object_set(’’, ’’, ’NTL’); Añadir un conjunto de objetos a la colección default_search_col para indexar todos los archivos spool creados en 2010. > call default_search_col.add_splf_object_set(’’, ’’, ’’, ’’, ’’, ’’, ’’, ’2010-01-01T00:00:00’, ’2011-01-01T00:00:00’); Añadir un conjunto de objetos a la colección default_search_col para indexar todos los archivos spool creados en 2010 con los datos de usuario 'MYAPP': > call default_search_col.add_splf_object_set(’’, ’’, ’’, ’’, ’’, ’’, ’MYAPP’, ’2010-01-01T00:00:00’, ’2011-01-01T00:00:00’); Para añadir un conjunto de objetos de archivo spool a una colección desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > OmniFind > Lista de colecciones. 3. Pulse la colección con el botón derecho del ratón y seleccione Propiedades. En la pestaña Objeto, pulse el botón Añadir colas de salida o Añadir archivos en spool. Eliminar un conjunto de objetos de datos de archivo spool Este procedimiento almacenado eliminará un conjunto de objetos de datos de archivo en spool de una colección de búsqueda de texto. RMV_SPLF_OBJECT_SET Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis Eliminar un conjunto de objetos de archivo spool: 128 >--+-nombre_cola_salida-+--,--+-nombre_usuario-+--,-------------------> '-null -------------' '-null -----' IBM i: OmniFind Text Search Server for DB2 for i >--+-nombre_trabajo_cal-+--,--+-usuario_trabajo_cal-+--,-------------------> '-null ---------' '-null ---------' >--+-número_trabajo_cal-+--,--+-datos_usuario-+--,---------------------> '-null -----------' '-null -----' >--+-indicación_fecha_hora_inicial-+--,--+-indicación_fecha_hora_final-+-----------------> '-null -----------' '-null ------------' Las siguientes versiones simplificadas del procedimiento de eliminación de conjunto de objetos de archivo spool pueden utilizarse a efectos de comodidad. Seleccionar archivos spool sólo por cola de salida: >>-RMV_SPLF_OBJECT_SET--(--+-biblioteca_cola_salida-+--,--------------> '-null ------------' >--+-nombre_cola_salida-+--)------------------------------------>< '-null -------------' Seleccionar archivos spool sólo por cola de salida y nombre de usuario: >>-RMV_SPLF_OBJECT_SET--(--+-biblioteca_cola_salida-+--,--------------> '-null ------------' >--+-nombre_cola_salida-+--,--+-nombre_usuario-+--)------------------>< '-null -------------' '-null -----' El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros biblioteca_cola_salida Nombre del sistema para la biblioteca de la cola de salida. El tipo de datos de este parámetro es VARCHAR(10). nombre_cola_salida Nombre del sistema para el nombre de cola de salida. El tipo de datos de este parámetro es VARCHAR(10). nombre_usuario Nombre del sistema para el usuario propietario del archivo spool. El tipo de datos de este parámetro es VARCHAR(10). nombre_trabajo_cal Nombre del sistema para la biblioteca de la cola de salida. El tipo de datos de este parámetro es VARCHAR(10). usuario_trabajo_cal Nombre del sistema para el nombre de perfil de usuario del trabajo asociada con el archivo spool. El tipo de datos de este parámetro es VARCHAR(10). Es obligatorio un valor no nulo y no vacío para este parámetro si se ha especificado NOMBRE_TRABAJO_CALIFICADO. OmniFind Text Search Server 129 Si NOMBRE_TRABAJO_CALIFICADO es una serie vacía o NULL, este parámetro también debe ser nulo o una serie vacía. número_trabajo_cal Serie de seis caracteres que representa el número de trabajo. (Debe estar formada por los dígitos 0-9) El tipo de datos de este parámetro es VARCHAR(6) Es obligatorio un valor no nulo y no vacío para este parámetro si se ha especificado NOMBRE_TRABAJO_CALIFICADO. Si NOMBRE_TRABAJO_CALIFICADO es una serie vacía o NULL, este parámetro también debe ser nulo o una serie vacía. datos_usuario Serie de diez caracteres que el usuario asocia con un archivo spool. Esta serie no se convierte a mayúsculas y debe coincidir exactamente con los datos de usuario asociados a un archivo spool para que se considere una coincidencia. Nota: un valor de 'abc' es distinto de 'ABC' El tipo de datos de este parámetro es VARCHAR(10). indicación_fecha_hora_inicial Valor de indicación de fecha y hora que indica la hora de creación más antigua de los archivos spool añadidos al conjunto de objetos. El tipo de datos de este parámetro es TIMESTAMP indicación_fecha_hora_final Valor de indicación de fecha y hora que indica la hora de creación más reciente de los archivos spool añadidos al conjunto de objetos. El tipo de datos de este parámetro es TIMESTAMP Nota: Para obtener más detalles sobre el significado y las restricciones de los parámetros anteriores, consulte la descripción del procedimiento almacenado add_splf_object_set. Nota sobre el resultado En los casos siguientes, la eliminación fallará debido a un conjunto de objetos no encontrado: >El usuario especifica parámetros incorrectos >Especifica parámetros correspondientes a un conjunto de objetos que se ha suprimido. El usuario recibirá un mensaje de error que mostrará que no existe un conjunto de objetos con el atributo específico. QUERY_OBJECT_SET() devuelve la lista de conjuntos de objetos y los parámetros de entrada. El usuario puede especificar los parámetros de entrada correctos al invocar este procedimiento almacenado para eliminar el conjunto de objetos. Ejemplos Eliminar un conjunto de objetos de la colección nick789 para todos los archivos spool de la cola de salida NTL/MYOUTQ. > call nick789.rmv_splf_object_set(’NTL’, ’MYOUTQ’); Eliminar un conjunto de objetos de la colección nick123 para todos los archivos spool propiedad del usuario NTL. > call nick123.rmv_splf_object_set(’’, ’’, ’NTL’); 130 IBM i: OmniFind Text Search Server for DB2 for i Eliminar un conjunto de objetos de la colección test_col para todos los archivos spool creados en 2010. > call test_col.rmv_splf_object_set(’’, ’’, ’’, ’’, ’’, ’’, ’’, ’2010-01-01T00:00:00’, ’2011-01-01T00:00:00’); Añadir un conjunto de objetos a la colección default_search_col para indexar todos los archivos spool creados en 2010 con los datos de usuario 'MYAPP': > call default_search_col.add_splf_object_set(’’, ’’, ’’, ’’, ’’, ’’, ’MYAPP’, ’2010-01-01T00:00:00’, ’2011-01-01T00:00:00’); Añadir un conjunto de objetos de datos de archivo continuo El procedimiento almacenado se encuentra en el esquema de DB2 para añadir un conjunto de objetos de datos de archivo continuo. ADD_IFS_STMF_OBJECT_SET Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis Este procedimiento permite a un usuario añadir un conjunto de objetos de archivos continuos (STMF) al sistema de archivos integrado (IFS). Añadir un conjunto de objetos para datos de archivo continuo (archivos continuos en IFS): ADD_IFS_STMF_OBJECT_SET ( serie-expresión_stmf ) , id_conjunto_salida El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros serie-expresión_stmf Este parámetro contiene una vía de acceso absoluta a un directorio que contiene los archivos que se indexarán. Debe ser un directorio válido (de tipo *DIR) de un sistema de archivos que sea accesible. se indexarán los objetos de archivo continuo (tipo *STMF) de este directorio. El nombre de vía de acceso debe ser absoluto y no debe contener expresiones regulares. El tipo de datos de este parámetro es VARCHAR(32000) Se indexan los archivos continuos del directorio especificado. v NO se siguen enlaces simbólicos v NO se procesan subdirectorios v Los nombres de vía de acceso no debe estar delimitados; los caracteres tales como '*' ', ?", etc. no tienen ningún significado especial y no deben especificarse con escapes. v Los nombres de vía de acceso pueden o no ser sensibles a las mayúsculas y minúsculas, dependiendo del atributo del sistema de archivos. Se realizará una comprobación al añadir el conjunto de objetos para verificar que no exista ya un conjunto duplicado en la colección de búsqueda de texto. Esta comprobación no considera las vías de acceso equivalentes como duplicadas. OmniFind Text Search Server 131 En otras palabras, las siguientes vías de acceso podrían representar el mismo directorio, pero se considerarán conjuntos de objetos exclusivos; es más, los objetos de esos conjuntos se indexarán varias veces como objetos exclusivos. /dir1/DIR2 /dir1//DIR2// /DIR1/DIR2/ (si el sistema de archivos es sensible a las mayúsculas y minúsculas) /dir1/DIR2/../DIR2 etc. id_conjunto_salida Valor entero de salida que devuelve el ID de conjunto del conjunto de objetos que se ha añadido. Este valor puede utilizarse para eliminar el conjunto de objetos en un momento posterior. Este parámetro es opcional. El tipo de datos de este parámetro es INTEGER. Consideraciones especiales para el proceso de actualización Sistemas de archivos inexistentes: Si un directorio no se puede localizar durante una operación de actualización, los archivos asociados a ese directorio no se eliminarán del índice. Esto evita la reindexación innecesaria de documentos cuando un sistema de archivos se desmonta y luego vuelve a montarse. Si estos archivos deben eliminarse del índice, existen varias opciones: v Emita el procedimiento almacenado de eliminación de conjunto de objetos en el conjunto de objetos de archivo continuo IFS. Esta acción eliminará todos los documentos asociados con el conjunto de objetos. v Emita el procedimiento almacenado REPRIME en la colección. Todos los datos se eliminarán del índice y sólo se reindexarán los archivos que puedan localizarse. v Cree el directorio como un directorio vacío y emita la actualización Conversión de CCSID Si el formato (FORMAT) de la colección es TEXT: v El atributo CCSID del archivo se utiliza para convertir los datos extraídos del archivo a UTF-8 para la indexación. El atributo CCSID del archivo debe ser correcto para que el archivo pueda indexarse correctamente. Si el formato (FORMAT) de la colección es INSO: v Los datos del archivo se extraerán del archivo y se enviarán al servidor de búsqueda de texto para el proceso. No se realizará ninguna conversión de juego de caracteres y el atributo CCSID del archivo se ignorará. El servidor de búsqueda de texto utilizará su proceso de texto enriquecido para determinar el formato y la codificación del documento. Puede utilizarse para indexar archivos de texto enriquecido (como PDF) o archivos de texto normales. En el caso de algunos documentos de texto sin formato, puede que el servidor de búsqueda de texto no pueda determinar la codificación del documento con la confianza suficiente para indexar los datos. Esto es más probable para documentos muy pequeños, pero también puede producirse en documentos grandes que utilice una amplia gama de caracteres. Si el formato y la codificación del archivo no pueden determinarse, el archivo no se indexará y se registrará un error de documento. Autorizaciones para objetos indexados Al añadir un conjunto de objetos de archivo continuo IFS, considere cuidadosamente los requisitos de autorización para leer los archivos continuos. Las autorizaciones adoptadas no se aceptan al acceder a los datos del archivo continuo. Además, se ejecutan actualizaciones planificadas bajo el perfil de usuario 132 IBM i: OmniFind Text Search Server for DB2 for i propietario del índice. Consulte la documentación del procedimiento almacenado de actualización para obtener más información sobre los requisitos de autorización para objetos indexados. ADD_IFS_STMF_OBJECT_SET_WITH_SUBDIR La sintaxis y los requisitos de autorización de este procedimiento almacenado son similares a los de ADD_IFS_STMF_OBJECT_SET. Con este procedimiento almacenado, el usuario puede añadir un directorio como un conjunto de objetos a la colección. Todos los archivos y subdirectorios bajo este directorio se indexarán recursivamente. Ejemplo Añadir un conjunto de objetos a MYCOLLECTION para indexar todos los archivos continuos del directorio IFS '/home/ntl/stmf': > CALL MYCOLLECTION.ADD_IFS_STMF_OBJECT_SET(’/home/ntl/stmf’); Añadir un conjunto de objetos a MYCOLLECTION para indexar todos los archivos continuos y subdirectorios del directorio IFS '/home/ntl/stmf': > CALL MYCOLLECTION.ADD_IFS_STMF_OBJECT_SET_WITH_SUBDIR(’/home/ntl/stmf’); Para añadir una vía de acceso de IFS a una colección desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > OmniFind > Lista de colecciones. 3. Pulse la colección con el botón derecho del ratón y seleccione Propiedades. En la pestaña Objeto, pulse el botón Añadir vía de acceso de IFS. Seleccione Incluir subdirectorios para añadir todos los subdirectorios bajo la vía de acceso de IFS especificada. Eliminar un conjunto de objetos de datos de archivo continuo El procedimiento almacenado se encuentra en el esquema de DB2® para eliminar un conjunto de objetos de datos de archivo continuo. RMV_IFS_STMF_OBJECT_SET Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis Este procedimiento permite a un usuario eliminar un conjunto de objetos de archivos continuos (STMF) del sistema de archivos integrado (IFS). Eliminar un conjunto de objetos para datos de archivo continuo (archivos continuos en IFS): >>-RMV_IFS_STMF_OBJECT_SET -(--serie_expresión_stmf----------->< El calificador de esquema es el nombre de la colección de búsqueda de texto. OmniFind Text Search Server 133 Parámetros serie-expresión_stmf Este parámetro es una vía de acceso absoluta a un directorio que es el atributo del conjunto de objetos. No es necesario que sea un directorio válido de un sistema de archivos que sea accesible, ya que el usuario podría suprimir la vía de acceso, pero el conjunto de objetos seguiría existiendo. El nombre de vía de acceso debe ser absoluto y no debe contener expresiones regulares. El tipo de datos de este parámetro es VARCHAR(32000) Nota: Nota para el nombre de vía de acceso de directorio especificada: v Los nombres de vía de acceso no debe estar delimitados; los caracteres tales como '*' ', ?", etc. no tienen ningún significado especial y no deben especificarse con escapes. v Los nombres de vía de acceso pueden o no ser sensibles a las mayúsculas y minúsculas, dependiendo del atributo del sistema de archivos. Dado que ADD_IFS_STMF_OBJECT_SET no considera las vías de acceso equivalentes como un conjunto de objetos duplicado, el usuario debe indicar exactamente la misma vía de acceso que ADD_IFS_STMF_OBJECT_SET añadido al intentar eliminar el conjunto de objetos específico. En otras palabras, las siguientes vías de acceso podrían representar el mismo directorio, pero se considerarán conjuntos de objetos diferentes. /dir1/DIR2 /dir1//DIR2// /DIR1/DIR2/ (si el sistema de archivos es sensible a las mayúsculas y minúsculas) /dir1/DIR2/../DIR2 etc. RMV_IFS_STMF_OBJECT_SET_WITH_SUBDIR Este procedimiento almacenado puede eliminar un conjunto de objetos que incluya archivos IFS de subdirectorio. Este conjunto de objetos puede añadirse mediante el procedimiento ADD_IFS_STMF_OBJECT_SET_WITH_SUBDIR. La sintaxis, requisitos de autorización y parámetros de este procedimiento almacenado son similares a los de RMV_IFS_STMF_OBJECT_SET. Si el usuario añade una vía de acceso IFS a un conjunto de objetos con subdirectorio y a un conjunto de objetos sin subdirectorios, el uso de este procedimiento sólo eliminará el conjunto de objetos con subdirectorio. Nota sobre el resultado En los casos siguientes, la eliminación fallará debido a un conjunto de objetos no encontrado: >El usuario especifica una vía de acceso IFS incorrecta >Especifica una vía de acceso IFS correspondiente a un conjunto de objetos que se ha suprimido. El usuario recibirá un mensaje de error que mostrará que no existe un conjunto de objetos con el atributo específico. QUERY_OBJECT_SET() devuelve la lista de conjuntos de objetos y los parámetros de entrada. El usuario puede especificar los parámetros de entrada correctos al invocar este procedimiento almacenado para eliminar el conjunto de objetos. 134 IBM i: OmniFind Text Search Server for DB2 for i Ejemplos Eliminar un conjunto de objetos de MYCOLLECTION, cuyo directorio de IFS es '/home/ntl/stmf': > CALL MYCOLLECTION.RMV_IFS_STMF_OBJECT_SET(’/home/ntl/stmf’); Eliminar un conjunto de objetos de MYCOLLECTION que incluye todos los archivos continuos y subdirectorios del directorio de IFS '/home/ntl/stmf': > CALL MYCOLLECTION.RMV_IFS_STMF_OBJECT_SET_WITH_SUBDIR(’/home/ntl/stmf’); Añadir un conjunto de objetos de archivo físico de origen multimiembro El procedimiento almacenado se encuentra en el esquema de DB2® para añadir un conjunto de objetos de archivo físico de origen multimiembro. ADD_SRCPF_OBJECT_SET Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis Este procedimiento permite a un usuario añadir un conjunto de objetos de archivo físico de origen multimiembro (MMPF). Añadir un conjunto de objetos de archivo físico de origen multimiembro: >>-ADD_SRCPF_OBJECT-SET -(---SRCPF_LIB-----------> >-------- SRCPF_NAME ------)------------------------------------->< >--+------------------+--)------------------------------------->< ’-,-- OUT_SETID -’ El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetro SRCPF_LIB Este parámetro indica una biblioteca absoluta que contiene los archivos físicos de origen que se indexarán. Debe ser un nombre de biblioteca válido en el sistema. Se indexarán los objetos de archivo físico de origen multimiembro de esta biblioteca. El nombre de biblioteca debe ser absoluto y no debe contener expresiones regulares. El tipo de datos de este parámetro es VARCHAR(10) SRCPF_NAME Este parámetro indica un archivo físico de origen absoluto que puede tener uno o más miembros; se indexarán todos los miembros del archivo físico de origen. El nombre de archivo debe ser absoluto y no debe contener expresiones regulares. OmniFind Text Search Server 135 Nota: si el archivo físico de origen se suprime después de añadir el conjunto de objetos a la colección de búsqueda de texto, la llamada posterior al procedimiento almacenado UPDATE lo detectará, y el resultado de la búsqueda no contendrá los miembros de ese archivo físico de origen. *ALLSRCPF Si se especifica *ALLSRCPF como nombre del archivo físico de origen, indicará que los archivos físicos de origen de SRCPF_LIB se indexarán al actualizar el índice. Nota: Si el usuario especifica *ALLSRCPF como nombre de archivo físico de origen al añadir un conjunto de objetos, también se permite añadir otro PF específico bajo la misma biblioteca que un conjunto de objetos. Esto NO conducirá a un error de duplicación. El tipo de datos de este parámetro es VARCHAR(10). OUT_SETID Valor entero de salida que devuelve el ID de conjunto del conjunto de objetos que se ha añadido. Este valor puede utilizarse para eliminar el conjunto de objetos en un momento posterior. Este parámetro es opcional. El tipo de datos de este parámetro es INTEGER. Restricciones adicionales v Se realizará una comprobación al añadir el conjunto de objetos para verificar que no exista ya un conjunto duplicado en la colección de búsqueda de texto. v Al añadir un conjunto de objetos de archivo físico de origen a una colección de búsqueda de texto, OmniFind verifica que el archivo físico de origen existe. Si el archivo físico de origen no existe, se devuelve un mensaje de error y el conjunto de objetos no se añade. v Si el archivo especificado no es un archivo físico de origen, la llamada al procedimiento falla con un error. Autorizaciones para objetos indexados Al añadir un conjunto de objetos de archivo físico de origen de varios miembros, considere cuidadosamente los requisitos de autorización para leer los archivos. Las autorizaciones adoptadas no se aceptan al acceder a los datos del archivo físico de origen. Además, se ejecutan actualizaciones planificadas bajo el perfil de usuario propietario del índice. Consulte la documentación del procedimiento almacenado de actualización para obtener más información sobre los requisitos de autorización para objetos indexados. Ejemplos Añadir un conjunto de objetos a MYCOLLECTION para indexar el archivo físico de origen multimiembro QCSRC de la biblioteca ISVSQLLP: > CALL MYCOLLECTION.ADD_SRCPF_OBJECT_SET(’ISVSQLLP’,’QCSRC’); Añadir un conjunto de objetos a MYCOLLECTION para indexar el archivo físico de origen multimiembro QCSRC de la biblioteca ISVSQLLP, y esperar la obtención del ID de conjunto (setid). > create variable setid int default 0; > CALL MYCOLLECTION.ADD_SRCPF_OBJECT_SET(’ISVSQLLP’,’QCSRC’,setid); Añadir un conjunto de objetos a MYCOLLECTION para indexar todos los archivos físicos de origen multimiembro de la biblioteca ISVSQLLP: > CALL MYCOLLECTION.ADD_SRCPF_OBJECT_SET(’ISVSQLLP’,’*ALLSRCPF’); Para añadir un conjunto de objetos de archivo físico de origen a una colección desde IBM® Navigator for i, siga estos pasos. 136 IBM i: OmniFind Text Search Server for DB2 for i 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas >OmniFind > Lista de colecciones. 2. Pulse la colección con el botón derecho del ratón y seleccione Propiedades. En la pestaña Objeto, pulse el menú desplegable, seleccione Añadir archivo físico de origen y, a continuación, pulse Añadir. Eliminar un conjunto de objetos de archivo físico de origen multimiembro El procedimiento almacenado se encuentra en el esquema de DB2® para eliminar un conjunto de objetos de archivo físico de origen multimiembro. RMV_SRCPF_OBJECT_SET Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis Este procedimiento permite a un usuario eliminar un conjunto de objetos de archivo físico de origen multimiembro (MMPF). Eliminar un conjunto de objetos de archivo físico de origen multimiembro: >>-RMV_SRCPF_OBJECT-SET -(---SRCPF_LIB-----------> >-------- SRCPF_NAME ------)------------------------------------->< El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetro SRCPF_LIB Este parámetro indica una biblioteca absoluta que contiene los archivos físicos de origen. El nombre de biblioteca debe ser absoluto y no debe contener expresiones regulares. El tipo de datos de este parámetro es VARCHAR(10). SRCPF_NAME Este parámetro indica un archivo físico de origen absoluto que puede tener uno o más miembros; se indexarán todos los miembros del archivo físico de origen. El nombre de archivo debe ser absoluto y no debe contener expresiones regulares. *ALLSRCPF Si se especifica *ALLSRCPF como nombre del archivo físico de origen, indica que se eliminará el conjunto de objetos de todos los archivos físicos de origen de SRCPF_LIB. El tipo de datos de este parámetro es VARCHAR(10). Nota sobre el resultado En los casos siguientes, la eliminación fallará debido a un conjunto de objetos no encontrado: >El usuario especifica un valor incorrecto de SRCPF_LIB o SRCPF_NAME >Especifica un conjunto de objetos SRCPF_LIB/SRCPF_NAME correspondiente que se ha eliminado anteriormente. OmniFind Text Search Server 137 El usuario recibirá un mensaje de error que mostrará que no existe un conjunto de objetos con el atributo específico. QUERY_OBJECT_SET() devuelve la lista de conjuntos de objetos y los parámetros de entrada. El usuario puede especificar los parámetros de entrada correctos al invocar este procedimiento almacenado para eliminar el conjunto de objetos. Ejemplos Eliminar un conjunto de objetos de MYCOLLECTION para el archivo físico de origen multimiembro QCSRC de la biblioteca ISVSQLLP: > CALL MYCOLLECTION.RMV_SRCPF_OBJECT_SET(’ISVSQLLP’,’QCSRC’); Eliminar un conjunto de objetos de MYCOLLECTION para todos los archivos físicos de origen multimiembro de la biblioteca ISVSQLLP: > CALL MYCOLLECTION.RMV_SRCPF_OBJECT_SET(’ISVSQLLP’,’*ALLSRCPF’); Eliminar un conjunto de objetos Este procedimiento almacenado eliminará un conjunto de objetos de una colección de búsqueda de texto. REMOVE_OBJECT_SET Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis REMOVE_OBJECT_SET ( setid ) El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros setid El ID de conjunto que se ha obtenido al añadir el conjunto de objetos. El ID de conjunto de objetos también puede obtenerse utilizando el procedimiento almacenado QUERY_OBJECT_SET después de añadir el conjunto de objetos. El tipo de datos de este parámetro es INTEGER. Ejemplos Eliminar el conjunto de objetos #1 de la colección MYCOLLECTION. > CALL MYCOLLECTION.remove_object_set(1) Para eliminar un conjunto de objetos de una colección desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > OmniFind > Lista de colecciones. 138 IBM i: OmniFind Text Search Server for DB2 for i 3. Pulse la colección con el botón derecho del ratón y seleccione Propiedades. En la pestaña Objeto, pulse el botón Eliminar. Actualizar la colección Este procedimiento almacenado actualiza la colección. Cuando se llama inicialmente, se indexan todos los objetos incluidos en los conjuntos de objetos de la colección. Cuando se llama a este procedimiento almacenado después de completar una actualización inicial satisfactoria, todos los objetos cambiados se actualizan en el índice. El procedimiento no devuelve el control al interlocutor hasta que ha finalizado la actualización. UPDATE Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis UPDATE El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros Ninguno Requisitos de autorización sobre objetos indexados Las actualizaciones planificadas se ejecutan bajo el perfil propietario de la colección de búsqueda de texto. Las llamadas a los procedimientos almacenados UPDATE se ejecutan bajo el perfil que invoca el procedimiento. Es recomendable que tanto el propietario del índice como el perfil que administra el índice tengan autorización para leer los datos de texto de todos los objetos indexados en la colección. Si no se tiene la autorización suficiente, pueden producirse resultados imprevisibles. La autorización adoptada no se respetará necesariamente para rastrear objetos y extraer texto de esos objetos. Los problemas de autorización durante el proceso de actualización pueden provocar que la actualización falle, o que no se indexen documentos individuales. Ejemplos CALL MYCOLLECTION.UPDATE; Para actualizar el índice de colección desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > OmniFind > Lista de colecciones. OmniFind Text Search Server 139 3. Pulse la colección con el botón derecho del ratón y seleccione Actualizar. Volver a llenar la colección de búsqueda de texto El procedimiento almacenado REPRIME borra la colección y, a continuación, realiza una actualización inicial. El procedimiento no devuelve el control al interlocutor hasta que ha finalizado la actualización. REPRIME Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis REPRIME El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros Ninguno Consideraciones sobre la autorización de Reprime para objetos indexados Las actualizaciones planificadas se ejecutan bajo el perfil propietario de la colección de búsqueda de texto. Las llamadas a los procedimientos almacenados REPRIME se ejecutan bajo el perfil que invoca el procedimiento. Es recomendable que tanto el propietario del índice como el perfil que administra el índice tengan autorización para leer los datos de texto de todos los objetos indexados en la colección. Si no se tiene la autorización suficiente, pueden producirse resultados imprevisibles. La autorización adoptada no se respetará necesariamente para rastrear objetos y extraer texto de esos objetos. Los problemas de autorización durante el proceso de actualización pueden provocar que la actualización falle, o que no se indexen documentos individuales. Ejemplos CALL MYCOLLECTION.REPRIME; Para volver a llenar la colección de búsqueda de texto desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > OmniFind > Lista de colecciones. 3. Pulse la colección con el botón derecho del ratón y seleccione Volver a preparar. 140 IBM i: OmniFind Text Search Server for DB2 for i Buscar en la colección Este procedimiento permite a un usuario buscar en una colección de búsqueda de texto los objetos que coinciden con una búsqueda. SEARCH Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis SEARCH ( serie_búsqueda ) , opciones_búsqueda , número_de_resultados El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros serie_búsqueda Un parámetro de serie que contiene la expresión de búsqueda. Nota: esta expresión no puede estar formada sólo por espacios en blanco ni ser una serie vacía. Consulte la sintaxis de argumentos de búsqueda del manual de consulta de OmniFind para obtener detalles. El tipo de datos de este parámetro es VARCHAR(32700). opciones_búsqueda Identifica una constante de tipo serie que especifica las opciones de argumento de búsqueda en vigor para la función. El tipo de datos de este parámetro es VARCHAR(32700). opciones_búsqueda: , QUERYLANGUAGE = valor , RESULTLIMIT = valor , SYNONYM = OFF ON QUERYLANGUAGE Especifica el idioma de la consulta. El valor puede ser cualquiera de los códigos de idioma soportados. Si no se especifica la opción QUERYLANGUAGE, el valor predeterminado es el valor de idioma del índice de búsqueda de texto utilizado cuando se invoca la función. Si el valor de idioma del índice de búsqueda de texto es AUTO, el valor predeterminado para QUERYLANGUAGE es en_US. RESULTLIMIT Proporciona una pista al optimizador de DB2 con respecto al número de filas del conjunto de resultados que se espera utilizar. El optimizador puede elegir un plan diferente para devolver menos filas desde el procedimiento SEARCH. El optimizador también puede ignorar esta opción si no se va a obtener una ventaja de rendimiento durante la búsqueda. OmniFind Text Search Server 141 SYNONYM Especifica si debe utilizarse un diccionario de sinónimos asociado con el índice de búsqueda de texto. Puede añadir un diccionario de sinónimos a una colección mediante la herramienta de sinónimos. OFF es el valor predeterminado. número_de_resultados Valor entero de salida que devuelve el número de documentos del resultado de la búsqueda. El tipo de datos de este parámetro es VARCHAR(32700). CONJUNTO DE RESULTADOS DEVUELTO El procedimiento de búsqueda devuelve un conjunto de resultados con coincidencias para la expresión de búsqueda. El conjunto de resultados contiene las columnas siguientes: OBJTYPE OBJATTR CONTAINING_OBJECT_LIB CONTAINING_OBJECT_NAME OBJECTINFOR MODIFY_TIME SCORE CHAR(10) CCSID CHAR(10) CCSID CHAR(10) CCSID CHAR(10) CCSID XML TIMESTAMP DOUBLE 1208 1208 1208 1208 OBJTYPE - El tipo de objeto del sistema para este resultado (*STMF, *OUTQ, etc). OBJATR - El atributo del objeto del sistema que ha coincidido con la expresión de búsqueda (*SPLF, *DATA, etc.). CONTAINING_OBJECT_LIB - La biblioteca del objeto del sistema coincidente. CONTAINING_OBJECT_NAME - El nombre del objeto del sistema coincidente. OBJECTINFOR - Un valor XML que describe la información de ubicación de los datos indexados coincidentes con la expresión serie_búsqueda. A continuación se muestra un ejemplo de ubicación de archivo spool: <Spool_File xmlns=”http://www.ibm.com/xmlns/prod/db2textsearch/obj1”> <job_name>QPADEV000Cjob_name>QPADEV000C> <job_user_name>USERAjob_user_name>USERA> <spool_file_name>DSXSVRALSspool_file_name>DSXSVRALS> <spool_file_number>1spool_file_number>1> <job_system_name>ZD21BP1job_system_name>ZD21BP1> <create_date>1081027create_date>1081027> <create_time>035554create_time>035554> </Spool_File> A continuación se muestra un ejemplo de ubicación de archivo continuo IFS: <Stream_File xmlns=”http://www.ibm.com/xmlns/prod/db2textsearch/obj1”> <file_path>/home/usera/a.txt</file_path> </Spool_File> A continuación se muestra un ejemplo de ubicación de miembro de archivo físico: <Source_Physical_File_Member xmlns=”http://www.ibm.com/xmlns/prod/db2textsearch/obj1> <file_library>MYLIB</file_library> <file_name>MYPF</file_name> <member_name>member1</member_name> </Source_Physical_File_Member> DB2 proporciona una serie de métodos para convertir un valor XML a otros formatos para que las aplicaciones puedan acceder a los datos. Una posibilidad es crear una hoja de estilo XSL y utilizar la 142 IBM i: OmniFind Text Search Server for DB2 for i función XSLTRANSFORM. Otra posibilidad es crear un esquema anotado para los valores XML y utilizar el procedimiento XDBDECOMPXML para llenar las tablas relacionales con los valores. El manual de consulta de SQL de Information Center contiene detalles sobre ambas funciones. MODIFY_TIME - Indicación de fecha y hora que indica la hora de la última modificación del objeto que está en la colección. Esta indicación de fecha y hora nunca será más reciente que el proceso de la última actualización. SCORE - El resultado es mayor que 0 pero menor que 1 si los datos de texto indexados contienen una coincidencia con los criterios de búsqueda especificados por el argumento de búsqueda. Cuanto mayor sea la frecuencia con la que se encuentre una coincidencia, mayor será el valor del resultado. Si la columna no contiene una coincidencia, el resultado es 0. El conjunto de resultados se ordena por puntuación descendente. Ejemplos 1. call MYCOLLECTION.search('big bad wolf'); 2. call MYCOLLECTION.search('big bad wolf', 'QUERYLANGUAGE=en_US'); Para buscar en la colección desde IBM Navigator for i, siga estos pasos. 1. Desde IBM Navigator for i, expanda Gestión de IBM i > Sistema > Buscar. 2. Seleccione Buscar. Consultar información de conjunto de objetos Este procedimiento permite a un usuario ver la lista de conjuntos de objetos que están contenidos dentro de la colección. QUERY_OBJECT_SET Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis QUERY_OBJECT_SET El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros Ninguno CONJUNTO DE RESULTADOS DEVUELTO El procedimiento devuelve un conjunto de resultados que contiene una fila para cada conjunto de objetos: SETID SETSTATE LASTREFRESHTIME ADDOBJSETSQL INTEGER CHAR(10) CCSID 1208 TIMESTAMP VARCHAR(2000) CCSID 1208 OmniFind Text Search Server 143 SETID - Identificador exclusivo asignado a cada conjunto de objetos. Este identificador puede utilizarse en el procedimiento almacenado remove_object_set para eliminar el conjunto de objetos de la colección. SETSTATE - Estado del conjunto de objetos. Está reservado para una ampliación futura y siempre es 'ACTIVE'. LASTREFRESHTIME - La última vez que el conjunto de objetos se ha renovado para reflejar los objetos que se encuentran realmente en el sistema. ADDOBJSETSQL - Llamada al procedimiento almacenado SQL que se ha utilizado para añadir este conjunto de objetos. Ejemplos Call MYCOLLECTION.QUERY_OBJECT_SET; Para consultar la información de conjunto de objetos de una colección desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > OmniFind > Lista de colecciones. 3. Pulse la colección con el botón derecho del ratón y seleccione Propiedades. Pulse la pestaña Objeto. Recuperar estado de objetos de índices Este procedimiento devuelve el estado de todos los objetos de la colección de búsqueda de texto. GET_OBJECT_STATUS Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis GET_OBJECT_STATUS El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros Ninguno CONJUNTO DE RESULTADOS DEVUELTO El procedimiento devuelve un conjunto de resultados que contiene una fila para cada conjunto de objetos: OBJECT STATUS_TIMESTAMP STATUS_CODE TEXT_STATUS XML TIMESTAMP INTEGER VARCHAR(100) OBJECT - La información de ubicación del objeto en el índice, que coincide con el formato devuelto por la búsqueda para la columna OBJECTINFOR. 144 IBM i: OmniFind Text Search Server for DB2 for i STATUS_TIMESTAMP - Si el estado del objeto es INDEXED, esta es la indicación de fecha y hora de modificación del objeto en el índice. En otras palabras, los cambios realizados en el objeto antes de esta hora se reflejan en el índice de búsqueda de texto. Para todos los demás valores de estado, esta indicación de fecha y hora es la hora en que el estado se ha registrado en el índice. Por ejemplo: si el estado del objeto es ERROR, este es el momento en que se ha registrado el error. STATUS_CODE - Valor numérico que representa el estado de este objeto: 0 = El objeto se ha indexado y no se han detectado cambios en el objeto. 10 = El objeto se encuentra actualmente en proceso de indexación. 20 = Se han detectado cambios en el objeto. 30 = El objeto se ha indexado, pero se ha producido un aviso durante el proceso de indexación. 40 = Un error ha impedido la indexación del objeto. Estos valores permiten criterios de selección más complejos. Es decir, recuperar todos los objetos no actuales del índice se puede expresar como STATUS_CODE > 0. Nota: el estado de los objetos que se encuentran en proceso de actualización o estaban en proceso de actualización cuando se canceló una actualización puede diferir de la realidad. Es posible que un objeto informe de que hay cambios pendientes, cuando en realidad el texto que se debe indexar ya ha sido enviado al servidor. También es posible que el estado de un documento sea 'INDEXED', pero el objeto puede no estar en condiciones de búsqueda hasta un punto de confirmación futuro del proceso de actualización. STATUS_CODE reflejará la realidad cuando el procedimiento almacenado de actualización se haya completado. El conjunto de resultados se ordena (por orden descendente) por código de estado. TEXT_STATUS - La versión de texto del código de estado: 0 10 20 30 40 = = = = = INDEXED INDEXING CHANGES PENDING WARNING ERROR Ejemplos Call MYCOLLECTION.GET_OBJECT_STATUS; Obtener objetos no indexados Este procedimiento devuelve los objetos que no están indexados en la colección de búsqueda de texto. GET_OBJECTS_NOT_INDEXED Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis GET_OBJECTS_NOT_INDEXED El calificador de esquema es el nombre de la colección de búsqueda de texto. OmniFind Text Search Server 145 Parámetros Ninguno CONJUNTO DE RESULTADOS DEVUELTO El procedimiento devuelve un conjunto de resultados que contiene una fila para cada conjunto de objetos: OBJECT STATUS_TIMESTAMP STATUS_CODE TEXT_STATUS XML TIMESTAMP INTEGER VARCHAR(100) OBJECT - La información de ubicación del objeto en el índice, que coincide con el formato devuelto por la búsqueda para la columna OBJECTINFOR. STATUS_TIMESTAMP - Si el estado del objeto es INDEXED, esta es la indicación de fecha y hora de modificación del objeto en el índice. En otras palabras, los cambios realizados en el objeto antes de esta hora se reflejan en el índice de búsqueda de texto. Para todos los demás valores de estado, esta indicación de fecha y hora es la hora en que el estado se ha registrado en el índice. Por ejemplo: si el estado del objeto es ERROR, este es el momento en que se ha registrado el error. STATUS_CODE - Valor numérico que representa el estado de este objeto: 0 = El objeto se ha indexado y no se han detectado cambios en el objeto. 10 = El objeto se encuentra actualmente en proceso de indexación. 20 = Se han detectado cambios en el objeto. 30 = El objeto se ha indexado, pero se ha producido un aviso durante el proceso de indexación. 40 = Un error ha impedido la indexación del objeto. Estos valores permiten criterios de selección más complejos. Es decir, recuperar todos los objetos no actuales del índice se puede expresar como STATUS_CODE > 0. Nota: el estado de los objetos que se encuentran en proceso de actualización o estaban en proceso de actualización cuando se canceló una actualización puede diferir de la realidad. Es posible que un objeto informe de que hay cambios pendientes, cuando en realidad el texto que se debe indexar ya ha sido enviado al servidor. También es posible que el estado de un documento sea 'INDEXED', pero el objeto puede no estar en condiciones de búsqueda hasta un punto de confirmación futuro del proceso de actualización. STATUS_CODE reflejará la realidad cuando el procedimiento almacenado de actualización se haya completado. El conjunto de resultados se ordena (por orden descendente) por código de estado. TEXT_STATUS - La versión de texto del código de estado: 0 10 20 30 40 = = = = = INDEXED INDEXING CHANGES PENDING WARNING y ERROR WARNING y ERROR Ejemplos Call MYCOLLECTION.GET_OBJECTS_NOT_INDEXED; Recuperar estado de colección Este procedimiento devuelve el estado de la colección de búsqueda de texto. STATUS 146 IBM i: OmniFind Text Search Server for DB2 for i Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis STATUS El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros Ninguno CONJUNTO DE RESULTADOS DEVUELTO El procedimiento devuelve un conjunto de resultados que contiene una fila para cada conjunto de objetos: SERVERID SERVERNAME SERVERSTATUS LASTUPDATETIME LASTUPDATESTATUS UPDATEFREQUENCY INTEGER VARCHAR(128) VARCHAR(32) TIMESTAMP VARCHAR(30) VARCHAR(512) SERVERID - ID de servidor del índice de búsqueda de texto. SERVERNAME - Nombre de host o dirección IP del servidor de búsqueda de texto. SERVERSTATUS - Indica si el servidor puede utilizarse como servidor de búsqueda de texto para crear índices de búsqueda de texto. El valor predeterminado es 0 (cero), que indica que el servidor puede utilizarse. LASTUPDATETIME - Hora de última actualización del índice de búsqueda de texto. LASTUPDATESTATUS - Indica el último estado de actualización del índice de búsqueda de texto. NEVER UPDATED - El índice de búsqueda de texto nuca se ha actualizado. UP TO DATE - El índice de búsqueda de texto está actualizado. CHANGES PENDING - Hay cambios pendientes. El usuario necesita actualizar el índice para actualizar el índice de búsqueda de texto. FAILED - El índice de búsqueda de texto se ha actualizado de forma anómala por última vez. UPDATEFREQUENCY - Frecuencia de actualizaciones automáticas en el índice de búsqueda de texto. Ejemplos Call MYCOLLECTION.STATUS; Para recuperar el estado de colección desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > OmniFind > Lista de colecciones. OmniFind Text Search Server 147 Eliminar una colección de búsqueda de texto Este procedimiento elimina una colección de búsqueda de texto del sistema. SYSPROC.SYSTS_DRPCOL y SYSPROC.SYSTS_DROP_COLLECTION Autorización Los procedimientos almacenados SYSPROC.SYSTS_DRPCOL y SYSPROC.SYSTS_DROP_COLLECTION se suministran con la autorización pública *EXECUTE. No se adopta ninguna autorización y el procedimiento se ejecuta bajo el perfil del usuario. El usuario debe tener autorización para eliminar el esquema SQL (incluidos todos los objetos que contiene) para poder eliminar correctamente la colección. Sintaxis SYSTS_DRPCOL ( nombre_colección ) Sintaxis SYSTS_DROP_COLLECTION ( nombre_colección ) El calificador de esquema es SYSPROC. Parámetros nombre_colección El nombre de la colección suministrado en el procedimiento almacenado SYSTS_CREATE_COLLECTION. El tipo de datos de este parámetro es VARCHARE(128). Ejemplos CALL SYSPROC.SYTS_DRPCOL(‘”MYCOLLECTION”') Otros ejemplos utilizando procedimientos de colección de búsqueda de texto > CALL SYSPROC.SYSTS_CREATE_COLLECTION(’MYCOLLECTION’, ’FORMAT TEXT’); De forma predeterminada, siempre se llama a los procedimientos almacenados asociados con la nueva colección. > SET SCHEMA MYCOLLECTION > SET PATH MYCOLLECTION Añadir un conjunto de objetos para todos los archivos spool propiedad del usuario ZOOKEEPER > CALL.ADD_SPLF_OBJECT_SET(’’, ’’, ’ZOOKEEPER’); Añadir un conjunto de objetos para todos los archivos spool creados el 06/14/2010 > CALL ADD_SPLF_OBJECT_SET(’’, ’’, ’’, ’’, ’’, ’’, ’’, ’2010-06-14T00:00:00’, ’2010-06-15T00:00:00’); Añadir un conjunto de objetos para todos los archivos continuos del directorio de IFS ’/home/zookeeper’ > CALL ADD_IFS_STMF_OBJECT_SET(’/home/zookeeper’); Actualizar la colección > CALL UPDATE; Buscar ’Leones AND tigres AND osos’ 148 IBM i: OmniFind Text Search Server for DB2 for i > CALL SEARCH(’leones AND tigres AND osos’); Otorgar autorización a otro usuario (SEARCHER) > GRANT EXECUTE ON SPECIFIC PROCEDURE SEARCH1 TO SEARCHER Eliminar la colección > CALL SYSPROC.SYSTS_DROP_COLLECTION(’MYCOLLECTION’) Para eliminar una colección de búsqueda de texto desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > OmniFind > Lista de colecciones. 3. Pulse la colección con el botón derecho del ratón y seleccione Suprimir. Modificar una colección de búsqueda de texto Puede llamar a este procedimiento almacenado para modificar los atributos de una colección que se ha creado mediante SYSPROC.SYSTS_CREATE_COLLECTION. Sólo se cambiarán los atributos especificados explícitamente en este procedimiento. Todos los demás atributos del índice permanecerán sin cambios. Este procedimiento resulta de utilidad si necesita cambiar los atributos de la colección, como por ejemplo la frecuencia de actualización, una vez que ésta se ha creado. ALTER_COLLECTION Autorización Este procedimiento almacenado se crea con la autorización pública *EXCLUDE y es propiedad del creador de la colección de búsqueda de texto. El procedimiento adoptará la autorización del perfil del propietario de la colección de búsqueda de texto. Puede otorgarse autorización a otros usuarios para permitirles ejecutar el procedimiento. Sintaxis >>-ALTER_COLLECTION--(--opciones----------------------------->< El calificador de esquema es el nombre de la colección de búsqueda de texto. Parámetros opciones Serie de caracteres que especifica las diversas opciones que están disponibles para este procedimiento almacenado. El tipo de datos de este parámetro es VARCHAR(32000). opciones: características-actualización características-actualización: UPDATE FREQUENCY NONE < frecuencia-actualización> OmniFind Text Search Server 149 características-actualización Especifica la frecuencia de las actualizaciones automáticas de la colección de búsqueda de texto. El proceso de actualización de una colección de búsqueda de texto implica tanto la indexación de los datos de texto como el rastreo de los objetos del sistema para detectar datos nuevos o cambiados. UPDATE FREQUENCY frecuencia-actualización Especifica cuándo deben realizarse actualizaciones automáticas en la colección de búsqueda de texto. El valor predeterminado es NONE. frecuencia-actualización (Formato 1): NONE D ( * ) H ( * , ) M ( * , 0..6 0..23 0..6 ) , 0..59 0..23 0..59 NONE Si se especifica NONE, no se realizan más actualizaciones de índice. La actualización debe iniciarse manualmente. D Especifica el día o días de la semana en los que se actualiza el índice. Un asterisco (*) indica todos los días. 0 indica el Domingo. H Especifica la hora u horas en las que se actualiza el índice. Un asterisco (*) indica todas las horas. M Especifica el minuto o minutos en los que se actualiza el índice. No puede especificarse un asterisco (*). La frecuencia de actualización mínima es de 5 minutos. Ejemplo: este ejemplo especifica que la actualización de índice debe ejecutarse cada 30 minutos. UPDATE FREQUENCY D(*) H(*) M(0,30) frecuencia-actualización (Formato 2, cronológico): < minuto> < hora> <díaDelMes> <mesDelAño> <díaDeLaSemana> El formato de la opción frecuencia-actualización (cronológica) es una lista de cinco valores separados por espacios en blanco. Los cinco valores representan los minutos, horas, días del mes, meses del año y días de la semana empezando por el Domingo. Si especifica un intervalo de valores o un asterisco (*), puede especificar un valor de recorrido utilizando una barra inclinada (/) al final del intervalo definido. Ejemplo: este ejemplo especifica que la actualización de índice debe ejecutarse cada cuarto de hora (0,15,30,45) en las horas pares entre las 8 a.m. y las 6:45 p.m. (8-18/2 es equivalente a 8,10,12,14,16,18), de Lunes a Viernes todos los meses del año (* * 1-5). 0,15,30,45 8-18/2 * * 1-5 minuto Especifica los minutos de la hora en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para un intervalo de cada 5 minutos o un entero de 0 a 59. No pueden repetirse valores. La frecuencia de actualización mínima es de 5 minutos. Un valor de 1, 4 u 8 no es válido. frecuencia-actualización (minuto): 150 IBM i: OmniFind Text Search Server for DB2 for i * / 0...59 , 0...59 - 0...59 / 0...59 0...59 hora Especifica las horas del día en las que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada hora o un entero de 0 a 23. No pueden repetirse valores. frecuencia-actualización (hora): * / 0...23 , 0...23 - 0...23 / 0...23 0...23 díaDelMes Especifica los días del mes en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada día o un entero de 1 a 31. No pueden repetirse valores. frecuencia-actualización (díaDelMes): * / 1...31 , 1...31 - 1...31 / 1...31 1...31 mesDelAño Especifica los meses del año en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada mes o un entero de 1 a 12. No pueden repetirse valores. frecuencia-actualización (mesDelAño): * / 1...12 , 1...12 - 1...12 / 1...12 1...12 díaDeLaSemana Especifica los días de la semana en los que debe actualizarse el índice de búsqueda de texto. Puede especificar un asterisco (*) para cada día o un entero de 0 a 7. Tanto 0 como 7 son valores válidos para el Domingo. No pueden repetirse valores. OmniFind Text Search Server 151 frecuencia-actualización (díaDeLaSemana): * / 0...7 , 0...7 - 0...7 / 0...7 0...7 Ejemplos 1. CALL MYCOLLECTION.ALTER_COLLECTION(‘UPDATE FREQUENCY H(0) M(0) D(*)'); Se modifica el valor de frecuencia de actualización de la colección MYCOLLECTION. La colección de búsqueda de texto tendrá una frecuencia de actualización diaria a las 00:00 horas. 2. CALL MYCOLLECTION.ALTER_COLLECTION(‘UPDATE FREQUENCY NONE'); Esta colección de búsqueda de texto se cambia a no planificada. Para modificar una colección desde IBM Navigator for i, siga estos pasos. 1. En IBM Navigator for i, expanda Gestión de IBM i > Sistema > Todas las tareas. 2. En el panel derecho, seleccione Sistema > OmniFind > Modificar colección. Consideraciones sobre las ASP independientes para las colecciones de búsqueda de texto Consideraciones sobre las IASP para una colección de búsqueda de texto. Pueden crearse colecciones de búsqueda de texto en un entorno de agrupaciones de almacenamiento auxiliar (ASP) independientes con las siguientes restricciones: 1. Si un grupo de ASP independientes está asociado con la hebra actual, la colección debe residir en una ASP del grupo de ASP independientes. No es posible administrar una colección de búsqueda de texto en la ASP del sistema o en una ASP básica de usuario mientras la hebra está establecida en un grupo de ASP independientes. Es posible buscar en una colección que existe en la ASP del sistema o en una ASP básica de usuario, pero dado que ese índice no puede incluir datos del grupo de ASP independientes, sólo se incluirán los objetos que son accesibles cuando el grupo de ASP es *NONE. 2. Una colección de búsqueda de texto puede indexar cualquier objeto visible desde el espacio de nombres de grupo de ASP de la colección. 3. Si un conjunto de objetos incluye objetos que existen en el espacio de nombres del grupo de ASP, pero no en el propio grupo, el tiempo de indexación puede ser significativo si el grupo de ASP independientes se mueve a otro sistema. Por ejemplo: si se crea una colección en la ASP independiente 33 para indexar todos los archivos de spool del sistema, y el grupo de ASP se conmuta a una máquina diferente, todos los archivos de spool de la máquina antigua que no se encuentren en el grupo de ASP se eliminarán del índice, y se añadirán todos los archivos de spool de la máquina nueva que no estén en el índice. Consideraciones sobre la copia de seguridad y restauración de colecciones de búsqueda de texto Salvar y restaurar una colección de búsqueda de texto. Puede realizarse una copia de seguridad y restaurarse una colección de búsqueda de texto salvando y restaurando la biblioteca del esquema creado para la colección. Durante la restauración, se iniciará de forma asíncrona una actualización. La actualización rastreará los objetos del sistema y volverá a llenar el índice. 152 IBM i: OmniFind Text Search Server for DB2 for i SQLCODE -0196 • SQLCODE -20423 Es necesario poder restaurar el índice de búsqueda de texto contenido en la colección para que la colección pueda utilizarse. Deben tenerse en cuenta estas consideraciones para restaurar un índice de búsqueda de texto: v Todos los productos necesarios deben estar instalados. v El servidor de búsqueda de texto debe estar disponible. Mensajes y códigos Puede visualizar los mensajes y códigos de retorno SQL de OmniFind Text Search for DB2 for i. Los mensajes se listan por orden numérico. Mensajes de OmniFind Puede visualizar los mensajes de OmniFind correspondientes a OmniFind Text Search for DB2 for i. Los mensajes se listan por orden numérico. Se añaden mensajes al archivo de mensajes de OmniFind (QDBTSLIB/QOMFMSGF) para los errores siguientes. Tabla 40. Mensajes de OmniFind Número Tipo Mensaje OMF0011 Información Índice de búsqueda de texto restaurado con opciones de configuración diferentes. OMF0012 Aviso El tipo FORMAT para el índice que se crea no es XML. Las búsquedas XML no están soportadas. OMF0334 Error El objeto ''{0}''.''{1}'' que ha especificado no está soportado. Un índice de búsqueda de texto sólo puede crearse sobre una tabla SQL, un alias SQL o un miembro simple de un archivo físico. OMF0358 Error El usuario actual no tiene autoridad suficiente para realizar la operación solicitada. OMF0359 Error La restauración ha fallado. El servidor de texto para el índice de texto no está disponible. SQLCODE -0196 La columna &3 de &1 en &2 no puede descartarse. Explicación: Se ha intentado descartar la columna &3. La columna no puede descartarse porque una vista, un desencadenante o un índice depende de la columna y se ha especificado RESTRICT, o la columna forma parte de la clave de partición. Respuesta del Usuario: Especifique CASCADE en la sentencia ALTER TABLE para descartar la columna y las vistas, restricciones, desencadenantes e índices que dependen de ella. Si la columna forma parte de la clave de partición, especifique DROP PARTITIONING en la sentencia ALTER TABLE para eliminar el particionamiento de la tabla. Intente de nuevo la petición. SQLSTATE: 42817 SQLCODE -5003 No puede realizarse la operación bajo control de compromiso. Explicación: Las operaciones siguientes no pueden realizarse bajo control de compromiso especificando COMMIT(*CHG), COMMIT(*CS) o COMMIT(*ALL): v Sentencia DROP SCHEMA. v Sentencia GRANT o REVOKE sobre un objeto que tiene un poseedor de autoridad. v Sentencia CREATE en modalidad de denominación SQL de un objeto que tiene un poseedor de autoridad. v DROP de un índice de búsqueda de texto. Estas operaciones no pueden comprometerse ni retrotraerse. Respuesta del Usuario: Especifique COMMIT(*NONE) e intente de nuevo la sentencia. SQLSTATE: 42922 SQLCODE -20423 Se ha producido un error durante el proceso de búsqueda de texto. Explicación: Se ha producido un error durante el proceso de búsqueda de texto de una función CONTAINS o SCORE. El error se ha producido en el OmniFind Text Search Server 153 SQLCODE -20424 • SQLCODE -20425 QSYS2.SYSTEXTSERVERS tiene un valor de 1, que indica que el soporte de búsqueda de texto se ha detenido. servidor servidor al utilizar el índice de búsqueda de texto nombre-índice por el código de razón código-razón. El testo que describe el problema es: texto. servidor: nombre o dirección IP del host y puerto del servidor de búsqueda de texto en el que se ha detectado el error. nombre-índice: nombre del índice utilizado en el proceso de búsqueda de texto. Nota: incluya el esquema y un punto en el nombre de índice en una única señal. código-razón: código de razón devuelto por OmniFind Text Search Server for DB2 for i. texto: texto devuelto por OmniFind Text Search Server for DB2 for i. Acción del Sistema: La sentencia no puede procesarse. Respuesta del Usuario: Póngase en contacto con el administrador del sistema para comprobar que OmniFind Text Search Server for DB2 for i esté correctamente instalado. SQLSTATE: 38H10 Referencia relacionada: “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. SQLCODE -20424 El soporte de búsqueda de texto no está disponible por la razón código-razón. Explicación: Se ha detectado un problema en una de las tablas administrativas de búsqueda de texto. El código de razón es código-razón. 1 Una de las tablas de administración de búsqueda de texto no se ha encontrado (QSYS2.SYSTEXTINDEXES, QSYS2.SYSTEXTCOLUMNS o QSYS2.SYSTEXTSERVERS). 7 No hay ningún OmniFind Text Search Server for DB2 for i definido. Acción del Sistema: La sentencia no puede procesarse. Respuesta del Usuario: Póngase en contacto con el administrador del sistema para asegurarse de que el soporte para la búsqueda de texto esté correctamente configurado en el sistema. SQLSTATE: 38H11 Referencia relacionada: “Tabla de administración QSYS2.SYSTEXTSERVERS” en la página 115 Puede visualizar dónde están instalados los servidores de búsqueda de texto mediante la tabla de administración QSYS2.SYSTEXTSERVERS. “Tabla de administración QSYS2.SYSTEXTINDEXES” en la página 112 Puede visualizar información acerca de cada índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTINDEXES. Cada índice de búsqueda de texto tiene un nombre, un nombre de esquema y un nombre de colección asociada en el servidor de búsqueda de texto. “Tabla de administración QSYS2.SYSTEXTCOLUMNS” en la página 114 Puede visualizar información acerca de las columnas de texto de un índice de búsqueda de texto en la tabla de administración QSYS2.SYSTEXTCOLUMNS. Cada índice de búsqueda de texto tiene un ID de índice, nombres de columna de texto y el nombre de esquema de la tabla base. SQLCODE -20425 Búsqueda de texto no permitida para la columna nombre-columna. Explicación: Una función de búsqueda de texto CONTAINS o SCORE ha especificado la columna nombre-columna de la tabla nombre-tabla en el esquema de tabla. No existe un índice de texto para esta columna, por lo que el proceso de búsqueda de texto no puede ejecutarse. Acción del Sistema: La sentencia no puede procesarse. Respuesta del Usuario: Compruebe que la columna y la tabla estén registradas en OmniFind Text Search Server for DB2 for i. SQLSTATE: 38H12 Referencia relacionada: 3 El soporte de búsqueda de texto no se ha iniciado. 4 La columna STATUS de la tabla 154 IBM i: OmniFind Text Search Server for DB2 for i “CONTAINS” en la página 40 Puede utilizar la función CONTAINS para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve un resultado que indica si se ha encontrado una coincidencia. SQLCODE -20426 • CPI321E “SCORE” en la página 43 Puede utilizar la función SCORE para realizar búsquedas en un índice de búsqueda de texto utilizando criterios especificados en un argumento de búsqueda. La función devuelve una puntuación de relevancia que mide hasta que punto un documento coincide con la consulta. SQLCODE -20426 Ya se está ejecutando un procedimiento de administración de búsqueda de texto conflictivo. Explicación: En este índice ya se está ejecutando un procedimiento administrativo de búsqueda de texto conflictivo, como por ejemplo una actualización. Acción del Sistema: La sentencia no puede procesarse. Respuesta del Usuario: Invoque de nuevo el procedimiento almacenado de administración una vez finalizado el procedimiento almacenado en ejecución. SQLSTATE: 38H13 SQLCODE -20427 Se ha producido un error durante el procedimiento administrativo de búsqueda de texto. Explicación: Se ha producido un error durante un procedimiento administrativo de búsqueda de texto. El código de razón es código-razón. El testo devuelto es: texto. El texto del error describe el problema. Acción del Sistema: La sentencia CALL falla con este SQLCODE. Respuesta del Usuario: Solucione el problema indicado por el error e invoque de nuevo el procedimiento almacenado administrativo. SQLSTATE: 38H14 CPF32fa Operación no permitida en el índice de búsqueda de texto &2 de &1. Explicación: Se ha intentado una operación que no está soportada para un índice de búsqueda de texto. Los índices de búsqueda de texto no permiten algunas operaciones que están permitidas en los índices y vistas tradicionales de DB2. Si se ha intentado suprimir el índice, la operación puede haber fallado debido a que el control de compromiso estaba activo. Respuesta del Usuario: Realice las operaciones administrativas de búsqueda de texto mediante los procedimientos almacenados SQL incluidos en OmniFind Text Search Server for DB2 for i. Para obtener más información acerca de los índices de búsqueda de texto y las restricciones que se les aplican, consulte la documentación de Information Center: http://www.ibm.com/systems/i/infocenter/ CPF32fb La operación en el índice de búsqueda de texto &2 de &1 no ha podido realizarse. Explicación: Se ha intentado una operación en el índice de búsqueda de texto &2 de &1. La operación solicitada no es válida actualmente debido al código de razón &3; los códigos de razón y sus significados son los siguientes: 1. Un producto necesario no está instalado. 2. El servidor de búsqueda de texto solicitado &4 no está disponible o no está definido. 3. Se ha intentado una restauración del índice, pero el índice ya existe. El índice existente no ha podido modificarse para que coincida con el índice salvado. 4. Un objeto dependiente &5 en &6 de tipo &7 no existía. 5. Un objeto &5 en &6 de tipo &7 no estaba disponible. 6. La agrupación de almacenamiento auxiliar (ASP) para la hebra actual no coincide con la ASP del índice de búsqueda de texto. 7. Ya existe un índice de búsqueda de texto para la columna &8, tabla &5 de la biblioteca &6. Respuesta del Usuario: Corrija el problema e intente de nuevo la operación. Para obtener más información acerca de los índices de búsqueda de texto, consulte la documentación de Information Center: http://www.ibm.com/systems/i/ infocenter/ CPI321E Archivo &1 de la biblioteca &2 diferido. Explicación: El archivo &1 de la biblioteca &2 se ha diferido durante esta solicitud de restauración con el ID de diferimiento especificado &4. El archivo se ha diferido debido al código de razón &3. Los códigos de razón son: 1. El archivo base &5 de la biblioteca &6 no existía cuando se estaba creando &1 para la restauración. 2. El archivo &1 no ha podido crearse por alguna otra razón que no es la ausencia de un archivo base. Consulte los mensajes anteriores para determinar por qué ha fallado la creación del archivo. 3. Uno o varios de los miembros del archivo &1 no han podido crearse. Consulte los mensajes anteriores para determinar por qué ha fallado la creación de los miembros. 4. El archivo representa un índice de búsqueda de texto y el objeto de programa bajo licencia necesario no existe en el sistema. 5. El archivo representa un índice de búsqueda de texto y el índice no ha podido volver a crearse. Respuesta del Usuario: Para el código de razón 1: restaure el archivo base que falta o utilice el mandato Restaurar objetos diferidos (RSTDFROBJ) especificando OmniFind Text Search Server 155 el mismo ID de diferimiento (parámetro DFRID) &4 en cualquiera de los mandatos utilizados. Para los códigos de razón 2 y 3: corrija las razones de la anomalía de creación y luego utilice el mandato Restaurar objetos diferidos (RSTDFROBJ) especificando el mismo ID de diferimiento (parámetro DFRID) &4 en el mandato. Para el código de razón 5: consulte los mensajes anteriores del registro de trabajo, corrija los errores y luego utilice el mandato Restaurar objetos diferidos (RSTDFROBJ) especificando el mismo ID de diferimiento (parámetro DFRID) &4 en el mandato. Información relacionada: Restaurar objetos diferidos (RSTDFROBJ) Información sobre licencia de código y exención de responsabilidad IBM le otorga una licencia de copyright no exclusiva para utilizar todos los ejemplos de código de programación, a partir de los que puede generar funciones similares adaptadas a sus necesidades específicas. SUJETO A LAS GARANTÍAS ESTATUTARIAS QUE NO PUEDAN EXCLUIRSE, IBM Y LOS DESARROLLADORES Y SUMINISTRADORES DE PROGRAMAS DE IBM NO OFRECEN NINGUNA GARANTÍA NI CONDICIÓN, YA SEA IMPLÍCITA O EXPLÍCITA, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTÍAS O CONDICIONES IMPLÍCITAS DE COMERCIALIZACIÓN, ADECUACIÓN A UN PROPÓSITO DETERMINADO Y NO VULNERACIÓN CON RESPECTO AL PROGRAMA O AL SOPORTE TÉCNICO, SI EXISTE. BAJO NINGUNA CIRCUNSTANCIA, IBM Y LOS DESARROLLADORES O SUMINISTRADORES DE PROGRAMAS DE IBM SE HACEN RESPONSABLES DE NINGUNA DE LAS SIGUIENTES SITUACIONES, NI SIQUIERA EN CASO DE HABER SIDO INFORMADOS DE TAL POSIBILIDAD: 1. PÉRDIDA DE DATOS O DAÑOS CAUSADOS EN ELLOS; 2. DAÑOS ESPECIALES, ACCIDENTALES, DIRECTOS O INDIRECTOS, O DAÑOS ECONÓMICOS DERIVADOS; 3. PÉRDIDAS DE BENEFICIOS, COMERCIALES, DE INGRESOS, CLIENTELA O AHORROS ANTICIPADOS. ALGUNAS JURISDICCIONES NO PERMITEN LA EXCLUSIÓN O LA LIMITACIÓN DE LOS DAÑOS DIRECTOS, ACCIDENTALES O DERIVADOS, POR LO QUE PARTE DE LAS LIMITACIONES O EXCLUSIONES ANTERIORES, O TODAS ELLAS, PUEDE NO SER PROCEDENTE EN SU CASO. 156 IBM i: OmniFind Text Search Server for DB2 for i Avisos Esta información se ha escrito para productos y servicios ofrecidos en Estados Unidos de América. Es posible que IBM no ofrezca en otros países los productos, servicios o características que se describen en este documento. El representante local de IBM IBM le puede informar acerca de los productos y servicios que actualmente están disponibles en su localidad. Cualquier referencia a un producto, programa o servicio de IBM no pretende indicar ni implicar que sólo pueda utilizarse dicho producto, programa o servicio de IBM. En su lugar, se puede utilizar cualquier producto, programa o servicio funcionalmente equivalente que no infrinja ningún derecho de propiedad intelectual de IBM. No obstante, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM. IBM puede tener patentes o solicitudes de patentes pendientes que cubran la materia descrita en este documento. La posesión de este documento no le confiere ninguna licencia sobre dichas patentes. Puede enviar las consultas sobre licencias, por escrito, a la siguiente dirección: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 Estados Unidos de América Para las consultas relacionadas con información de doble byte (DBCS), póngase en contacto con el departamento de propiedad intelectual de IBM de su país o envíe las consultas, por escrito, a: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan El párrafo siguiente no se aplica al Reino Unido ni a ningún otro país donde estas disposiciones sean incompatibles con la legislación local: INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA DOCUMENTACIÓN "TAL CUAL" SIN GARANTÍAS DE NINGÚN TIPO, NI EXPLÍCITAS NI IMPLÍCITAS, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTÍAS DE NO VULNERABILIDAD, COMERCIALIZACIÓN O IDONEIDAD PARA FINES CONCRETOS. Algunas legislaciones no contemplan la declaración de limitación de responsabilidad, ni implícitas ni explícitas, en determinadas transacciones, por lo que cabe la posibilidad de que esta declaración no se aplique en su caso. Esta información puede contener imprecisiones técnicas o errores tipográficos. La información incluida en este documento está sujeta a cambios periódicos, que se incorporarán en nuevas ediciones de la publicación. IBM puede realizar en cualquier momento mejoras o cambios en los productos o programas descritos en esta publicación sin previo aviso. Las referencias hechas en esta publicación a sitios Web que no son de IBM se proporcionan únicamente por cortesía y de ningún modo deben interpretarse como promoción de dichos sitios Web. Los materiales de estos sitios Web no forman parte de los materiales de este producto IBM, y el usuario será responsable del uso que se haga de estos sitios Web. IBM puede utilizar o distribuir la información que se le proporcione de la forma que considere adecuada, sin incurrir en ninguna obligación con el cliente. © Copyright IBM Corp. 2002, 2014 157 Los licenciatarios de este programa que deseen obtener información acerca del mismo con el fin de: (i) intercambiar la información entre programas creados independientemente y otros programas (incluido este) y (ii) utilizar mutuamente la información que se ha intercambiado, deben ponerse en contacto con: IBM Corporation Software Interoperability Coordinator, Department YBWA 3605 Highway 52 N Rochester, MN 55901 Estados Unidos de América Esta información puede estar disponible, sujeta a los términos y condiciones pertinentes, e incluir en algunos casos el pago de una cantidad. El programa bajo licencia que se describe en este documento y todo el material bajo licencia disponible los proporciona IBM bajo los términos de las Condiciones Generales de IBM, Acuerdo Internacional de Programas Bajo Licencia de IBM o cualquier acuerdo equivalente entre las partes. Los datos de rendimiento incluidos aquí se determinaron en un entorno controlado. Por lo tanto, los resultados que se obtengan en otros entornos operativos pueden variar significativamente. Algunas mediciones pueden haberse realizado en sistemas que estén en fase de desarrollo y no existe ninguna garantía de que esas mediciones vayan a ser iguales en los sistemas disponibles en el mercado. Además, es posible que algunas mediciones se hayan estimado mediante extrapolación. Los resultados reales pueden variar. Los usuarios de este documento deben verificar los datos aplicables a su entorno específico. La información concerniente a productos que no son de IBM se ha obtenido de los suministradores de dichos productos, de sus anuncios publicados o de otras fuentes de información pública disponibles. IBM no ha probado esos productos y no puede confirmar la exactitud del rendimiento, de la compatibilidad ni de ninguna otra declaración relacionada con productos que no sean de IBM. Las consultas acerca de las prestaciones de los productos que no son de IBM deben dirigirse a los suministradores de tales productos. Todas las declaraciones relativas a la dirección o intención futura de IBM están sujetas a cambios o anulación sin previo aviso y representan únicamente metas y objetivos. Todos los precios de IBM mostrados son precios de minoristas sugeridos por IBM, están actualizados y están sujetos a cambios sin aviso previo. Los precios de los concesionarios pueden ser diferentes. Esta información tiene únicamente valor de planificación. La información contenida en esta documentación está sujeta a cambios antes de que los productos descritos estén disponibles. Esta información contiene ejemplos de datos e informes utilizados en operaciones comerciales diarias. Para ilustrarlas de la forma más completa posible, los ejemplos incluyen nombres de personas, empresas, marcas y productos. Todos estos nombres son ficticios y cualquier parecido con los nombres y direcciones utilizados por una empresa real es mera coincidencia. LICENCIA DE COPYRIGHT: Esta información contiene programas de aplicación de ejemplo en lenguaje fuente, que ilustran las técnicas de programación en diversas plataformas operativas. Puede copiar, modificar y distribuir estos programas de muestra de cualquier modo sin pagar a IBM con el fin de desarrollar, utilizar, comercializar o distribuir programas de aplicación que se ajusten a la interfaz de programación de aplicaciones para la plataforma operativa para la que se ha escrito el código de muestra. Los ejemplos no se han probado minuciosamente bajo todas las condiciones. Por lo tanto, IBM no puede garantizar ni dar por sentada la 158 IBM i: OmniFind Text Search Server for DB2 for i fiabilidad, facilidad de mantenimiento o la función de estos programas. Los programas de ejemplo se ofrecen "TAL CUAL", sin garantía de ningún tipo. IBM no será responsable de ningún daño derivado del uso de los programas de ejemplo. Cada copia o parte de estos programas de ejemplo, así como todo trabajo derivado, debe incluir un aviso de copyright como el siguiente: © nombre de la empresa) (año). Partes de este código derivan de programas de ejemplo de IBM Corp. Sample Programs. © Copyright IBM Corp. _escriba el año o años_. Si está viendo esta información en copia software, es posible que las fotografías y las ilustraciones en color no aparezcan. Información de la interfaz de programación Esta publicación de Common Information Model (CIM) documenta las interfaces de programación cuya finalidad es permitir al cliente escribir programas para obtener los servicios de IBM i. Marcas registradas IBM, el logotipo de IBM e ibm.com son marcas registradas o marcas comerciales registradas de International Business Machines Corp., registradas en muchas jurisdicciones de todo el mundo. Puede que otros productos o nombres de servicio sean marcas registradas de IBM u otras compañías. Hay disponible una lista actual de marcas registradas de IBM en la web “Información de marca registrada y copyright” en www.ibm.com/legal/copytrade.shtml. Adobe, el logotipo de Adobe, PostScript y el logotipo de PostScript son marcas registradas de Adobe Systems Incorporated en los Estados Unidos de América o en otros países. IT Infrastructure Library es una marca registrada de Central Computer and Telecommunications Agency, que actualmente forma parte de Office of Government Commerce. Intel, el logotipo de Intel, Intel Inside, el logotipo de Intel Inside, Intel Centrino, el logotipo de Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium, y Pentium son marcas registradas de Intel Corporation o de sus subsidiarias en los Estados Unidos y/o en otros países. Linux es una marca registrada de Linus Torvalds en los Estados Unidos de América o en otros países. Microsoft, Windows, Windows NT, y el logotipo de Windows son marcas comerciales de Microsoft Corporation en Estados Unidos, otros países o ambos. ITIL es una marca registrada y una marca registrada de comunidad de Office of Government Commerce y está registrada en U.S. Patent and Trademark Office. UNIX es una marca registrada de The Open Group en los Estados Unidos de América o en otros países. Cell Broadband Engine es una marca comercial de Sony Computer Entertainment, Inc. en Estados Unidos, otros países o ambos y se utiliza bajo licencia. Java y todas las marcas registradas y logotipos basados en Java son marcas registradas de Sun Microsystems, Inc. en los Estados Unidos de América o en otros países. Los demás nombres de productos y servicios pueden ser marcas registradas de IBM o de terceros. Avisos 159 160 IBM i: OmniFind Text Search Server for DB2 for i Índice A actualizar la colección 139 ADD_SPLF_OBJECT_SET 124, 131 alta disponibilidad 93 añadir un conjunto de objetos para datos de archivo spool ADD_SPLF_OBJECT_SET 124 añadir un conjunto de objetos para un archivo continuo ADD_IFS_STMF_OBJECT_SET 131 archivos de registro 74 argumento de búsqueda 40, 43 B búsqueda 94, 98 búsqueda de texto 3 iniciar 13 búsqueda XML características 54 gramática de consultas eliminar un conjunto de objetos REMOVE_OBJECT_SET 138 eliminar una colección de búsqueda de texto SYSTS_DROP_COLLECTION 148 F formatos de documento soportados 6 función CONTAINS ejemplo 53 función SCORE ejemplo 53 funciones CONTAINS 40 SCORE 43 funciones de búsqueda de texto conceptos clave 4 funciones definidas por el usuario L lenguaje XPath llenar 12 mensajes 40 G cabecera de ampliaciones colecciones de búsqueda de texto 118 códigos de idioma 8 códigos de retorno SQL 153 colección de búsqueda SEARCH 141 SYSPROC.SYSTS_CRTCOL 119 colecciones de búsqueda de texto cabecera de ampliaciones 118 COLLECTION_NAME.UPDATE 139 collection.status 146 comunicación entre cliente y servidor 3 conceptos clave funciones de búsqueda de texto 4 configurar 12 consultar información sobre conjuntos de objetos 143 CONTAINS 47 Get_object_status 144 GET_OBJECTS_NOT_INDEXED gramática EBNF 68 145 H hardware requisitos 4 Health Checker 91 herramienta de administración 89 Herramienta de configuración 76 Herramienta de sinónimos 85 Herramienta ServerInstance 90 herramientas de línea de mandatos 76 Health Checker 91 herramienta de administración 89 Herramienta de configuración 76 Herramienta de sinónimos 85 Herramienta ServerInstance 90 D I datos XML indexar 6 desencadenantes 5 determinación de problemas 74 diccionario de sinónimos 85 añadir 85 eliminar 86 IASP para colecciones de búsqueda de texto Colecciones de búsqueda de texto 152 IBM OmniFind Text Search Server detener 70 iniciar 70 idiomas soportados 8 indexación asíncrona 5 índice de búsqueda de texto 71, 72, 73 actualizaciones 4, 118 actualizar 14 buscar 15 E ejemplos de consultas función CONTAINS función SCORE 47 47 © Copyright IBM Corp. 2002, 2014 68 M 68 C índice de búsqueda de texto (continuación) creación 4, 118 crear 14 índice de texto 3, 71, 72, 73 instalación 12 instalar 12 153 O Obtener objetos no indexados 145 OmniFind 3, 12 OmniFind Text Search 12 OmniFind Text Search Server 12 operadores de búsqueda avanzada función CONTAINS 48 función SCORE 48 P paquete de diccionarios 8 procedimiento almacenado SYSPROC.SYSTS_REMOVE 78 SYSPROC.SYSTS_REPRIMEINDEX 80, 81 SYSPROC.SYSTS_VALIDITYCHECK 82 procedimientos almacenados 15 SYSPROC.SYSTS_ALTER 28 SYSPROC.SYSTS_CREATE 19 SYSPROC.SYSTS_DROP 34 SYSPROC.SYSTS_START 15 SYSPROC.SYSTS_STOP 17 SYSPROC.SYSTS_UPDATE 36 proceso lingüístico 8 Chino 9 proceso lingüístico 9 Coreano 9 proceso lingüístico 9 Japonés 9 proceso lingüístico 9 puntuación de relevancia 43 puntuación de texto 7 Q QDBTS_LISTINXSTS UDTF 87 QSYS2.SYSTEXTCOLUMNS 114, 117 QSYS2.SYSTEXTCONFIGURATION 116 QSYS2.SYSTEXTINDEXES 112 161 tamaño de documento 15 Text Search for DB2 for i 12 tipos de datos soportados 7 transacción 98 QSYS2.SYSTEXTSERVERHISTORY 117 QSYS2.SYSTEXTSERVERS 12, 115 QUERY_OBJECT_SET 143 R recorte de documentos 15 recuperar el estado de colección 146 recuperar estado de objetos indexados 144 registro del servidor guardar 75 visualizar 75 rendimiento 94 requisitos del sistema 4 restaurar 71, 72, 73 Restaurar colecciones de búsqueda de texto Restaurar colecciones de búsqueda de texto 152 U UDTF QDBTS_LISTINXSTS 87 UPDATEAUTOCOMMIT 94, 98 V visión general del producto 3 volver a llenar la colección de búsqueda de texto 140 volver a preparar colección 140 S salvar 71, 72, 73 salvar y restaurar 71, 72, 73 SCORE 47 segmentación basada en diccionario 9 segmentación n-gram 8, 9 servidor de búsqueda de texto IBM 4 servidor de búsqueda de texto OmniFind 3 búsqueda de texto 2 índice de texto 2 OmniFind 2 servidores de búsqueda de texto 12 sintaxis de argumentos de búsqueda 40 búsqueda de frases 45 búsqueda simple 45 carácter comodín 45 excluir términos 45 incluir términos 45 sintaxis de búsqueda 40 sistema operativo requisitos 4 software requisitos 4 soporte de sinónimos 7 SYSIBMTS.SYSTEXTDEFAULTS 111 SYSPROC.SYSTS_CREATE 19 SYSPROC.SYSTS_CREATE_COLLECTION SYSPROC.SYSTS_CRTCOL 119 SYSPROC.SYSTS_DROP 28, 34 SYSPROC.SYSTS_START 15 SYSPROC.SYSTS_STOP 17 SYSPROC.SYSTS_UPDATE 36 SYSTEXTSERVERS 12 119 T tablas de administración 111 QSYS2.SYSTEXTCOLUMNS 114, 117 QSYS2.SYSTEXTCONFIGURATION 116 QSYS2.SYSTEXTINDEXES 112 QSYS2.SYSTEXTSERVERHISTORY 117 QSYS2.SYSTEXTSERVERS 115 SYSIBMTS.SYSTEXTDEFAULTS 111 162 IBM i: OmniFind Text Search Server for DB2 for i Número de Programa: 5733-OMF Impreso en España