Compartilhar via


Lição 1-4 – adicionar configurações de pacote

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

Nessa tarefa, você adicionará uma configuração a cada pacote. As configurações atualizam os valores das propriedades e dos objetos do pacote em tempo de execução.

Integration Services fornece uma variedade de tipos de configuração. Você pode armazenar configurações em variáveis de ambiente, entradas de Registro, variáveis definidas pelo usuário, tabelas SQL Server e arquivos XML. Para fornecer flexibilidade adicional, o Integration Services oferece suporte ao uso de configurações indiretas. Isso significa que você usa uma variável de ambiente para especificar o local da configuração, que por sua vez especifica os valores reais. Os pacotes no projeto Tutorial de Implantação usam uma combinação de arquivos de configuração XML e configurações indiretas. Um arquivo de configuração XML pode incluir configurações para várias propriedades e, quando apropriado, pode ser mencionado por vários pacotes. Neste tutorial, você usará um arquivo de configuração separado para cada pacote.

Os arquivos de configuração normalmente contêm informações confidenciais, como cadeia de caracteres de conexão. Portanto, você deverá usar uma lista de controle de acesso (ACL) para restringir o acesso ao local ou à pasta em que você armazena os arquivos, e fornecer acesso apenas aos usuários ou contas com permissão para executar pacotes. Para obter mais informações, consulte Acesso aos arquivos usados por pacotes.

Os pacotes (DataTransfer e LoadXMLData) adicionados ao projeto Tutorial de Implantação na tarefa anterior precisam de configurações para serem executados com êxito depois de implantados no servidor de destino. Para implementar configurações, você criará primeiro as configurações indiretas para os arquivos XML e, depois, criará os arquivos de configuração XML.

Serão criados dois arquivos de configuração, DataTransferConfig.dtsConfig e LoadXMLData.dtsConfig. Esses arquivos contêm os pares nome-valor que atualizam as propriedades nos pacotes que especificam o local dos arquivos de dados e de log usados pelo pacote. Depois, como uma etapa no processo de implantação, você atualizará os valores nos arquivos de configuração para refletir o novo local dos arquivos no computador de destino.

Integration Services reconhece que Datatransferconfig.dtsconfig e LoadXMLData.dtsConfig são dependências dos pacotes DataTransfer e LoadXMLData, e automaticamente incluirá os arquivos de configuração quando você criar o pacote de implantação na próxima lição.

Para criar configuração indireta para o pacote DataTransfer

Verifique o modelo de implantação atual do projeto e defina-o como Modelo de Implantação de Pacote, se necessário. No menu Projeto, clique em Converter em Modelo de Implantação de Pacote

  1. No Gerenciador de Soluções, clique duas vezes em DataTransfer.dtsx.

  2. No Designer SSIS , clique em qualquer local no plano de fundo da superfície de design do 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 a opção Habilitar configurações do pacote , se não estiver selecionada, e clique em Adicionar.

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

  6. Na página Selecionar Tipo de Configuração, selecione Arquivo de configuração XML na lista Tipo de configuração , selecione a opção O local de configuração está armazenado em uma variável do ambiente e digite DataTransfer ou selecione a variável de ambiente DataTransfer na lista.

    Observação

    Para disponibilizar a variável de ambiente na lista, talvez você precise reiniciar o computador após a adição da variável. Se você não quiser reiniciar o computador, poderá digitar o nome da variável de ambiente.

  7. Clique em Próximo.

  8. Na página Concluindo o Assistente, digite DataTransfer EV Configuration na caixa Nome da Configuração , revise o conteúdo da configuração no painel Visualização e clique em Concluir.

  9. Feche a caixa de diálogo Organizador de Configurações do Pacote.

Para criar a configuração XML para o pacote DataTransfer

  1. No Gerenciador de Soluções, clique duas vezes em DataTransfer.dtsx.

  2. No Designer SSIS , clique em qualquer local no plano de fundo da superfície de design do fluxo de controle.

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

  4. Na caixa de diálogo do Organizador de Configurações do Pacote, selecione a caixa de seleção Habilitar Configurações do Pacote e clique em Adicionar.

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

  6. Na página Selecionar Tipo de Configuração, selecione Arquivo de configuração XML na lista Tipo de configuração e clique em Procurar.

  7. Na caixa de diálogo Selecionar Local do Arquivo de Configuração , procure C:\DeploymentTutorial, digite DataTransferConfig na caixa Nome do arquivo e clique em Salvar.

  8. Na página Selecionar Tipo de Configuração, clique em Avançar.

  9. Na página Selecionar Propriedades a Serem Exportadas, expanda DataTransfer, Gerenciadores de Conexões, Log do Tutorial de Implantação e Propriedades e marque a caixa de seleção Cadeia de Conexão .

  10. Em Gerenciadores de Conexões, expanda NewCustomers e marque a caixa de seleção Cadeia de Conexão .

  11. Clique em Próximo.

  12. Na página Concluindo o Assistente, digite DataTransfer Configuration na caixa Nome da configuração , revise o conteúdo da configuração e clique em Concluir.

  13. Na caixa de diálogo Organizador de Configurações do Pacote , verifique se a opção DataTransfer EV Configuration é a primeira da lista e DataTransfer Configuration é a segunda da lista. Clique em Fechar.

Para criar configuração indireta para o pacote LoadXMLData

  1. No Gerenciador de Soluções, clique duas vezes em LoadXMLData.dtsx.

  2. No Designer SSIS , clique em qualquer local no plano de fundo da superfície de design do 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, clique em Adicionar.

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

  6. Na página Selecionar Tipo de Configuração, selecione o Arquivo de configuração XML na lista Tipo de configuração , selecione a opção O local de configuração está armazenado em uma variável do ambiente , digite LoadXMLData ou selecione a variável de ambiente LoadXMLData na lista.

    Observação

    Para disponibilizar a variável de ambiente na lista, talvez você precise reiniciar o computador após a adição da variável.

  7. Clique em Próximo.

  8. Na página Concluindo o Assistente, digite LoadXMLData EV Configuration na caixa Nome da configuração , revise o conteúdo da configuração e clique em Concluir.

Para criar a configuração XML para o pacote LoadXMLData

  1. No Gerenciador de Soluções, clique duas vezes em LoadXMLData.dtsx.

  2. No Designer SSIS , clique em qualquer local no plano de fundo da superfície de design do fluxo de controle.

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

  4. Na caixa de diálogo do Organizador de Configurações do Pacote, marque a caixa de seleção Habilitar Configurações do Pacote e clique em Adicionar.

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

  6. Na página Selecionar Tipo de Configuração, selecione Arquivo de configuração XML na lista Tipo de configuração e clique em Procurar.

  7. Na caixa de diálogo Selecionar Local do Arquivo de Configuração , procure C:\DeploymentTutorial, digite LoadXMLDataConfig na caixa Nome do arquivo e clique em Salvar.

  8. Na página Selecionar Tipo de Configuração, clique em Avançar.

  9. Na página Selecionar Propriedades a Serem Exportadas, expanda LoadXMLData, Executáveis, Carregar Dados XML e Propriedades e marque as caixas de seleção [XMLSource].[XMLData] e [XMLSource].[XMLSchemaDefinition] .

  10. Clique em Próximo.

  11. Na página Concluindo o Assistente, digite LoadXMLData Configuration na caixa Nome da configuração , revise o conteúdo da configuração e clique em Concluir.

  12. Na caixa de diálogo Organizador de Configurações do Pacote , verifique se a opção LoadXMLData EV Configuration é a primeira da lista e LoadXMLData Configuration é a segunda da lista e clique em Fechar.

Próxima tarefa da lição

Etapa 5: Testar os pacotes atualizados

Consulte Também

Configurações do Pacote
Criar configurações de pacote
Acesso aos arquivos usados por pacotes