sp_help_fulltext_tables_cursor (Transact-SQL)

Artigo
06/18/2013

Usa um cursor ao retornar uma lista de tabelas que são registradas para indexação de texto completo.

Importante
Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use a nova exibição de catálogo sys.fulltext_indexes em vez disso. Para obter mais informações, consulte sys.fulltext_indexes (Transact-SQL).

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

sp_help_fulltext_tables_cursor [ @cursor_return = ] @cursor_variable OUTPUT 
     [ , [ @fulltext_catalog_name = ] 'fulltext_catalog_name' ] 
     [ , [ @table_name = ] 'table_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, com o padrão de NULL. Se o fulltext_catalog_name for omitido ou for NULL, todas as tabelas indexadas de texto completo serão associadas ao banco de dados retornado. Se o fulltext_catalog_name for especificado, mas o table_name for omitido ou for NULL, as informações de índice de texto completo serão recuperadas para todas as tabelas indexadas de texto completo associadas a esse catálogo. Se o fulltext_catalog_name e o table_name forem especificados, uma linha será retornada se o table_name estiver associado ao fulltext_catalog_name; caso contrário, será gerado um erro.
[ @table_name=] 'table_name'
É o nome de uma ou duas partes da tabela para a qual são solicitados metadados de texto completo. table_name é nvarchar(517), com o valor padrão de NULL. Se for especificado apenas o table_name, será retornada somente a linha relevante ao table_name.

Valores de código de retorno

0 (êxito) ou (1) falha

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
TABLE_OWNER	sysname	Proprietário da tabela. Esse é o nome do usuário de banco de dados que criou a tabela.
TABLE_NAME	sysname	Nome da tabela.
FULLTEXT_KEY_INDEX_NAME	sysname	Índice que impõe a restrição UNIQUE na coluna designada como a coluna de chave exclusiva.
FULLTEXT_KEY_COLID	int	ID de coluna do índice exclusivo identificado por FULLTEXT_KEY_NAME.
FULLTEXT_INDEX_ACTIVE	int	Especifica se as colunas marcadas para indexação de texto completo nessa tabela são elegíveis para consultas: 0 = Inativo 1 = Ativo
FULLTEXT_CATALOG_NAME	sysname	Catálogo de texto completo no qual os dados de índice de texto completo residem.

Permissões

As permissões de execução usam como padrão membros da função pública.

Exemplos

O exemplo a seguir retorna os nomes das tabelas indexadas de texto completo associadas ao catálogo de texto completo Cat_Desc.

USE AdventureWorks;
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