Distribuire un progetto SSIS con codice C# in un'app .NET

Si applica a:SQL ServerRuntime di integrazione SSIS in Azure Data Factory

Questa guida introduttiva illustra come scrivere codice C# per connettersi a un server di database e distribuire un progetto SSIS.

Per creare un'app C#, è possibile usare Visual Studio, Visual Studio Code o un altro strumento di propria scelta.

Prerequisiti

Prima di iniziare, verificare che Visual Studio o Visual Studio Code sia installato. Scaricare l'edizione Community gratuita di Visual Studio o lo strumento gratuito Visual Studio Code dalla pagina dei download di Visual Studio.

Un server di Database SQL di Azure è in ascolto sulla porta 1433. Se si sta provando a connettersi a un server di database SQL di Azure dall'interno di un firewall aziendale, per stabilire correttamente la connessione questa porta deve essere aperta nel firewall aziendale.

Piattaforme supportate

È possibile usare le informazioni di questa guida introduttiva per distribuire un progetto SSIS nelle piattaforme seguenti:

Non è possibile usare le informazioni contenute in questa guida introduttiva per distribuire un pacchetto SSIS in SQL Server in Linux. Per altre informazioni sull'esecuzione di pacchetti in Linux, vedere Estrarre, trasformare e caricare i dati in Linux con SSIS.

Ottenere le informazioni di connessione per il database SQL di Azure

Per distribuire il progetto nel database SQL di Azure, ottenere le informazioni di connessione necessarie per connettersi al database del catalogo SSIS (SSISDB). Nelle procedure che seguono sono necessari il nome completo del server e le informazioni di accesso.

  1. Accedi al portale di Azure.
  2. Selezionare Database SQL nel menu a sinistra e quindi il database SSISDB nella pagina Database SQL.
  3. Nella pagina Panoramica del tuo database, verifica il nome completo del server. Passare il mouse sul nome del server per visualizzare l'opzione Fare clic per copiare.
  4. Se si dimenticano le informazioni di accesso del server di database SQL di Azure, passare alla pagina del server di database SQL per visualizzare il nome amministratore del server. Se necessario, è possibile reimpostare la password.
  5. Selezionare Mostra stringhe di connessione del database.
  6. Esaminare l'intera stringa di connessione ADO.NET. Facoltativamente il codice può usare SqlConnectionStringBuilder per ricreare questa stringa di connessione con i valori dei singoli parametri specificati.

Metodo di autenticazione supportato

Vedere i metodi di autenticazione per la distribuzione.

Creare un nuovo progetto Visual Studio

  1. In Visual Studio scegliere File, Nuovo, Progetto.
  2. Nella finestra di dialogo Nuovo progetto espandere Visual C#.
  3. Selezionare Applicazione console e immettere deploy_ssis_project come nome del progetto.
  4. Selezionare OK per creare e aprire il nuovo progetto in Visual Studio.

Aggiungere riferimenti

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sulla cartella Riferimenti e selezionare Aggiungi riferimento. Viene visualizzata la finestra di dialogo Gestione riferimenti.
  2. Nella finestra di dialogo Gestione riferimenti espandere Assembly e selezionare Estensioni.
  3. Seleziona i seguenti due riferimenti da aggiungere:
    • Microsoft.SqlServer.Management.Sdk.Sfc
    • Microsoft.SqlServer.Smo
  4. Selezionare il pulsante Sfoglia per aggiungere un riferimento a Microsoft.SqlServer.Management.IntegrationServices. Questo assembly viene installato solamente nella Global Assembly Cache (GAC). Viene visualizzata la finestra di dialogo Selezionare i file a cui fare riferimento.
  5. Nella finestra di dialogo Seleziona i file a cui fare riferimento, naviga alla cartella della GAC che contiene l'assembly. In genere questa cartella è C:\Windows\assembly\GAC_MSIL\Microsoft.SqlServer.Management.IntegrationServices\14.0.0.0__89845dcd8080cc91.
  6. Selezionare l'assembly (ovvero il file .dll) nella cartella e selezionare Aggiungi.
  7. Selezionare OK per chiudere la finestra di dialogo Gestione riferimenti e aggiungere i tre riferimenti. Per verificare se i riferimenti sono presenti, controllare l'elenco Riferimenti in Esplora soluzioni.
  8. Aggiungere il pacchetto NuGet Microsoft.Data.SqlClient . Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni, scegliere Gestisci pacchetti NuGet, cercare Microsoft.Data.SqlCliente installarlo.

Aggiungere il codice C#

  1. Aprire Program.cs.

  2. Sostituire il contenuto di Program.cs con il codice seguente. Aggiungere i valori appropriati per server, database, utente e password.

Nota

L'esempio seguente usa l'autenticazione di Windows. Per usare l'autenticazione di SQL Server, sostituire l'argomento Integrated Security=SSPI; con User ID=<user name>;Password=<password>;. Se ci si connette a un server di database SQL di Azure, non è possibile usare l'autenticazione di 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.");
        }
    }
}

Eseguire il codice

  1. Premere F5 per eseguire l'applicazione.
  2. In SQL Server Management Studio verificare che il progetto sia stato distribuito.

Contenuti correlati

  • Last updated on