Este mandato inicia inmediatamente el proceso de indexación, poniendo al día el índice para que refleje el contenido actual de las columnas de texto a las que está asociado el índice.
Mientras se realiza la actualización, es posible realizar búsquedas utilizando el predicado CONTAINS. En un índice con una tabla de resultados de la antememoria activada, también es posible realizar búsquedas mediante procedimiento almacenado durante la actualización. Sin embargo, las columnas de la tabla de antememoria pueden mostrar nuevos valores aunque no se haya confirmado todavía el texto cambiado para el índice de texto.
Si se utiliza la opción RECREATE INDEX ON UPDATE en el mandato CREATE INDEX, el índice se borrará antes de volver a crearlo. Hasta que finalice la actualización, se devolverán resultados vacíos.
Autorización
Según las vistas de catálogo de DB2, el ID de usuario de este mandato debe tener el privilegio CONTROL sobre la tabla para la que se haya creado el índice de texto completo.
Sintaxis del mandato
>>-UPDATE-INDEX--+--------------------+--nombre-índice----------> '-esquema-índice-"."-' >--FOR-TEXT--+------------+--+---------------------------+------> '-REORGANIZE-' '-COMMITCOUNT--número total-' >--+----------------------+--+---------------------+----------->< '-USING-UPDATE-MINIMUM-' '-|opciones-conexión|-' opciones-conexión: |--+----------------------------------------------------------------------+--| '-CONNECT-TO--nombre-basedatos--+------------------------------------+-' '-USER--idusuario--USING--contraseña-'
Parámetros del mandato
Utilice la opción REORGANIZE AUTOMATIC del mandato CREATE INDEX para evitar el tener que comprobar y reorganizar manualmente el índice.
Nota |
---|
El proceso de reorganización tiene lugar después de una actualización regular. |
Para las bases de datos distribuidas, UPDATE MINIMUM se comprueba en cada nodo.
Vea CREATE INDEX para obtener información adicional.
Sin embargo, para actualizaciones iniciales como, por ejemplo, la primera actualización después del mandato CREATE INDEX o cualquier actualización con la opción RECREATE INDEX ON UPDATE, sólo hay una transacción lógica que ignora COMMITCOUNT. Esto puede cambiarse utilizando el mandato ALTER INDEX.
Uso
Este mandato se ejecuta sincrónicamente. Empieza el proceso de actualización en todos los nodos lógicos/físicos de DB2 necesarios en un entorno DB2 distribuido. La duración depende del número de archivos que se deban indexar y del número de documentos ya indexados. El estado de la actualización puede verse mediante una vista que se crea para cada índice. El nombre de esta vista puede recuperarse de DB2EXT.TEXTINDEXES en la columna EVENTVIEWNAME. Para obtener más información, vea el Apéndice C, Catálogos de información de Net Search Extender.
Hay dos opciones para ver el número de documentos confirmados que se han procesado. Para determinar si una actualización todavía se ejecuta y cuántos documentos se han confirmado en el índice, utilice la vista DB2EXT.TEXTINDEXES (NUMBERDOCS). Utilice la vista de sucesos asociada al índice para obtener información sobre el inicio, la confirmación de los cambios y la finalización del proceso de actualización.
Para ver el número de documentos no confirmados que se deben procesar, utilice el mandato CONTROL LIST ALL LOCKS FOR INDEX.
Nota |
---|
Las vistas sólo muestran información del nodo conectado. Para las actualizaciones incrementales en una tabla base con nodos físicos, la hora de cada nodo debe estar sincronizada. Si las horas no están sincronizadas, es posible que se pierdan las actualizaciones o que no se produzcan. |
El mandato no se podrá emitir si se está ejecutando uno de los mandatos siguientes sobre el índice:
Después de actualizar un índice con una tabla de resultados de antememoria permanente desactivada, se suprime la antememoria permanente para que el próximo mandato ACTIVATE CACHE vuelva a crearla basándose en el contenido de la base de datos.
Si el usuario interrumpe este mandato, todos los procesos implicados en la función de actualización se detendrán. Si se ha utilizado un número-total-confirmación en una actualización incremental, puede que algunas actualizaciones sean visibles en el índice mientras que otras necesiten un nuevo mandato de actualización.
Para detener la actualización automática de un índice, busque el proceso del propietario de la instancia de DB2 que ejecute el mandato de actualización del índice en la partición utilizado para los servicios de actualización. Detenga este proceso y se detendrá el proceso de actualización en todas las particiones.
Nota |
---|
Como el mandato funciona en dos fases distintas para la creación del índice en todas las particiones y actualizaciones de índice iniciales, emita un mandato db2text drop index para asegurarse de que el índice no esté disponible parcialmente. Si no se emite este mandato, la siguiente actualización, que puede activarse mediante un mandato de actualización o la opción de frecuencia de actualización, realizará una reindexación completa para garantizar un estado coherente. |
Cuando utilice las tablas de capturas de duplicación, se efectuarán los siguientes cambios en la base de datos.