Compartilhar via

Lição 5-2: Habilitar e configurar as configurações do pacote

  • Artigo

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

Nesta tarefa, você converterá o projeto no Modelo de Implantação de Pacote e habilitará configurações de pacote usando o Assistente de Configuração de Pacotes. Você usará esse assistente para gerar um arquivo de configuração XML que contém definições de configuração da propriedade Directory do contêiner Loop Foreach. O valor da propriedade Directory é fornecido por uma nova variável de nível de pacote que você pode atualizar no tempo de execução. Você também pode preencher uma nova pasta de dados de exemplo para uso em testes.

Crie uma variável em nível de pacote mapeada para a propriedade Directory

  1. Selecione a tela de fundo da guia Fluxo de Controle no Designer do SSIS. Essa seleção define o escopo da variável que você criará para o pacote.

  2. No menu SSIS , selecione Variáveis.

  3. Na janela Variáveis, selecione o ícone Adicionar Variável.

  4. Na caixa Nome, insira varFolderName.

    Importante

    Nomes de variáveis diferenciam maiúsculas e minúsculas.

  5. Verifique se a caixa Escopo mostra o nome do pacote, Lição 5.

  6. Defina o valor da caixa Tipo de Dados da variável varFolderName como Cadeia de Caracteres.

  7. Retorne à guia Fluxo de Controle e clique duas vezes no contêiner Arquivo Foreach na Pasta .

  8. Na página Coleção do Editor de Loop Foreach, selecione Expressões e, em seguida, selecione o botão de reticências (…).

  9. No Editor de Expressões de Propriedades, selecione a lista Propriedade e selecione Directory.

  10. Na caixa Expressão, selecione o botão de reticências (…).

  11. No Construtor de Expressões, expanda a pasta Variáveis e Parâmetros e arraste a variável User::varFolderName até a caixa Expressão.

  12. Selecione OK para sair do Construtor de Expressões.

  13. Selecione OK para sair do Editor de Expressões de Propriedades.

  14. Selecione OK para sair do Editor do Loop Foreach.

Habilitar configurações de pacote

  1. No Menu do Projeto, selecione Converter em Modelo de Implantação de Pacote.

  2. Selecione OK no aviso e, assim que a conversão for concluída, selecione OK na caixa de diálogo Converter em Modelo de Implantação de Pacote.

  3. Selecione a tela de fundo da guia Fluxo de Controle no Designer do SSIS.

  4. No menu SSIS, selecione Configurações do Pacote.

  5. Na caixa de diálogo Organizador de Configurações do Pacote, selecione Habilitar Configurações do Pacote e selecione Adicionar.

  6. Na página inicial do Assistente de Configuração de Pacotes, selecione Avançar.

  7. Na página Selecionar Tipo de Configuração , verifique se o Tipo de configuração está definido como Arquivo de configuração XML.

  8. Na página Selecionar Tipo de Configuração, selecione Procurar.

  9. A caixa de diálogo Selecionar Local do Arquivo de Configuração é aberta para a pasta do projeto.

  10. Na caixa de diálogo Selecionar Local do Arquivo de Configuração, para Nome do arquivo, insira SSISTutorial e selecione Salvar.

  11. Na página Selecionar Tipo de Configuração, selecione Avançar.

  12. Na página Selecionar Propriedades para Exportar, no painel Objetos, expanda Variáveis, varFolderName, Propriedades e selecione Valor.

  13. Na página Selecionar Propriedades para Exportar, selecione Avançar.

  14. Na página Concluindo o Assistente, insira um nome de configuração para a configuração, como Configuração do Diretório de Tutoriais do SSIS. O nome de configuração é exibido na caixa de diálogo Organizador de Configurações do Pacote.

  15. Selecione Concluir.

  16. Selecione Fechar.

  17. O assistente cria um arquivo de configuração, chamado SSISTutorial.dtsConfig, que contém as definições de configuração do Valor da variável que, por sua vez, define a propriedade Directory do enumerador.

    Observação

    Um arquivo de configuração geralmente contém informações complexas sobre as propriedades do pacote, mas, para este tutorial, a única informação de configuração deveria ser a seguinte:

    <Configuration 
    ConfiguredType="Property"  
    Path="\Package.Variables[User::varFolderName].Properties[Value]" 
    ValueType="String">  
  <ConfiguredValue></ConfiguredValue>  
</Configuration>

Criar e popular uma nova pasta de dados de exemplo

  1. No Windows Explorer, no nível de raiz da unidade (por exemplo, C:\), crie uma pasta chamada Novos Dados de Exemplo.

  2. Localize os arquivos de exemplo no computador e copie três dos arquivos da pasta.

  3. Na pasta Novos Dados de Exemplo , cole os arquivos copiados.

Ir para a próxima tarefa

Etapa 3: Modificar o valor de configuração da propriedade Directory