Dela via

Distribuera ett SSIS-projekt med C#-kod i en .NET-app

gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

Den här snabbstarten visar hur du skriver C#-kod för att ansluta till en databasserver och distribuera ett SSIS-projekt.

Om du vill skapa en C#-app kan du använda Visual Studio, Visual Studio Code eller något annat valfritt verktyg.

Förutsättningar

Kontrollera att Visual Studio eller Visual Studio Code är installerat innan du börjar. Ladda ned den kostnadsfria Community-utgåvan av Visual Studio eller den kostnadsfria Visual Studio Code från Visual Studio Downloads.

En Azure SQL Database-server lyssnar på port 1433. Om du försöker ansluta till en Azure SQL Database-server inifrån en företagsbrandvägg måste den här porten vara öppen i företagsbrandväggen för att du ska kunna ansluta.

Plattformar som stöds

Du kan använda informationen i den här snabbstarten för att distribuera ett SSIS-projekt till följande plattformar:

Du kan inte använda informationen i den här snabbstarten för att distribuera ett SSIS-paket till SQL Server i Linux. Mer information om hur du kör paket på Linux finns i Extrahera, transformera och läsa in data i Linux med SSIS.

För Azure SQL Database hämtar du anslutningsinformationen

Om du vill distribuera projektet till Azure SQL Database hämtar du den anslutningsinformation du behöver för att ansluta till SSIS-katalogdatabasen (SSISDB). Du behöver det fullständigt kvalificerade servernamnet och inloggningsinformationen i de procedurer som följer.

  1. Logga in på Azure-portalen.
  2. Välj SQL-databaser på den vänstra menyn och välj sedan SSISDB-databasen på sidan SQL-databaser .
  3. På sidan Översikt för databasen granskar du det fullständigt kvalificerade servernamnet. Hovra över servernamnet om du vill se alternativet Klicka för att kopiera .
  4. Om du glömmer inloggningsinformationen för Azure SQL Database-servern går du till SQL Database-serversidan för att visa serveradministratörsnamnet. Du kan återställa lösenordet om det behövs.
  5. Välj Visa databasanslutningssträngar.
  6. Granska den fullständiga ADO.NET anslutningssträngen. Du kan också använda en SqlConnectionStringBuilder kod för att återskapa den här anslutningssträngen med de enskilda parametervärden som du anger.

Autentiseringsmetod som stöds

Se autentiseringsmetoder för distribution.

Skapa ett nytt Visual Studio-projekt

  1. I Visual Studio väljer du Arkiv, Nytt, Projekt.
  2. I dialogrutan Nytt projekt och expandera Visual C#.
  3. Välj Konsolapp och ange deploy_ssis_project som projektnamn.
  4. Välj OK för att skapa och öppna det nya projektet i Visual Studio.

Lägga till referenser

  1. Högerklicka på mappen Referenser i Solution Explorer och välj Lägg till referens. Dialogrutan Referenshanteraren öppnas.
  2. I dialogrutan Referenshanterarenexpanderar du Sammansättningar och väljer Tillägg.
  3. Välj följande två referenser att lägga till:
    • Microsoft.SqlServer.Management.Sdk.Sfc
    • Microsoft.SqlServer.Smo
  4. Välj knappen Bläddra för att lägga till en referens till Microsoft.SqlServer.Management.IntegrationServices. (Den här assemblyn installeras endast i den globala assemblycachen (GAC).) Dialogrutan Välj de filer som ska refereras öppnas.
  5. I dialogrutan Välj de filer som ska refereras navigerar du till den GAC-mapp som innehåller sammansättningen. Den här mappen är C:\Windows\assembly\GAC_MSIL\Microsoft.SqlServer.Management.IntegrationServices\14.0.0.0__89845dcd8080cc91vanligtvis .
  6. Välj sammansättningen (d.v.s. filen .dll) i mappen och välj Lägg till.
  7. Välj OK för att stänga dialogrutan Referenshanteraren och lägg till de tre referenserna. Kontrollera att referenserna finns där genom att kontrollera listan Referenser i Solution Explorer.
  8. Lägg till NuGet-paketet Microsoft.Data.SqlClient . Högerklicka på projektet i Solution Explorer, välj Hantera NuGet-paket, sök Microsoft.Data.SqlClientefter och installera det.

Lägg till C#-koden

  1. Öppna Program.cs.

  2. Ersätt innehållet i Program.cs med följande kod. Lägg till lämpliga värden för din server, databas, användare och lösenord.

Anmärkning

I följande exempel används Windows-autentisering. Om du vill använda SQL Server-autentisering ersätter du Integrated Security=SSPI; argumentet med User ID=<user name>;Password=<password>;. Om du ansluter till en Azure SQL Database-server kan du inte använda Windows-autentisering.

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.");
        }
    }
}

Kör koden

  1. Tryck på F5 för att köra programmet.
  2. I SSMS kontrollerar du att projektet har distribuerats.

Relaterat innehåll

  • Last updated on