Partilhar via

Implantação de pacote herdado (SSIS)

  • Artigo

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

O SQL Server Integration Services inclui ferramentas e assistentes que simplificam a implantação de pacotes do computador de desenvolvimento para o servidor de produção ou para outros computadores.

Há quatro etapas no processo de implantação de pacotes:

  1. A primeira etapa é opcional e envolve a criação de configurações de pacote que atualizam as propriedades dos elementos de pacote em tempo de execução. As configurações são incluídas automaticamente quando se implantam os pacotes.

  2. A segunda etapa é compilar o projeto do Integration Services para criar um utilitário de implantação de pacote. O utilitário de implantação para o projeto contém os pacotes que você quer implantar

  3. A terceira etapa é copiar a pasta de implantação que foi criada quando você desenvolveu o projeto do Integration Services para o computador de destino.

  4. A quarta etapa é executar no computador de destino o Assistente de Instalação de Pacotes para instalar os pacotes no sistema de arquivos ou em uma instância do SQL Server.

Configurações do Pacote

O SQL Server Integration Services fornece configurações de pacote que podem ser usadas para atualizar os valores das propriedades em tempo de execução.

Observação

As configurações estão disponíveis para o modelo de implantação de pacote. Os parâmetros são usados no lugar das configurações para o modelo de implantação de projeto. O modelo de implantação de projeto permite que você implante projetos do Integration Services no servidor do Integration Services. Para obter mais informações sobre os modelos de implantação, consulte Deployment of Projects and Packages.

Uma configuração é um par propriedade/valor que você adiciona a um pacote concluído. Normalmente, você cria propriedades de definição de pacote nos objetos do pacote durante o desenvolvimento do pacote e, depois, adiciona as configurações ao pacote. Quando o pacote é executado, obtém os novos valores da propriedade da configuração. Por exemplo, ao usar uma configuração, você pode alterar a cadeia de caracteres de conexão de um gerenciador de conexões ou atualizar o valor de uma variável.

As configurações de pacote fornecem os seguintes benefícios:

  • As configurações facilitam a movimentação dos pacotes de um ambiente de desenvolvimento para um ambiente de produção. Por exemplo, uma configuração pode atualizar o caminho de um arquivo de origem, ou alterar o nome de um banco de dados ou de um servidor.

  • As configurações são úteis quando você implanta pacotes em muitos servidores diferentes. Por exemplo, uma variável na configuração de cada pacote implantado pode conter um valor de espaço de disco diferente e, se o espaço em disco disponível não atingir esse valor, o pacote não será executado.

  • As configurações tornam os pacotes mais flexíveis. Por exemplo, uma configuração pode atualizar o valor de uma variável usada em uma expressão de propriedade.

O Integration Services oferece suporte a vários métodos diferentes de armazenamento de configurações de pacote, como arquivos XML, tabelas em um banco de dados do SQL Server e variáveis de ambiente e pacote.

Cada configuração é um par propriedade/valor. O arquivo de configuração XML e os tipos de configuração do SQL Server podem incluir várias configurações.

As configurações são incluídas quando você cria um utilitário de desenvolvimento de pacote para instalar pacotes. Quando você instala os pacotes, as configurações podem ser atualizadas como uma etapa na instalação de pacotes.

Compreendendo como as configurações de pacote são aplicadas em tempo de execução

Quando você usa o utilitário do prompt de comando dtexec para executar um pacote implantado, o utilitário aplica as configurações do pacote duas vezes. O utilitário aplica configurações antes e depois de aplicar as opções que você especificou na linha de comando.

Como o utilitário carrega e executa o pacote, os eventos ocorrem na seguinte ordem:

  1. O utilitário dtexec carrega o pacote.

  2. O utilitário aplica as configurações que foram especificadas no pacote em tempo de design e na ordem especificada no pacote. (A única exceção a isso são as configurações de Variáveis de Pacote Pai. O utilitário aplica essas configurações apenas uma vez e posteriormente no processo.)

  3. Em seguida, o utilitário aplica qualquer opção que você especificou na linha de comando.

  4. O utilitário recarrega as configurações que foram especificadas no pacote em tempo de design e na ordem especificada no pacote. (Novamente, a exceção a essa regra são as configurações de Variáveis do Pacote Pai). O utilitário usa qualquer opção de linha de comando que foi especificada para recarregar as configurações. Portanto, valores diferentes podem ser recarregados a partir de locais distintos.

  5. O utilitário aplica as configurações Variáveis do Pacote Pai.

  6. O utilitário executa o pacote.

O modo como o utilitário dtexec aplica as configurações afeta as seguintes opções da linha de comando:

  • Você pode usar a opção /Connection ou /Set na execução para carregar as configurações do pacote por meio de um local diferente do especificado no design.

  • É possível usar a opção /ConfigFile para carregar as configurações adicionais não especificadas em tempo de design.

Porém, essas opções de linha de comando têm algumas restrições:

  • Não é possível usar as opções /Set ou /Connection para substituir os valores únicos que também são definidos por uma configuração.

  • Não é possível usar a opção /ConfigFile para carregar configurações que substituem as configurações especificadas em tempo de design.

Para obter mais informações sobre essas opções e sobre como o comportamento delas difere entre o SQL Server 2019 Integration Services (SSIS) e versões anteriores, confira Alterações de comportamento dos recursos do Integration Services no SQL Server 2016.

Tipos de configuração de pacotes

A tabela a seguir descreve os tipos de configuração de pacotes.

Type Descrição
Arquivo de configuração XML Um arquivo XML contém as configurações. O arquivo XML pode incluir várias configurações.
Variável de ambiente Uma variável de ambiente contém a configuração.
Entrada de Registro Uma entrada de Registro contém a configuração.
Variável de pacote pai Uma variável no pacote contém a configuração. Normalmente, esse tipo de configuração é usado para atualizar as propriedades em pacotes filho.
Tabela do SQL Server Uma tabela em um banco de dados do SQL Server que contém a configuração. A tabela pode incluir várias configurações.

Arquivos de configuração XML

Se você selecionar o tipo de configuração arquivo de configuração XML , poderá criar um novo arquivo de configuração, reutilizar um arquivo existente e adicionar configurações novas ou reutilizar um arquivo existente, mas substituir o conteúdo do arquivo.

Um arquivo de configuração XML inclui duas seções:

  • Um título que contém informações sobre o arquivo de configuração. Esse elemento inclui atributos tais como quando o arquivo foi criado e o nome da pessoa que gerou o arquivo.

  • Elementos de configuração que contêm informações sobre cada configuração. Esse elemento inclui atributos como o caminho da propriedade e o valor configurado de uma propriedade.

O código XML a seguir mostra a sintaxe de um arquivo de configuração XML. Esse exemplo mostra uma configuração para a propriedade Value de uma variável de inteiro chamada MyVar.

\<?xml version="1.0"?>  
<DTSConfiguration>  
   <DTSConfigurationHeading>  
      <DTSConfigurationFileInfo  
          GeneratedBy="DomainName\UserName"  
          GeneratedFromPackageName="Package"  
          GeneratedFromPackageID="{2AF06766-817A-4E28-9878-0DE37A150648}"  
          GeneratedDate="2/01/2005 5:58:09 PM"/>  
   </DTSConfigurationHeading>  
   <Configuration ConfiguredType="Property" Path="\Package.Variables[User::MyVar].Value" ValueType="Int32">  
      <ConfiguredValue>0</ConfiguredValue>  
   </Configuration>  
</DTSConfiguration>

Entrada de Registro

Se deseja usar uma entrada de Registro para armazenar a configuração, você pode usar uma chave existente ou criar uma em HKEY_CURRENT_USER. A chave do Registro que você usa deve ter um valor denominado Value. O valor pode ser um DWORD ou uma cadeia de caracteres.

Se você selecionar o tipo de configuração Entrada de Registro, digitará o nome da chave do Registro na caixa de entrada de Registro. O formato é <chave do Registro>. Se deseja usar uma chave do Registro que não está na raiz de HKEY_CURRENT_USER, use o formato <Registry key\registry key\...> para identificar a chave. Por exemplo, para usar a chave MyPackage localizada em SSISPackages, digite SSISPackages\MyPackage.

SQL Server

Se você selecionar o tipo de configuração SQL Server, especifique a conexão para o banco de dados do SQL Server em que deseja armazenar as configurações. Você pode salvar as configurações em uma tabela existente ou criar uma tabela no banco de dados especificado.

A instrução SQL a seguir mostra a instrução padrão CREATE TABLE fornecida pelo Assistente de Configuração de Pacotes.

CREATE TABLE [dbo].[SSIS Configurations]  
(  
ConfigurationFilter NVARCHAR(255) NOT NULL,  
ConfiguredValue NVARCHAR(255) NULL,  
PackagePath NVARCHAR(255) NOT NULL,  
ConfiguredValueType NVARCHAR(20) NOT NULL  
)

O nome fornecido para a configuração é o valor armazenado na coluna ConfigurationFilter .

Configurações diretas e indiretas

O Integration Services fornece configurações diretas e indiretas. Se você especificar as configurações diretamente, o Integration Services criará um vínculo direto entre o item de configuração e a propriedade de objeto do pacote. As configurações diretas são a melhor escolha quando o local da origem não é alterado. Por exemplo, se você tiver certeza de que todas as implantações no pacote usam o mesmo caminho de arquivo, poderá especificar um arquivo de configuração XML.

As configurações indiretas usam variáveis de ambiente. Em vez de especificar os parâmetros de configuração diretamente, a configuração aponta para uma variável de ambiente que, por sua vez, contém o valor da configuração. O uso de configurações indiretas é a escolha mais adequada quando o local da configuração pode ser alterado em cada implantação de um pacote.

Criar configurações de pacote

Crie as configurações do pacote por meio da caixa de diálogo Organizador de Configurações de Pacote e do Assistente de Configuração de Pacote. Para acessar essas ferramentas, selecione Configurações do Pacote no menu SSIS em SSDT (SQL Server Data Tools).

Observação

Você também pode acessar o Organizador de Configurações de Pacote clicando no botão de reticências ao lado da propriedade Configuração . A propriedade Configuração aparece na janela de propriedades para o pacote.

As configurações estão disponíveis para o modelo de implantação de pacote. Os parâmetros são usados no lugar das configurações para o modelo de implantação de projeto. O modelo de implantação de projeto permite que você implante projetos do Integration Services no servidor do Integration Services. Para obter mais informações sobre os modelos de implantação, consulte Deployment of Projects and Packages.

Na caixa de diálogo Organizador de Configurações do Pacote , você pode habilitar pacotes para usar configurações, adicionar e excluir configurações e definir a ordem de preferência para carregar as configurações.

Quando as configurações de pacote são carregadas na ordem preferencial, elas são carregadas da parte superior da lista mostrada na caixa de diálogo Organizador de Configurações do Pacote até a parte inferior da lista. Porém, no tempo de execução, talvez as configurações do pacote não sejam carregadas na ordem preferencial. Em particular, as configurações do pacote pai são carregadas depois das configurações de outros tipos.

Se várias configurações definirem a mesma propriedade de objeto, o valor carregado por último será usado no tempo de execução.

Na caixa de diálogo Organizador de Configurações do Pacote , você executa o Assistente de Configuração de Pacotes, que o guia através de etapas para criar uma configuração. Para executar o Assistente de Configuração de Pacotes, adicione uma nova configuração na caixa de diálogo Organizador de Configurações do Pacote ou edite uma existente. Nas páginas do assistente, você escolhe o tipo de configuração, escolhe se quer acessar a configuração diretamente ou usar variáveis de ambiente, e seleciona as propriedades a serem salvas na configuração.

O seguinte exemplo mostra as propriedades de destino de uma variável e de um pacote, do modo como são mostradas na página Concluindo o Assistente, no Assistente de Configuração de Pacotes:

\Package.Variables[User::TodaysDate].Properties[RaiseChangedEvent]

\Package.Properties[MaximumErrorCount]

\Package.Properties[LoggingMode]

\Package.Properties[LocaleID]

\Package\My SQL Task.Variables[User::varTableName].Properties[Value]

Neste exemplo, a configuração atualiza estas propriedades:

  • A propriedade RaiseChangedEvent da variável definida pelo usuário, TodaysDate.

  • As propriedades MaximumErrorCount, LoggingMode e LocaleID do pacote.

  • A propriedade Value da variável definida pelo usuário, varTableName, dentro do escopo da tarefa, My SQL Task.

O "\Package" representa a raiz e pontos (.) separam os objetos que definem o caminho até a propriedade que a configuração atualiza. Os nomes das variáveis e das propriedades estão entre parênteses. O termo Package sempre é usado na configuração, independente do nome do pacote; porém, todos os outros objetos no caminho usam os nomes definidos pelo usuário.

Depois que o assistente terminar, a nova configuração é adicionada à lista de configurações na caixa de diálogo Organizador de Configurações do Pacote .

Observação

A última página do Assistente de Configuração de Pacote, Concluindo o Assistente, lista as propriedades de destino da configuração. Se quiser atualizar as propriedades enquanto estiver executando pacotes usando o utilitário prompt de comando dtexec , você poderá gerar as cadeias de caracteres que representam os caminhos de propriedade executando o Assistente de Configuração de Pacotes e, então, copiá-las e colá-las na janela do prompt de comando para usar com a opção definida de dtexec.

A tabela a seguir descreve as colunas da lista de configurações na caixa de diálogo Organizador de Configurações do Pacote .

Coluna Descrição
Nome da Configuração O nome da configuração.
Tipo de Configuração O tipo de configuração.
Cadeia de Caracteres de Configuração O local da configuração. O local pode ser um caminho, uma variável de ambiente, uma chave do Registro, um nome de variável do pacote pai ou uma tabela em um banco de dados do SQL Server.
Objeto de Destino O nome do objeto com uma propriedade que tem uma configuração. Se a configuração for um arquivo de configuração XML, a coluna ficará em branco, devido à configuração poder atualizar vários objetos.
Propriedade de Destino O nome da propriedade. Se a configuração gravar em um arquivo de configuração XML ou em uma tabela do SQL Server, a coluna ficará em branco, pois a configuração pode atualizar vários objetos.

Para criar uma configuração de pacote

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

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

  3. No Designer do SSIS, selecione as guias Fluxo de Controle, Fluxo de Dados, Manipulador de Eventos ou Explorador de Pacotes.

  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 escolha 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, especifique o tipo de configuração e defina as propriedades pertinentes ao tipo de configuração. Para obter mais informações, consulte Referência da interface do usuário do Assistente de Configuração de Pacotes.

  8. Na página Selecionar Propriedades a Serem Exportadas, selecione as propriedades dos objetos do pacote a serem incluídas na configuração. Se o tipo de configuração oferecer suporte somente a uma propriedade, o título dessa página de assistente será Selecionar Propriedade de Destino. Para obter mais informações, consulte Referência da interface do usuário do Assistente de Configuração de Pacotes.

    Observação

    Somente os tipos de configuração Arquivo de Configuração XML e SQL Server dão suporte à inclusão de várias propriedades em uma configuração.

  9. Na página Concluindo o Assistente, digite o nome da configuração e selecione Concluir.

  10. Exiba a configuração na caixa de diálogo Organizador de Configurações do Pacote .

  11. Selecione Fechar.

Organizador de Configurações do Pacote

Use a caixa de diálogo Organizador de Configurações do Pacote para habilitar configurações de pacote, visualizar uma lista de configurações para o pacote atual e para definir a ordem de preferência para carregar as configurações.

Observação

As configurações estão disponíveis para o modelo de implantação de pacote. Os parâmetros são usados no lugar das configurações para o modelo de implantação de projeto. O modelo de implantação de projeto permite que você implante projetos do Integration Services no servidor do Integration Services. Para obter mais informações sobre os modelos de implantação, consulte Deployment of Projects and Packages.

Se várias configurações atualizarem a mesma propriedade, valores de configurações listadas na parte inferior da lista de configurações substituirão os valores das configurações na parte superior da lista. O último valor carregado na propriedade é o valor usado quando o pacote executar. Além disso, se o pacote usar uma combinação de configuração direta, como um arquivo de configuração XML, e uma configuração indireta, como uma variável de ambiente, a configuração indireta que aponta para o local da configuração direta deve estar na parte superior da lista.

Observação

Quando as configurações de pacote são carregadas na ordem preferencial, elas são carregadas da parte superior da lista mostrada na caixa de diálogo Organizador de Configurações do Pacote até a parte inferior da lista. Porém, no tempo de execução, talvez as configurações do pacote não sejam carregadas na ordem preferencial. Em particular, Configurações do Pacote Pai são carregadas depois das configurações de outros tipos.

Configurações de Pacote atualizam os valores das propriedades de objetos de pacote em tempo de execução. Quando um pacote é carregado, os valores das configurações substituem os valores que foram definidos quando o pacote foi desenvolvido. O Integration Services dá suporte a diferentes tipos de configuração. Por exemplo, é possível usar um arquivo XML que pode ter várias configurações, ou uma variável de ambiente que contenha uma única configuração. Para obter mais informações, consulte Package Configurations.

Opções

Habilitar configurações de pacote
Selecione para usar configurações com o pacote.

Nome da Configuração
Exibe o nome da configuração.

Tipo de Configuração
Exibe o tipo do local onde as configurações são armazenadas.

Cadeia de Caracteres de Configuração
Exibe o local no qual os valores de configuração são armazenados. O local pode ser um caminho de um arquivo, o nome de uma variável de ambiente, o nome de uma variável do pacote pai, uma chave do Registro ou o nome de uma tabela do SQL Server.

Objeto de Destino
Exibe o nome do objeto atualizado pela configuração. Se a configuração for um arquivo de configuração XML ou uma tabela do SQL Server, a coluna ficará em branco porque a configuração pode incluir vários objetos.

Propriedade de Destino
Exibe o nome da propriedade modificada pela configuração. Esta coluna estará em branco se o tipo de configuração oferecer suporte a várias configurações.

Adicionar
Adicione uma configuração usando o Assistente de Configuração do Pacote.

Editar
Edite uma configuração existente executando novamente o Assistente de Configuração do Pacote.

Remover
Selecione uma configuração e escolha Remover.

Setas
Selecione uma configuração e use as setas para cima e para baixo para movê-la para cima ou para baixo na lista. As configurações são carregadas na sequência exibida na lista.

Referência da interface do usuário do Assistente de Configuração de Pacotes

Use o Assistente de Configuração de Pacotes para criar configurações que atualizem as propriedades de um pacote do Integration Services e seus respectivos objetos em tempo de execução. Esse assistente é executado quando você adiciona uma nova configuração ou modifica uma existente na caixa de diálogo Organizador de Configurações do Pacote . Para abrir a caixa de diálogo Organizador de Configurações do Pacote, selecione Configurações de Pacote no menu SSIS no SQL Server Data Tools (SSDT). Para obter mais informações, consulte Criar configurações de pacote.

Observação

As configurações estão disponíveis para o modelo de implantação de pacote. Os parâmetros são usados no lugar das configurações para o modelo de implantação de projeto. O modelo de implantação de projeto permite que você implante projetos do Integration Services no servidor do Integration Services. Para obter mais informações sobre os modelos de implantação, consulte Deployment of Projects and Packages.

As seções a seguir descrevem as páginas do Assistente.

Bem-vindo à página Assistente de Configuração de Pacotes

Use o Assistente de Configuração do SSIS para criar configurações que atualizem as propriedades de um pacote e seus respectivos objetos no tempo de execução.

Opções

Não mostrar esta página novamente
Ignore a página inicial da próxima vez que abrir o assistente.

Próximo
Vá para a próxima página do assistente.

Selecionar a página Tipo de configuração

Use a página Selecionar Tipo de Configuração para especificar o tipo de configuração que deseja criar.

Se precisar de mais informações para determinar qual tipo de configuração usar, consulte Configurações de Pacote.

Opções estáticas

Tipo de configuração
Selecione o tipo de fonte na qual deseja armazenar a configuração usando as seguintes opções:

Valor Descrição
Arquivo de configuração XML Armazene a configuração como um arquivo XML. Se este valor for selecionado, as opções dinâmicas serão exibidas na seção Tipo de Configuração.
Variável de ambiente Armazene a configuração em uma das variáveis de ambiente. Se este valor for selecionado, as opções dinâmicas serão exibidas na seção Tipo de Configuração.
Entrada de Registro Armazene a configuração no Registro. Se este valor for selecionado, as opções dinâmicas serão exibidas na seção Tipo de Configuração.
Variável de pacote pai Armazene a configuração como uma variável no pacote que contém a tarefa. Se este valor for selecionado, as opções dinâmicas serão exibidas na seção Tipo de Configuração.
SQL Server Armazene a configuração em uma tabela no SQL Server. Se este valor for selecionado, as opções dinâmicas serão exibidas na seção Tipo de Configuração.

Próximo
Visualize a próxima página da sequência do assistente.

Opções dinâmicas

Opção Tipo de Configuração = Arquivo de Configuração XML

Especificar as definições de configuração diretamente
Use para especificar as configurações diretamente.

Valor Descrição
Nome do arquivo de configuração Digite o caminho do arquivo de configuração gerado pelo assistente.
Procurar Use a caixa de diálogo Selecionar Local do Arquivo de Configuração para especificar o caminho do arquivo de configuração gerado pelo assistente. Se o arquivo não existir, ele será criado pelo assistente.

O local de configuração é armazenado em uma variável de ambiente
Use para especificar a variável de ambiente na qual você deseja armazenar a configuração.

Valor Descrição
Variável de ambiente Selecione uma variável de ambiente da lista.
Opção Tipo de Configuração = Variável de Ambiente

Variável de ambiente
Selecione a variável de ambiente que contém as informações de configuração.

Opção Tipo de Configuração = Entrada de Registro

Especificar as definições de configuração diretamente
Use para especificar as configurações diretamente.

Valor Descrição
Entrada de Registro Digite a chave do Registro que contém as informações de configuração. O formato é <chave do Registro>.

A chave do Registro já deve existir em HKEY_CURRENT_USER e ter um valor chamado Value. O valor pode ser um DWORD ou uma cadeia de caracteres.

Se deseja usar uma chave do Registro que não está na raiz de HKEY_CURRENT_USER, use o formato <Registry key\registry key\...> para identificar a chave.

O local de configuração é armazenado em uma variável de ambiente
Use para especificar a variável de ambiente na qual deseja armazenar a configuração.

Valor Descrição
Variável de ambiente Selecione uma variável de ambiente da lista.
Opção Tipo de Configuração = Variável de pacote pai

Especificar as definições de configuração diretamente
Use para especificar as configurações diretamente.

Valor Descrição
Variável pai Especifique a variável no pacote pai que contém as informações de configuração.

O local de configuração é armazenado em uma variável de ambiente
Use para especificar a variável de ambiente que armazena a configuração.

Valor Descrição
Variável de ambiente Selecione uma variável de ambiente da lista.
Opções de Tipo de Configuração = SQL Server

Especificar as definições de configuração diretamente
Use para especificar as configurações diretamente.

Valor Descrição
Conexão Selecione uma conexão da lista ou escolha Nova para criar uma conexão.
Tabela de configuração Selecione uma tabela existente ou escolha Nova para gravar uma instrução SQL que cria uma tabela.
Filtro de configuração Selecione um nome de configuração existente ou digite um novo nome.

Podem ser armazenadas muitas configurações do SQL Server na mesma tabela e cada configuração pode incluir vários itens de configuração.

O valor definido pelo usuário é armazenado na tabela para identificar os itens de configuração que pertencem a uma determinada configuração.

O local de configuração é armazenado em uma variável de ambiente
Use para especificar a variável de ambiente onde a configuração está armazenada.

Valor Descrição
Variável de ambiente Selecione uma variável de ambiente da lista.

Selecionar a página Objetos a Exportar

Use a página Selecionar Propriedade de Destino ou Selecionar Propriedades a Serem Exportadas para especificar as propriedades do objeto que a configuração contém. O recurso para selecionar várias propriedades estará disponível somente se você selecionar o tipo de configuração XML.

Opções

Objetos
Expanda a hierarquia de pacotes e selecione as propriedades a serem exportadas.

Atributos da propriedade
Exiba os atributos de uma propriedade.

Próximo
Vá para a próxima página do assistente.

Concluindo a página do assistente

Use a página Concluindo o Assistente para fornecer um nome para a configuração e definições de exibição usado pelo assistente para criar a configuração. Ao concluir o assistente, o Organizador de Configurações do Pacote é exibido e ele lista todas as configurações do pacote.

Opções

Nome da configuração
Digite o nome da configuração.

Visualização
Exiba as definições usadas pelo assistente para criar a configuração.

Concluir
Crie a configuração e saia do Assistente de Configuração de Pacotes.

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 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 do pacote, selecione qualquer lugar da superfície de design da guia Fluxo de Controle.

    • Para definir o escopo de um contêiner pai da tarefa Executar Pacote, selecione o contêiner.

    • Para definir o escopo da tarefa Executar Pacote, selecione a 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, selecione 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 do pacote e selecione 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, selecione Salvar Itens Selecionados no menu Arquivo.

Criar um utilitário de implantação

A primeira etapa da implantação de pacotes é a criação de um utilitário de implantação para um projeto do Integration Services. O utilitário de implantação é uma pasta que contém os arquivos necessários para a implantação dos pacotes em um projeto do Integration Services em um servidor diferente. O utilitário de implantação é criado no computador no qual o projeto do Integration Services é armazenado.

Você cria um utilitário de implantação de pacotes para um projeto do Integration Services configurando primeiro o processo de compilação para criar um utilitário de implantação e, depois, compilando o projeto. Quando você compila o projeto, todos os pacotes e configurações de pacote do projeto são incluídos automaticamente. Para implantar arquivos adicionais como um arquivo Leiame com o projeto, coloque os arquivos na pasta Diversos do projeto do Integration Services. Quando o projeto é compilado, esses arquivos também são automaticamente incluídos.

Você pode configurar cada implantação de projeto de modo diferente. Antes de compilar o projeto e criar o utilitário de implantação do pacote, você pode definir as propriedades no utilitário de implantação para personalizar o modo como os pacotes do projeto serão implantados. Por exemplo, você pode especificar se as configurações do pacote podem ser atualizadas quando o projeto é implantado. Para acessar as propriedades de um projeto do Integration Services, clique com o botão direito do mouse no projeto e selecione Propriedades.

A tabela a seguir lista as propriedades do utilitário de implantação.

Propriedade Descrição
AllowConfigurationChange Um valor que especifica se as configurações podem ser atualizadas durante a implantação.
CreateDeploymentUtility Um valor que especifica se um utilitário de implantação do pacote é criado quando o projeto é compilado. Essa propriedade deve ser True para criar um utilitário de implantação.
DeploymentOutputPath O local, relativo ao projeto do Integration Services, do utilitário de implantação.

Quando você cria um projeto do Integration Services, um arquivo de manifesto, <nome do projeto>.SSISDeploymentManifest.xml, é criado e adicionado, junto com cópias dos pacotes de projeto e dependências do pacote, à pasta bin\Deployment do projeto ou ao local especificado na propriedade DeploymentOutputPath. O arquivo de manifesto lista os pacotes, as configurações de pacote e os diversos arquivos do projeto.

O conteúdo da pasta de implantação é atualizado toda vez que você compila o projeto. Isso significa que qualquer arquivo salvo nessa pasta que não for copiado novamente na pasta pelo processo de compilação será excluído. Por exemplo, serão excluídos arquivos de configuração do pacote salvos nas pastas de implantação.

Para criar um utilitário de implantação de pacote

  1. No SQL Server Data Tools (SSDT), abra a solução que contém o projeto do Integration Services para o qual deseja criar um utilitário de implantação de pacotes.

  2. Clique com o botão direito do mouse no projeto e selecione Propriedades.

  3. Na caixa de diálogo <Nome do projeto> Páginas de Propriedades, selecione Utilitário de Implantação.

  4. Para atualizar as configurações do pacote quando os pacotes são implantados, defina AllowConfigurationChanges como True.

  5. Defina CreateDeploymentUtility como True.

  6. Opcionalmente, atualize o local do utilitário de implantação modificando a propriedade do DeploymentOutputPath .

  7. Selecione OK.

  8. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e clique em Compilar.

  9. Visualize o progresso da compilação e os erros de compilação na janela Saída .

Implantar pacotes usando o utilitário de implantação

Quando você cria um utilitário de implantação para instalar pacotes de um projeto do Integration Services em um computador diferente daquele em que o utilitário de implantação foi criado, é necessário primeiro copiar a pasta de implantação no computador de destino.

O caminho da pasta de implantação está especificado na propriedade DeploymentOutputPath do projeto do Integration Services para o qual foi criado o utilitário de implantação. O caminho padrão é bin\Deployment, relativo ao projeto do Integration Services. Para obter mais informações, consulte Criar um utilitário de implantação.

É possível usar o Assistente de Instalação de Pacotes para instalar os pacotes. Para iniciar o assistente, clique duas vezes no arquivo do utilitário de implantação depois de ter copiado a pasta de implantação no servidor. Esse arquivo é chamado <nome do projeto>.SSISDeploymentManifest e pode ser encontrado na pasta de implantação do computador de destino.

Observação

Dependendo da versão do pacote que está sendo implantado, você poderá encontrar um erro se tiver diferentes versões do SQL Server instaladas lado a lado. Esse erro pode ocorrer porque a extensão do nome de arquivo .SSISDeploymentManifest é a mesma para todas as versões do Integration Services. Clicar duas vezes no arquivo chama o instalador (dtsinstall.exe) da versão instalada mais recentemente do Integration Services, que talvez não seja a mesma versão do arquivo de utilitário de implantação. Para resolver esse problema, execute a versão correta de dtsinstall.exe na linha de comando e forneça o caminho do arquivo de utilitário de implantação.

O Assistente de Instalação de Pacotes guiará você pelas etapas para instalar pacotes no sistema de arquivos ou no SQL Server. Você pode configurar a instalação das seguintes formas:

  • Escolhendo o local e o tipo de local para instalar os pacotes.

  • Escolhendo o local para instalar dependências dos pacotes.

  • Validando os pacotes após a instalação no servidor de destino.

As dependências com base em arquivo para pacotes sempre são instaladas no sistema de arquivos. Se for instalado um pacote no sistema de arquivos, as dependências serão instaladas na mesma pasta especificada por você para o pacote. Se instalar um pacote no SQL Server, você poderá especificar a pasta na qual armazenará as dependências com base no arquivo.

Se o pacote incluir configurações que deseja modificar para usar no computador destino, você poderá atualizar os valores e as propriedades usando o assistente.

Além de instalar os pacotes com o Assistente de Instalação de Pacotes, você pode copiar e mover pacotes com o utilitário de prompt de comando dtutil . Para obter mais informações, consulte dtutil Utility.

Para implantar pacotes em uma instância do SQL Server

  1. Abra a pasta de implantação no computador de destino.

  2. Clique duas vezes no arquivo de manifesto, <nome do projeto>.SSISDeploymentManifest, para iniciar o Assistente de Instalação de Pacotes.

  3. Na página Implantar Pacotes SSIS , selecione a opção Implantação no SQL Server .

  4. Opcionalmente, selecione Validar pacotes após instalação para validar os pacotes depois de instalados no servidor de destino.

  5. Na página Especificar SQL Server de Destino, especifique a instância do SQL Server para instalar os pacotes e selecionar um modo de autenticação. Se você selecionar a Autenticação do SQL Server, você deve fornecer um nome de usuário e uma senha.

  6. Na página Selecionar Pasta de Instalação , especifique a pasta no sistema de arquivos para as dependências do pacote que serão instaladas.

  7. Se o pacote incluir configurações, você poderá editar as configurações atualizando os valores na lista Valor da página Configurar Pacotes.

  8. Se você escolheu validar os pacotes após a instalação, exiba os resultados de validação dos pacotes implantados.

Reimplantação de pacotes

Após a implantação de um projeto, talvez seja necessário atualizar ou estender a funcionalidade de pacotes e reimplantar o projeto do Integration Services que contém os pacotes atualizados. Como parte do processo de reimplantação dos pacotes, você deve revisar as propriedades de configuração incluídas no utilitário de implantação. Por exemplo, você pode desejar não permitir mudanças de configuração depois que o pacote for reimplantado.

Processo de reimplantação

Após a conclusão da atualização dos pacotes, você deve recriar o projeto, copiar a pasta de implantação para o computador de destino e executar novamente o Assistente de Instalação de Pacotes.

Se você atualizar apenas alguns pacotes do projeto, talvez não queira reimplantar o projeto todo. Para implantar apenas alguns pacotes, você pode criar um novo projeto do Integration Services, adicionar os pacotes atualizados ao novo projeto e compilar e implantar o projeto. As configurações de pacotes são copiadas automaticamente com o pacote quando você adiciona o pacote a um projeto diferente.

Referência da interface do usuário do Assistente de Instalação de Pacotes

Use o Assistente de Instalação de Pacotes para implantar um projeto do Integration Services, inclusive os pacotes e arquivos diversos contidos nele, bem como todas as dependências do pacote.

Antes de implantar pacotes, você pode criar configurações e implantá-las com os pacotes. O Integration Services usa configurações para atualizar dinamicamente as propriedades de pacotes e objetos de pacote em tempo de execução. Por exemplo, a cadeia de conexão de uma conexão OLE DB pode ser definida dinamicamente em tempo de execução fornecendo-se uma configuração que mapeie um valor para uma propriedade que contenha a cadeia de conexão.

Você não pode executar o Assistente de Instalação de Pacotes enquanto não compilar um projeto do Integration Services e criar um utilitário de implantação. Para obter mais informações, consulte Implantar pacotes por meio do utilitário de implantação.

As seções a seguir descrevem as páginas do assistente.

Bem-vindo à página Assistente de Instalação de Pacotes

Use o Assistente de Instalação de Pacotes para implantar um projeto do Integration Services para o qual você criou um utilitário de implantação de pacotes.

Não mostrar esta página inicial novamente
Selecione para ignorar a página inicial ao executar o assistente novamente.

Próximo
Vá para a próxima página do assistente.

Concluir
Pule para a página Concluir o assistente de instalação de pacotes. Use esta opção caso você já tenha retornado às páginas anteriores do assistente para revisar suas opções e especificado todas as obrigatórias.

Configurar a página Pacotes

Use a página Configurar Pacotes para editar as configurações do pacote.

Opções

Arquivo de configuração
Edite o conteúdo de um arquivo de configuração selecionando o arquivo na lista.

Tópicos relacionados: Criar configurações de pacote

Caminho
Exiba o caminho da propriedade a ser configurada.

Tipo
Exiba o tipo de dados da propriedade.

Valor
Especifique o valor da configuração.

Próximo
Vá para a próxima página do assistente.

Concluir
Pule para a página Concluir o assistente de instalação de pacotes. Use esta opção caso você já tenha retornado às páginas anteriores do assistente para revisar suas opções e especificado todas as obrigatórias.

Página Confirmar Instalação

Use a página Confirmar Instalação para iniciar a instalação de pacotes, para exibir o status e para exibir as informações que serão usadas pelo assistente para instalar os arquivos a partir do projeto especificado.

Próximo
Instale os pacotes e suas dependências e vá para a próxima página do assistente quando instalação for concluída.

Status
Mostra o progresso da instalação do pacote.

Concluir
Vá para a página Concluir o assistente de instalação de pacotes. Use esta opção caso você já tenha retornado às páginas anteriores do assistente para revisar suas opções e especificado todas as obrigatórias.

Página Implantar Pacotes SSIS

Use a página Implantar Pacotes do SSIS para especificar onde os pacotes do Integration Services e suas dependências serão instalados.

Opções

Implantação do sistema de arquivos
Distribua os pacotes e suas dependências em uma pasta especificada no sistema de arquivos.

Implantação no SQL Server
Implante os pacotes e suas dependências em uma instância do SQL Server. Use essa opção caso o SQL Server compartilhe pacotes entre servidores. Todas as dependências do pacote são instaladas na pasta especificada no sistema de arquivos.

Validar pacotes após a instalação
Indique se é preciso validar os pacotes após a instalação.

Próximo
Vá para a próxima página do assistente.

Concluir
Pule para a página Concluir o assistente de instalação de pacotes. Use esta opção caso você já tenha retornado às páginas anteriores do assistente para revisar suas opções e especificado todas as obrigatórias.

Página Validação de Pacotes

Use a página Validação de Pacotes para exibir o progresso e os resultados da validação do pacote.

Próximo
Vá para a próxima página do assistente.

Página Selecionar Pasta de Instalação

Use a página Selecionar Pasta de Instalação para especificar a pasta do arquivo de sistemas na qual os pacotes e as dependências de pacotes serão instalados.

Opções

Pasta
Especifique o caminho e a pasta nos quais o pacote e suas dependências serão copiados.

Procurar
Procure a pasta de destino usando a caixa de diálogo Procurar Pasta .

Próximo
Vá para a próxima página do assistente.

Concluir
Pule para a página Concluir o assistente de instalação de pacotes. Use esta opção caso você já tenha retornado às páginas anteriores do assistente para revisar suas opções e especificado todas as obrigatórias.

Página Especificar SQL Server de Destino

Use a página Especificar SQL Server de Destino para especificar as opções para implantar o pacote a uma instância do SQL Server.

Opções

Nome do servidor
Especifique o nome do servidor para o qual deseja implantar os pacotes.

Usar Autenticação do Windows
Especifique se usará a Autenticação do Windows para entrar no servidor. A Autenticação do Windows é recomendada para obter melhor segurança.

Usar Autenticação do SQL Server
Especifique se o pacote deverá usar a Autenticação do SQL Server para entrar no servidor. Se você usar a Autenticação do SQL Server , será preciso fornecer um nome de usuário e uma senha.

Nome de usuário
Especifique um nome de usuário.

Senha
Especifique uma senha.

Caminho do pacote
Especifique o nome da pasta lógica ou digite "/" para a pasta padrão.

Para selecionar a pasta na caixa de diálogo Pacote do SSIS, escolha Procurar (...). Entretanto, a caixa de diálogo não fornece um meio para selecionar a pasta padrão. Se desejar usar a pasta padrão, digite "/" na caixa de texto.

Observação

Se você não inserir um caminho de pacote válido, a seguinte mensagem de erro será exibida: "Um ou mais argumentos são inválidos."

Depender do armazenamento do servidor para criptografia
Selecione essa opção para usar os recursos de segurança do Mecanismo de Banco de Dados para ajudar a manter a segurança dos pacotes.

Próximo
Vá para a próxima página do assistente.

Concluir
Pule para a página Concluir o assistente de instalação de pacotes. Use esta opção caso você já tenha retornado às páginas anteriores do assistente para revisar suas opções e especificado todas as obrigatórias.

Página Concluir o Assistente de Instalação de Pacotes

Use a página Concluir o Assistente de Instalação de Pacotes para exibir um resumo dos resultados da instalação do pacote. Essa página fornece detalhes como o nome do projeto do Integration Services que foi implantado, os pacotes que foram instalados, os arquivos de configuração e o local da instalação.

Concluir
Para sair do assistente, clique em Concluir.