SQL-Ausführungsanweisungen in einem Loop Package-Beispiel

Die SQL-Ausführungsanweisungen in einem Loop-Beispielpaket verwenden einen Foreach-Schleifencontainer für die Iteration durch SQL-Anweisungen, die in Textdateien oder in einem Ordner gespeichert sind. Die Transact-SQL-Anweisungen erstellen fünf Tabellen in der AdventureWorks-Datenbank. Dies entspricht einer Tabelle für jede der gültigen Verkaufsregionen in den Vereinigten Staaten. Der Auflistungswert des Foreach-Dateienumerators ist einer Variablen zugeordnet. Diese Variable wird in einem Eigenschaftsausdruck verwendet, um den Wert einer Verbindungszeichenfolge im Dateiverbindungs-Manager bei jeder Enumeration zu aktualisieren.

Bei den Daten in der Textdatei sind verschiedene Probleme aufgetreten: Einige Postleitzahlen werden fälschlicherweise als numerische Werte interpretiert, sodass führende Nullen verloren gehen, und die Bezeichner für einige Verkaufsregionen sind ungültig. Der Datenfluss im Paket erkennt und korrigiert falsche Postleitzahlen, schreibt Datenzeilen mit ungültigen Verkaufsregionen in eine Datei und leitet gültige Datenzeilen an eine von fünf Tabellen in der AdventureWorks-Datenbank weiter.

Bei einer erneuten Ausführung des Pakets werden die Tabellen vor dem Einfügen der Daten abgeschnitten.

Wenn Sie das Beispiel unter einer nicht englischsprachigen Version von Windows ausführen, müssen Sie möglicherweise den lokalisierten Namen des Programmdateiordners ersetzen, um das Beispiel öffnen oder ausführen zu können.

Wichtig:
Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für die Verwendung in einer Produktionsumgebung gedacht und wurden nicht in einer Produktionsumgebung getestet. Microsoft bietet für diese Beispiele keinen technischen Support.

Anforderungen

Stellen Sie vor dem Ausführen des Beispielpakets sicher, dass die folgenden Bedingungen erfüllt sind:

• Das Beispielpaket und die von diesem verwendeten Daten müssen auf dem lokalen Festplattenlaufwerk installiert sein.
• Sie müssen die AdventureWorks-Datenbank installiert haben und über Administratorrechte für die Datenbank verfügen.
• Wenn Sie beabsichtigen, das Beispielpaket lediglich über die Befehlszeile auszuführen, müssen Sie SQL Server 2005 Integration Services (SSIS) installieren.
• Wenn Sie beabsichtigen, das Paket im SSIS-Designer zu öffnen und das Beispielpaket auszuführen, müssen Sie Business Intelligence Development Studio installieren.

Weitere Informationen zum Installieren von Beispielen finden Sie im Thema "Installieren von Integration Services-Beispielpaketen" in der SQL Server 2005-Onlinedokumentation. Wenn Sie die aktuelle Version der Beispiele erhalten möchten, einschließlich neuer Beispiele, die nach der ursprünglichen Version von SQL Server 2005 veröffentlicht wurden, finden Sie entsprechende Informationen unter SQL Server 2005 Samples and Sample Databases (April 2006) (in Englisch).

Speicherort des Beispielpakets

Wenn die Beispiele im Standardverzeichnis installiert wurden, befindet sich das Beispielpaket für SQL-Ausführungsanweisungen im folgenden Ordner:

c:\Programme\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\ExecuteSQLStatementsInLoop Sample\ExecuteSQLStatementsInLoop\

Zum Ausführen des Beispielpakets sind die folgenden Dateien erforderlich.

Ausführen des Beispiels

Das Paket kann von der Befehlszeile aus mithilfe des Dienstprogramms dtexec oder in Business Intelligence Development Studio ausgeführt werden.

Wenn Sie eine nicht englischsprachige Version von Windows verwenden, müssen Sie möglicherweise die ConnectionString-Eigenschaft aller Dateiverbindungs-Manager aktualisieren, der in dem Paket verwendet wurde, um das Beispielpaket erfolgreich auszuführen. Überprüfen Sie, ob der im Verbindungs-Manager verwendete Pfad auf Ihrem Computer gültig ist, und ändern Sie ihn ggf. so, dass er den lokalisierten Namen des Programmdateiordners verwendet.

Für dieses Beispiel müssen Sie möglicherweise "Programme" in der ConnectionString-Eigenschaft für die Verbindungs-Manager CreateTableSQL, Customers und CustomersWithInvalidTerritoryID aktualisieren.

So führen Sie das Paket mithilfe von dtexec aus

1. Öffnen Sie ein Eingabeaufforderungsfenster.

2. Wechseln Sie mit dem Befehl zum Wechseln des Verzeichnisses, cd, in das Verzeichnis C:\Programme\Microsoft SQL Server\90\DTS\Binn, in dem sich dtexec befindet.

3. Geben Sie folgenden Befehl ein:

   dtexec /f "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\ExecuteSQLStatementsInLoop Sample\ExecuteSQLStatementsInLoop\ExecuteSQLStatementsInLoop.dtsx"
   

4. Drücken Sie die Eingabetaste.

Weitere Informationen zum Ausführen des Pakets mithilfe des Dienstprogramms dtexec finden Sie im Thema "dtexec (Dienstprogramm)" in der SQL Server 2005-Onlinedokumentation.

So führen Sie das Paket in Business Intelligence Development Studio aus

1. Öffnen Sie Business Intelligence Development Studio.

2. Zeigen Sie im Menü Datei auf Öffnen, und klicken Sie auf Projekt/Projektmappe.

3. Navigieren Sie zum ExecuteSQLStatementsInLoop-Beispielordner, und doppelklicken auf die Datei mit dem Namen ExecuteSQLStatementsInLoop.sln.

4. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ExecuteSQLStatementsInLoop.dtsx im Ordner SSIS-Pakete, und klicken Sie dann auf Paket ausführen.

Wichtig:

Wenn Sie die SQL-Ausführungsanweisungen eines Loop-Beispielpakets noch vor dem erstmaligen Ausführen des Pakets im SSIS-Designer öffnen, enthält der Datenflusstask eine Warnung. Die Warnung wird ausgegeben, weil die vom Paket verwendeten SQL Server-Tabellen zu diesem Zeitpunkt noch nicht vorhanden sind. Die Tabellen werden erstellt, wenn Sie das Paket zum ersten Mal ausführen. Die Warnung wird nicht angezeigt, wenn Sie das Paket erneut im SSIS-Designer öffnen, nachdem Sie es mindestens einmal ausgeführt haben. Das Paket wird ungeachtet der Warnung erfolgreich ausgeführt.

Komponenten im Beispiel

Die folgende Tabelle listet die Integration Services-Tasks, -Container, -Quellen, -Transformationen, -Ziele und -Verbindungs-Manager auf, die im Beispiel verwendet werden.

Beispielergebnisse

Um die Ausführungsergebnisse des Beispielpakets für SQL-Ausführungsanweisungen in einer Schleife anzuzeigen, öffnen Sie ein Abfragefenster in SQL Server Management Studio, geben die folgende Transact-SQL-Abfrage ein (oder kopieren sie) und führen die Abfrage aus.

SELECT * FROM AdventureWorks.dbo.Territory1
SELECT * FROM AdventureWorks.dbo.Territory2
SELECT * FROM AdventureWorks.dbo.Territory3
SELECT * FROM AdventureWorks.dbo.Territory4
SELECT * FROM AdventureWorks.dbo.Territory5

Diese Abfrage ruft die aus der Textdatei extrahierten und in SQL Server-Tabellen geladenen Daten ab.