transformação Pesquisa de Termos
Aplica-se a: 
SQL Server SSIS Integration Runtime no Azure Data Factory
A transformação Pesquisa de Termo corresponde termos extraídos de texto em uma coluna de entrada de transformação com termos em uma tabela de referência. Ela conta o número de vezes em que um termo na tabela de pesquisa ocorre no conjunto de dados de entrada e grava a contagem junto com o termo da tabela de referência nas colunas na saída de transformação. Essa transformação é útil para criar uma lista de palavras personalizada com base no texto de entrada, completa com estatísticas de frequência de palavras.
Antes de a transformação pesquisa de termos executar uma pesquisa, ela extrai palavras do texto em uma coluna de entrada usando o mesmo método da transformação extração de termos:
O texto é dividido em sentenças.
As sentenças são divididas em palavras.
As palavras são normalizadas.
Para personalizar ainda mais quais os termos a corresponder, a transformação pesquisa de termos pode ser configurada para executar uma correspondência com diferenciação de maiúsculas e minúsculas.
Correspondências
A pesquisa de termos executa uma pesquisa e retorna um valor usando as regras a seguir:
Se a transformação estiver configurada para executar correspondências com diferenciação de maiúsculas e minúsculas, as correspondências que apresentarem falha na comparação com diferenciação de maiúsculas e minúsculas serão descartadas. Por exemplo, estudante e ESTUDANTE serão tratadas como palavras diferentes.
Observação
Uma palavra sem inicial em maiúscula pode corresponder a uma palavra que tenha a inicial em maiúscula por estar no início de uma sentença. Por exemplo, a correspondência entre estudante e Estudante obterá êxito quando Estudante for a primeira palavra em um sentença.
Se uma forma plural do substantivo ou locução nominal existir na tabela de referência, a pesquisa corresponderá apenas à forma plural do substantivo ou locução nominal. Por exemplo, todas as ocorrências de estudantes seriam contadas separadamente das ocorrências de estudante.
Se apenas a forma singular da palavra for achada na tabela de referência, tanto a forma singular quanto a plural da palavra ou locução corresponderão à forma singular. Por exemplo, se a tabela de pesquisa contiver estudantee a transformação achar as palavras estudante e estudantes, ambas as palavras seriam contadas como correspondentes ao termo de pesquisa estudante.
Se o texto na coluna de entrada for uma locução nominal lematizada, só a última palavra na locução nominal será afetada pela normalização. Por exemplo, a versão lematizada de consultas de médicos é consulta de médicos.
Quando um item de pesquisa contém termos que se sobrepõem no conjunto de referência, isto é, um subtermo é achado em mais de um registro de referência, a transformação pesquisa de termos só retorna um resultado de pesquisa. O exemplo a seguir mostra o resultado quando um item de pesquisa contém um subtermo sobreposto. O subtermo sobreposto nesse caso é Windows, que é achado dentro de dois termos de referência. Porém, a transformação não retorna dois resultados, mas apenas um único termo de referência: Windows. O segundo termo de referência, Windows 7 Professionalnão é retornado.
| Item | Valor |
|---|---|
| Termo de entrada | Windows 7 Professional |
| Termos de referência | Windows, Windows 7 Professional |
| Saída | Windows |
A transformação pesquisa de termos pode corresponder substantivos e locuções nominais que contenham caracteres especiais e os dados na tabela de referência podem incluir esses caracteres. Os caracteres especiais são os seguintes: %, @, &, $, #, *, :, ;, ., , , !, ?, <, >, +, =, ^, ~, |, \, /, (, ), [, ], {, }, " e '.
Tipos de dados
A transformação pesquisa de termos só pode usar uma coluna que tenha tipo de dados DT_WSTR ou DT_NTEXT. Se uma coluna contiver texto, mas não tiver um desses tipos de dados, a transformação Conversão de Dados poderá adicionar uma coluna com tipo de dados DT_WSTR ou DT_NTEXT para o fluxo de dados e copiar os valores da coluna para a coluna nova. A saída da transformação Conversão de Dados pode ser usada, então, como entrada para a transformação pesquisa de termos. Para obter mais informações, consulte Data Conversion Transformation.
Configuração da transformação Pesquisa de Termo
As colunas de entrada da transformação Pesquisa de Termo incluem a propriedade InputColumnType, que indica o uso da coluna. InputColumnType pode conter os valores a seguir:
O valor 0 indica que a coluna só é transmitida para a saída e não é usada na pesquisa.
O valor 1 indica que a coluna só é usada na pesquisa.
O valor 2 indica que a coluna é transmitida para a saída e também é usada na pesquisa.
As colunas de saída da transformação cuja propriedade InputColumnType é definida como 0 ou 2 incluem a propriedade CustomLineageID para uma coluna, que contém o identificador de linhagem atribuído à coluna por um componente de fluxo de dados upstream.
A transformação Pesquisa de Termos adiciona duas colunas à saída da transformação; por padrão elas são nomeadas como Term e Frequency. A colunaTerm contém um termo da tabela de pesquisa e a Frequency contém o número de vezes que o termo na tabela de referência ocorre no conjunto de dados de entrada. Essas colunas não incluem a propriedade CustomLineageID.
A tabela de pesquisa deve ser uma tabela em um banco de dados do SQL Server ou do Access. Se a saída da transformação extração de termos for salva em uma tabela, esta tabela poderá ser usada como tabela de referência, mas outras tabelas também poderão ser usadas. Texto em arquivos simples, pastas de trabalho do Excel ou outras fontes precisam ser importadas em um banco de dados do SQL Server ou em um banco de dados do Access antes de você poder usar a transformação pesquisa de termos.
A transformação pesquisa de termos usa uma conexão OLE DB separada para conectar-se à tabela de referência. Para obter mais informações, consulte OLE DB Connection Manager.
A transformação pesquisa de termos funciona em um modo totalmente pré-armazenado em cache. No tempo de execução, a transformação pesquisa de termos lê os termos da tabela de referência e os armazena em sua memória privada antes de processar qualquer linha de entrada de transformação.
Como os termos em uma linha de coluna de entrada podem se repetir, a saída da transformação pesquisa de termos geralmente tem mais linhas que a entrada da transformação.
A transformação tem uma entrada e uma saída. Ela não oferece suporte a saídas de erro.
Você pode definir propriedades pelo Designer do SSIS ou programaticamente.
Para obter mais informações sobre as propriedades que podem ser definidas na caixa de diálogo Editor Avançado ou programaticamente, clique em um dos seguintes tópicos:
Para obter mais informações sobre como definir as propriedades, consulte Definir as propriedades de um componente de fluxo de dados.
Editor de Transformação Pesquisa de Termos (guia Pesquisa de Termos)
Use a guia Pesquisa de Termos na caixa de diálogo Editor de Transformação Pesquisa de Termos para mapear uma coluna de entrada para uma coluna de pesquisa em uma tabela de referência e fornecer um alias para cada coluna de saída.
Opções
Colunas de Entrada Disponíveis
Usando as caixas de seleção, selecione colunas de entrada para passar para a saída inalteradas. Arraste uma coluna de entrada para a lista Colunas de Referência Disponíveis para mapeá-la para uma coluna de pesquisa na tabela de referência. As colunas de entrada e de pesquisa devem ter tipos de dados correspondentes e que tenham suporte no DT_NTEXT ou DT_WSTR. Selecione uma linha de mapeamento e clique com o botão direito do mouse para editar os mapeamentos na caixa de diálogo Criar Relações .
Colunas de Referência Disponíveis
Exiba as colunas disponíveis na tabela de referência. Escolha a coluna que contém a lista de termos a corresponder.
Coluna de Passagem
Selecione na lista de colunas de entrada disponíveis. As seleções se refletem naquelas da caixa de seleção da tabela Colunas de Entrada Disponíveis .
Alias de Coluna de Saída
Digite um alias para cada coluna de saída. O padrão é o nome da coluna; no entanto, é possível escolher qualquer nome descritivo exclusivo.
Configurar Saída de Erro
Use a caixa de diálogo Configurar Saída de Erro para especificar as opções de tratamento de erro em linhas que causam erros.
Editor de Transformação Pesquisa de Termos (guia Tabela de Referência)
Use a guia Tabela de Referência da caixa de diálogo Editor de Transformação Pesquisa de Termos para especificar a conexão com a tabela de referência (pesquisa).
Opções
Gerenciador de conexões OLE DB
Selecione um gerenciador de conexões existente na lista ou crie uma nova conexão clicando em Nova.
Novo
Crie uma nova conexão usando a caixa de diálogo Configurar Gerenciador de Conexões OLE DB .
Nome da tabela de referência
Selecione uma tabela de pesquisa ou exibição do banco de dados, selecionando um item da lista. A tabela ou exibição deve conter uma coluna com uma lista existente de termos com os quais o texto na coluna de origem possa ser comparado.
Configurar Saída de Erro
Use a caixa de diálogo Configurar Saída de Erro para especificar as opções de tratamento de erro em linhas que causam erros.
Editor de Transformação Pesquisa de Termos (guia Avançado)
Use a guia Avançado da caixa de diálogo Editor de Transformação Pesquisa de Termos para especificar se a pesquisa deve diferenciar maiúsculas e minúsculas.
Opções
Usar pesquisa de termos com diferenciação de maiúsculas e minúsculas
Indique se a pesquisa diferencia maiúsculas e minúsculas. O padrão é False.
Configurar Saída de Erro
Use a caixa de diálogo Configurar Saída de Erro para especificar as opções de tratamento de erro em linhas que causam erros.
Consulte Também
Referência de mensagens e erros do Integration Services
Transformação Extração de Termos