Executar um pacote do SSIS com o código C# em um aplicativo .NET

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

Este guia de início rápido demonstra como gravar código C# para se conectar a um servidor de banco de dados e executar um pacote do SSIS.

Você pode usar o Visual Studio, o Visual Studio Code ou outra ferramenta de sua preferência para criar um aplicativo C#.

Pré-requisitos

Antes de começar, verifique se você tem o Visual Studio ou Visual Studio Code instalado. Baixe a Community Edition gratuita do Visual Studio ou o Visual Studio Code gratuito de Downloads do Visual Studio.

Um servidor do Banco de Dados SQL do Azure escuta na porta 1433. Se estiver tentando se conectar a um servidor de Banco de Dados SQL do Azure em um firewall corporativo, essa porta deverá estar aberta no firewall corporativo para que você se conecte com êxito.

Para o Banco de Dados SQL do Azure, obtenha as informações de conexão

Para executar o pacote no Banco de Dados SQL do Azure, obtenha as informações de conexão necessárias para se conectar ao SSISDB (banco de dados de catálogo do SSIS). Você precisa das informações de logon e de nome do servidor totalmente qualificado nos procedimentos a seguir.

  1. Faça logon no Portal do Azure.
  2. Selecione Bancos de Dados SQL no menu à esquerda e selecione o banco de dados do SSISDB na página Bancos de dados SQL.
  3. Na página Visão geral do banco de dados, examine o nome totalmente qualificado do servidor. Para ver a opção Clique para copiar, passe o mouse sobre o nome do servidor.
  4. Se você esquecer suas informações de logon do servidor de Banco de Dados SQL do Azure, navegue até a página do servidor de Banco de Dados SQL para exibir o nome do administrador de servidor. Você pode redefinir a senha, se necessário.
  5. Clique em Mostrar cadeias de conexão de banco de dados.
  6. Examine a cadeia de conexão ADO.NET completa. Opcionalmente, seu código pode usar um SqlConnectionStringBuilder para recriar essa cadeia de conexão com os valores de parâmetro individuais que você fornece.

Criar um novo projeto do Visual Studio

  1. No Visual Studio, escolha Arquivo, Novo, Projeto.
  2. Na caixa de diálogo Novo Projeto, expanda Visual C#.
  3. Selecione Aplicativo de Console e digite run_ssis_project para o nome do projeto.
  4. Clique em OK para criar e abrir o novo projeto no Visual Studio.

Adicionar referências

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência. A caixa de diálogo Gerenciador de Referências é aberta.
  2. Na caixa de diálogo Gerenciador de Referências, expanda Assemblies e selecione Extensões.
  3. Selecione as duas referências a seguir a serem adicionadas:
    • Microsoft.SqlServer.Management.Sdk.Sfc
    • Microsoft.SqlServer.Smo
  4. Clique no botão Procurar para adicionar uma referência a Microsoft.SqlServer.Management.IntegrationServices. (Esse assembly é instalado apenas no GAC (cache de assembly global).) A caixa de diálogo selecionar os arquivos a referenciar é aberta.
  5. Na caixa de diálogo Selecionar os arquivos a referenciar, navegue até a pasta do GAC que contém o assembly. Normalmente, essa pasta é C:\Windows\assembly\GAC_MSIL\Microsoft.SqlServer.Management.IntegrationServices\14.0.0.0__89845dcd8080cc91.
  6. Selecione o assembly (ou seja, o arquivo. dll) na pasta e clique em Adicionar.
  7. Clique em OK para fechar a caixa de diálogo Gerenciador de Referências e adicione as três referências. Para verificar se as referências estão lá, verifique a lista Referências no Gerenciador de Soluções.

Adicione o código C#

  1. Abra Program.cs.

  2. Substitua o conteúdo de Program.cs pelo código a seguir. Adicione os valores apropriados para seu servidor, banco de dados, usuário e senha.

Observação

O exemplo a seguir usa a Autenticação do Windows. Para usar a autenticação do SQL Server, substitua o argumento Integrated Security=SSPI; com User ID=<user name>;Password=<password>;. Se você estiver se conectando a um servidor de Banco de Dados SQL do Azure, não poderá usar a autenticação do Windows.

using Microsoft.SqlServer.Management.IntegrationServices;
using System.Data.SqlClient;

namespace run_ssis_package
{
    class Program
    {
        static void Main(string[] args)
        {
            // Variables
            string targetServerName = "localhost";
            string folderName = "Project1Folder";
            string projectName = "Integration Services Project1";
            string packageName = "Package.dtsx";

            // Create a connection to the server
            string sqlConnectionString = "Data Source=" + targetServerName +
                ";Initial Catalog=master;Integrated Security=SSPI;";
            SqlConnection sqlConnection = new SqlConnection(sqlConnectionString);

            // Create the Integration Services object
            IntegrationServices integrationServices = new IntegrationServices(sqlConnection);

            // Get the Integration Services catalog
            Catalog catalog = integrationServices.Catalogs["SSISDB"];

            // Get the folder
            CatalogFolder folder = catalog.Folders[folderName];

            // Get the project
            ProjectInfo project = folder.Projects[projectName];

            // Get the package
            PackageInfo package = project.Packages[packageName];

            // Run the package
            package.Execute(false, null);

        }
    }
}

Executar o código

  1. Para executar o aplicativo, pressione F5.
  2. Verifique se o pacote foi executado conforme o esperado e, em seguida, feche a janela do aplicativo.

Próximas etapas