ALTER FULLTEXT CATALOG (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Cambia las propiedades de un catálogo de texto completo.

Convenciones de sintaxis de Transact-SQL

Sintaxis

ALTER FULLTEXT CATALOG catalog_name   
{ REBUILD [ WITH ACCENT_SENSITIVITY = { ON | OFF } ]  
| REORGANIZE  
| AS DEFAULT   
}

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

catalog_name
Especifica el nombre del catálogo que se va a modificar. Si no existe un catálogo con el nombre especificado, Microsoft SQL Server devuelve un error y no realiza la operación ALTER.

REBUILD
Indica a SQL Server que vuelva a generar todo el catálogo. Cuando vuelve a generarse un catálogo, el catálogo existente se elimina y se crea uno nuevo en su lugar. Todas las tablas que tienen referencias de índices de texto completo se asocian al catálogo nuevo. La regeneración restablece los metadatos de texto completo de las tablas del sistema de la base de datos.

WITH ACCENT_SENSITIVITY = {ON|OFF}
Especifica si el catálogo que se va a modificar distingue o no los acentos para la indización y las consultas de texto completo.

Para determinar la configuración de la propiedad de distinción de acentos actual de un catálogo de texto completo, use la función FULLTEXTCATALOGPROPERTY con el valor de propiedad accentsensitivity en catalog_name. Si la función devuelve '1', el catálogo de texto completo distingue acentos; si la función devuelve '0', el catálogo no distingue acentos.

La distinción de acentos predeterminada para el catálogo y la base de datos es la misma.

REORGANIZE
Indica a SQL Server que realice una combinación maestra, que combina en un índice mayor los índices más pequeños creados en el proceso de indización. La combinación de los fragmentos de índices de texto completo puede mejorar el rendimiento y liberar recursos de disco y memoria. Si se realizan cambios frecuentes en el catálogo de texto completo, utilice este comando de manera periódica para reorganizarlo.

REORGANIZE también optimiza la estructura interna de los índices y del catálogo.

Tenga en cuenta que, en función de la cantidad de datos indizados, una combinación maestra puede llevar cierto tiempo. La combinación maestra de una cantidad grande de datos puede crear una transacción de larga duración, con lo que se retrasa el truncamiento del registro de transacciones durante el punto de comprobación. En este caso, el registro de transacciones podría crecer significativamente bajo el modelo de recuperación completa. Como práctica recomendada, asegúrese de que su registro de transacciones contenga el espacio suficiente para una transacción de larga duración antes de reorganizar un índice de texto completo grande en una base de datos que use el modelo de recuperación completa. Para obtener más información, vea Administrar el tamaño del archivo de registro de transacciones.

AS DEFAULT
Especifica que este catálogo es el predeterminado. Cuando se crean índices de texto completo sin especificar catálogos, se utiliza el catálogo predeterminado. Si hay un catálogo de texto completo predeterminado, al establecer este catálogo como AS DEFAULT, se invalidará el catálogo predeterminado existente.

Permisos

El usuario debe tener el permiso ALTER en el catálogo de texto completo o ser un miembro de los roles fijos de base de datos db_owner o db_ddladmin, o del rol fijo de servidor sysadmin.

Nota

Para utilizar ALTER FULLTEXT CATALOG AS DEFAULT, el usuario debe disponer del permiso ALTER en el catálogo de texto completo y del permiso CREATE FULLTEXT CATALOG en la base datos.

Ejemplos

En el ejemplo siguiente se cambia la propiedad accentsensitivity del catálogo de texto completo predeterminado ftCatalog, que hace distinción de acentos.

--Change to accent insensitive  
USE AdventureWorks2022;  
GO  
ALTER FULLTEXT CATALOG ftCatalog   
REBUILD WITH ACCENT_SENSITIVITY=OFF;  
GO  
-- Check Accentsensitivity  
SELECT FULLTEXTCATALOGPROPERTY('ftCatalog', 'accentsensitivity');  
GO  
--Returned 0, which means the catalog is not accent sensitive.

Vea también

sys.fulltext_catalogs (Transact-SQL)
CREATE FULLTEXT CATALOG (Transact-SQL)
DROP FULLTEXT CATALOG (Transact-SQL)
Búsqueda de texto completo