IBM Books
(C) IBM Corp. 2000

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

ALTER INDEX

El mandato cambia las características de un índice de texto completo como, por ejemplo, las opciones de actualización y las de almacenamiento.

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

>>-ALTER-INDEX--+--------------------+--nombre-índice----------->
                '-esquema-índice-"."-'
 
>--FOR-TEXT--+---------------------------------+---------------->
             '-|características-actualización|-'
 
>--+---------------------------+--+---------------------+------><
   '-|opciones-almacenamiento|-'  '-|opciones-conexión|-'
 
opciones-almacenamiento:
 
|--+-----------------------------+------------------------------>
   '-INDEX-DIRECTORY--directorio-'
 
>--+------------------------------------+----------------------->
   '-WORK-DIRECTORY--directorio-trabajo-'
 
>--+-------------------------------------------------+---------->
   '-CACHE TABLE--+-PERSISTENT--+----------------+-+-'
                  |             '-IN--directorio-' |
                  '-TEMPORARY----------------------'
 
>--+---------------------+-------------------------------------->
   '-PCTFREE--porcentaje-'
 
>--+------------------------------------+-----------------------|
   '-MAXIMUM CACHE SIZE--tamaño-memoria-'
 
características-actualización:
 
|--+--------------------------------------------------+--------->
   '-UPDATE-FREQUENCY--+-NONE-----------------------+-'
                       '-|frecuencia-actualización|-'
 
>--+---------------------------------+-------------------------->
   '-UPDATE-MINIMUM--cambios-mínimos-'
 
>--+--------------------------------------+---------------------|
   '-COMMITCOUNT-FOR-UPDATE--número total-'
 
frecuencia-actualización:
 
|--D--(--+-*---------+--)--H--(--+-*----------+--)--M----------->
         | .-,-----. |           | .-,------. |
         | V       | |           | V        | |
         '---0...6-+-'           '---0...23-+-'
 
      .-,------.
      V        |
>--(----0...59-+--)---------------------------------------------|
 
opciones-conexión:
 
|--+----------------------------------------------------------------------+--|
   '-CONNECT-TO--nombre-basedatos--+------------------------------------+-'
                                   '-USER--idusuario--USING--contraseña-'
 
 

Parámetros del mandato

esquema-índice
Esquema del índice de texto tal como se ha especificado en el mandato CREATE INDEX. Si no se ha especificado ningún esquema, se utilizará el ID de usuario de la conexión de DB2.

nombre-índice
Nombre del índice de texto tal como se ha especificado en el mandato CREATE INDEX.

INDEX DIRECTORY directorio
Vía de acceso del directorio donde se almacenar el índice de texto. Como el directorio contendrá datos de índice, asegúrese de que el directorio tenga permiso de lectura/grabación y ejecución para el ID de usuario del propietario de la instancia de DB2.

Tenga en cuenta que en un entorno DB2 distribuido, este directorio tiene que existir en cada nodo. Se crea un subdirectorio, NODE<nr>, en el directorio para distinguir los índices de nodos lógicos de un servidor. Se suprimen todos los archivos de índice del directorio de índices anterior.

WORK DIRECTORY directorio de trabajo
Almacena archivos temporales durante operaciones de búsqueda y administración. El directorio de trabajo separado se puede cambiar independientemente de un directorio de índice nuevo.

Si el directorio no existe, se creará uno para el ID de usuario del propietario de la instancia de DB2. Si ya existe, asegúrese de que el directorio tenga permiso de lectura/grabación sobre las plataformas UNIX para el propietario de la instancia.

Tenga en cuenta que en un entorno DB2 distribuido, este directorio tiene que existir en cada nodo. Se crea un subdirectorio, NODE<nr>, en el directorio para distinguir los índices de nodos lógicos de un servidor. Se suprimen todos los archivos de índice temporales del directorio de índices anterior.

CACHE TABLE PERSISTENT IN directorio
Especifica que, después de una desactivación o un rearranque del sistema, la tabla de la antememoria de CREATE INDEX es permanente. En cualquier caso, esto permite una ejecución rápida de ACTIVATE CACHE. La antememoria permanente se almacena en el directorio especificado.

La antememoria permanente creada anteriormente se trasladas a una ubicación nueva. Esta ubicación siempre necesita un índice desactivado.

CACHE TABLE TEMPORARY
Especifica que la tabla de resultado de la antememoria ahora es temporal y se ha suprimido toda antememoria permanente que existiera anteriormente. Tenga en cuenta que este cambio requiere un índice desactivado.

MAXIMUM CACHE SIZE tamaño-memoria
Especifica el nuevo tamaño máximo de la tabla de la antememoria que debe crearse durante ACTIVATE CACHE. Especifique el parámetro tamaño-memoria en megabytes, como un entero positivo.

Si el entero es demasiado pequeño, el mandato ACTIVATE CACHE fallará. El tamaño real de la antememoria se calcula durante el mandato ACTIVATE CACHE. Este cambio requiere un índice desactivado.

PCTFREE porcentaje
Especifica el porcentaje de la antememoria que debe mantenerse libre para documentos adicionales. El porcentaje debe ser un valor entero menor que 100 y mayor o igual a 0. Tenga en cuenta que la antememoria permanente anterior se suprime y que este cambio requiere un índice desactivado. Consulte la sección ACTIVATE CACHE.

UPDATE FREQUENCY
Utilizando los siguientes parámetros, la frecuencia de actualización del índice determina cuándo se realiza la actualización:

Si no especifica la palabra clave UPDATE FREQUENCY, los valores de frecuencia se dejan sin modificar.

UPDATE MINIMUM cambios-mínimos
Número mínimo de cambios permitidos en los documentos de texto antes de que el índice se actualice de forma incremental. Si no especifica la palabra clave UPDATE MINIMUM, el valor no se modificará.

Tenga en cuenta que sólo podrá cambiar UPDATE MINIMUM si no ha creado el índice utilizando la opción RECREATE ON UPDATE.

COMMITCOUNT FOR UPDATE número total
Para el proceso de actualizaciones, puede especificar un número total de confirmaciones. Vea UPDATE INDEX para obtener más información. Esto se aplica tanto al mandato UPDATE como a la especificación UPDATE FREQUENCY, que planifica el proceso de actualización.

Tenga en cuenta que sólo podrá cambiar COMMITCOUNT si no ha creado el índice utilizando la opción RECREATE ON UPDATE.

Tenga en cuenta también que no podrá cambiar COMMITCOUNT si ha creado el índice con la cláusula REPLICATION.

CONNECT TO nombre-basedatos
Nombre de la base de datos que es el destino de este mandato. Puede omitir este parámetro si DB2DBDFT está establecido y el usuario está ejecutando el mandato en el servidor. Tenga en cuenta que el ID de usuario debe tener las autorizaciones necesarias de DB2.

USER id-usuario USING contraseña
Utilice una contraseña y un ID de usuario para conectarse a la base de datos. Si no se especifica, se intentará realizar una conexión a partir del ID de usuario actual sin contraseña.

Uso

El mandato no se podrá emitir si se está ejecutando uno de los mandatos siguientes sobre el índice:

En un entorno DB2 distribuido, sólo se permite un índice de texto con opciones de antememoria en un espacio de tabla de un solo nodo.

Cambios en la base de datos
Cambios en las vistas de catálogo de DB2 Net Search Extender.

Cambios en el sistema de archivos


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