Compartilhar via


Adicionar, excluir, alterar o escopo de uma variável definida pelo usuário em um pacote

Estes procedimentos descrevem como adicionar, excluir e alterar o escopo de uma variável definida pelo usuário em um pacote usando a janela Variáveis.

Para obter mais informações sobre escopo variável, consulte Variáveis do SSIS (Integration Services).

O Integration Services também fornece variáveis do sistema que disponibilizam informações sobre o sistema em tempo de execução e podem ser usadas em contêineres como pacotes e manipuladores de eventos. Você não pode excluir as variáveis de sistema.

Para adicionar uma variável

  1. No SSDT (SQL Server Data Tools), 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. 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 a um manipulador de eventos, selecione um executável e um manipulador de eventos na superfície de design da guia Manipulador de Eventos.

    • Para definir o escopo para uma tarefa ou contêiner, na superfície de design da guia Fluxo de Controle ou Manipulador de Eventos, clique na tarefa ou no contêiner.

  4. No menu SSIS, clique em Variáveis. Além disso, você pode exibir a janela Variáveis mapeando o comando Exibir Variáveis em uma combinação de teclas de sua escolha na página Teclado da caixa de diálogo Opções.

  5. Na janela Variáveis, clique no ícone Adicionar Variável. A nova variável é adicionada à lista.

  6. Se desejar, clique no ícone Opções de Grade, selecione as colunas adicionais a serem exibidas na caixa de diálogo Opções de Grade Variáveis e clique em OK.

  7. Como opção, define as propriedades de variáveis. Para obter mais informações, consulte Definir as propriedades de uma variável definida pelo usuário.

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

Para excluir uma variável

  1. No SSDT (SQL Server Data Tools), abra o projeto do Integration Services que contém o pacote desejado.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no pacote para abri-lo.

  3. No menu SSIS, clique em Variáveis. Além disso, você pode exibir a janela Variáveis mapeando o comando Exibir Variáveis em uma combinação de teclas de sua escolha na página Teclado da caixa de diálogo Opções.

  4. Selecione a variável a ser excluída e clique em Excluir Variável.

    Se você não vir a variável na janela Variáveis, clique em Opções de Grade e selecione Mostrar variáveis de todos os escopos.

  5. Se a caixa de diálogo Confirmar Exclusão de Variáveis abrir, clique em Sim para confirmar.

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

Para alterar o escopo de uma variável

  1. No SSDT (SQL Server Data Tools), abra o projeto do Integration Services que contém o pacote desejado.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no pacote para abri-lo.

  3. No menu SSIS, clique em Variáveis. Além disso, você pode exibir a janela Variáveis mapeando o comando Exibir Variáveis em uma combinação de teclas de sua escolha na página Teclado da caixa de diálogo Opções.

  4. Selecione a variável e clique em Mover Variável.

    Se você não vir a variável na janela Variáveis, clique em Opções de Grade e selecione Mostrar variáveis de todos os escopos.

  5. Na caixa de diálogo Selecionar Novo Escopo, selecione o pacote ou um contêiner, tarefa ou manipulador de eventos no pacote, para alterar o escopo variável.

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

Consulte também

Tarefas

Usar variáveis em pacotes

Definir as propriedades de uma variável definida pelo usuário

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

Conceitos

Variáveis do SSIS (Integration Services)