Como perguntar sobre a coluna de chave de texto completo (Transact-SQL)
Normalmente, o resultado de funções com valor de conjunto de linhas CONTAINSTABLE ou FREETEXTTABLE precisam ser unidas à tabela base. Nesses casos, você precisa saber o nome da coluna de chave exclusiva. Você pode perguntar se um dado índice exclusivo é usado como chave de texto completo e pode obter o identificador da coluna de chave de texto completo.
Para perguntar se um dado índice de texto completo é usado como a coluna de chave de texto completo
Use uma instrução SELECT para chamar a função INDEXPROPERTY. Na chamada de função, use a função OBJECT_ID para converter o nome da tabela (nome_da_tabela) na ID de tabela, especifique o nome de um índice exclusivo para a tabela e especifique a propriedade de índice IsFulltextKey da seguinte maneira:
SELECT INDEXPROPERTY( OBJECT_ID('table_name'), 'index_name', 'IsFulltextKey' );Esta instrução retornará 1 se o índice for usado para impor a exclusividade da coluna de chave de texto completo e 0 se não impor.
Para obter mais informações, consulte Exemplo A, mais adiante neste tópico.
Para encontrar o identificador da coluna de chave de texto completo
Cada tabela habilitada para texto completo tem uma coluna que é usada para impor linhas exclusivas da tabela (a coluna de chaveexclusiva). A propriedade TableFulltextKeyColumn, obtida da função OBJECTPROPERTYEX, contém a ID de coluna da coluna de chave exclusiva.
Para obter esse identificador, você pode usar uma instrução SELECT para chamar a função OBJECTPROPERTYEX. Use a função OBJECT_ID para converter o nome da tabela (nome_da_tabela) na ID de tabela e especifique a propriedade TableFulltextKeyColumn da seguinte maneira:
SELECT OBJECTPROPERTYEX(OBJECT_ID( 'table_name'), 'TableFulltextKeyColumn' ) AS 'Column Identifier';Para obter mais informações, consulte os exemplos “B. Obtendo o identificador da coluna de chave de texto completo” e “C. Obtendo o nome da coluna de chave exclusiva”, mais adiante neste tópico.
Exemplo
Todos os exemplos a seguir usam a tabela Document do banco de dados AdventureWorks. Para obter informações sobre esta tabela, consulte Tabela Document (AdventureWorks).
A. Perguntando se um dado índice de texto completo é usado como a coluna de chave de texto completo
O exemplo a seguir pergunta se o índice PK_Document_DocumentID é usado para impor a exclusividade da coluna de chave de texto completo, da seguinte maneira:
USE AdventureWorks
GO
SELECT INDEXPROPERTY ( OBJECT_ID('Production.Document'), 'PK_Document_DocumentID', 'IsFulltextKey' )
Este exemplo retornará 1 se o índice PK_Document_DocumentID for usado para impor a exclusividade da coluna de chave de texto completo. Caso contrário, retornará 0 ou NULL. NULL implica que você esteja usando um nome de índice inválido, que o nome de índice não corresponde à tabela, que a tabela não existe, e assim por diante.
B. Obtendo o identificador da coluna de chave de texto completo
O próximo exemplo retorna o identificador da coluna de chave de texto completo ou NULL. NULL implica que você esteja usando um nome de índice inválido, que o nome de índice não corresponde à tabela, que a tabela não existe, e assim por diante.
USE AdventureWorks;
GO
SELECT OBJECTPROPERTYEX(OBJECT_ID('Production.Document'), 'TableFulltextKeyColumn');
GO
C. Obtendo o nome da coluna de chave exclusiva
O exemplo a seguir mostra como usar o identificador da coluna de chave exclusiva para obter seu nome programaticamente.
USE AdventureWorks;
GO
DECLARE @key_column sysname
SET @key_column = Col_Name(Object_Id('Production.Document'),
ObjectProperty(Object_id('Production.Document'),
'TableFulltextKeyColumn')
)
SELECT @key_column AS 'Unique Key Column';
GO
Este exemplo retorna um conjunto de resultados chamado Unique Key Column, que exibe uma única linha contendo o nome da coluna de chave exclusiva da tabela Document, DocumentID. Observe que, se esta consulta continha um nome de índice inválido, se o nome de índice não correspondia à tabela, se a tabela não existia etc., será retornado NULL.