Udostępnij przez

Wdrażanie projektu usług SSIS przy użyciu kodu C# w aplikacji .NET

Dotyczy:SQL Server SSIS Integration Runtime w ramach usługi Azure Data Factory

W tym przewodniku Szybki start pokazano, jak napisać kod języka C# w celu nawiązania połączenia z serwerem bazy danych i wdrożyć projekt SSIS.

Aby utworzyć aplikację w języku C#, możesz użyć programu Visual Studio, programu Visual Studio Code lub innego wybranego narzędzia.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz zainstalowany program Visual Studio lub Visual Studio Code. Pobierz bezpłatną wersję Community programu Visual Studio lub bezpłatny program Visual Studio Code z witryny Visual Studio Downloads.

Serwer usługi Azure SQL Database nasłuchuje na porcie 1433. Jeśli próbujesz nawiązać połączenie z serwerem usługi Azure SQL Database z poziomu zapory firmowej, ten port musi być otwarty w zaporze firmowej, aby pomyślnie nawiązać połączenie.

Obsługiwane platformy

Informacje przedstawione w tym przewodniku Szybki start umożliwiają wdrożenie projektu usług SSIS na następujących platformach:

Nie można użyć informacji z tego samouczka, aby wdrożyć pakiet SSIS na serwerze SQL Server w systemie Linux. Aby uzyskać więcej informacji na temat uruchamiania pakietów w systemie Linux, zobacz Wyodrębnianie, przekształcanie i ładowanie danych w systemie Linux przy użyciu usługi SSIS.

W przypadku usługi Azure SQL Database uzyskaj informacje o połączeniu

Aby wdrożyć projekt w Azure SQL Database, uzyskaj informacje o połączeniu potrzebne do połączenia się z bazą danych Katalogu SSIS (SSISDB). Potrzebujesz w pełni kwalifikowanej nazwy serwera i informacji logowania w poniższych procedurach.

  1. Zaloguj się do witryny Azure Portal.
  2. Wybierz pozycję Bazy danych SQL z menu po lewej stronie, a następnie wybierz bazę danych SSISDB na stronie Bazy danych SQL .
  3. Na stronie Przegląd bazy danych przejrzyj w pełni kwalifikowaną nazwę serwera. Aby wyświetlić opcję Kliknij, aby skopiować , umieść kursor na nazwie serwera.
  4. Jeśli zapomnisz informacje logowania serwera usługi Azure SQL Database, przejdź do strony serwera usługi SQL Database, aby wyświetlić nazwę administratora serwera. W razie potrzeby możesz zresetować hasło.
  5. Wybierz pozycję Pokaż parametry połączenia bazy danych.
  6. Sprawdź pełny string połączenia ADO.NET. Opcjonalnie twój kod może użyć SqlConnectionStringBuilder, aby ponownie utworzyć ten ciąg połączenia z podanymi przez ciebie wartościami poszczególnych parametrów.

Obsługiwana metoda uwierzytelniania

Zapoznaj się z metodami uwierzytelniania na potrzeby wdrażania.

Tworzenie nowego projektu programu Visual Studio

  1. W programie Visual Studio wybierz pozycję Plik, Nowy, Projekt.
  2. W oknie dialogowym Nowy projekt rozwiń sekcję Visual C#.
  3. Wybierz pozycję Aplikacja konsolowa i wprowadź deploy_ssis_project jako nazwę projektu.
  4. Wybierz przycisk OK , aby utworzyć i otworzyć nowy projekt w programie Visual Studio.

Dodawanie odwołań

  1. W Eksploratorze rozwiązań kliknij prawym przyciskiem myszy folder Odwołania i wybierz polecenie Dodaj odwołanie. Okno dialogowe menedżera odwołań zostanie otwarte.
  2. W oknie dialogowym Menedżer odwołań rozwiń węzeł Zestawy i wybierz pozycję Rozszerzenia.
  3. Wybierz następujące dwa odwołania do dodania:
    • Microsoft.SqlServer.Management.Sdk.Sfc
    • Microsoft.SqlServer.Smo
  4. Wybierz przycisk Przeglądaj , aby dodać odwołanie do pliku Microsoft.SqlServer.Management.IntegrationServices. (Ten zestaw jest instalowany tylko w globalnej pamięci składowania zestawów (GAC)). Zostanie otwarte okno dialogowe Wybieranie plików do odwołania .
  5. W oknie dialogowym Wybieranie plików do odwołania, przejdź do folderu GAC, który zawiera zestaw. Zazwyczaj ten folder jest C:\Windows\assembly\GAC_MSIL\Microsoft.SqlServer.Management.IntegrationServices\14.0.0.0__89845dcd8080cc91.
  6. Wybierz zestaw (czyli plik .dll) w folderze i wybierz pozycję Dodaj.
  7. Wybierz przycisk OK , aby zamknąć okno dialogowe Menedżer odwołań i dodać trzy odwołania. Aby upewnić się, że odwołania się tam znajdują, sprawdź listę Odwołania w Eksploratorze rozwiązań.
  8. Dodaj pakiet NuGet Microsoft.Data.SqlClient . Kliknij prawym przyciskiem myszy projekt w Eksploratorze rozwiązań, wybierz pozycję Zarządzaj pakietami NuGet, wyszukaj Microsoft.Data.SqlClienti zainstaluj go.

Dodawanie kodu w języku C#

  1. Otwórz plik Program.cs.

  2. Zastąp zawartość pliku Program.cs poniższym kodem. Dodaj odpowiednie wartości dla serwera, bazy danych, użytkownika i hasła.

Uwaga / Notatka

W poniższym przykładzie użyto uwierzytelniania systemu Windows. Aby użyć uwierzytelniania programu SQL Server, zastąp Integrated Security=SSPI; argument argumentem User ID=<user name>;Password=<password>;. Jeśli łączysz się z serwerem usługi Azure SQL Database, nie możesz użyć uwierzytelniania systemu 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.");
        }
    }
}

Uruchamianie kodu

  1. Aby uruchomić aplikację, naciśnij klawisz F5.
  2. W programie SSMS sprawdź, czy projekt został wdrożony.

Treści powiązane

  • Last updated on