sp_help_fulltext_catalogs_cursor (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstâ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 o modo de exibição de catálogo sys.fulltext_catalogs .

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_help_fulltext_catalogs_cursor [ @cursor_return= ] @cursor_variable OUTPUT ,   
     [ @fulltext_catalog_name = ] 'fulltext_catalog_name'

Argumentos

[ @cursor_return = ] @cursor_variable OUTPUT É a variável de saída do tipo cursor. O cursor é somente leitura, rolável e dinâmico.

[ @fulltext_catalog_name = ] 'fulltext_catalog_name' É o nome do catálogo de texto completo. fulltext_catalog_name é sysname. Se este parâmetro for omitido ou for NULL, serão retornadas informações sobre todos os catálogos de texto completo associados ao banco de dados atual.

Valores do código de retorno

0 (êxito) ou (1) falha

Conjuntos de resultados

Nome da coluna Tipo de dados Descrição
fulltext_catalog_id smallint Identificador do catálogo de texto completo.
NOME sysname Nome do catálogo de texto completo.
PATH nvarchar(260) A partir do SQL Server 2008 (10.0.x), essa cláusula não tem nenhum efeito.
ESTADO int Status de população do índice de texto completo do catálogo:

0 = Ocioso

1 = População completa em andamento

2 = Pausado

3 = Acelerado

4 = Recuperando

5 = Desligado

6 = População incremental em andamento

7 = Construindo índice

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

Confira também

FULLTEXTCATALOGPROPERTY (Transact-SQL)
sp_fulltext_catalog (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)