Freigeben über

sp_help_fulltext_tables_cursor (Transact-SQL)

  • Artikel

Gilt für: SQL Server Azure SQL Managed Instance Analytics Platform System (PDW)

Verwendet einen Cursor, um eine Liste der Tabellen zurückzugeben, die für die Volltextindizierung registriert sind.

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Verwenden Sie stattdessen die neue sys.fulltext_indexes Katalogansicht. Weitere Informationen finden Sie unter sys.fulltext_indexes.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @cursor_return = ] cursor_return OUTPUT

Die Ausgabevariable des Typcursors. Bei dem Cursor handelt es sich um einen schreibgeschützten, bildlauffähigen, dynamischen Cursor.

[ @fulltext_catalog_name = ] N'fulltext_catalog_name'

Name des Volltextkatalogs. @fulltext_catalog_name ist "sysname" mit der Standardeinstellung "NULL.

  • Wenn @fulltext_catalog_name weggelassen wird oder ist NULL, werden alle volltextindizierten Tabellen zurückgegeben, die der Datenbank zugeordnet sind.

  • Wenn @fulltext_catalog_name angegeben ist, aber @table_name ausgelassen wird oder ist NULL, werden die Volltextindexinformationen für jede volltextindizierte Tabelle abgerufen, die diesem Katalog zugeordnet ist.

  • Wenn sowohl @fulltext_catalog_name als auch @table_name angegeben werden, wird eine Zeile zurückgegeben, wenn @table_name @fulltext_catalog_name zugeordnet ist. Andernfalls wird ein Fehler ausgelöst.

[ @table_name = ] N'table_name'

Der einteilige oder zweiteilige Tabellenname, für den die Volltextmetadaten angefordert werden. @table_name ist nvarchar(517) mit einem Standardwert von NULL. Wenn nur @table_name angegeben wird, wird nur die zeile zurückgegeben, die für @table_name relevant ist.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Spaltenname Datentyp Beschreibung
TABLE_OWNER sysname Tabellenbesitzer. Der Name des Datenbankbenutzers, der die Tabelle erstellt hat.
TABLE_NAME sysname Tabellenname.
FULLTEXT_KEY_INDEX_NAME sysname Index, der die UNIQUE Einschränkung für die Spalte aufzwingt, die als eindeutige Schlüsselspalte festgelegt ist.
FULLTEXT_KEY_COLID int Spalten-ID des eindeutigen Indexes, der durch FULLTEXT_KEY_INDEX_NAME.
FULLTEXT_INDEX_ACTIVE int Gibt an, ob die für die Volltextindizierung markierten Spalten in dieser Tabelle bei Abfragen einbezogen werden sollen:

0 = Inaktiv
1 = Aktiv
FULLTEXT_CATALOG_NAME sysname Volltextkatalog, in dem sich die Volltextindexdaten der Tabelle befinden.

Berechtigungen

Die Ausführungsberechtigungen werden standardmäßig der public -Rolle erteilt.

Beispiele

Im folgenden Beispiel werden die Namen der volltextindizierten Tabellen zurückgegeben, die dem Cat_Desc-Volltextkatalog zugeordnet sind.

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

Zugehöriger Inhalt