Sdílet prostřednictvím


Nasazení projektu SSIS s kódem jazyka C# v aplikaci .NET

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

Tento rychlý start ukazuje, jak napsat kód jazyka C# pro připojení k databázovému serveru a nasadit projekt SSIS.

K vytvoření aplikace v jazyce C# můžete použít Visual Studio, Visual Studio Code nebo jiný nástroj podle vašeho výběru.

Předpoklady

Než začnete, ujistěte se, že máte nainstalovanou sadu Visual Studio nebo Visual Studio Code. Stáhněte si bezplatnou komunitní edici sady Visual Studio nebo bezplatný Visual Studio Code ze sady Visual Studio ke stažení.

Server Azure SQL Database naslouchá na portu 1433. Pokud se pokoušíte připojit k serveru Azure SQL Database z podnikové brány firewall, musí být tento port otevřený v podnikové bráně firewall, abyste se mohli úspěšně připojit.

Podporované platformy

Informace v tomto rychlém startu můžete použít k nasazení projektu SSIS na následující platformy:

Informace v tomto rychlém startu nemůžete použít k nasazení balíčku SSIS na SQL Server v Linuxu. Další informace o spouštění balíčků v Linuxu najdete v tématu Extrakce, transformace a načítání dat v Linuxu pomocí služby SSIS.

V případě Azure SQL Database získejte informace o připojení.

Pokud chcete projekt nasadit do služby Azure SQL Database, získejte informace o připojení, které potřebujete pro připojení k databázi katalogu SSIS (SSISDB). V následujících postupech potřebujete plně kvalifikovaný název serveru a přihlašovací údaje.

  1. Přihlaste se do Azure Portalu.
  2. V nabídce vlevo vyberte databáze SQL a pak na stránce databáze SQL vyberte databázi SSISDB.
  3. Na stránce Přehled databáze zkontrolujte plně kvalifikovaný název serveru. Pokud chcete zobrazit možnost Kopírování kliknutím , najeďte myší na název serveru.
  4. Pokud zapomenete přihlašovací údaje k serveru Azure SQL Database, přejděte na stránku serveru Azure SQL Database a zobrazte název správce serveru. V případě potřeby můžete heslo resetovat.
  5. Vyberte Zobrazit připojovací řetězce databáze.
  6. Zkontrolujte úplný připojovací řetězec ADO.NET. Volitelně můžete kód použít SqlConnectionStringBuilder k opětovnému vytvoření tohoto připojovacího řetězce s hodnotami jednotlivých parametrů, které zadáte.

Podporovaná metoda ověřování

Projděte si metody ověřování pro nasazení.

Vytvoření nového projektu sady Visual Studio

  1. V sadě Visual Studio zvolte Soubor, Nový, Projekt.
  2. V dialogovém okně Nový projekt a rozbalte Visual C#.
  3. Vyberte konzolovou aplikaci a jako název projektu zadejte deploy_ssis_project .
  4. Vyberte OK pro vytvoření a otevření nového projektu ve Visual Studio.

Přidání odkazů

  1. V Průzkumníku řešení klikněte pravým tlačítkem na složku Reference a vyberte Přidat odkaz. Otevře se dialogové okno Správce odkazů .
  2. V dialogovém okně Správce odkazů rozbalte sestavení a vyberte Rozšíření.
  3. Vyberte následující dva odkazy, které chcete přidat:
    • Microsoft.SqlServer.Management.Sdk.Sfc
    • Microsoft.SqlServer.Smo
  4. Výběrem tlačítka Procházet přidejte odkaz na Microsoft.SqlServer.Management.IntegrationServices. (Toto sestavení je nainstalováno pouze v globální mezipaměti pro sestavení (GAC).) Otevře se dialogové okno Vybrat soubory, na které chcete odkazovat .
  5. V dialogovém okně Vybrat soubory k odkazování přejděte do složky GAC, která obsahuje sestavení. Obvykle je tato složka C:\Windows\assembly\GAC_MSIL\Microsoft.SqlServer.Management.IntegrationServices\14.0.0.0__89845dcd8080cc91.
  6. Vyberte sestavení (tj. soubor .dll) ve složce a vyberte Přidat.
  7. Výběrem možnosti OK zavřete dialogové okno Správce odkazů a přidejte tři odkazy. Pokud chcete mít jistotu, že odkazy existují, zkontrolujte seznam Odkazů v Průzkumníku řešení.
  8. Přidejte balíček NuGet Microsoft.Data.SqlClient . Klikněte pravým tlačítkem na projekt v Průzkumníku řešení, vyberte Spravovat balíčky NuGet, vyhledejte Microsoft.Data.SqlClienta nainstalujte ho.

Přidání kódu jazyka C#

  1. Otevřete soubor Program.cs.

  2. Obsah Program.cs nahraďte následujícím kódem. Přidejte příslušné hodnoty pro server, databázi, uživatele a heslo.

Poznámka:

Následující příklad používá ověřování systému Windows. Chcete-li použít ověřování SYSTÉMU SQL Server, nahraďte Integrated Security=SSPI; argument argumentem User ID=<user name>;Password=<password>;. Pokud se připojujete k serveru Azure SQL Database, nemůžete použít ověřování systému 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.");
        }
    }
}

Spuštění kódu

  1. Aplikaci spustíte stisknutím klávesy F5.
  2. V nástroji SSMS ověřte, že byl projekt nasazen.