sp_help_fulltext_tables_cursor (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL Managed InstanceAnalytics Platform System (PDW)

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 version future de 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 plutôt la nouvelle sys.fulltext_indexes vue catalogue. Pour plus d’informations, consultez sys.fulltext_indexes (Transact-SQL).

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_help_fulltext_tables_cursor
     [ @cursor_return = ] cursor_return OUTPUT
     [ , [ @fulltext_catalog_name = ] N'fulltext_catalog_name' ]
     [ , [ @table_name = ] N'table_name' ]
[ ; ]

Arguments

[ @cursor_return = ] sortie de cursor_return

Variable de sortie du curseur de type. Le curseur est en lecture seule, dynamique et permet les défilements.

[ @fulltext_catalog_name = ] N’fulltext_catalog_name'

Nom du catalogue de texte intégral. @fulltext_catalog_name est sysname, avec la valeur par défaut NULL.

  • Si @fulltext_catalog_name est omis ou est NULL, toutes les tables indexées en texte intégral associées à la base de données sont retournées.

  • Si @fulltext_catalog_name est spécifié, mais que @table_name est omis ou est NULLomis, les informations d’index de recherche en texte intégral sont récupérées pour chaque table indexée en texte intégral associée à ce catalogue.

  • Si @fulltext_catalog_name et @table_name sont spécifiés, une ligne est retournée si @table_name est associée à @fulltext_catalog_name ; sinon, une erreur est générée.

[ @table_name = ] N’table_name'

Nom de la table en une ou deux parties pour laquelle les métadonnées de texte intégral sont demandées. @table_name est nvarchar(517), avec une valeur par défaut de NULL. Si seule @table_name est spécifiée, seule la ligne pertinente pour @table_name est retournée.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

Nom de la 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 UNIQUE contrainte sur la colonne désignée comme colonne clé unique.
FULLTEXT_KEY_COLID int ID de colonne de l’index unique identifié par FULLTEXT_KEY_INDEX_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 .

Exemples

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 AdventureWorks2022;
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

Contenu connexe