sp_help_fulltext_catalogs_cursor (Transact-SQL)

  • Artigo

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

Usa um cursor para retornar a ID, o nome, o diretório raiz, o status e o número de tabelas indexadas de 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 desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use a exibição sys.fulltext_catalogs catálogo.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@cursor_return [ = ] cursor_return SAÍDA

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

@fulltext_catalog_name [ = ] N'fulltext_catalog_name'

Nome do catálogo de texto completo. @fulltext_catalog_name é sysname, com um padrão de NULL. Se esse parâmetro for omitido ou for NULL, as informações sobre todos os catálogos de texto completo associados ao banco de dados atual serão retornadas.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

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

0 = Ocioso
1 = População completa em andamento
2 = Pausado
3 = Limitado
4 = Recuperando
5 = Desligamento
6 = População incremental em andamento
7 = Índice de construção
8 = O disco está cheio. Pausada
9 = Controle de alterações
NUMBER_FULLTEXT_TABLES int Número de tabelas de texto completo indexadas associadas ao catálogo.

Permissões

As permissões de execução têm como padrão a função public .

Exemplos

O exemplo a seguir retorna informações sobre o catálogo de texto completo Cat_Desc.

USE AdventureWorks2022;
GO
DECLARE @mycursor CURSOR;
EXEC 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

Conteúdo relacionado