Inserir uma associação definida pelo usuário é semelhante a inserir uma consulta personalizada de SQL. Entretanto, só são inseridos os conteúdos da cláusula WHERE, e não toda a consulta. Ao executar uma associação externa, o Serviço de Integração pode inserir a sintaxe de associação na cláusula WHERE ou na cláusula FROM da consulta, dependendo da sintaxe do banco de dados.

Ao adicionar uma associação definida pelo usuário, a transformação de Qualificador de Origem acrescenta a configuração na consulta de SQL padrão. Todavia, se você modificar a consulta padrão após adicionar uma associação definida pelo usuário, o Serviço de Integração utilizará apenas a consulta definida nas propriedades de Consulta de SQL da transformação de Qualificador de Origem.

É possível utilizar um parâmetro ou uma variável como associação definida pelo usuário ou incluir parâmetros e variáveis na associação. Quando você inclui um parâmetro ou uma variável de mapeamento de string, use um identificador de string que seja apropriado ao sistema de origem. No caso da maiorias dos bancos de dados, é necessário colocar o nome de um parâmetro ou uma variável de string entre aspas simples.

Quando você inclui um parâmetro ou variável de data e hora, talvez seja necessário alterar o formato da data para corresponder ao formato usado pela origem. O Serviço de Integração converte um valor e uma variável de data e hora em uma string com base no sistema de origem.

Para criar uma associação definida pelo usuário: