Partilhar via


sp_help_fulltext_catalogs_cursor (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada SQL do Azure

Utiliza um cursor para devolver o ID, nome, diretório raiz, estado e número de tabelas indexadas em texto completo para o catálogo de texto completo especificado.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Use antes a vista de catálogo sys.fulltext_catalogs .

Transact-SQL convenções de sintaxe

Sintaxe

sp_help_fulltext_catalogs_cursor
    [ @cursor_return = ] cursor_return OUTPUT
    [ , [ @fulltext_catalog_name = ] N'fulltext_catalog_name' ]
[ ; ]

Arguments

[ @cursor_return = ] cursor_return SAÍDA

@cursor_return é um parâmetro OUTPUT do tipo int. O cursor é um cursor dinâmico, apenas de leitura e deslizável.

[ @fulltext_catalog_name = ] N'fulltext_catalog_name'

O nome do catálogo de texto completo. @fulltext_catalog_name é sysname, com um padrão de NULL. Se este parâmetro for omitido ou for NULL, é devolvida informação sobre todos os catálogos de texto completo associados à base de dados atual.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nome da coluna Tipo de dados Description
fulltext_catalog_id smallint Identificador de catálogo em texto completo.
NAME sysname Nome do catálogo do texto completo.
PATH nvarchar(260) Esta cláusula não tem efeito.
STATUS int Estado da população do índice em texto completo do catálogo:

0 = Ocioso
1 = População total em curso
2 = Pauso
3 = Limitado
4 = Recuperação
5 = Encerramento
6 = População incremental em curso
7 = Índice de edifícios
8 = Disco cheio. Em pausa
9 = Acompanhamento de alterações
NUMBER_FULLTEXT_TABLES int Número de tabelas indexadas em texto completo associadas ao catálogo.

Permissions

As permissões de execução passam por defeito ao papel público .

Examples

O exemplo seguinte devolve informações sobre o Cat_Desc catálogo de texto completo.

USE AdventureWorks2022;
GO

DECLARE @mycursor AS CURSOR;

EXECUTE sp_help_fulltext_catalogs_cursor @mycursor OUTPUT, 'Cat_Desc';

FETCH NEXT FROM @mycursor;

WHILE (@@FETCH_STATUS <> -1)
    BEGIN
        FETCH NEXT FROM @mycursor;
    END

CLOSE @mycursor;

DEALLOCATE @mycursor;
GO