CREATE FULLTEXT CATALOG (Transact-SQL)

  • Artículo

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance

Crea un catálogo de texto completo para una base de datos. Un catálogo de texto completo puede tener varios índices de texto completo, pero un índice de texto completo solo puede pertenecer a un catálogo de texto completo. Cada base de datos puede contener varios catálogos de texto completo o ninguno.

No es posible crear catálogos de texto completo en las bases de datos master, model o tempdb.

Importante

A partir de SQL Server 2008 (10.0.x), un catálogo de texto completo es un objeto virtual y no pertenece a ningún grupo de archivos. Un catálogo de texto completo es un concepto lógico que hace referencia a un grupo de índices de texto completo.

Convenciones de sintaxis de Transact-SQL

Sintaxis

  
CREATE FULLTEXT CATALOG catalog_name  
     [ON FILEGROUP filegroup ]  
     [IN PATH 'rootpath']  
     [WITH <catalog_option>]  
     [AS DEFAULT]  
     [AUTHORIZATION owner_name ]  
  
<catalog_option>::=  
     ACCENT_SENSITIVITY = {ON|OFF}

Argumentos

catalog_name

Es el nombre del catálogo nuevo. El nombre del catálogo debe ser único en la base de datos actual. El nombre del archivo que corresponde al catálogo de texto completo (vea ON FILEGROUP) también debe ser único en la base de datos. Si la base de datos ya contiene un catálogo con el mismo nombre, SQL Server generará un error.

La longitud del nombre del catálogo no puede superar los 120 caracteres.

ON FILEGROUP filegroup
A partir de SQL Server 2008 (10.0.x), esta cláusula no tiene ningún efecto.

IN PATH 'rootpath'

Nota:

Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

A partir de SQL Server 2008 (10.0.x), esta cláusula no tiene ningún efecto.

ACCENT_SENSITIVITY = {ON|OFF}
Especifica si el catálogo distingue los acentos para la indización de texto completo. Cuando se cambia esta propiedad, el índice debe volver a crearse. La opción predeterminada es utilizar la distinción de acentos que se haya especificado en la intercalación de base de datos. Para mostrar la intercalación de base de datos, use la vista de catálogo sys.databases.

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 el valor devuelto es '1', el catálogo de texto completo distingue acentos; si el valor es '0', el catálogo no distingue acentos.

AS DEFAULT
Especifica que el catálogo es el predeterminado. Cuando se crean índices de texto completo sin especificar de forma explícita un catálogo de texto completo, se utiliza el catálogo predeterminado. Si un catálogo de texto completo existente ya se ha marcado como AS DEFAULT, configurar este nuevo catálogo como AS DEFAULT lo convertirá en el catálogo de texto completo predeterminado.

AUTHORIZATION owner_name
Establece el propietario del catálogo de texto completo en el nombre de un usuario o un rol de base de datos. Si owner_name es un rol, debe ser el nombre de un rol al que pertenezca el usuario actual, o bien el usuario que ejecute la instrucción debe ser el propietario de la base de datos o el administrador del sistema.

Si owner_name es un nombre de usuario, debe ser uno de los siguientes:

  • El nombre del usuario que ejecuta la instrucción.

  • El nombre de un usuario para el que el usuario que está ejecutando el comando tiene permisos de suplantación.

  • O bien, el usuario que ejecuta el comando debe ser el propietario de la base de datos o el administrador del sistema.

owner_name también debe tener el permiso TAKE OWNERSHIP en el catálogo de texto completo especificado.

Comentarios

Los identificadores de los catálogos de texto completo comienzan por 00005 y se incrementan en uno con cada catálogo nuevo que se crea.

Permisos

El usuario debe tener el permiso CREATE FULLTEXT CATALOG en la base de datos o ser miembro de los roles fijos de base de datos db_owner o db_ddladmin.

Ejemplos

En el ejemplo siguiente se crea un catálogo de texto completo y un índice de texto completo.

USE AdventureWorks2022;  
GO  
CREATE FULLTEXT CATALOG ftCatalog AS DEFAULT;  
GO  
CREATE FULLTEXT INDEX ON HumanResources.JobCandidate(Resume) KEY INDEX PK_JobCandidate_JobCandidateID;  
GO

Vea también