Transformação Mapas de Caracteres

  • Artigo

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

A transformação Mapa de Caracteres aplica funções de cadeia de caracteres, como a conversão de letra minúscula em maiúscula, em dados de caracteres. Essa transformação funciona apenas em dados de coluna com um tipo de dados de cadeia de caracteres.

A transformação Mapa de Caracteres pode converter dados de coluna existentes ou adicionar uma coluna à saída de transformação e colocar os dados convertidos na coluna nova. Você pode aplicar conjuntos diferentes de operações de mapeamento na mesma coluna de entrada e colocar os resultados em colunas diferentes. Por exemplo, é possível converter a mesma coluna em maiúsculas e minúsculas e colocar os resultados em duas colunas diferentes.

O mapeamento pode, em algumas circunstâncias, fazer com que os dados fiquem truncados. Por exemplo, o truncamento pode acontecer quando caracteres de byte único são mapeados para caracteres com representação de vários bytes. A transformação Mapa de Caracteres inclui uma saída de erro, que pode ser usada para direcionar dados truncados para uma saída separada. Para obter mais informações, consulte Tratamento de erros em dados.

Essa transformação tem uma entrada, uma saída e uma saída de erro.

Mapeando operações

A tabela a seguir descreve as operações de mapeamento suportadas pela transformação Mapa de Caracteres.

Operação Descrição
Inversão de bytes Inverte a ordem de bytes.
Largura inteira Mapeia caracteres de meia largura para caracteres de largura inteira.
Meia largura Mapeia caracteres de largura inteira para caracteres de meia largura.
Hiragana Mapeia caracteres katakana para caracteres hiragana.
Katakana Mapeia caracteres hiragana para caracteres katakana.
Caixas linguísticas Aplica caixas linguísticas em vez de regras do sistema. As caixas linguísticas se referem à funcionalidade fornecida pela API do Win32 para mapeamento de maiúsculas/minúsculas simples de Unicode de idiomas turcomanos e de outras localidades.
Letras minúsculas Converte caracteres em minúsculas.
Chinês simplificado Mapeia caracteres de chinês tradicional para caracteres de chinês simplificado.
Chinês tradicional Mapeia caracteres de chinês simplificado para caracteres de chinês tradicional.
Letras Maiúsculas Converte caracteres em maiúsculas.

Operações de mapeamento mutuamente exclusivas

Mais de uma operação pode ser executada em uma transformação. Entretanto, algumas operações de mapeamento são mutuamente exclusivas. A tabela a seguir relaciona restrições que se aplicam quando você usa várias operações na mesma coluna. As operações nas colunas Operação A e Operação B são mutuamente exclusivas.

Operação A Operação B
Letras minúsculas Letras Maiúsculas
Hiragana Katakana
Meia largura Largura inteira
Chinês tradicional Chinês simplificado
Letras minúsculas Hiragana, katakana, meia largura, largura inteira
Letras Maiúsculas Hiragana, katakana, meia largura, largura inteira

Configuração da transformação Mapa de Caracteres

Você pode configurar a transformação Mapa de Caracteres das seguintes formas:

  • Especificando as colunas a serem convertidas.

  • Especificando as operações a serem aplicadas em cada coluna.

Você pode definir propriedades pelo Designer do SSIS ou programaticamente.

A caixa de diálogo Editor Avançado reflete as propriedades que podem ser definidas 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 propriedades, clique em um dos seguintes tópicos:

Editor de Transformação Mapas de Caracteres

Use a caixa de diálogo Editor de Transformação Mapas de Caracteres para selecionar as funções de cadeia de caracteres a serem aplicadas aos dados de coluna, bem como para especificar se o mapeamento é uma alteração in-loco ou se deve ser adicionado como uma nova coluna.

Opções

Colunas de Entrada Disponíveis
Use as caixas de seleção para selecionar as colunas a transformar, utilizando funções de cadeia de caracteres. Suas seleções aparecem na tabela abaixo.

Coluna de Entrada
Exibir colunas de entrada selecionadas na tabela acima. Você também pode alterar ou remover uma seleção, por meio da lista de colunas de entrada disponíveis.

Destino
Especifique entre salvar os resultados das operações de cadeia de caracteres no local, usando a coluna existente, ou salvar os dados modificados como uma nova coluna.

Valor Descrição
Nova coluna Salve os dados em uma nova coluna. Atribua o nome de coluna em Alias de Saída.
Alteração no local Salve os dados modificados na coluna existente.

Operação
Selecione na lista as funções de cadeia de caracteres a aplicar aos dados da coluna.

Valor Descrição
Letras minúsculas Converter para letras minúsculas.
Letras Maiúsculas Converter para letras maiúsculas.
Inversão de bytes Converter invertendo a ordem de bytes.
Hiragana Converter caracteres japoneses de katakana em hiragana.
Katakana Converter caracteres japoneses de hiragana em katakana.
Meia largura Converter caracteres de largura inteira em meia largura.
Largura inteira Converter caracteres de meia largura em largura inteira.
Caixas linguísticas Aplicar regras linguísticas de maiúsculas e minúsculas (mapeamento simples de maiúsculas e minúsculas Unicode para a Turquia e outras localidades), em vez das regras do sistema.
Chinês simplificado Converter caracteres do chinês tradicional em caracteres do chinês simplificado.
Chinês tradicional Converter caracteres do chinês simplificado em caracteres do chinês tradicional.

Alias de Saída
Digite um alias para cada coluna de saída. O padrão é Copiar de seguido do nome da coluna de entrada; 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 opções de tratamento de erro para esta transformação.