Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:Servidor SQL Tempo de execução da integração do SSIS 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 do pacote:
A primeira etapa é opcional e envolve a criação de configurações de pacote que atualizam as propriedades dos elementos do pacote em tempo de execução. As configurações são incluídas automaticamente quando você implanta os pacotes.
A segunda etapa é criar o projeto 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ê deseja implantar
A terceira etapa é copiar a pasta de implantação que foi criada quando você criou o projeto Integration Services para o computador de destino.
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 você pode usar 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 do projeto. O modelo de implantação de projeto permite implantar projetos do Integration Services no servidor do Integration Services. Para obter mais informações sobre os modelos de implantação, consulte Implantação de projetos e pacotes.
Uma configuração é um par propriedade/valor que você adiciona a um pacote concluído. Normalmente, você cria propriedades de conjunto de pacotes nos objetos de pacote durante o desenvolvimento do pacote e, em seguida, adiciona a configuração ao pacote. Quando o pacote é executado, ele obtém os novos valores da propriedade da configuração. Por exemplo, usando uma configuração, você pode alterar a cadeia de conexão de um gerenciador de conexões ou atualizar o valor de uma variável.
As configurações de pacote oferecem os seguintes benefícios:
As configurações facilitam a movimentação de 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 servidor.
As configurações são úteis quando você implanta pacotes em muitos servidores diferentes. Por exemplo, uma variável na configuração para cada pacote implantado pode conter um valor de espaço em disco diferente e, se o espaço em disco disponível não atender a 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 que é 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 implantação de pacote para instalar pacotes. Quando você instala os pacotes, as configurações podem ser atualizadas como uma etapa na instalação do pacote.
Compreendendo como as configurações de pacote são aplicadas em tempo de execução
Quando você usa o utilitário de prompt de comando dtexec (dtexec.exe) 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 especificadas na linha de comando.
À medida que o utilitário carrega e executa o pacote, os eventos ocorrem na seguinte ordem:
O utilitário dtexec carrega o pacote.
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 mais tarde no processo.)
Em seguida, o utilitário aplica todas as opções especificadas na linha de comando.
Em seguida, 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 de Pacote Pai). O utilitário usa todas as opções de linha de comando especificadas para recarregar as configurações. Portanto, valores diferentes podem ser recarregados de um local diferente.
O utilitário aplica as configurações da variável de pacote pai.
O utilitário executa o pacote.
A maneira como o utilitário dtexec aplica configurações afeta as seguintes opções de linha de comando:
Você pode usar a opção /Connection ou /set em tempo de execução para carregar configurações de pacote de um local diferente do local especificado em tempo de design.
Você pode usar a opção /ConfigFile para carregar configurações adicionais que não especificou em tempo de design.
No entanto, essas opções de linha de comando têm algumas restrições:
Não é possível usar a opção /set ou /Connection para substituir 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 substituam as configurações especificadas em tempo de design.
Para obter mais informações sobre essas opções e como o comportamento dessas opções difere entre o SQL Server 2019 Integration Services (SSIS) e versões anteriores, consulte Alterações de comportamento nos recursos do Integration Services no SQL Server 2016.
Tipos de configuração de pacote
A tabela a seguir descreve os tipos de configuração do pacote.
| Tipo | Description |
|---|---|
| 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 do Registro contém a configuração. |
| Variável de pacote pai | Uma variável no pacote contém a configuração. Esse tipo de configuração é normalmente usado para atualizar propriedades em pacotes filho. |
| Tabela do SQL Server | Uma tabela em um banco de dados do SQL Server 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 do arquivo de configuração XML , poderá criar um novo arquivo de configuração, reutilizar um arquivo existente e adicionar novas configurações ou reutilizar um arquivo existente, mas substituir o conteúdo do arquivo existente.
Um arquivo de configuração XML inclui duas seções:
Um título que contém informações sobre o arquivo de configuração. Este elemento inclui atributos 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. Este elemento inclui atributos como o caminho da propriedade e o valor configurado de uma propriedade.
O código XML a seguir demonstra a sintaxe de um arquivo de configuração XML. Este exemplo mostra uma configuração para a propriedade Value de uma variável inteira 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 registo
Se desejar usar uma entrada do Registro para armazenar a configuração, você poderá usar uma chave existente ou criar uma nova chave no HKEY_CURRENT_USER. A chave do Registro que você usa deve ter um valor chamado Value. O valor pode ser um DWORD ou uma cadeia de caracteres.
Se você selecionar o tipo de configuração de entrada do Registro , digite o nome da chave do Registro na caixa de entrada do Registro. O formato é <a chave> do Registro. Se você quiser usar uma chave do Registro que não esteja na raiz do , use o formato <Chave do HKEY_CURRENT_USERRegistro\rchave egistry\...> 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 do SQL Server , especificará a conexão com o banco de dados do SQL Server no qual deseja armazenar as configurações. Você pode salvar as configurações em uma tabela existente ou criar uma nova tabela no banco de dados especificado.
A instrução SQL a seguir mostra a instrução CREATE TABLE padrão que o Assistente de Configuração de Pacote fornece.
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 que você fornece 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 configurações diretamente, o Integration Services criará um link direto entre o item de configuração e a propriedade do objeto do pacote. As configurações diretas são uma escolha melhor quando a localização da fonte não muda. 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 a definição de configuração diretamente, a configuração aponta para uma variável de ambiente, que, por sua vez, contém o valor de configuração. O uso de configurações indiretas é uma escolha melhor quando o local da configuração pode mudar para cada implantação de um pacote.
Criar configurações de pacote
Crie configurações de pacote usando a caixa de diálogo Organizador de Configuração de Pacote e o Assistente de Configuração de Pacote. Para acessar essas ferramentas, selecione Configurações de pacote no menu SSIS no SSDT (SQL Server Data Tools).
Observação
Você também pode acessar o Organizador de Configuração de Pacote clicando no botão de reticências ao lado da propriedade Configuração . A propriedade Configuration aparece na janela de propriedades do 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 do projeto. O modelo de implantação de projeto permite implantar projetos do Integration Services no servidor do Integration Services. Para obter mais informações sobre os modelos de implantação, consulte Implantação de projetos e pacotes.
Na caixa de diálogo Organizador de Configuração de Pacotes , você pode habilitar pacotes para usar configurações, adicionar e excluir configurações e definir a ordem preferencial na qual as configurações devem ser carregadas.
Quando as configurações de pacote são carregadas na ordem preferida, as configurações são carregadas do topo da lista mostrada na caixa de diálogo Organizador de Configuração de Pacote para a parte inferior da lista. No entanto, em tempo de execução, as configurações do pacote podem não ser carregadas na ordem preferida. Em particular, as configurações do pacote pai são carregadas após configurações de outros tipos.
Se várias configurações definirem a mesma propriedade de objeto, o valor carregado por último será usado em tempo de execução.
Na caixa de diálogo Organizador de Configuração de Pacote , execute o Assistente de Configuração de Pacote, que o orienta pelas etapas para criar uma configuração. Para executar o Assistente de Configuração de Pacote, adicione uma nova configuração na caixa de diálogo Organizador de Configurações de Pacote ou edite uma existente. Nas páginas do assistente, você escolhe o tipo de configuração, seleciona se deseja acessar a configuração diretamente ou usar variáveis de ambiente e seleciona as propriedades a serem salvas na configuração.
O exemplo a seguir mostra as propriedades de destino de uma variável e de um pacote conforme aparecem na página Concluindo o Assistente do Assistente de Configuração de Pacote:
\Package.Variables[Usuário::TodaysDate]. Propriedades[RaiseChangedEvent]
\Package.Properties[MaximumErrorCount]
\Package.Properties[LoggingMode]
\Package.Properties[LocaleID]
\Package\My SQL Task.Variables[Usuário::varTableName]. Propriedades[Valor]
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,
varTableNamedentro do escopo da tarefa, My SQL Task.
O "\Package" representa a raiz e os pontos (.) separam os objetos que definem o caminho para a propriedade que a configuração atualiza. Os nomes das variáveis e propriedades estão entre parênteses. O termo Pacote é sempre usado na configuração, independentemente do nome do pacote; no entanto, todos os outros objetos no caminho usam seus nomes definidos pelo usuário.
Após a conclusão do assistente, a nova configuração é adicionada à lista de configurações na caixa de diálogo Organizador de Configuração de Pacote .
Observação
A última página do Assistente de Configuração de Pacote, Concluindo o Assistente, lista as propriedades de destino na configuração. Se desejar atualizar as propriedades ao executar pacotes usando o utilitário de prompt de comando dtexec , você pode gerar as cadeias de caracteres que representam os caminhos de propriedade executando o Assistente de Configuração de Pacote e, em seguida, copiá-las e colá-las na janela do prompt de comando para uso com a opção set de dtexec.
A tabela a seguir descreve as colunas na lista de configuração na caixa de diálogo Organizador de Configuração de Pacote .
| Coluna | Description |
|---|---|
| Nome da configuração | O nome da configuração. |
| Tipo de configuração | O tipo de configuração. |
| Cadeia 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 de 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 estará em branco, porque a configuração pode 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, porque a configuração pode atualizar vários objetos. |
Para criar uma configuração de pacote
No SSDT (SQL Server Data Tools), abra o projeto Integration Services que contém o pacote desejado.
No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo.
No Designer SSIS, selecione a guia Fluxo de Controle, Fluxo de Dados, Manipulador de Eventos ou Explorador de Pacotes .
No menu SSIS , selecione Configurações do pacote.
Na caixa de diálogo Organizador de Configuração de Pacote , selecione Habilitar configurações de pacote e selecione Adicionar.
Na página de boas-vindas da página Assistente de Configuração de Pacote, selecione Avançar.
Na página Selecionar Tipo de Configuração, especifique o tipo de configuração e defina as propriedades relevantes para o tipo de configuração.
Na página Selecionar Propriedades para Exportar, selecione as propriedades dos objetos de pacote a serem incluídos na configuração. Se o tipo de configuração suportar apenas uma propriedade, o título desta página do assistente será Select Target Property. .
Observação
Somente o arquivo de configuração XML e os tipos de configuração do SQL Server oferecem suporte, incluindo várias propriedades em uma configuração.
Na página Concluindo o Assistente, digite o nome da configuração e selecione Concluir.
Exiba a configuração na caixa de diálogo Organizador de Configuração de Pacote .
Selecione Fechar.
Organizador de configurações de pacote
Use a caixa de diálogo Organizador de Configurações de Pacote para habilitar configurações de pacote, exibir uma lista de configurações para o pacote atual e especificar a ordem preferencial na qual as configurações devem ser carregadas.
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 do projeto. O modelo de implantação de projeto permite implantar projetos do Integration Services no servidor do Integration Services. Para obter mais informações sobre os modelos de implantação, consulte Implantação de projetos e pacotes.
Se várias configurações atualizarem a mesma propriedade, os valores das configurações listadas mais abaixo na lista de configurações substituirão os valores das configurações mais altas na lista. O último valor carregado na propriedade é o valor usado quando o pacote é executado. Além disso, se o pacote usa 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 ser mais alta na lista.
Observação
Quando as configurações de pacote são carregadas na ordem preferida, as configurações são carregadas do topo da lista mostrada na caixa de diálogo Organizador de Configuração de Pacote para a parte inferior da lista. No entanto, em tempo de execução, as configurações do pacote podem não ser carregadas na ordem preferida. Em particular, as Configurações do Pacote Pai são carregadas após configurações de outros tipos.
As 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 oferece suporte a diferentes tipos de configuração. Por exemplo, você pode usar um arquivo XML que pode conter várias configurações ou uma variável de ambiente que contém uma única configuração. .
Opções
Habilitar configurações de pacote
Selecione para usar configurações com o pacote.
Nome da configuração
Exiba o nome da configuração.
Tipo de configuração
Exiba o tipo do local onde as configurações são armazenadas.
Cadeia de configuração
Exiba o local onde os valores de configuração são armazenados. O local pode ser o caminho de um arquivo, o nome de uma variável de ambiente, o nome de uma variável de pacote pai, uma chave do Registro ou o nome de uma tabela do SQL Server.
Objeto de destino
Exiba o nome do objeto que a configuração atualiza. 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
Exiba o nome da propriedade modificada pela configuração. Esta coluna ficará em branco se o tipo de configuração suportar várias configurações.
Add
Adicione uma configuração usando o Assistente de Configuração de Pacote.
Edit
Edite uma configuração existente executando novamente o Assistente de Configuração de Pacote.
Remove
Selecione uma configuração e, em seguida, selecione 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 em que aparecem 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 atualizam as propriedades de um pacote do Integration Services e seus objetos em tempo de execução. Este assistente é executado quando você adiciona uma nova configuração ou modifica uma existente na caixa de diálogo Organizador de Configurações de Pacote . Para abrir a caixa de diálogo Organizador de Configurações de Pacote , selecione Configurações de Pacote no menu SSIS do SSDT (SQL Server Data Tools). .
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 do projeto. O modelo de implantação de projeto permite implantar projetos do Integration Services no servidor do Integration Services. Para obter mais informações sobre os modelos de implantação, consulte Implantação de projetos e pacotes.
As seções a seguir descrevem páginas do Assistente.
Bem-vindo à página do Assistente de Configuração de Pacotes
Use o Assistente de Configuração do SSIS para criar configurações que atualizam as propriedades de um pacote e seus objetos em tempo de execução.
Opções
Não mostrar esta página novamente
Ignore a página de boas-vindas na próxima vez que abrir o assistente.
Seguinte
Vá para a próxima página no assistente.
Página Selecionar Tipo de Configuração
Use a página Selecionar Tipo de Configuração para especificar o tipo de configuração a ser criada.
Opções estáticas
Tipo de configuração
Selecione o tipo de fonte na qual armazenar a configuração, usando as seguintes opções:
| Valor | Description |
|---|---|
| Arquivo de configuração XML | Armazene a configuração como um arquivo XML. A seleção desse valor exibe as opções dinâmicas na seção Tipo de configuração. |
| Variável de ambiente | Armazene a configuração em uma das variáveis de ambiente. A seleção desse valor exibe as opções dinâmicas na seção Tipo de configuração. |
| Entrada de registo | Armazene a configuração no Registro. A seleção desse valor exibe as opções dinâmicas 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. A seleção desse valor exibe as opções dinâmicas na seção Tipo de configuração. |
| Servidor SQL | Armazene a configuração em uma tabela no SQL Server. A seleção desse valor exibe as opções dinâmicas na seção Tipo de configuração. |
Seguinte
Exiba a próxima página na sequência do assistente.
Opções dinâmicas
Opção de Tipo de Configuração = Arquivo de Configuração XML
Especificar definições de configuração diretamente
Use para especificar configurações diretamente.
| Valor | Description |
|---|---|
| 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 armazenar a configuração.
| Valor | Description |
|---|---|
| Variável de ambiente | Selecione uma variável de ambiente na lista. |
Opção de 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 de Tipo de Configuração = Entrada do Registro
Especificar definições de configuração diretamente
Use para especificar configurações diretamente.
| Valor | Description |
|---|---|
| Entrada de registo | Digite a chave do Registro que contém as informações de configuração. O formato é <a chave> do Registro. A chave do Registro já deve existir e HKEY_CURRENT_USER ter um valor chamado Value. O valor pode ser um DWORD ou uma cadeia de caracteres.Se você quiser usar uma chave do Registro que não esteja na raiz do , use o formato <Chave do HKEY_CURRENT_USERRegistro\rchave egistry\...> 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 armazenar a configuração.
| Valor | Description |
|---|---|
| Variável de ambiente | Selecione uma variável de ambiente na lista. |
Opção de Tipo de Configuração = Variável de Pacote Pai
Especificar definições de configuração diretamente
Use para especificar configurações diretamente.
| Valor | Description |
|---|---|
| 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 | Description |
|---|---|
| Variável de ambiente | Selecione uma variável de ambiente na lista. |
Opções de tipo de configuração = SQL Server
Especificar definições de configuração diretamente
Use para especificar configurações diretamente.
| Valor | Description |
|---|---|
| Conexão | Selecione uma conexão na lista ou selecione Novo para criar uma nova conexão. |
| Tabela de configuração | Selecione uma tabela existente ou selecione Novo para escrever uma instrução SQL que crie uma nova tabela. |
| Filtro de configuração | Selecione um nome de configuração existente ou digite um novo nome. Muitas configurações do SQL Server podem ser armazenadas na mesma tabela e cada configuração pode incluir vários itens de configuração. Esse valor definido pelo usuário é armazenado na tabela para identificar itens de configuração que pertencem a uma configuração específica |
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 | Description |
|---|---|
| Variável de ambiente | Selecione uma variável de ambiente na lista. |
Selecionar objetos para exportar página
Use a página Selecionar propriedade de destino ou Selecionar propriedades para exportar para especificar as propriedades do objeto que a configuração contém. A capacidade de 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.
Seguinte
Vá para a próxima página no assistente.
Concluindo a página do assistente
Use a página Concluindo o Assistente para fornecer um nome para as definições de configuração e exibição usadas pelo assistente para criar a configuração. Após a conclusão do assistente, o Organizador de Configurações de Pacote é exibido, que lista todas as configurações do pacote.
Opções
Nome da configuração
Digite o nome da configuração.
Preview
Exiba as configurações usadas pelo assistente para criar a configuração.
Acabamento
Crie a configuração e saia do Assistente de Configuração de Pacote.
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 da variável pai. Esse tipo de configuração permite que um pacote filho executado a partir de um pacote pai acesse uma variável no pai.
Observação
Você também pode passar valores para um pacote filho configurando a Tarefa Executar Pacote para mapear variáveis ou parâmetros do pacote pai, ou parâmetros do projeto, para parâmetros do pacote filho. Para obter mais informações, consulte Executar tarefa de pacote.
Não é necessário criar a variável no pacote pai antes de criar a configuração do pacote no pacote filho. Você pode adicionar a variável ao pacote pai a qualquer momento, mas deve usar o nome exato da variável pai na configuração do pacote. No entanto, antes de criar uma configuração de variável pai, deve haver uma variável existente no pacote filho que a configuração possa atualizar. Para obter mais informações sobre como adicionar e configurar variáveis, consulte Adicionar, excluir, alterar o escopo de User-Defined variável em um pacote.
O escopo da variável no pacote pai que é usada em uma configuração de variável pai pode ser definido para a tarefa Executar Pacote, para o contêiner que tem a tarefa ou para o pacote. Se várias variáveis com o mesmo nome forem definidas em um pacote, a variável mais próxima em escopo da tarefa Executar Pacote será usada. O escopo mais próximo da tarefa Executar Pacote é a própria tarefa.
Para adicionar uma variável a um pacote pai
No SSDT (SQL Server Data Tools), abra o projeto Integration Services que contém o pacote ao qual você deseja adicionar uma variável para passar para um pacote filho.
No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo.
No Designer SSIS, para definir o escopo da variável, siga um destes procedimentos:
Para definir o escopo para o pacote, selecione qualquer lugar na superfície de design da guia Fluxo de controle .
Para definir o escopo como um contêiner pai da tarefa Executar Pacote, selecione o contêiner.
Para definir o escopo para a tarefa Executar Pacote, selecione a tarefa.
Adicione e configure uma variável.
Observação
Selecione um tipo de dados que seja compatível com os dados que a variável armazenará.
Para salvar o pacote atualizado, selecione Salvar itens selecionados no menu Arquivo .
Para adicionar uma variável a um pacote filho
No SSDT (SQL Server Data Tools), abra o projeto Integration Services que contém o pacote ao qual você deseja adicionar uma configuração de variável pai.
No Gerenciador de Soluções, clique duas vezes no pacote para abri-lo.
No Designer SSIS, para definir o escopo para o pacote, selecione qualquer lugar na superfície de design da guia Fluxo de Controle .
Adicione e configure uma variável.
Observação
Selecione um tipo de dados que seja compatível com os dados que a variável armazenará.
Para salvar o pacote atualizado, selecione Salvar itens selecionados no menu Arquivo .
Criar um utilitário de implantação
A primeira etapa na implantação de pacotes é criar 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 implantar os 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 está armazenado.
Você cria um utilitário de implantação de pacote para um projeto do Integration Services primeiro configurando o processo de compilação para criar um utilitário de implantação e, em seguida, criando o projeto. Quando você cria o projeto, todos os pacotes e configurações de pacote no 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 Integration Services. Quando o projeto é construído, esses arquivos também são incluídos automaticamente.
Você pode configurar cada implantação de projeto de forma diferente. Antes de criar o projeto e o utilitário de implantação de pacote, você pode definir as propriedades no utilitário de implantação para personalizar a maneira como os pacotes no projeto serão implantados. Por exemplo, você pode especificar se as configurações de 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 | Description |
|---|---|
| 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 de pacote é criado quando o projeto é criado. Essa propriedade deve ser True para criar um utilitário de implantação. |
| DeploymentOutputPath | O local, relativo ao projeto 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, juntamente com cópias dos pacotes de projeto e dependências do pacote, à pasta bin\Deployment no projeto ou ao local especificado na propriedade DeploymentOutputPath. O arquivo de manifesto lista os pacotes, as configurações de pacote e quaisquer arquivos diversos no projeto.
O conteúdo da pasta de implantação é atualizado sempre que você cria o projeto. Isso significa que qualquer arquivo salvo nesta pasta que não seja copiado para a pasta novamente pelo processo de compilação será excluído. Por exemplo, os arquivos de configuração do pacote salvos nas pastas de implantação serão excluídos.
Para criar um utilitário de implantação de pacote
No SSDT (SQL Server Data Tools), abra a solução que contém o projeto Integration Services para o qual você deseja criar um utilitário de implantação de pacote.
Clique com o botão direito do mouse no projeto e selecione Propriedades.
Na caixa de diálogo Property Pages do nome> do< projeto, selecione Deployment Utility.
Para atualizar as configurações do pacote quando os pacotes são implantados, defina AllowConfigurationChanges como True.
Defina CreateDeploymentUtility como True.
Opcionalmente, atualize o local do utilitário de implantação modificando a propriedade DeploymentOutputPath .
Selecione OK.
No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Compilar.
Veja 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 tiver criado 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, você deve primeiro copiar a pasta de implantação para o computador de destino.
O caminho da pasta de implantação é especificado na propriedade DeploymentOutputPath do projeto Integration Services para o qual você criou o utilitário de implantação. O caminho padrão é bin\Deployment, relativo ao projeto Integration Services. .
Use 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 copiar a pasta de implantação para o servidor. Este arquivo é chamado nome> do <projeto. SSISDeploymentManifest e pode ser encontrado na pasta de implantação no computador de destino.
Observação
Dependendo da versão do pacote que você está implantando, você pode encontrar um erro se tiver versões diferentes do SQL Server instaladas lado a lado. Este erro pode ocorrer porque o arquivo . A extensão de nome de arquivo SSISDeploymentManifest é a mesma para todas as versões do Integration Services. Clicar duas vezes no arquivo chama o instalador (dtsinstall.exe) para a versão instalada mais recentemente do Integration Services, que pode não ser a mesma versão do arquivo do utilitário de implantação. Para contornar esse problema, execute a versão correta do dtsinstall.exe a partir da linha de comando e forneça o caminho do arquivo do utilitário de implantação.
O Assistente de Instalação de Pacotes orienta você pelas etapas de instalação de pacotes no sistema de arquivos ou no SQL Server. Você pode configurar a instalação das seguintes maneiras:
Escolhendo o tipo de local e o local para instalar os pacotes.
Escolhendo o local para instalar as dependências do pacote.
Validação dos pacotes depois que eles são instalados no servidor de destino.
As dependências baseadas em arquivo para pacotes são sempre instaladas no sistema de arquivos. Se você instalar um pacote no sistema de arquivos, as dependências serão instaladas na mesma pasta especificada para o pacote. Se você instalar um pacote no SQL Server, poderá especificar a pasta na qual armazenar as dependências baseadas em arquivo.
Se o pacote incluir configurações que você deseja modificar para uso no computador de destino, você pode atualizar os valores das propriedades usando o assistente.
Além de instalar pacotes usando o Assistente de Instalação de Pacotes, você pode copiar e mover pacotes usando 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
Abra a pasta de implantação no computador de destino.
Clique duas vezes no arquivo de manifesto, <nome> do projeto. SSISDeploymentManifest, para iniciar o Assistente de Instalação de Pacotes.
Na página Implantar Pacotes SSIS , selecione a opção de implantação do SQL Server .
Opcionalmente, selecione Validar pacotes após a instalação para validar pacotes depois que eles forem instalados no servidor de destino.
Na página Especificar SQL Server de destino , especifique a instância do SQL Server para instalar os pacotes e selecione um modo de autenticação. Se você selecionar Autenticação do SQL Server, deverá fornecer um nome de usuário e uma senha.
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.
Se o pacote incluir configurações, você poderá editá-las atualizando os valores na lista Valor na página Configurar Pacotes.
Se você optou por validar pacotes após a instalação, exiba os resultados da validação dos pacotes implantados.
Reimplantação de pacotes
Depois que um projeto for implantado, talvez seja necessário atualizar ou estender a funcionalidade do pacote e, em seguida, reimplantar o projeto do Integration Services que contém os pacotes atualizados. Como parte do processo de reimplantação de pacotes, você deve revisar as propriedades de configuração incluídas no utilitário de implantação. Por exemplo, talvez você não queira permitir alterações de configuração depois que o pacote for reimplantado.
Processo de reimplantação
Depois de concluir a atualização dos pacotes, reconstrua o projeto, copie a pasta de implantação para o computador de destino e execute novamente o Assistente de Instalação de Pacotes.
Se você atualizar apenas alguns pacotes no projeto, talvez não queira reimplantar o projeto inteiro. Para implantar apenas alguns pacotes, você pode criar um novo projeto do Integration Services, adicionar os pacotes atualizados ao novo projeto e, em seguida, criar e implantar o projeto. As configurações do pacote 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, incluindo os pacotes e arquivos diversos que ele contém e quaisquer dependências de pacote.
Antes de implantar pacotes, você pode criar configurações e, em seguida, 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 uma configuração que mapeia um valor para a propriedade que contém a cadeia de conexão.
Não é possível executar o Assistente de Instalação de Pacotes até criar um projeto do Integration Services e criar um utilitário de implantação.
As seções a seguir descrevem as páginas do assistente.
Bem-vindo à página do 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 pacote.
Não mostrar esta página inicial novamente
Selecione esta opção para ignorar a página inicial quando executar o assistente novamente.
Seguinte
Vá para a próxima página no assistente.
Acabamento
Vá para a página Concluir o Assistente de Instalação de Pacotes. Utilize esta opção se tiver voltado atrás nas páginas do assistente para rever as suas escolhas e tiver especificado todas as opções necessárias.
Página Configurar Pacotes
Use a página Configurar pacotes para editar configurações de pacotes.
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
Path
Exiba o caminho da propriedade a ser configurada.
Type
Exiba o tipo de dados da propriedade.
Valor
Especifique o valor da configuração.
Seguinte
Vá para a próxima página no assistente.
Acabamento
Vá para a página Concluir o Assistente de Instalação de Pacotes. Utilize esta opção se tiver voltado atrás nas páginas do assistente para rever as suas escolhas e tiver especificado todas as opções necessá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 o assistente usará para instalar arquivos do projeto especificado.
Seguinte
Instale os pacotes e suas dependências e vá para a próxima página do assistente quando a instalação for concluída.
Situação
Mostra o progresso da instalação do pacote.
Acabamento
Vá para a página Concluir o Assistente de Instalação de Pacotes. Use esta opção se tiver voltado atrás nas páginas do assistente para revisar suas escolhas e tiver especificado todas as opções necessárias.
Página Implantar Pacotes SSIS
Use a página Implantar Pacotes SSIS para especificar onde instalar os pacotes do Integration Services e suas dependências.
Opções
Implantação do sistema de arquivos
Implante pacotes e dependências em uma pasta especificada no sistema de arquivos.
Implantação do SQL Server
Implante pacotes e dependências em uma instância do SQL Server. Use essa opção se o SQL Server compartilhar 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 os pacotes devem ser validados após a instalação.
Seguinte
Vá para a próxima página no assistente.
Acabamento
Vá para a página Concluir o Assistente de Instalação de Pacotes. Utilize esta opção se tiver voltado atrás nas páginas do assistente para rever as suas escolhas e tiver especificado todas as opções necessárias.
Página de Validação de Pacotes
Use a página Validação de pacotes para exibir o progresso e os resultados da validação do pacote.
Seguinte
Vá para a próxima página no assistente.
Página Selecionar Pasta de Instalação
Use a página Selecionar Pasta de Instalação para especificar a pasta do sistema de arquivos na qual instalar os pacotes e suas dependências.
Opções
Folder
Especifique o caminho e a pasta na qual copiar o pacote e suas dependências.
Procurar
Navegue até a pasta de destino usando a caixa de diálogo Procurar pasta .
Seguinte
Vá para a próxima página no assistente.
Acabamento
Vá para a página Concluir o Assistente de Instalação de Pacotes. Utilize esta opção se tiver voltado atrás nas páginas do assistente para rever as suas escolhas e se tiver especificado todas as opções necessárias.
Especificar página do SQL Server de destino
Use a página Especificar SQL Server de Destino para especificar opções de implantação do pacote em uma instância do SQL Server.
Opções
Nome do servidor
Especifique o nome do servidor no qual implantar os pacotes.
Usar a Autenticação do Windows
Especifique se deseja usar a Autenticação do Windows para entrar no servidor. A Autenticação do Windows é recomendada para uma melhor segurança.
Usar a autenticação do SQL Server
Especifique se o pacote deve usar a Autenticação do SQL Server para entrar no servidor. Se você usar a Autenticação do SQL Server, deverá fornecer um nome de usuário e uma senha.
Nome de utilizador
Especifique um nome de usuário.
Palavra-passe
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 SSIS , selecione Procurar (...). No entanto, a caixa de diálogo não fornece um meio de selecionar a pasta padrão. Se você quiser usar a pasta padrão, você tem que digitar "/" 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".
Confie no armazenamento do servidor para criptografia
Selecione esta opção para usar os recursos de segurança do Mecanismo de Banco de Dados para ajudar a proteger os pacotes.
Seguinte
Vá para a próxima página no assistente.
Acabamento
Vá para a página Concluir o Assistente de Instalação de Pacotes. Utilize esta opção se tiver voltado atrás nas páginas do assistente para rever as suas escolhas e tiver especificado todas as opções necessárias.
Concluir a página de instalação do pacote
Use a página Concluir o Assistente de Instalação de Pacotes para exibir um resumo dos resultados da instalação do pacote. Esta página fornece detalhes como o nome do projeto Integration Services implantado, os pacotes que foram instalados, os arquivos de configuração e o local de instalação.
Acabamento
Saia do assistente clicando em Concluir.