Documentation
(C) IBM Corp. 1996, 2000

DB2 Text Extender Administración y programación

ENABLE TEXT COLUMN

Este mandato habilita una columna de texto para que DB2 Text Extender la utilice.

Autorización

Debe tener como mínimo uno de los siguientes privilegios para la tabla:

Privilegio ALTER

Privilegio SELECT

Privilegio UPDATE.

Sintaxis del mandato

>>-ENABLE TEXT COLUMN--nombre-tabla--nombre-columna-texto------->
 
>-----+---------------------------+----------------------------->
      '-FUNCTION--nombre-función--'
 
>----HANDLE--nombre-columna-descriptores-contexto--------------->
 
>-----+------------------------+-------------------------------->
      '-| información-texto |--'
 
>-----+-----------------------------+--------------------------->
      '-| características-índice |--'
 
>-----+----------------------------+---------------------------->
      '-UPDATEINDEX--+-UPDATE---+--'
                     '-NOUPDATE-'
 
>-----+-----------------------------------+--------------------->
      '-TABLESPACE--nombre-espacio-tabla--'
 
>-----+----------------------+---------------------------------><
      '-COMMITCOUNT--cuenta--'
 
información-texto
 
|---+---------------+---+-------------------+------------------->
    '-CCSID--ccsid--'   '-LANGUAGE--idioma--'
 
>-----+------------------+--------------------------------------|
      '-FORMAT--formato--'
 
características-índice
 
|---+------------+---+-PRECISE----+----------------------------->
    '-INDEXTYPE--'   +-LINGUISTIC-+
                     '-NGRAM------'
 
>-----+--------------------------------+------------------------>
      '-INDEXOPTION--+-CASE_ENABLED-+--'
                     '-NORMALIZED---'
 
>-----+-----------------------------------------------------------------------------+>
      |                                                          .-,---------.      |
      |                                                          V           |      |
      '-INDEXPROPERTY--SECTIONS_ENABLED--+-DOCUMENTMODEL--+---(-----modelo---+---)--'
                                         '-DOCUMENTMODELS-'
 
>-----+------------------------------------------------+-------->
      '-UPDATEFREQ--+-NONE--------------------------+--'
                    '-| frecuencia-actualización |--'
 
>-----+--------------------------------------------------------------------------------+>
      +-DIRECTORY--directorio----------------------------------------------------------+
      |  .---------------------------------------------------------------------------. |
      |  |                                           .-,---------------------.       | |
      |  V                                           V                       |       | |
      '----DIRECTORY--directorio--ON--+-NODE--+---(-----nodo--+-----------+--+---)---+-'
                                      '-NODES-'               '-TO--nodo--'
 
>---------------------------------------------------------------|
 
frecuencia-actualización
 
|---MIN--(--docsmín--)--D---(--+-*------------+---)---H--------->
                               |  .-,-------. |
                               |  V         | |
                               '----0...6---+-'
 
                                       .-,---------.
                                       V           |
>----(--+-*-------------+---)---M---(-----0...59---+---)--------|
        |  .-,--------. |
        |  V          | |
        '----0...23---+-'
 

Parámetros del mandato

nombre-tabla
El nombre de la tabla de texto de la base de datos conectada que contiene la columna que se ha de habilitar. El nombre debe incluir un nombre de esquema explícito (calificador) a menos que el nombre de esquema sea el mismo que el ID de usuario.

nombre-columna-texto
El nombre de la columna que se ha de habilitar para que DB2 Text Extender la utilice. Esta columna debe ser de tipo CHAR, VARCHAR, LONG VARCHAR, CLOB, DBCLOB, GRAPHIC, VARGRAPHIC o LONG VARGRAPHIC. Si el tipo de documento no es ninguno de estos, utilice FUNCTION para convertir el tipo de documento.

FUNCTION

nombre-función

El nombre de una función definida por el usuario que DB2 Text Extender utilizará para acceder a los documentos de texto que están en la columna que no es de tipo CHAR, VARCHAR, LONG VARCHAR, CLOB, DBCLOB, GRAPHIC, VARGRAPHIC ni LONG VARGRAPHIC. Consulte el apartado Habilitación de columnas de texto de un tipo de datos no soportado para obtener más información.

HANDLE nombre-columna-descriptores-contexto
El nombre de la columna de descriptores de contexto que se ha de añadir a la tabla para que la utilicen las funciones de DB2 Text Extender.

CCSID ccsid
El identificador de juego de caracteres codificado que se ha de utilizar al indexar documentos de texto.

Si especifica un CCSID al habilitar una columna de texto para un índice Ngram, el CCSID debe ser el mismo CCSID de la base de datos y el CCSID utilizado durante la búsqueda (el CCSID de la base de datos ) debe coincidir con este CCSID.

Para buscar el CCSID por omisión, utilice:

db2tx get text cfg

El valor por omisión de instalación es el CCSID de la base de datos .

Si no se especifica esta palabra clave, se utiliza el CCSID especificado en los valores de configuración del texto. Los cambios posteriores en los valores de configuración del texto se pasan por alto; el valor utilizado es el que existía en el momento en que se ha habilitado la columna, no el que existe cuando se indexan los documentos de texto.

Para obtener información acerca de otros CCSID que pueden soportarse, consulte el apartado CCSID.

LANGUAGE idioma
El idioma en el que está escrito el texto. Esto determina el diccionario que se va a utilizar al indexar los documentos de texto y al buscar en los documentos de texto. El Capítulo 15, Proceso lingüístico para los índices lingüístico y exacto describe cómo se utilizan los diccionarios.

Esta palabra clave especifica el idioma una vez para toda la columna. Puede alterar temporalmente este valor para los documentos de texto insertados individualmente utilizando la función INIT_TEXT_HANDLE en una sentencia INSERT.

Si no se especifica esta palabra clave, se utiliza el idioma especificado en los valores de configuración de texto. Los cambios posteriores en los valores de configuración del texto se pasan por alto; el valor utilizado es el que existía en el momento en que se ha habilitado la columna, no el que existe cuando se indexan los documentos de texto.

Los idiomas soportados se listan en la Tabla 5.

FORMAT

formato

El tipo de documento de texto almacenado, como, por ejemplo WordPerfect o ASCII. DB2 Text Extender necesita esta información para indexar los documentos. Los formatos de documento soportados se listan en el apartado Formatos de documentos que se soportan.

Los formatos de documentos soportados para los documentos estructurados son:

Para estos formatos, debe especificar la información de estructura en un archivo de modelos de documentos. Consulte el apartado Trabajar con documentos estructurados (soporte de secciones). Si se especifican los formatos TDS e INDEXPROPERTY SECTION_ENABLED, se supone que el formato del documento es ASCII_SECTIONS.

Los identificadores que no están definidos en el archivo de modelos se indexan de manera normal, de acuerdo al tipo de índice.

Esta palabra clave especifica el formato una vez para toda la columna. Puede alterar temporalmente este valor para los documentos de texto insertados individualmente utilizando la función INIT_TEXT_HANDLE en una sentencia INSERT.

Si no se especifica esta palabra clave, se utiliza el formato especificado en los valores de configuración del texto. Los cambios posteriores en los valores de configuración del texto se pasan por alto; el valor utilizado es el que existía en el momento en que se ha habilitado la columna, no el que existe cuando se indexan los documentos de texto.

INDEXTYPE
El tipo de índice que se ha de crear. Para obtener más información, consulte el apartado Tipos de búsqueda.

PRECISE
Los términos se indexan y se buscan exactamente tal como aparecen en los documentos de texto.

LINGUISTIC
Los términos se procesan lingüísticamente antes de indexarse. También se procesan lingüísticamente los términos de búsqueda antes de que empiece la búsqueda.

NGRAM
Los términos se indexan analizando los juegos de caracteres en lugar de utilizar un diccionario. Este tipo de índice es obligatorio si los documentos que está indexando contienen caracteres DBCS, aunque también se puede utilizar un índice Ngram para documentos SBCS.

Si no especifica la palabra clave INDEXTYPE, se utiliza el valor de los valores de configuración del texto.

No se da soporte a los documentos en formato XML para índices Ngram.

INDEXOPTION
Las opciones que se han de utilizar al crear el índice.

CASE_ENABLED
Esta opción está disponible únicamente para índices Ngram. Normalmente, los índices Ngram no permiten una búsqueda sensible a las mayúsculas y minúsculas. Con la especificación de CASE_ENABLED, asegura que los documentos se indexen de modo que sea posible una búsqueda sensible a las mayúsculas y minúsculas. Para obtener más información, consulte el apartado Efectuar una búsqueda similar o una búsqueda en documentos DBCS.

NORMALIZED
Esta opción está disponible únicamente para índices exactos. Un índice exacto normalizado difiere de un índice exacto en que:
  • No es sensible a las mayúsculas y minúsculas; todas las palabras, excepto las que están completamente en mayúsculas, se convierten a minúsculas.
  • Las palabras escritas con todas las letras en mayúsculas no son objeto de filtro de palabra de parada; por ejemplo, se indexa la abreviatura UK.
  • Los términos de búsqueda del idioma inglés se pueden ampliar para que incluyan formatos de lemas que utilizan un algoritmo heurístico, de modo que la búsqueda de house también busque houses.

INDEXPROPERTY SECTIONS_ENABLED DOCUMENTMODEL(S) modelo
Propiedades de un tipo de índice seleccionado.

SECTIONS_ENABLED especifica que el tipo de índice seleccionado puede contener información acerca de la estructura de documentos.

DOCUMENTMODEL/DOCUMENTMODELS modelo especifica el modelo o modelos que se han de asociar como valor por omisión para los documentos que se han de indexar. Debe especificarse un nombre de modelo si se utiliza la propiedad de índice SECTIONS_ENABLED. Si se especifica una lista de modelos, se utiliza el primer modelo como modelo por omisión para el índice. El modelo por omisión se utiliza durante la indexación si el documento no hace ninguna referencia a un modelo o si no se especifica ningún modelo durante la búsqueda.

Los caracteres que pueden utilizarse para el nombre de modelo son a-z, A-Z y 0-9.

El nombre de modelo especificado debe corresponder a una definición de modelo del archivo de definiciones de modelos desmodel.ini.

Para cambiar el modelo o modelos asociados a un índice,

  1. Utilice DISABLE TEXT COLUMN para inhabilitar el índice
  2. Utilice ENABLE TEXT COLUMN para volver a indexar los documentos, especificando nombres de modelos de documentos diferentes.

UPDATEFREQ frecuencia-actualización
La frecuencia de actualización del índice en función de cuándo se ha de realizar la actualización y del número mínimo de documentos de texto que deben estar en cola en la tabla de registro cronológico. Si no hay suficientes documentos de texto en la tabla de registro cronológico en el día y la hora dadas, el índice no se actualiza.

La sintaxis se describe en el apartado Actualización de un índice.

Si no especifica UPDATEFREQ, se utiliza la frecuencia por omisión especificada en los valores de configuración del texto.
Consejo

Si tiene muchas tablas, considere la posibilidad de evitar la utilización de los valores por omisión. Creando valores de frecuencia de actualización individuales para las tablas puede evitar la indexación simultánea de todas las tablas que provoca una carga prolongada innecesaria en los recursos del sistema.

NONE
No se realizan más actualizaciones de índice. Está pensado para una columna de texto en la que no habrán más cambios.

Estos valores de frecuencia de actualización se pasan por alto si ya se han establecido para toda la tabla por ENABLE TEXT TABLE.

DIRECTORY directorio
La vía de acceso del directorio en el que se ha de almacenar el índice de texto. La vía de acceso especificada se concatena con ""txinsnnn" donde nnn es el número de nodo.

Se trata de un directorio del sistema en el que se ejecuta el servidor DB2 Text Extender. Si todavía no existe el directorio, se crea. Si ya existe, asegúrese en las plataformas UNIX que el directorio tenga permisos de lectura/grabación para el propietario de la instancia y compruebe el 'ID de usuario con barreras' si se ha especificado uno diferente del especificado cuando se ha creado la instancia de DB2.

Si no especifica la palabra clave DIRECTORY, se utiliza el valor de DIRECTORY de los valores de configuración del texto.

Este valor se pasa por alto si ya se ha establecido para toda la tabla por ENABLE TEXT TABLE.

Si está utilizando bases de datos particionadas, puede especificar un nombre de vía de acceso del índice común para todos los nodos o para un rango de nodos, o vías de acceso de directorios de índices diferentes para cada nodo.

ON NODE nodo [TO nodo]
El número del nodo o del rango de nodos al que se está asignando el nombre de vía de acceso del directorio.

UPDATEINDEX
Una palabra clave que determina si los documentos de texto asociados a esta columna de descriptores de contexto se indexan inmediatamente después de que se haya completado este mandato, sin esperar a la próxima indexación periódica establecida por UPDATEFREQ.

UPDATE
La indexación de los documentos de texto se produce inmediatamente después de que se haya completado este mandato.

NOUPDATE
La indexación se produce en un momento establecido por los valores de frecuencia de actualización especificados en este mandato por UPDATEFREQ o por el valor de configuración del texto.

Si no especifica esta palabra clave, se toma el valor de los valores de configuración del texto.

TABLESPACE nombre-espacio-tabla
El nombre del espacio de tabla para el índice que se crea internamente en la columna de descriptores de contexto. El espacio de tabla debe haberse creado previamente.

COMMITCOUNT cuenta
Un valor de 500 a 1 000 000 que indica el número de inserciones o actualizaciones después de las cuales DB2 debe emitir una sentencia de compromiso intermedia. Esto puede evitar una situación en la que no haya suficiente espacio de registro cronológico al habilitar tablas o columnas grandes o un gran número de archivos externos.

Notas del uso

Este mandato añade una columna de descriptores de contexto a la tabla DB2 especificada. Cada columna de descriptores de contexto se asocia a una columna de texto y la utilizan las funciones de DB2 Text Extender.

Si aún no se ha habilitado esta tabla para crear un índice común, se crea un índice que está asociado a esta columna de texto.

También, se crea una tabla de registro cronológico en la base de datos. La tabla de registro cronológico se utiliza para registrar los cambios en la columna de texto, es decir, las inserciones, las actualizaciones y las supresiones. Se definen desencadenantes de inserción, actualización y supresión para la columna de texto para mantener actualizada automáticamente la tabla de registro cronológico.

Si la columna de texto que está habilitando pertenece a una tabla que forma parte de un grupo de nodos de múltiples nodos, el directorio de índices que especifique debe estar disponible en todos los nodos físicos. Si utiliza el directorio por omisión especificado en la configuración del texto, asegúrese de que la vía de acceso esté disponible en todos los nodos del grupo de nodos. Si no es conveniente, puede especificar una vía de acceso específica para cada nodo en el mandato ENABLE TEXT COLUMN.

Si cambia la configuración de los nodos de un grupo de nodos que contiene una tabla que está habilitada para DB2 Text Extender, debe volver a indexar la tabla.
Consejo

Si se queda sin espacio de registro cronológico en este paso, consulte el apartado Habilitación de una columna de texto en una tabla grande para ver las posibles soluciones.


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