Implantar projetos e pacotes do Integration Services (SSIS)

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

Integration Services dá suporte a dois modelos de implantação, o modelo de implantação de projeto e o modelo de implantação de pacote herdado. O modelo de implantação de projeto permite que você implante seus projetos no servidor do Integration Services .

Para obter mais informações sobre o modelo de implantação de pacote herdado, confira Implantação de pacote herdado (SSIS).

Compare o modelo de implantação de projeto e o modelo de implantação de pacote herdado

O tipo de modelo de implantação que você escolhe para um projeto determina quais opções de desenvolvimento e administrativas estão disponíveis para aquele projeto. A tabela a seguir mostra as diferenças e as semelhanças entre o uso do modelo de implantação de projeto e o uso do modelo de implantação de pacote.

Ao usar o modelo de implantação de projeto	Quando usar o modelo de implantação de pacote herdado
Um projeto é a unidade de implantação.	Um pacote é a unidade de implantação.
Parâmetros são usados para atribuir valores a propriedades de pacote.	As configurações são usadas para atribuir valores a propriedades de pacote.
Um projeto, que contém pacotes e parâmetros, é compilado em um arquivo de implantação de projeto (extensão .ispac).	Os pacotes (extensão .dtsx) e as configurações (extensão .dtsConfig) são salvos individualmente no sistema de arquivos.
Um projeto que contém pacotes e parâmetros é implantado no catálogo do SSISDB em uma instância do SQL Server.	Os pacotes e as configurações são copiados no sistema de arquivos em outro computador. Os pacotes também podem ser salvos no banco de dados msdb ou em uma instância do SQL Server.
A integração CLR é necessária no mecanismo de banco de dados.	A integração CLR não é necessária no mecanismo de banco de dados.
Os valores dos parâmetros específicos ao ambiente são armazenados em variáveis de ambiente.	Os valores de configuração específicos ao ambiente são armazenados nos arquivos de configuração.
Os projetos e pacotes do catálogo podem ser validados no servidor antes da execução. Você pode usar o SQL Server Management Studio, procedimentos armazenados ou código gerenciado para executar a validação.	Os pacotes são validados antes da execução. Você também pode validar um pacote com o código gerenciado dtExec.
Os pacotes são executados com o início de uma execução no mecanismo de banco de dados. Um identificador de projeto, valores de parâmetros explícitos (opcional) e referências ao ambiente (opcional) são atribuídos a uma execução antes de ela ser iniciada. Também é possível executar pacotes usando dtExec.	Os pacotes são executados com os utilitários de execução dtExec e DTExecUI . As configurações aplicáveis são identificadas por argumentos de prompt de comando (opcional).
Durante a execução, os eventos produzidos pelo pacote são capturados automaticamente e salvos no catálogo. Você pode consultar esses eventos com exibições Transact-SQL.	Durante a execução, os eventos produzidos por um pacote não são capturados automaticamente. Um provedor de log deve ser adicionado ao pacote para capturar eventos.
Os pacotes são executados em um processo separado do Windows.	Os pacotes são executados em um processo separado do Windows.
O SQL Server Agent é usado para agendar a execução do pacote.	O SQL Server Agent é usado para agendar a execução do pacote.

Recursos do modelo de implantação de projeto

A tabela a seguir lista os recursos que estão disponíveis para projetos desenvolvidos apenas para o modelo de implantação de projeto.

Recurso	Descrição
Parâmetros	Um parâmetro especifica os dados que serão usados por um pacote. Você pode definir o escopo dos parâmetros no nível do pacote ou do projeto com parâmetros de pacote e de projeto, respectivamente. Os parâmetros podem ser usados em expressões ou tarefas. Quando o projeto é implantado no catálogo, você pode atribuir um valor literal para cada parâmetro ou usar o valor padrão que foi atribuído em tempo de design. Em lugar de um valor literal, você também pode fazer referência a uma variável de ambiente. Os valores de variáveis de ambiente são resolvidos na hora da execução do pacote.
Ambientes	Um ambiente é um contêiner de variáveis que podem ser referenciadas por projetos do Integration Services . Cada projeto pode ter várias referências de ambiente, mas uma única instância de execução de pacote pode fazer referência apenas a variáveis de um único ambiente. Os ambientes permitem organizar os valores que você atribui a um pacote. Por exemplo, você pode ter ambientes denominados "Desenvolvimento", "Teste" e "Produção".
Variáveis de ambiente	Uma variável de ambiente define um valor literal que pode ser atribuído a um parâmetro durante a execução do pacote. Para usar uma variável de ambiente, crie uma referência de ambiente (no projeto que corresponde ao ambiente que tem o parâmetro), atribua um valor de parâmetro ao nome da variável de ambiente e especifique a referência de ambiente correspondente ao configurar uma instância de execução.
Catálogo do SSISDB	Todos os objetos do Integration Services são armazenados e gerenciados em uma instância do SQL Server em um banco de dados chamado de catálogo do SSISDB. O catálogo permite usar pastas para organizar seus projetos e ambientes. Cada instância do SQL Server pode ter um catálogo. Cada catálogo pode ter zero ou mais pastas. Cada pasta pode ter zero ou mais projetos e zero ou mais ambientes. Uma pasta do catálogo também pode ser usada como um limite para permissões para objetos do Integration Services .
Procedimentos armazenados e exibições do catálogo	Um grande número de procedimentos armazenados e exibições pode ser usado para gerenciar objetos do Integration Services no catálogo. Por exemplo, você pode especificar valores para parâmetros e variáveis de ambiente, criar e iniciar execuções e monitorar operações do catálogo. É possível até ver exatamente quais valores serão usados por um pacote antes do início da execução.

Implantação de projeto

No centro do modelo de implantação do projeto está o arquivo de implantação do projeto (extensão .ispac). O arquivo de implantação do projeto é uma unidade independente de implantação que inclui apenas as informações essenciais sobre os pacotes e parâmetros do projeto. O arquivo de implantação do projeto não captura todas as informações contidas no arquivo do projeto do Integration Services (extensão .dtproj). Por exemplo, arquivos de texto adicionais que você usa para escrever observações não são armazenados no arquivo de implantação do projeto e, portanto, não são implantados no catálogo.

Permissões necessárias para implantar projetos e pacotes do SSIS

Se você alterar a conta de serviço do SSIS do padrão, precisará conceder permissões adicionais para a conta de serviço não padrão antes de implantar pacotes com êxito. Se a conta de serviço não padrão não tiver as permissões necessárias, você poderá ver a mensagem de erro a seguir.

A .NET Framework error occurred during execution of user-defined routine or aggregate "deploy_project_internal": System.ComponentModel.Win32Exception: A required privilege is not held by the client.

Esse erro normalmente é o resultado de permissões DCOM ausentes. Para corrigir o erro, faça o seguinte:

1. Abra o console Serviços de Componentes (ou execute Dcomcnfg.exe).
2. No console Serviços de Componentes, expanda Serviços de Componentes>Computadores>Meu Computador>Configuração do DCOM.
3. Na lista, localize Microsoft SQL Server Integration Services xx.0 na versão do SQL Server que está sendo usada. Por exemplo, o SQL Server 2016 é a versão 13.
4. Clique com o botão direito do mouse e selecione Propriedades.
5. Na caixa de diálogo Propriedades do Microsoft SQL Server Integration Services 13.0, selecione a guia Segurança.
6. Para cada um dos três conjuntos de permissões – Inicialização e Ativação, Acesso e Configuração – selecione Personalizar e, em seguida, Editar para abrir a caixa de diálogo Permissão.
7. Na caixa de diálogo Permissão, adicione a conta de serviço não padrão e conceda permissões Permitir, conforme necessário. Normalmente, uma conta tem as permissões Inicialização Local e Ativação Local.
8. Selecione OK duas vezes e, em seguida, feche o console dos Serviços de Componentes.

Para obter mais informações sobre o erro descrito nesta seção e sobre as permissões necessárias para a conta de serviço do SSIS, confira a seguinte postagem no blog:

• System.ComponentModel.Win32Exception: o cliente não tem um privilégio obrigatório durante a Implantação de Projeto do SSIS

Implantar projetos no servidor do Integration Services

Na versão atual do Integration Services, você pode implantar seus projetos no servidor do Integration Services . O servidor do Integration Services permite gerenciar pacotes, executar pacotes, e configura valores de runtime para pacotes por meio de ambientes.

Para implantar um projeto no servidor do Integration Services , conclua as tarefas a seguir:

1. Criar um catálogo do SSISDB se ainda não tiver criado. Para obter mais informações, consulte Catálogo do SSIS.

2. Converta o projeto no modelo de implantação de projeto executando o Assistente de Conversão de Projeto do Integration Services. Para obter mais informações, confira as seguintes instruções: Para converter um projeto no modelo de implantação de projeto

   • Se você criou o projeto no SQL Server 2014 Integration Services (SSIS) ou posterior, por padrão, o projeto usa o modelo de implantação de projeto.

   • Se você criou o projeto em uma versão anterior do Integration Services, depois que abrir o arquivo de projeto no Visual Studio, converta o projeto no modelo de implantação de projeto.

     Observação

     Se o projeto contiver uma ou mais fontes de dados, as fontes de dados serão removidas quando a conversão de projeto estiver concluída. Para criar uma conexão com uma fonte de dados que pode ser compartilhada pelos pacotes no projeto, adicione um gerenciador de conexões no nível de projeto. Para obter mais informações, consulte adicionar, excluir ou compartilhar um Gerenciador de Conexão em um pacote.

     Dependendo em se você executa o Assistente de Conversão de Projeto do Integration Services no Visual Studio ou no SQL Server Management Studio, o assistente executa tarefas de conversão diferentes.

     • Se você executar o assistente de Visual Studio, os pacotes contidos no projeto serão convertidos de Integration Services 2005, 2008 ou 2008 R2 no formato usado pela versão atual do Integration Services. O projeto original (.dtproj) e os arquivos de pacotes (.dtsx) são atualizados.

     • Se você executar o assistente de SQL Server Management Studio, ele gerará um arquivo de implantação de projeto (.ispac) de pacotes e configurações contidos no projeto. Os arquivos de pacote original (.dtsx) não são atualizados.

       Você pode selecionar um arquivo existente ou criar um novo arquivo, na página Destino de Seleção do assistente.

       Para atualizar arquivos de pacotes quando um projeto é convertido, execute o Assistente de Conversão de Projeto do Integration Services de Visual Studio. Para atualizar os arquivos de pacotes separadamente de uma conversão de projeto, execute o Assistente de Conversão de Projeto do Integration Services do SQL Server Management Studio e, em seguida, execute o Assistente de Atualização de Pacotes SSIS. Se você atualizar os arquivos de pacotes separadamente, verifique se você salvou as alterações. Caso contrário, quando você converter o projeto no modelo de implantação de projeto, todas as alterações não salvas no pacote não serão convertidas.

   Para obter mais informações sobre a atualização de pacotes, consulte Atualizar pacotes do Integration Services e Atualizar pacotes do Integration Services usando o Assistente de Atualização de Pacote SSIS.

3. Implante o projeto no servidor do Integration Services . Para obter mais informações, confira as instruções abaixo: Para implantar um projeto no Servidor do Integration Services.

4. (Opcional) Crie um ambiente para o projeto implantado.

Para converter um projeto no modelo de implantação de projeto

1. Abra o projeto no Visual Studio e, no Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Converter em Modelo de Implantação de Projeto.

   -ou-

   No Pesquisador de Objetos, no Management Studio, clique com o botão direito do mouse no nó Projetos e selecione Importar Pacotes.

2. Conclua o assistente.

Para implantar um projeto no Servidor do Integration Services

1. Abra o projeto no Visual Studioe, em seguida, no menu Projeto , selecione Implantar para implantar o Assistente de Implantação do Integration Services.

   ou

   No SQL Server Management Studio, expanda o nó Integration Services >SSISDB no Pesquisador de Objetos e localize a pasta Projetos do projeto que você deseja implantar. Clique com o botão direito do mouse na pasta Projetos e selecione Implantar Projetos.

   ou

   No prompt de comando, execute isdeploymentwizard.exe de %ProgramFiles%\Microsoft SQL Server\130\DTS\Binn. Em computadores de 64 bits, há também uma versão de 32 bits da ferramenta em %ProgramFiles(x86)%\Microsoft SQL Server\130\DTS\Binn.

2. Na página Selecionar Origem, selecione Arquivo de implantação de projeto para selecionar o arquivo de implantação do projeto.

   ou

   Selecione Catálogo do Integration Services para selecionar um projeto que já foi implantado no catálogo do SSISDB.

3. Conclua o assistente.

Implantar pacotes no Servidor do Integration Services

O recurso de Implantação de pacotes incremental introduzido no SSIS (SQL Server 2016 Integration Services) permite que você implante um ou mais pacotes em um projeto novo ou existente, sem implantar o projeto inteiro.

Implantar pacotes usando o Assistente de implantação do Integration Services

1. No prompt de comando, execute isdeploymentwizard.exe de %ProgramFiles%\Microsoft SQL Server\130\DTS\Binn. Em computadores de 64 bits, há também uma versão de 32 bits da ferramenta em %ProgramFiles(x86)%\Microsoft SQL Server\130\DTS\Binn.

2. Na página Selecionar fonte , mude para Modelo de implantação do pacote. Em seguida, selecione a pasta que contém pacotes de origem e configure os pacotes.

3. Conclua o assistente. Siga as etapas restantes descritas em Modelo de Implantação do Pacote.

Implantar pacotes usando o SQL Server Management Studio

1. No SQL Server Management Studio, expanda o nó Catálogos do Integration Services>SSISDB no Pesquisador de Objetos.

2. Clique com o botão direito do mouse na pasta Projetos e selecione Implantar Projetos.

3. Se você vir a página Introdução, selecione Avançar para continuar.

4. Na página Selecionar fonte , mude para Modelo de implantação do pacote. Em seguida, selecione a pasta que contém pacotes de origem e configure os pacotes.

5. Conclua o assistente. Siga as etapas restantes descritas em Modelo de Implantação do Pacote.

Implantar pacotes usando o SQL Server Data Tools (Visual Studio)

1. No Visual Studio, com um projeto do Integration Services aberto, selecione o pacote ou pacotes que você quer implantar.

2. Clique com o botão direito do mouse e selecione Implantar Pacote. O Assistente de implantação é aberto com os pacotes selecionados configurados como pacotes de código-fonte.

3. Conclua o assistente. Siga as etapas restantes descritas em Modelo de Implantação do Pacote.

Implantar pacotes usando o procedimento armazenado deploy_packages

Você pode usar o procedimento armazenado [catalog].[ deploy_packages] para implantar um ou mais pacotes do SSIS no catálogo do SSIS. O exemplo de código a seguir demonstra o uso desse procedimento armazenado para implantar pacotes em um servidor SSIS. Para obter mais informações, consulte catalog.deploy_packages.

private static void Main(string[] args)
{
    // Connection string to SSISDB
    var connectionString = "Data Source=.;Initial Catalog=SSISDB;Integrated Security=True;MultipleActiveResultSets=false";

    using (var sqlConnection = new SqlConnection(connectionString))
    {
        sqlConnection.Open();

        var sqlCommand = new SqlCommand
        {
            Connection = sqlConnection,
            CommandType = CommandType.StoredProcedure,
            CommandText = "[catalog].[deploy_packages]"
        };

        var packageData = Encoding.UTF8.GetBytes(File.ReadAllText(@"C:\Test\Package.dtsx"));

        // DataTable: name is the package name without extension and package_data is byte array of package.
        var packageTable = new DataTable();
        packageTable.Columns.Add("name", typeof(string));
        packageTable.Columns.Add("package_data", typeof(byte[]));
        packageTable.Rows.Add("Package", packageData);

        // Set the destination project and folder which is named Folder and Project.
        sqlCommand.Parameters.Add(new SqlParameter("@folder_name", SqlDbType.NVarChar, ParameterDirection.Input, "Folder", -1));
        sqlCommand.Parameters.Add(new SqlParameter("@project_name", SqlDbType.NVarChar, ParameterDirection.Input, "Project", -1));
        sqlCommand.Parameters.Add(new SqlParameter("@packages_table", SqlDbType.Structured, ParameterDirection.Input, packageTable, -1));

        var result = sqlCommand.Parameters.Add("RetVal", SqlDbType.Int);
        result.Direction = ParameterDirection.ReturnValue;

        sqlCommand.ExecuteNonQuery();
    }
}

Implantar pacotes usando a API do Modelo de objeto de gerenciamento

O exemplo de código a seguir demonstra o uso da API do Modelo de objeto de gerenciamento para implantar pacotes no servidor.

static void Main()
 {
     // Before deploying packages, make sure the destination project exists in SSISDB.
     var connectionString = "Data Source=.;Integrated Security=True;MultipleActiveResultSets=false";
     var catalogName = "SSISDB";
     var folderName = "Folder";
     var projectName = "Project";

     // Get the folder instance.
     var sqlConnection = new SqlConnection(connectionString);
     var store = new Microsoft.SqlServer.Management.IntegrationServices.IntegrationServices(sqlConnection);
     var folder = store.Catalogs[catalogName].Folders[folderName];

     // Key is package name without extension and value is package binaries.
     var packageDict = new Dictionary<string, string>();

     var packageData = File.ReadAllText(@"C:\Folder\Package.dtsx");
     packageDict.Add("Package", packageData);

     // Deploy package to the destination project.
     folder.DeployPackages(projectName, packageDict);
 }

Caixa de diálogo Converter em Modelo de Implantação de Pacote

A caixa de diálogo Converter em Modelo de Implantação de Pacote permite converter um pacote para o modelo de implantação de pacote depois de verificar se o projeto e cada pacote do projeto são compatíveis com esse modelo. Se um pacote usar recursos exclusivos para o modelo de implantação de projeto, como parâmetros, o pacote não poderá ser convertido.

Converter um pacote para o modelo de implantação de pacote exige duas etapas.

1. Quando você seleciona o comando Converter em Modelo de Implantação de Pacote no menu Project , o projeto e cada pacote do projeto terão a compatibilidade verificada com esse modelo. Os resultados são exibidos na tabela Resultados .

   Se o projeto ou pacote falhar no teste de compatibilidade, selecione Falha na coluna Resultado para obter mais informações. Selecione Salvar Relatório para salvar uma cópia destas informações em um arquivo de texto.

2. Se o projeto e todos os pacotes passarem no teste de compatibilidade, selecione OK para converter o pacote.

Assistente de Implantação do Integration Services

O Assistente de Implantação do Integration Services dá suporte a dois modelos de implantação:

• Modelo de implantação de projeto
• Modelo de implantação do pacote

O modelo de Implantação do Projeto permite implantar um projeto do SSIS (SQL Server Integration Services) como uma única unidade no Catálogo do SSIS.

O modelo de Implantação do Pacote permite implantar pacotes que você atualizou no Catálogo do SSIS sem precisar implantar o projeto todo.

Iniciar o assistente

Inicie o assistente:

• Digitando “Assistente de Implantação do SQL Server” no Windows Search

ou

• Pesquisando o arquivo executável ISDeploymentWizard.exe na pasta de instalação do SQL Server; por exemplo: "C:\Arquivos de Programas (x86)\Microsoft SQL Server\130\DTS\Binn".

As configurações nessa página são diferentes para cada modelo de implantação. Siga as etapas na seção Modelo de implantação de projeto ou na seção Modelo de implantação de pacote de acordo com o modelo selecionado nessa página.

Modelo de Implantação do Projeto

Selecionar fonte

Para implantar um arquivo de implantação do projeto que você criou, selecione Arquivo de implantação do projeto e insira o caminho para o arquivo .ispac. Para implantar um projeto residente no catálogo Integration Services , selecione Catálogo do Integration Servicese insira o nome do servidor e o caminho para o projeto no catálogo. Selecione Avançar para ver a página Selecionar Destino.

Selecionar Destino

Para selecionar a pasta de destino para o projeto no catálogo Integration Services , insira a instância SQL Server ou selecione Procurar para selecionar de uma lista de servidores. Digite o caminho do projeto no SSISDB ou selecione Procurar para selecioná-lo. Selecione Avançar para abrir a página Revisar.

Revisar (e implantar)

A página permite revisar as configurações que você selecionou. Você pode alterar suas seleções selecionando Anterior ou selecionando qualquer uma das etapas no painel esquerdo. Selecione Implantar para iniciar o processo de implantação.

Resultados

Depois que o processo de implantação estiver concluído, você deverá ver a página Resultados . Essa página exibe o êxito ou a falha de cada ação. Se a ação falhar, selecione Com falha na coluna Resultado para exibir uma explicação do erro. Selecione Salvar Relatório... para salvar os resultados em um arquivo XML ou clique em Fechar para sair do assistente.

Modelo de Implantação do Pacote

Selecionar fonte

A página Selecionar Origem no Assistente de Implantação do Integration Services mostra configurações específicas ao modelo de implantação do pacote quando você selecionou a opção Implantação do Pacote para o modelo de implantação.

Para selecionar os pacotes de origem, selecione o botão Procurar… para selecionar a pasta que contém os pacotes ou digite o caminho da pasta na caixa de texto Caminho da pasta de pacotes e selecione o botão Atualizar na parte inferior da página. Agora, você deve ver todos os pacotes na pasta especificada na caixa de listagem. Por padrão, todos os pacotes são selecionados. Marque a caixa de seleção na primeira coluna para escolher quais pacotes você deseja que sejam implantados no servidor.

Consulte as colunas Status e Mensagem para verificar o status do pacote. Se o status estiver definido como Pronto ou Aviso, o assistente de implantação não bloqueará o processo de implantação. Se o status for definido como Erro, o assistente não prosseguirá para implantar os pacotes selecionados. Para exibir as mensagens de aviso ou erro detalhadas, selecione o link da coluna Mensagem.

Se os dados confidenciais ou dados de pacote forem criptografados com uma senha, digite-a na coluna Senha e selecione o botão Atualizar para verificar se ela é aceita. Se a senha estiver correta, o status mudará para Pronto e a mensagem de aviso desaparecerá. Se houver vários pacotes com a mesma senha, selecione os pacotes com a mesma senha de criptografia, digite a senha na caixa de texto Senha e selecione o botão Aplicar. A senha deve ser aplicada aos pacotes selecionados.

Se o status de todos os pacotes selecionados não estiver definido como Erro, o botão Avançar será habilitado para que você possa continuar com o processo de implantação do pacote.

Selecionar Destino

Após a seleção das origens do pacote, selecione o botão Avançar para alternar para a página Selecionar Destino. Os pacotes devem ser implantados em um projeto no Catálogo do SSIS (SSISDB). Antes de implantar pacotes, verifique se o projeto de destino já existe no Catálogo do SSIS. Crie um projeto vazio se não houver um projeto. Na página Selecionar Destino, digite o nome do servidor na caixa de texto Nome do Servidor ou selecione o botão Procurar... para selecionar uma instância de servidor. Em seguida, selecione o botão Procurar... ao lado da caixa de texto Caminho para especificar o projeto de destino. Se o projeto não existir, selecione o botão Novo projeto... para criar um projeto vazio como o projeto de destino. O projeto precisa ser criado em uma pasta.

Revisar e implantar

Selecione Avançar na página Selecionar Destino para acessar a página Revisar no Assistente de Implantação do Integration Services. Na página de revisão, revise o relatório de resumo sobre a ação de implantação. Após a verificação, selecione o botão Implantar para executar a ação de implantação.

Resultados

Depois que a implantação estiver concluída, você deverá ver a página Resultados . Na página Resultados, examine os resultados de cada etapa no processo de implantação. Selecione Salvar Relatório para salvar o relatório de implantação ou em Fechar para fechar o assistente.

Criar e mapear um ambiente de servidor

Você cria um ambiente de servidor para especificar valores de runtime para pacotes contidos em um projeto que você implantou no servidor do Integration Services. Você pode mapear as variáveis de ambiente para parâmetros, para um pacote específico, para pacotes de ponto de entrada ou para todos os pacotes em um projeto específico. Um pacote de ponto de entrada é geralmente um pacote pai que executa um pacote filho.

Você pode consultar as exibições para uma lista de ambientes de servidor, referências de ambiente e variáveis de ambiente. Você também pode chamar procedimentos armazenados para adicionar, excluir, alterar e modificar ambientes, referências de ambiente e variáveis de ambiente. Para obter mais informações, confira a seção Ambientes de servidor, variáveis de servidor e referências de ambiente de servidor no Catálogo do SSIS.

Para criar e usar um ambiente de servidor

1. No Management Studio, expanda o nó Catálogos do Integration Services SSISDB no Pesquisador de Objetos e localize a pasta Ambientes do projeto para o qual você deseja criar um ambiente.

2. Clique com o botão direito do mouse na pasta Ambientes e selecione Criar Ambiente.

3. Digite um nome para o ambiente e, opcionalmente, adicione uma descrição. Selecione OK.

4. Clique com o botão direito do mouse no novo ambiente e selecione Propriedades.

5. Na página Variáveis , faça o seguinte para adicionar uma variável.

   1. Selecione o Tipo da variável. O nome da variável não precisa corresponder ao nome do parâmetro do projeto que você mapeará para a variável.

   2. Digite uma Descrição opcional para a variável.

   3. Digite o Valor para a variável de ambiente.

      Para obter informações sobre as regras para nomes de variável de ambiente, consulte a seção Variável do ambiente em SSIS Catalog.

   4. Indica se a variável contém o valor confidencial, marcando ou desmarcando a caixa de seleção Confidencial .

      Se você selecionar Confidencial, o valor da variável não será exibido no campo Valor .

      Os valores confidenciais são criptografados no catálogo do SSISDB. Para obter mais informações sobre a criptografia SSL, consulte SSIS Catalog.

6. Na página Permissões , conceda ou negue permissões para usuários e funções selecionados fazendo o seguinte.

   1. Selecione Procurar e, em seguida, selecione um ou mais usuários e funções na caixa de diálogo Procurar Todas as Entidades de Segurança.

   2. Na área Logons ou funções , selecione o usuário ou função ao qual você quer conceder ou negar permissões.

   3. Na área Explícita, selecione Conceder ou Negar ao lado de cada permissão.

7. Para criar o script do ambiente, selecione Script. Por padrão, o script é exibido em uma nova janela do Editor de Consultas.

   Dica

   Você precisará selecionar Script depois de ter feito uma ou mais alterações às propriedades do ambiente, como adicionar uma variável e antes de selecionar OK na caixa de diálogo Propriedades do Ambiente. Caso contrário, um script não será gerado.

8. Selecione OK para salvar suas alterações nas propriedades de ambiente.

9. No nó SSISDB no Pesquisador de Objetos, expanda a pasta Projetos, clique com o botão direito do mouse no projeto e, em seguida, selecione Configurar.

10. Na página Referências, selecione Adicionar para adicionar um ambiente e, em seguida, OK para salvar a referência para o ambiente.

11. Clique novamente com o botão direito do mouse no projeto e selecione Configurar.

12. Para mapear a variável de ambiente para um parâmetro adicionado ao pacote em tempo de design ou para um parâmetro gerado quando você converteu o projeto do Integration Services no modelo de implantação de projeto, faça o seguinte:

    1. Na guia Parâmetros na página Parâmetros, selecione o botão Procurar ao lado do campo Valor.

    2. Clique em Usar variável de ambiente e selecione a variável de ambiente que você criou.

13. Para mapear a variável de ambiente para uma propriedade de gerenciador de conexões, siga os procedimentos a seguir. Os parâmetros são gerados automaticamente no servidor do SSIS para as propriedades do gerenciador de conexões.

    1. Na guia Gerenciadores de Conexões na página Parâmetros, selecione o botão Procurar ao lado do campo Valor.

    2. Clique em Usar variável de ambiente e selecione a variável de ambiente que você criou.

14. Selecione OK duas vezes para salvar suas alterações.

Implantar e executar pacotes SSIS usando procedimentos armazenados

Quando configura um projeto do Integration Services para usar o modelo de implantação de projeto, você pode usar procedimentos armazenados no catálogo do SSIS para implantar o projeto e executar os pacotes. Para obter informações sobre o modelo de implantação de projeto, consulte Implantação de projetos e pacotes.

Você também pode usar o SQL Server Management Studio ou o SQL Server Data Tools (SSDT) para implantar o projeto e executar os pacotes. Para obter mais informações, consulte os tópicos na seção Consulte também .

Para implantar e executar um pacote usando procedimentos armazenados

1. Chame catalog.deploy_project (Banco de Dados SSISDB) para implantar o projeto Integration Services que contém o pacote para o servidor Integration Services.

   Para recuperar o conteúdo binário do arquivo de implantação do projeto do Integration Services, para o parâmetro @project_stream, use uma instrução SELECT com a função OPENROWSET e o provedor de conjunto de linhas BULK. O conjuntos de linhas BULK permite a você ler dados de um arquivo. O argumento SINGLE_BLOB do provedor de conjuntos de linhas BULK retorna o conteúdo do arquivo de dados como uma única linha, um conjunto de linhas de coluna única do tipo varbinary(max). Para obter mais informações, confira OPENROWSET (Transact-SQL).

   No exemplo a seguir, o projeto SSISPackages_ProjectDeployment é implantado na pasta Pacotes SSIS no servidor do Integration Services . Os dados binários são lidos no arquivo de projeto (SSISPackage_ProjectDeployment.ispac) e armazenados no parâmetro _@ProjectBinary do tipo varbinary(max). O valor do parâmetro @ProjectBinary é atribuído ao parâmetro @project_stream.

   DECLARE @ProjectBinary as varbinary(max)
   DECLARE @operation_id as bigint
   Set @ProjectBinary = (SELECT * FROM OPENROWSET(BULK 'C:\MyProjects\ SSISPackage_ProjectDeployment.ispac', SINGLE_BLOB) as BinaryData)
   
   Exec catalog.deploy_project @folder_name = 'SSIS Packages', @project_name = 'DeployViaStoredProc_SSIS', @Project_Stream = @ProjectBinary, @operation_id = @operation_id out
   

2. Chame catalog.create_execution (Banco de Dados SSISDB) para criar uma instância da execução do pacote e, opcionalmente, chame catalog.set_execution_parameter_value (Banco de Dados SSISDB) para definir valores de parâmetro de runtime.

   No exemplo a seguir, catalog.create_execution cria uma instância de execução para package.dtsx que está contida no projeto SSISPackage_ProjectDeployment. O projeto está localizado na pasta Pacotes SSIS. A execution_id retornada pelo procedimento armazenado é usado na chamada para catalog.set_execution_parameter_value. Esse segundo procedimento armazenado define o parâmetro LOGGING_LEVEL como 3 (log detalhado) e define um parâmetro de pacote denominado Parameter1 com um valor de 1.

   Para parâmetros como LOGGING_LEVEL, o valor de object_type é 50. Para parâmetros de pacote, o valor de object_type é 30.

   Declare @execution_id bigint
   EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Package.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'SSIS Packages', @project_name=N'SSISPackage_ProjectDeployment', @use32bitruntime=False, @reference_id=1
   
   Select @execution_id
   DECLARE @var0 smallint = 3
   EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,  @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var0
   
   DECLARE @var1 int = 1
   EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,  @object_type=30, @parameter_name=N'Parameter1', @parameter_value=@var1
   
   GO
   

3. Chame catalog.start_execution (Banco de Dados SSISDB) para executar o pacote.

   No exemplo a seguir, uma chamada a catalog.start_execution é adicionada ao Transact-SQL para iniciar a execução do pacote. A execution_id retornada pelo procedimento armazenado catalog.create_execution é usada.

   Declare @execution_id bigint
   EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Package.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'SSIS Packages', @project_name=N'SSISPackage_ProjectDeployment', @use32bitruntime=False, @reference_id=1
   
   Select @execution_id
   DECLARE @var0 smallint = 3
   EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,  @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var0
   
   DECLARE @var1 int = 1
   EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,  @object_type=30, @parameter_name=N'Parameter1', @parameter_value=@var1
   
   EXEC [SSISDB].[catalog].[start_execution] @execution_id
   GO
   

Para implantar um projeto de servidor para servidor usando procedimentos armazenados

Você pode implantar um projeto de um servidor a outros servidor usando os procedimentos armazenados catalog.get_project (Banco de dados SSISDB) e catalog.deploy_project (Banco de dados SSISDB).

Você precisa fazer o seguinte antes de executar os procedimentos armazenados:

• Crie um objeto de servidor vinculado. Para obter mais informações, confira Criar servidores vinculados (Mecanismo de Banco de Dados do SQL Server).

  Na página Opções do Servidor da caixa de diálogo Propriedades do Servidor Vinculado , defina RPC e RPC Out como True. Além disso, defina Habilitar Promoção de Transações Distribuídas para RPC como False.

• Habilite parâmetros dinâmicos para o provedor selecionado para o servidor vinculado expandindo o nó Provedores sob Servidores Vinculados no Pesquisador de Objetos, clicando com o botão direito do mouse no provedor e selecionando Propriedades. Selecione Habilitar ao lado de Parâmetro dinâmico.

• Confirme se o DTC (Distributed Transaction Coordinator) foi iniciado em ambos os servidores.

Chame catalog.get_project para retornar o binário do projeto e chame catalog.deploy_project. O valor retornado por catalog.get_project é inserido em uma variável de tabela do tipo varbinary(max). O servidor vinculado não pode retornar os resultados que são varbinary(max).

No exemplo a seguir, catalog.get_project retorna um binário para o projeto SSISPackages no servidor vinculado. O catalog.deploy_project implanta o projeto no servidor local, na pasta chamada DestFolder.

declare @resultsTableVar table (
project_binary varbinary(max)
)

INSERT @resultsTableVar (project_binary)
EXECUTE [MyLinkedServer].[SSISDB].[catalog].[get_project] 'Packages', 'SSISPackages'

declare @project_binary varbinary(max)
select @project_binary = project_binary from @resultsTableVar

exec [SSISDB].[CATALOG].[deploy_project] 'DestFolder', 'SSISPackages', @project_binary

Assistente de Conversão de Projeto do Integration Services

O Assistente de Conversão de Projeto do Integration Services converte um projeto no modelo de implantação de projeto.

O que você deseja fazer?

• Abrir o Assistente de Conversão de Projeto do Integration Services

• Definir opções na página Localizar Pacotes

• Definir opções na página Selecionar Pacotes

• Definir opções na página Selecionar Destino

• Definir opções na página Especificar Propriedades do Projeto

• Definir opções na página Atualizar a Tarefa Executar Pacote

• Definir opções na página Selecionar Configurações

• Definir opções na página Criar Parâmetros

• Definir opções na página Configurar Parâmetros

• Definir as opções na página Revisão

• Definir as opções em Executar Conversão

Abrir o Assistente de Conversão de Projeto do Integration Services

Siga um destes procedimentos para abrir o Assistente de Conversão de Projeto do Integration Services .

• Abra o projeto no Visual Studio e, no Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Converter em Modelo de Implantação de Projeto.

• Por meio do Pesquisador de Objetos no Management Studio, clique com o botão direito do mouse no nó Projetos no Catálogo do Integration Services e selecione Importar Pacotes.

Dependendo em se você executa o Assistente de Conversão de Projeto do Integration Services no Visual Studio ou no SQL Server Management Studio, o assistente executa tarefas de conversão diferentes.

Definir opções na página Localizar Pacotes

A opção a seguir é exibida na página quando você seleciona Sistema de arquivos na lista suspensa Origem. Selecione esta opção quando o pacote estiver no sistema de arquivos.

Pasta
Digite o caminho do pacote ou navegue para o pacote selecionando Procurar.

As opções a seguir são exibidas na página quando você seleciona Repositório de Pacotes SSIS na lista suspensa Origem. Para obter mais informações sobre o repositório de pacotes, confira Gerenciamento de Pacotes (Serviço SSIS).

Servidor
Digite o nome do servidor ou selecione o servidor.

Pasta
Digite o caminho do pacote ou navegue para o pacote selecionando Procurar.

As opções a seguir são exibidas na página quando você seleciona Microsoft SQL Server na lista suspensa Origem. Selecione esta opção quando o pacote estiver no Microsoft SQL Server.

Servidor
Digite o nome do servidor ou selecione o servidor.

Usar a autenticação do Windows
O modo de Autenticação do Microsoft Windows permite que um usuário se conecte por meio de uma conta de usuário do Windows. Se usar Autenticação do Windows, não será preciso fornecer um nome de usuário nem senha.

Usar Autenticação do SQL Server
Quando um usuário se conecta com um nome de logon e senha especificados em uma conexão não confiável, o SQL Server autentica a conexão verificando se foi definida uma conta de logon do SQL Server e se a senha especificada corresponde a uma senha registrada previamente. Se o SQL Server não tiver uma conta de logon definida, ocorrerá falha na autenticação e o usuário receberá uma mensagem de erro.

Nome de usuário
Especifique um nome de usuário quando você estiver usando a Autenticação do SQL Server.

Senha
Forneça uma senha quando você estiver usando a Autenticação do SQL Server.

Pasta
Digite o caminho do pacote ou navegue para o pacote selecionando Procurar.

Definir opções na página Selecionar Pacotes

Nome do Pacote
Lista o arquivo do pacote.

Status
Indica se um pacote está pronto para ser convertido ao modelo de implantação de projeto.

Message
Exibe uma mensagem associada ao pacote.

Senha
Exibe uma senha associada ao pacote. O texto da senha está oculto.

Aplicar à seleção
Selecione para aplicar a senha na caixa de texto Senha, para o pacote ou os pacotes selecionados.

Atualizar
Atualiza a lista de pacotes.

Definir opções na página Selecionar Destino

Nessa página, especifique o nome e o caminho de um novo arquivo de implantação de projeto (.ispac) ou selecione um arquivo existente.

Caminho de saída
Digite o caminho para o arquivo de implantação ou navegue para o arquivo selecionando Procurar.

Nome do projeto
Digite o nome do projeto.

Nível de proteção
Selecione o nível de proteção. Para obter mais informações, consulte Access Control for Sensitive Data in Packages.

Descrição do projeto
Digite uma descrição opcional para o projeto.

Definir opções na página Especificar Propriedades do Projeto

Nome do projeto
Lista o nome do projeto.

Nível de proteção
Selecione um nível de proteção para os pacotes contidos no projeto. Para obter mais informações sobre níveis de proteção, consulte Access Control for Sensitive Data in Packages.

Descrição do projeto
Digite uma descrição de projeto opcional.

Definir opções na página Atualizar a Tarefa Executar Pacote

Atualizar as Tarefas Executar Pacote contidas nos pacotes, para usar uma referência baseada em projeto. Para obter mais informações, consulte Execute Package Task Editor.

Pacote pai
Lista o nome do pacote que executa o pacote filho usando a tarefa Executar Pacote.

Nome da tarefa
Lista o nome da tarefa Executar Pacote.

Referência original
Lista o caminho atual do pacote filho.

Atribuir referência
Selecione um pacote filho armazenado no projeto.

Definir opções na página Selecionar Configurações

Selecione as configurações de pacote que você deseja substituir por parâmetros.

Pacote
Lista o arquivo do pacote.

Tipo
Lista o tipo de configuração, como um arquivo de configuração XML.

Cadeia de Caracteres de Configuração
Lista o caminho do arquivo de configuração.

Status
Exibe uma mensagem de status para a configuração. Selecione a mensagem para exibir o texto inteiro da mensagem.

Adicionar configurações
Adicione configurações de pacote contidas em outros projetos à lista de configurações disponíveis que você deseja substituir por parâmetros. Você pode selecionar configurações armazenadas em um sistema de arquivos ou armazenados no SQL Server.

Atualizar
Selecione para atualizar a lista de configurações.

Remover configurações de todos os pacotes após a conversão
É recomendável remover todas as configurações do projeto selecionando essa opção.

Se você não selecionar essa opção, somente as configurações selecionadas para substituir por parâmetros serão removidas.

Definir opções na página Criar Parâmetros

Selecione o nome do parâmetro e o escopo para cada propriedade de configuração.

Pacote
Lista o arquivo do pacote.

Nome do parâmetro
Lista o nome do parâmetro.

Escopo
Selecione o escopo do parâmetro, pacote ou projeto.

Definir opções na página Configurar Parâmetros

Nome
Lista o nome do parâmetro.

Escopo
Lista o escopo do parâmetro.

Valor
Lista o valor do parâmetro.

Selecione o botão de reticências ao lado do campo de valor para configurar as propriedades do parâmetro.

Na caixa de diálogo Definir Detalhes de Parâmetros , edite o valor do parâmetro. Você também pode especificar se o valor do parâmetro deve ser fornecido quando você executar o pacote.

Você pode modificar o valor na página Parâmetros da caixa de diálogo Configurar no Management Studio selecionando o botão Procurar ao lado do parâmetro. A caixa de diálogo Definir Valor do Parâmetro é exibida.

A caixa de diálogo Definir Detalhes de Parâmetros também lista o tipo de dados do valor de parâmetro e a origem do parâmetro.

Definir as opções na página Revisão

Use a página Revisão para confirmar as opções selecionadas para a conversão do projeto.

Anterior
Selecione para alterar uma opção.

Converter
Selecione para converter o projeto no modelo de implantação de projeto.

Definir as opções em Executar Conversão

A página Executar Conversão mostra o status da conversão do projeto.

Ação
Lista uma etapa de conversão específica.

Resultado
Lista o status de cada etapa de conversão. Selecione a mensagem de status para obter mais informações.

A conversão de projeto não será salva até que o projeto seja salvo no Visual Studio.

Salvar relatório
Selecione para salvar um resumo da conversão de projeto em um arquivo .xml.