Freigeben über

Bereitstellen eines SSIS-Pakets aus Visual Studio Code mit Transact-SQL

  • Artikel

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

In diesem Schnellstart wird erläutert, wie Sie mit Visual Studio Code eine Verbindung mit der SSIS-Katalogdatenbank herstellen und anschließend mithilfe von Transact-SQL-Anweisungen ein im SSIS-Katalog gespeichertes SSIS-Projekt bereitstellen.

Visual Studio Code ist ein Code-Editor für Windows, macOS und Linux, der Erweiterungen unterstützt. Dazu gehört auch die mssql-Erweiterung zum Herstellen einer Verbindung mit Microsoft SQL Server, Azure SQL-Datenbank und Azure Synapse Analytics. Weitere Informationen zu VS Code finden Sie unter Visual Studio Code.

Voraussetzungen

Prüfen Sie, bevor Sie beginnen, ob Sie die neueste Version von Visual Studio Code installiert haben und die mssql-Erweiterung geladen ist. Informationen zum Herunterladen dieser Tools finden Sie auf den folgenden Seiten:

Unterstützte Plattformen

Mithilfe der Informationen in diesem Schnellstart können Sie auf den folgenden Plattformen SSIS-Projekte bereitstellen:

  • SQL Server unter Windows

Mithilfe der Informationen in diesem Schnellstart können Sie keine SSIS-Pakete in Azure SQL-Datenbank bereitstellen. Die gespeicherte Prozedur catalog.deploy_project erwartet den Pfad zur Datei .ispac im lokalen Dateisystem. Weitere Informationen zum Bereitstellen und Ausführen von Paketen in Azure finden Sie unter Migration von SQL Server Integration Services-Workloads in die Cloud per Lift & Shift.

Dieser Schnellstart enthält keine Anleitung zum Bereitstellen von SSIS-Paketen in SQL Server unter Linux. Weitere Informationen zum Ausführen von Paketen finden Sie unter Extrahieren, Transformieren und Laden von Daten unter Linux mit SSIS.

Festlegen des Sprachmodus auf SQL in VS Code

Legen Sie den Sprachmodus auf mssqlSQL in Visual Studio Code fest, um -Befehle und T-SQL IntelliSense zu aktivieren.

  1. Öffnen Sie zuerst Visual Studio Code und dann ein neues Fenster.

  2. Klicken Sie auf Nur-Text in der unteren rechten Ecke der Statusleiste.

  3. Klicken Sie im sich öffnenden Dropdownmenü Sprachmodus auswählen auf SQL, oder geben Sie es ein, und drücken Sie dann die EINGABETASTE, um den Sprachmodus auf „SQL“ festzulegen.

Unterstützte Authentifizierungsmethode

Weitere Informationen finden Sie unter Authentifizierungsmethoden für die Bereitstellung.

Herstellen einer Verbindung mit der SSIS-Katalogdatenbank

Verwenden Sie Visual Studio Code, um eine Verbindung mit dem SSIS-Katalog herzustellen.

  1. Drücken Sie in VS Code STRG+UMSCHALT+P (oder F1), um die Befehlspalette zu öffnen.

  2. Geben Sie sqlcon ein, und drücken Sie die EINGABETASTE.

  3. Drücken Sie die EINGABETASTE, um die Option Create Connection Profile (Verbindungsprofil erstellen) auszuwählen. Mithilfe dieses Schritts wird ein Verbindungsprofil für Ihre SQL Server-Instanz erstellt.

  4. Befolgen Sie die Anweisungen, um die Verbindungseigenschaften für das neue Verbindungsprofil anzugeben. Nachdem Sie sämtliche Werte angegeben haben, drücken Sie die EINGABETASTE, um fortzufahren.

    Einstellung Vorgeschlagener Wert Weitere Informationen
    Servername Der vollqualifizierte Servername
    Datenbankname SSISDB Dies ist der Name der Datenbank, mit der eine Verbindung hergestellt werden soll.
    Authentifizierung SQL-Anmeldung
    Benutzername Das Serveradministratorkonto Dabei handelt es sich um das Konto, das Sie beim Erstellen des Servers angegeben haben.
    Kennwort (SQL-Anmeldung) Das Kennwort für das Serveradministratorkonto Dabei handelt es sich um das Kennwort, das Sie beim Erstellen des Servers angegeben haben.
    Kennwort speichern Ja oder Nein Wenn Sie nicht bei jedem Neustart Ihr Kennwort eingeben möchten, wählen Sie „Ja“ aus.
    Namen für dieses Profil eingeben Ein Profilname wie mySSISServer Wenn Sie den Profilnamen speichern, wird bei späteren Anmeldungen schneller eine Verbindung hergestellt.

  5. Drücken Sie die Taste ESC, um die Meldung mit dem Hinweis, dass das Profil erstellt und die Verbindung dafür hergestellt wurde, zu schließen.

  6. Überprüfen Sie die Verbindung in der Statusleiste.

Ausführen des T-SQL-Codes

Führen Sie den folgenden Transact-SQL-Code aus, um ein SSIS-Projekt bereitzustellen.

  1. Geben Sie im Fenster Editor die folgende Abfrage in ein leeres Abfragefenster ein.

  2. Aktualisieren Sie die Parameterwerte in der für das System gespeicherten catalog.deploy_project-Prozedur.

  3. Drücken Sie STRG+UMSCHALT+E, um den Code und das Projekt bereitzustellen.

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

Nächste Schritte