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

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

Bevor du anfängst, stelle sicher, dass du die neueste Version von Visual Studio Code installiert und die MSSQL-Erweiterung für Visual Studio Code geladen hast. 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.

Sie können die Informationen in dieser Schnellstartanleitung nicht verwenden, um ein SSIS-Paket auf SQL Server unter Linux bereitzustellen. 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 Klartext in der unteren rechten Ecke der Statusleiste.

  3. In der Dropdown-Liste "Sprachmodus auswählen ", die geöffnet wird, wählen oder geben Sie SQL ein und drücken Sie dann ENTER , um den Sprachmodus auf SQL zu setzen.

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 auszuführen 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

Verwandte Inhalte

  • Last updated on