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.
>>-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
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.
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.
Los formatos de documentos soportados para los documentos estructurados son:
Los documentos que tienen el formato ASCII_SECTIONS no pueden contener secciones anidadas. (Para obtener información acerca de las secciones anidadas, consulte el apartado Trabajar con documentos estructurados (soporte de secciones).) El código inicial para una sección finaliza en el siguiente código inicial.
Se proporciona un archivo de modelos de documentos para los documentos HTML. Contiene un subconjunto de las definiciones HTML estándar, que el usuario puede modificar si es necesario. Los documentos HTML contienen secciones anidadas.
El proceso de documentos XML incluye la evaluación de la Definición de tipo de documento (DTD). El modelo asignado al documento se comprueba con la DTD. Si los códigos definidos en el archivo de modelos de documentos no están definidos en la DTD, no se indexa el documento. Si no se ha definido ningún modelo para una DTD reconocida, el documento no se indexará. Los documentos XML pueden contener secciones anidadas.
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.
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.
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,
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. |
Estos valores de frecuencia de actualización se pasan por alto si ya se han establecido para toda la tabla por ENABLE TEXT TABLE.
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.
Si no especifica esta palabra clave, se toma el valor de los valores de configuración del texto.
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. |