Compartilhar via

Implantar um projeto 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 implantar um projeto 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 o Visual Studio Community Edition ou o Visual Studio Code gratuitos 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.

Plataformas com suporte

Você pode usar as informações neste guia de início rápido para implantar um projeto do SSIS nas seguintes plataformas:

Você não pode usar as informações neste início rápido para implantar um pacote SSIS no SQL Server no Linux. Para obter mais informações sobre como executar pacotes no Linux, veja Extrair, transformar e carregar dados no Linux com o SSIS.

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

Para implantar o projeto 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 do nome de domínio totalmente qualificado (FQDN) do servidor e das credenciais de login nos procedimentos a seguir.

  1. Entre 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 completo 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. Selecione 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.

Método de autenticação compatível

Confira os métodos de autenticação para implantação.

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 deploy_ssis_project para o nome do projeto.
  4. Selecione 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. Selecione o botão Procurar para adicionar uma referência a Microsoft.SqlServer.Management.IntegrationServices. (Este assembly é instalado apenas no cache de assembly global (GAC).) 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 selecione Adicionar.
  7. Selecione OK para fechar a caixa de diálogo Do Gerenciador de Referência 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.
  8. Adicione o pacote NuGet Microsoft.Data.SqlClient . Clique com o botão direito do mouse no projeto no Gerenciador de Soluções, selecione Gerenciar Pacotes NuGet, pesquise Microsoft.Data.SqlCliente instale-o.

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;
using Microsoft.Data.SqlClient;
using System.IO;

namespace deploy_ssis_project
{
    class Program
    {
        static void Main(string[] args)
        {
            // Variables
            string targetServerName = "localhost";
            string targetFolderName = "Project1Folder";
            string projectName = "Integration Services Project1";
            string projectFilePath = @"C:\Projects\Integration Services Project1\Integration Services Project1\bin\Development\Integration Services Project1.ispac";

            // 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"];

            // Create the target folder
            CatalogFolder folder = new CatalogFolder(catalog,
                targetFolderName, "Folder description");
            folder.Create();

            Console.WriteLine("Deploying " + projectName + " project.");

            byte[] projectFile = File.ReadAllBytes(projectFilePath);
            folder.DeployProject(projectName, projectFile);

            Console.WriteLine("Done.");
        }
    }
}

Executar o código

  1. Para executar o aplicativo, pressione F5.
  2. No SSMS, verifique se que o projeto foi implantado.

Conteúdo relacionado

  • Last updated on