sp_help_fulltext_tables_cursor (Transact-SQL)

Utilise un curseur pour retourner une liste des tables inscrites pour l'indexation de texte intégral.

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez le nouvel affichage catalogue sys.fulltext_indexes à la place. Pour plus d'informations, consultez sys.fulltext_indexes (Transact-SQL).

Icône Lien de rubriqueConventions de la syntaxe Transact-SQL

Syntaxe

sp_help_fulltext_tables_cursor [ @cursor_return = ] @cursor_variable OUTPUT 
     [ , [ @fulltext_catalog_name = ] 'fulltext_catalog_name' ] 
     [ , [ @table_name = ] 'table_name' ]

Arguments

  • [ @cursor_return= ] @cursor_variable OUTPUT
    Variable de sortie de type cursor. Le curseur est en lecture seule, dynamique et autorise les défilements.

  • [ @fulltext_catalog_name= ] 'fulltext_catalog_name'
    Nom du catalogue de texte intégral. fulltext_catalog_name est de type sysname et sa valeur par défaut est NULL. Si fulltext_catalog_name est omis ou a la valeur NULL, toutes les tables indexées sur le texte intégral associées à la base de données sont retournées. Si fulltext_catalog_name est précisé mais que table_name est omis ou a la valeur NULL, les informations sur l'indexation de texte intégral sont récupérées pour chaque table indexées sur le texte intégral associée au catalogue. Si fulltext_catalog_name et table_name sont précisés, une ligne est retournée si table_name est associé à fulltext_catalog_name ; et, dans le cas contraire, un message d'erreur est affiché.

  • [ @table_name=] 'table_name'
    Nom de la table en une ou deux parties pour laquelle les métadonnées de texte intégral sont nécessaires. table_name est de type nvarchar(517) et sa valeur par défaut est NULL. Si seul table_name est précisé, seule la ligne concernant table_name est retournée.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Nom de colonne

Type de données

Description

TABLE_OWNER

sysname

Propriétaire de la table Nom de l'utilisateur de la base de données qui a créé la table.

TABLE_NAME

sysname

Nom de la table

FULLTEXT_KEY_INDEX_NAME

sysname

Index imposant la contrainte UNIQUE dans la colonne désignée comme colonne clé unique.

FULLTEXT_KEY_COLID

int

ID de colonne de l'index unique identifié par FULLTEXT_KEY_NAME.

FULLTEXT_INDEX_ACTIVE

int

Indique si les colonnes de cette table marquées pour l'indexation de texte intégral peuvent faire l'objet de requêtes :

0 = Inactif

1 = Actif

FULLTEXT_CATALOG_NAME

sysname

Catalogue de texte intégral contenant les données d'index sur le texte intégral.

Autorisations

Les autorisations d'exécution reviennent par défaut aux membres du rôle public.

Exemple

Cet exemple retourne le nom des tables indexées sur le texte intégral associées au catalogue de texte intégral Cat_Desc.

USE AdventureWorks2008R2;
GO
DECLARE @mycursor CURSOR;
EXEC sp_help_fulltext_tables_cursor @mycursor OUTPUT, 'Cat_Desc';
FETCH NEXT FROM @mycursor;
WHILE (@@FETCH_STATUS <> -1)
   BEGIN
      FETCH NEXT FROM @mycursor;
   END;
CLOSE @mycursor;
DEALLOCATE @mycursor;
GO