共用方式為


sp_help_fulltext_columns_cursor (Transact-SQL)

適用於:SQL Server

使用數據指標傳回針對全文檢索索引所指定的數據行。

重要

SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 請改用 sys.fulltext_index_columns 目錄檢視。

Transact-SQL 語法慣例

語法

sp_help_fulltext_columns_cursor
    [ @cursor_return = ] cursor_return OUTPUT
    [ , [ @table_name = ] N'table_name' ]
    [ , [ @column_name = ] N'column_name' ]
[ ; ]

引數

[ @cursor_return = ] cursor_return OUTPUT

@cursor_return是 int 類型的 OUTPUT 參數。產生的數據指標是唯讀、可捲動的動態數據指標。

[ @table_name = ] N'table_name'

要求全文檢索索引資訊的一或兩部分數據表名稱。 @table_name為 nvarchar(517),預設值為 NULL

如果 省略@table_name ,則會針對每個全文檢索索引數據表擷取全文檢索索引數據行資訊。

[ @column_name = ] N'column_name'

需要全文檢索索引元數據的數據行名稱。 @column_name為 sysname,預設值為 NULL。 如果省略@column_name或 為 NULL,則會針對@table_name的每個全文檢索索引數據行傳回全文檢索數據行資訊。

如果 同時省略 @table_name 或為 NULL,則會針對資料庫中所有數據表的每個全文檢索索引數據行傳回全文檢索索引數據行資訊。

傳回碼值

0 (成功) 或 1 (失敗)。

結果集

資料行名稱 資料類型 描述
TABLE_OWNER sysname 數據表擁有者。 擁有者是建立數據表的資料庫用戶名稱。
TABLE_ID int 數據表的識別碼。
TABLE_NAME sysname 資料表名稱。
FULLTEXT_COLUMN_NAME sysname 指定索引編製索引之全文檢索數據表中的數據行。
FULLTEXT_COLID int 全文檢索索引數據行的數據行標識碼。
FULLTEXT_BLOBTP_COLNAME sysname 全文檢索索引數據表中的數據行,指定全文檢索索引數據行的檔類型。 只有在全文檢索索引數據行是 varbinary(max)image 數據行時,才適用此值。
FULLTEXT_BLOBTP_COLID int 檔類型數據行的數據行標識碼。 只有在全文檢索索引數據行是 varbinary(max)image 數據行時,才適用此值。
FULLTEXT_LANGUAGE sysname 用於數據行全文搜索的語言。

權限

執行許可權預設為公用角色的成員

範例

下列範例會傳回資料庫中所有數據表中針對全文檢索索引所指定之數據行的相關信息。

USE AdventureWorks2022;
GO
DECLARE @mycursor CURSOR;
EXEC sp_help_fulltext_columns_cursor @mycursor OUTPUT
FETCH NEXT FROM @mycursor;
WHILE (@@FETCH_STATUS <> -1)
   BEGIN
      FETCH NEXT FROM @mycursor;
   END;
CLOSE @mycursor;
DEALLOCATE @mycursor;
GO