• Artigo

Como mapear parâmetros de consulta para variáveis em uma tarefa Executar SQL

Este tópico descreve como usar uma instrução SQL parametrizada na tarefa Executar SQL e criar mapeamentos entre variáveis e os parâmetros na instrução SQL.

Para obter mais informações sobre a tarefa Executar SQL, os marcadores e os nomes de parâmetros que você usa com tipos de conexões diferentes, consulte Tarefa Executar SQL de SSI e Trabalhando com parâmetros e códigos de retorno na tarefa Executar SQL.

Para mapear um parâmetro de consulta para uma variável

  1. No Business Intelligence Development Studio, abra o pacote do Integration Services com o qual deseja trabalhar.

  2. No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo.

  3. Clique na guia Fluxo de Controle.

  4. Se o pacote ainda não incluir uma tarefa Executar SQL, adicione uma ao fluxo de controle do pacote. Para obter mais informações, consulte Como adicionar ou excluir uma tarefa ou um contêiner em um fluxo de controle.

  5. Clique duas vezes na tarefa Executar SQL.

  6. Forneça um comando SQL parametrizado de um dos seguintes modos:

    • Use a entrada direta e digite o comando SQL na propriedade SQLStatement.

    • Use a entrada direta, clique em Construir Consulta e crie um comando SQL usando as ferramentas gráficas que o Construtor de Consultas fornece.

    • Use uma conexão de arquivo e depois faça referência ao arquivo que contém o comando SQL.

    • Use uma variável e depois faça referência à variável que contém o comando SQL.

    Os marcadores de parâmetros que você usa nas instruções SQL parametrizadas dependem do tipo de conexão que a tarefa Executar SQL usa.

    Tipo de conexão

    Marcador de parâmetro

    ADO

    ?

    ADO.NET e SQLMOBILE

    @<nome_do_parâmetro>

    ODBC

    ?

    EXCEL e OLE DB

    ?

  7. Clique em Mapeamento de Parâmetro.

  8. Para adicionar um mapeamento de parâmetro, clique Adicionar.

  9. Forneça um nome na caixa Nome do Parâmetro.

    Os nomes de parâmetros que você usa dependem do tipo de conexão que a tarefa Executar SQL usa.

    Tipo de conexão

    Nome do parâmetro

    ADO

    Param1, Param2,...

    ADO.NET e SQLMOBILE

    @<nome_do_parâmetro>

    ODBC

    1, 2, 3, …

    EXCEL e OLE DB

    0, 1, 2, 3, …

  10. Na lista Nome da Variável, selecione uma variável. Para obter mais informações, consulte Como adicionar ou excluir uma variável em um pacote usando a janela Variáveis.

  11. Na lista Direção, especifique se o parâmetro é uma entrada, uma saída ou um valor de retorno.

  12. Na lista Tipo de Dados, defina o tipo de dados do parâmetro.

    Observação importanteImportante

    O tipo de dados do parâmetro deve ser compatível com o tipo de dados da variável.

  13. Repita as etapas de 8 a 11 para cada parâmetro na instrução SQL.

    Observação importanteImportante

    A ordem dos mapeamentos de parâmetros deve ser igual à ordem em que os parâmetros aparecem na instrução SQL.

  14. Clique em OK.