Ausführen 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 mit Transact-SQL-Anweisungen ein im SSIS-Katalog gespeichertes SSIS-Paket ausführen.

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-Pakete ausführen:

Anhand der Informationen in diesem Schnellstart können Sie unter Linux keine SSIS-Pakete ausführen. 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.

Abrufen der Verbindungsinformationen für Azure SQL-Datenbank

Um das Paket auf Azure SQL-Datenbank auszuführen, rufen Sie die Verbindungsinformationen ab, die für eine Verbindungsherstellung mit der SSIS-Katalogdatenbank (SSISDB) benötigt werden. Sie benötigen den vollqualifizierten Servernamen und die Anmeldeinformationen für die folgenden Prozeduren.

  1. Melden Sie sich beim Azure-Portalan.
  2. Wählen Sie aus dem Menü auf der linken Seite SQL-Datenbanken aus, und klicken Sie auf der Seite SQL-Datenbanken auf die SSISDB-Datenbank.
  3. Überprüfen Sie auf der Übersichtsseite Ihrer Datenbank den vollqualifizierten Servernamen. Zeigen Sie auf den Servernamen, damit die Option Klicken Sie zum Kopieren angezeigt wird.
  4. Wenn Sie die Anmeldeinformationen für Ihren Azure SQL-Datenbank-Server vergessen, navigieren Sie zur Seite „SQL Datenbank-Server“, damit der Serveradministratorname angezeigt wird. Sie können das Kennwort falls erforderlich zurücksetzen.

Herstellen einer Verbindung mit der SSIS-Katalogdatenbank

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

Wichtig

Bevor Sie fortfahren, stellen Sie sicher, dass Sie die erforderlichen Server-, Datenbank- und Anmeldeinformationen zur Hand haben. Wenn Sie den Fokus von Visual Studio Code ändern, nachdem Sie mit der Eingabe der Verbindungsprofilinformationen begonnen haben, müssen Sie erneut mit dem Erstellen des Verbindungsprofils beginnen.

  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 Wenn Sie eine Verbindung mit einem Azure SQL-Datenbank-Server herstellen, ist der Name im Format <server_name>.database.windows.net.
    Datenbankname SSISDB Dies ist der Name der Datenbank, mit der eine Verbindung hergestellt werden soll.
    Authentifizierung SQL-Anmeldung Mit der SQL Server-Authentifizierung können Sie eine Verbindung zu SQL Server oder Azure SQL-Datenbank herstellen. Wenn Sie eine Verbindung mit einem Azure SQL-Datenbank-Server herstellen, können Sie keine Windows-Authentifizierung verwenden.
    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-Paket auszuführen.

  1. Geben Sie im Fenster Editor die folgende Abfrage in ein leeres Abfragefenster ein. (Dabei handelt es sich um den Code, der durch die Option Skript im Dialogfeld Paket ausführen in SSMS generiert wurde.)

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

  3. Drücken Sie STRG+UMSCHALT+E, um den Code und das Paket auszuführen.

Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Package.dtsx',
    @execution_id=@execution_id OUTPUT,
    @folder_name=N'Deployed Projects',
	  @project_name=N'Integration Services Project1',
  	@use32bitruntime=False,
	  @reference_id=Null
Select @execution_id
DECLARE @var0 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,
    @object_type=50,
	  @parameter_name=N'LOGGING_LEVEL',
	  @parameter_value=@var0
EXEC [SSISDB].[catalog].[start_execution] @execution_id
GO

Nächste Schritte