Distribuire un progetto SSIS da Visual Studio Code con Transact-SQL

Articolo
05/23/2023

Si applica a: SQL Server SSIS Integration Runtime in Azure Data Factory

Questa guida introduttiva illustra come usare Visual Studio Code per connettersi al database del catalogo SSIS e quindi usare istruzioni Transact-SQL per distribuire un progetto SSIS nel catalogo SSIS.

Visual Studio Code è un editor di codice per Windows, macOS e Linux che supporta le estensioni, incluse le estensioni mssql per la connessione a Microsoft SQL Server, database SQL di Azure o Azure Synapse Analytics. Per altre informazioni su Visual Studio Code, vedere Visual Studio Code.

Prerequisiti

Prima di iniziare, assicurarsi di aver installato la versione più recente di Visual Studio Code e caricato l'estensione mssql. Per scaricare questi strumenti, vedere le pagine seguenti:

Piattaforme supportate

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

SQL Server in Windows.

Non è possibile usare le informazioni di questa guida introduttiva per distribuire un pacchetto SSIS nel database SQL di Azure. La stored procedure catalog.deploy_project prevede che il percorso del file .ispac sia nel file system locale. Per altre informazioni sulla distribuzione e l'esecuzione di pacchetti in Azure, vedere Spostare i carichi di lavoro di SQL Server Integration Services nel cloud.

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

Impostare la modalità di linguaggio su SQL in Visual Studio Code

Per abilitare i comandi mssql e Transact-SQL IntelliSense, impostare la modalità di linguaggio su SQL in Visual Studio Code.

Aprire Visual Studio Code e quindi aprire una nuova finestra.
Fare clic su Testo normale nell'angolo inferiore destro della barra di stato.
Nel menu a discesa Seleziona modalità linguaggio visualizzato selezionare o immettere SQL e quindi premere INVIO per impostare la modalità del linguaggio su SQL.

Metodo di autenticazione supportato

Vedere i metodi di autenticazione per la distribuzione.

Connettersi al database del catalogo SSIS

Usare SQL Visual Studio Code per stabilire una connessione al catalogo SSIS.

In Visual Studio Code premere CTRL+MAIUSC+P (o F1) per aprire il riquadro comandi.
Digitare sqlcon e premere INVIO.
Premere INVIO per iniziare la procedura di creazione del profilo di connessione. Questo passaggio consente di creare un profilo di connessione per l'istanza di SQL Server.

Seguire le istruzioni per specificare le proprietà di connessione per il nuovo profilo di connessione. Dopo aver specificato ogni valore, premere INVIO per continuare.

Impostazione	Valore suggerito	Altre informazioni
Nome server	Nome completo del server
Nome database	SSISDB	Il nome del database a cui si effettua la connessione.
Autenticazione	Account di accesso SQL
Nome utente	Account amministratore del server	Account specificato al momento della creazione del server.
Password (account di accesso SQL)	Password per l'account amministratore del server	Password specificata al momento della creazione del server.
Salvare la password?	Sì o No	Se non si vuole immettere la password ogni volta, selezionare Sì.
Immettere un nome per questo profilo	Un nome di profilo, ad esempio mySSISServer	Se si salva un nome di profilo, gli accessi successivi saranno più rapidi.

Premere il tasto ESC per chiudere il messaggio che informa che il profilo è stato creato e connesso.
Verificare la connessione nella barra di stato.

Eseguire il codice T-SQL

Eseguire il codice Transact-SQL seguente per distribuire un progetto SSIS.

Nella finestra Editor immettere la query seguente nella finestra di query vuota.
Aggiornare i valori dei parametri nella stored procedure catalog.deploy_project in base al sistema in uso.
Premere CTRL+MAIUSC+E per eseguire il codice e distribuire il progetto.

DECLARE @ProjectBinary AS varbinary(max)
DECLARE @operation_id AS bigint
SET @ProjectBinary = (SELECT * FROM OPENROWSET(BULK '<project_file_path>.ispac', SINGLE_BLOB) AS BinaryData)

EXEC catalog.deploy_project @folder_name = '<target_folder>',
    @project_name = '<project_name',
    @Project_Stream = @ProjectBinary,
    @operation_id = @operation_id out

Passaggi successivi

Prendere in considerazione altri modi per distribuire un pacchetto.
Eseguire un pacchetto distribuito. Per eseguire un pacchetto, è possibile scegliere tra diversi strumenti e linguaggi. Per altre informazioni, vedi gli articoli seguenti:

Condividi tramite