sp_help_fulltext_tables_cursor (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure Analytics Platform System (PDW)

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 SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use o novo sys.fulltext_indexes modo de exibição de catálogo. Para obter mais informações, consulte sys.fulltext_indexes.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_help_fulltext_tables_cursor
     [ @cursor_return = ] cursor_return OUTPUT
     [ , [ @fulltext_catalog_name = ] N'fulltext_catalog_name' ]
     [ , [ @table_name = ] N'table_name' ]
[ ; ]

Argumentos

@cursor_return [ = ] cursor_return SAÍDA

A variável de saída do tipo cursor. O cursor é somente leitura, rolável e dinâmico.

@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 @fulltext_catalog_name for omitido ou for NULL, todas as tabelas indexadas de texto completo associadas ao banco de dados serão retornadas.

  • Se @fulltext_catalog_name for especificado, mas @table_name for omitido ou for NULL, as informações de índice de texto completo serão recuperadas para cada tabela indexada de texto completo associada a esse catálogo.

  • Se @fulltext_catalog_name e @table_name forem especificados, uma linha será retornada se @table_name estiver associada a @fulltext_catalog_name; caso contrário, um erro será gerado.

[ @table_name = ] N'table_name'

O nome da tabela de uma ou duas partes para o qual os metadados de texto completo são solicitados. @table_name é nvarchar(517), com um valor padrão de NULL. Se apenas @table_name for especificado, somente a linha relevante para @table_name será retornada.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto 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 UNIQUE restrição na coluna designada como a coluna de chave exclusiva.
FULLTEXT_KEY_COLID int ID da coluna do índice exclusivo identificado por FULLTEXT_KEY_INDEX_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 AdventureWorks2022;
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

Conteúdo relacionado