Partilhar via


Usar os valores de variáveis e parâmetros em um pacote filho

Este procedimento descreve como criar uma configuração de pacote que usa o tipo de configuração variável pai. Este tipo de configuração habilita um pacote filho que é executado de um pacote pai para acessar uma variável no pai.

Observação

Você também pode passar valores para um pacote filho configurando a tarefa Executar Pacote para mapear as variáveis de pacote pai ou parâmetros, ou parâmetros de projeto, para parâmetros de pacote filho. Para obter mais informações, consulte Execute Package Task.

Não é necessário criar a variável no pacote pai antes de criar a configuração de pacote no pacote filho. É possível adicionar a variável ao pacote pai a qualquer momento, mas será preciso usar o nome exato da variável pai na configuração do pacote. Entretanto, antes de criar uma configuração da variável pai, é preciso que exista uma variável no pacote filho que possa ser atualizada pela configuração. Para obter mais informações sobre como adicionar e configurar variáveis, consulte Adicionar, excluir, alterar o escopo de uma variável definida pelo usuário em um pacote.

O escopo da variável no pacote pai que é usado na configuração da variável pai pode ser definido como a tarefa Executar Pacote, tanto para o contêiner que tenha a tarefa quanto para o pacote. Se várias variáveis tiverem o mesmo nome, será usada a variável que tiver o escopo mais próximo da tarefa Executar Pacote. O escopo mais próximo da tarefa Executar Pacote é a própria tarefa.

Adicionar uma variável a um pacote pai

  1. No SQL Server Data Tools (SSDT), abra o projeto do Integration Services que contém o pacote no qual deseja adicionar uma variável para ser transmitida a um pacote filho.

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

  3. No Designer SSIS , defina o escopo da variável, seguindo uma das ações:

    • Para definir o escopo para o pacote, clique na superfície de design da guia Fluxo de Controle .

    • Para definir o escopo para um contêiner pai da tarefa Executar Pacote, clique no contêiner.

    • Para definir o escopo da tarefa Executar Pacote, clique na tarefa.

  4. Adicione e configure uma variável.

    Observação

    Selecione um tipo de dados que seja compatível com os dados que serão armazenados pela variável.

  5. Para salvar o pacote atualizado, clique em Salvar Itens Selecionados no menu Arquivo .

Adicionar uma variável a um pacote filho

  1. No SQL Server Data Tools (SSDT), abra o projeto do Integration Services que contém o pacote no qual deseja adicionar uma configuração de variável pai.

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

  3. No Designer do SSIS, defina o escopo para o pacote e clique em qualquer lugar da superfície de design da guia Fluxo de Controle.

  4. Adicione e configure uma variável.

    Observação

    Selecione um tipo de dados que seja compatível com os dados que serão armazenados pela variável.

  5. Para salvar o pacote atualizado, clique em Salvar Itens Selecionados no menu Arquivo .

Adicionar uma configuração de pacote pai a um pacote filho

  1. Se ainda não estiver aberto, abra o pacote filho no SSDT (SQL Server Data Tools).

  2. Clique na superfície de design da guia Fluxo de Controle .

  3. No menu SSIS , clique em Configurações do Pacote.

  4. Na caixa de diálogo Organizador de Configurações do Pacote , selecione Ativar configurações do pacotee clique em Adicionar.

  5. Na página de boas-vindas do Assistente de Configuração de Pacotes, clique em Avançar.

  6. Na página Selecionar Tipo de Configuração, na lista Tipo de configuração , selecione Variável do pacote pai e siga um dos seguintes procedimentos:

    • Selecione Especificar as configurações de configuração diretamentee na caixa Variável pai , forneça o nome da variável no pacote pai a ser usado na configuração.

      Importante

      Nomes de variáveis fazem diferenciação de maiúsculas e minúsculas.

    • Selecione O local de configuração está armazenado em uma variável do ambiente e, na lista Variável de ambiente, selecione a variável de ambiente que contém o nome da variável.

  7. Clique em Próximo.

  8. Na página Selecionar Propriedade de Destino, expanda o nó Variável e o nó Propriedades da variável a ser configurada e, em seguida, clique na propriedade que será definida pela configuração.

  9. Clique em Próximo.

  10. Na página Concluindo o Assistente, você pode modificar o nome padrão da configuração e revisar a informações de configuração (opcional).

  11. Clique em Concluir para concluir o assistente e retornar para a caixa de diálogo Organizador de Configurações do Pacote .

  12. Na caixa de diálogo Organizador de Configurações do Pacote , a caixa Configuração lista a nova configuração.

  13. Clique em fechar

Consulte Também

Configurações do Pacote
Criar configurações de pacote
Variáveis do SSIS (Integration Services)
Usar variáveis em pacotes