Pakkethulpprogramma uitvoeren (dtexecui)

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

Gebruik het hulpprogramma Pakket uitvoeren om Integration Services-pakketten uit te voeren. Het hulpprogramma voert pakketten uit die zijn opgeslagen op een van de drie locaties: Microsoft SQL Server-database, de SSIS Package Store en het bestandssysteem. Deze gebruikersinterface, die kan worden geopend vanuit SQL Server Management Studio of door dtexecui te typen bij een opdrachtprompt, is een alternatief voor het uitvoeren van pakketten met behulp van het DTExec-opdrachtpromptprogramma .

Pakketten worden uitgevoerd in hetzelfde proces als het hulpprogrammadtexecui.exe . Omdat dit hulpprogramma een 32-bits hulpprogramma is, worden pakketten uitgevoerd met behulp van dtexecui.exe in een 64-bits omgeving die wordt uitgevoerd in Windows op Win32 (WOW). Wanneer u opdrachten ontwikkelt en test met behulp van het hulpprogramma dtexecui.exe op een 64-bits computer, moet u de opdrachten testen in de 64-bits modus met behulp van de 64-bits versie van dtexec.exe voordat u de opdrachten op een productieserver implementeert of plant.

Het hulpprogramma Pakket uitvoeren is een grafische gebruikersinterface voor het DTExec-opdrachtpromptprogramma . Met de gebruikersinterface kunt u eenvoudig opties configureren en wordt automatisch de opdrachtregel verzameld die wordt doorgegeven aan het DTExec-opdrachtpromptprogramma wanneer u het pakket uitvoert op basis van de opgegeven opties.

Het Uitvoeren Pakket Hulpprogramma kan ook worden gebruikt om opdrachtregels samen te stellen die u gebruikt wanneer u DTExec direct uitvoert.

Pakkethulpprogramma uitvoeren openen in SQL Server Management Studio

1. Klik in SQL Server Management Studio in het menu Beeld op Objectverkenner.

2. Klik in Objectverkenner op Verbinding maken en klik vervolgens op Integration Services.

3. Voer in het dialoogvenster Verbinding maken met server de servernaam in de lijst Servernaam in en klik vervolgens op Verbinding maken.

4. Vouw de map Opgeslagen pakketten en submappen uit, klik met de rechtermuisknop op het pakket dat u wilt uitvoeren en klik vervolgens op Pakket uitvoeren.

Het hulpprogramma Pakket uitvoeren openen via de opdrachtprompt

• Voer in een opdrachtpromptvenster dtexecui uit.

In de volgende secties worden pagina's van het dialoogvenster Pakkethulpprogramma uitvoeren beschreven.

Algemene pagina

Gebruik de pagina Algemeen van het dialoogvenster Pakkethulpprogramma uitvoeren om een pakketnaam en locatie op te geven.

Het hulpprogramma Execute Package (dtexecui.exe) voert altijd een pakket uit op de lokale computer, zelfs als het pakket wordt opgeslagen op een externe server. Als het externe pakket configuratiebestanden gebruikt die ook worden opgeslagen op de externe server, kan het hulpprogramma Pakket uitvoeren de configuraties niet vinden en mislukt het pakket. Om dit probleem te voorkomen, moeten de configuraties worden verwezen met behulp van een UNC-sharenaam (Universal Naming Convention), zoals \\myserver\myfile.

Statische opties

pakketbron
Geef de locatie op van het pakket dat moet worden uitgevoerd met behulp van de volgende opties:

Waarde	Beschrijving
SQL Server	Selecteer deze optie wanneer het pakket zich in Microsoft SQL Server bevindt. Geef een exemplaar van SQL Server op en geef een gebruikersnaam en wachtwoord op voor SQL Server-verificatie. Elke gebruikersnaam en elk wachtwoord voegt de /USER-gebruikersnaam en /PASSWORD-wachtwoordopties toe aan de opdrachtprompt.
bestandssysteem	Selecteer deze optie wanneer het pakket zich in het bestandssysteem bevindt.
SSIS Package Store	Selecteer deze optie wanneer het pakket zich in het SSIS-pakketarchief bevindt.

Elk van deze selecties heeft de volgende set opties.

uitvoeren
Klik hier om het pakket uit te voeren.

sluiten
Klik om het dialoogvenster Pakkethulpprogramma uitvoeren te sluiten.

Dynamische opties

Pakketbron = SQL Server

Server
Typ de naam van de server waarin het pakket zich bevindt of selecteer een server in de lijst.

Aanmelden bij de server
Geef op of het pakket Windows-verificatie of SQL Server-verificatie moet gebruiken om verbinding te maken met SQL Server. Windows-verificatie wordt aanbevolen voor betere beveiliging. Met Windows-verificatie hoeft u geen gebruikersnaam en wachtwoord op te geven.

Windows-verificatie gebruiken
Selecteer deze optie om Windows-verificatie te gebruiken en u aan te melden met een Microsoft Windows-gebruikersaccount.

SQL Server-verificatie gebruiken
Selecteer deze optie om SQL Server-verificatie te gebruiken. Wanneer een gebruiker verbinding maakt met een opgegeven aanmeldingsnaam en wachtwoord van een niet-vertrouwde verbinding, voert SQL Server de verificatie uit door te controleren of er een SQL Server-aanmeldingsaccount is ingesteld en of het opgegeven wachtwoord overeenkomt met het wachtwoord dat eerder is vastgelegd. Als SQL Server het aanmeldingsaccount niet kan vinden, mislukt de verificatie en ontvangt de gebruiker een foutbericht.

Belangrijk

Gebruik waar mogelijk Windows-verificatie.

Pakket
Typ de naam van het pakket of klik op de knop met het beletselteken (...) om een pakket te zoeken met behulp van het dialoogvenster Een SSIS-pakket selecteren.

Pakketbron = Bestandssysteem

Pakket
Typ de naam van het pakket of klik op de knop met het beletselteken (...) om een pakket te zoeken met behulp van het dialoogvenster Openen. Standaard worden in het dialoogvenster alleen bestanden weergegeven met de extensie .dtsx.

Pakketbron = SSIS-pakketarchief

Server
Typ de naam van de computer waarop het pakket zich bevindt of selecteer een computer in de lijst.

Aanmelden bij de server
Geef op of het pakket Microsoft Windows-verificatie moet gebruiken om verbinding te maken met de pakketbron. Windows-verificatie wordt aanbevolen voor betere beveiliging. Met Windows-verificatie hoeft u geen gebruikersnaam en wachtwoord op te geven.

Windows-verificatie gebruiken
Selecteer deze optie om Windows-verificatie te gebruiken en u aan te melden met een Microsoft Windows-gebruikersaccount.

SQL Server-verificatie gebruiken
Deze optie is niet beschikbaar wanneer u een pakket uitvoert dat is opgeslagen in de SSIS Package Store.

Pakket
Typ de naam van het pakket of klik op de knop met het beletselteken (...) om een pakket te zoeken met behulp van het dialoogvenster Een SSIS-pakket selecteren.

Pagina Configuraties

Gebruik de pagina Configuraties van het dialoogvenster Pakkethulpprogramma uitvoeren om de configuratiebestanden te selecteren die tijdens de uitvoering moeten worden geladen en om de volgorde op te geven waarin ze worden geladen.

Opties

Configuratiebestanden
Geeft een lijst van de configuraties die door het pakket worden gebruikt. Elk configuratiebestand voegt een /CONFIGFILE-bestandsnaamoptie toe aan de opdrachtprompt.

pijltoetsen
Selecteer een configuratiebestand in de lijst en gebruik de pijltoetsen rechts om de laadvolgorde te wijzigen. Configuraties laden in volgorde vanaf het begin van de lijst.

Opmerking

Als meerdere configuraties dezelfde eigenschap wijzigen, wordt de configuratie die het laatst wordt geladen, gebruikt.

Toevoegen
Klik om configuraties toe te voegen via het dialoogvenster Openen . Standaard worden in het dialoogvenster alleen bestanden weergegeven met de extensie .dtsconfig.

verwijderen
Selecteer een configuratiebestand in de lijst en klik vervolgens op Verwijderen.

uitvoeren
Klik hier om het pakket uit te voeren.

sluiten
Klik om het dialoogvenster Pakkethulpprogramma uitvoeren te sluiten.

Pagina Opdrachtbestanden

Gebruik de pagina Opdrachtbestanden van het dialoogvenster Pakkethulpprogramma uitvoeren om de opdrachtbestanden te selecteren die tijdens de uitvoering moeten worden geladen.

Opties

Opdrachtbestanden
Geeft een lijst van de opdrachtbestanden die door het pakket worden gebruikt. Een pakket kan meerdere bestanden gebruiken om opdrachtregelopties in te stellen.

pijltoetsen
Selecteer een opdrachtbestand in de lijst en gebruik de pijltoetsen rechts om de laadvolgorde te wijzigen. Opdrachtbestanden worden op volgorde geladen, beginnend vanaf het begin van de lijst.

Toevoegen
Klik om een opdrachtbestand toe te voegen met behulp van het dialoogvenster Openen .

verwijderen
Selecteer een opdrachtbestand in het tekstvak en verwijder het met behulp van de knop Verwijderen .

uitvoeren
Klik hier om het pakket uit te voeren.

sluiten
Klik om het dialoogvenster Pakkethulpprogramma uitvoeren te sluiten.

Pagina Verbindingsbeheer

Gebruik de pagina Verbindingsbeheer van het dialoogvenster Pakkethulpprogramma uitvoeren om de verbindingsreeksen te bewerken van de verbindingsbeheerders die door het pakket worden gebruikt.

Opties

Verbindingsbeheer
Schakel het bijbehorende selectievakje in om de kolom Verbindingsreeks te bewerken.

Beschrijving
Bekijk een beschrijving voor elk verbindingsbeheer. Beschrijvingen kunnen niet worden bewerkt.

Verbindingsstring
Bewerk de verbindingsstring voor een verbindingbeheer. Dit veld kan alleen worden bewerkt wanneer het selectievakje Verbindingsbeheer is ingeschakeld.

uitvoeren
Klik hier om het pakket uit te voeren.

sluiten
Klik om het dialoogvenster Pakkethulpprogramma uitvoeren te sluiten.

Pagina Uitvoeringsopties

Gebruik de pagina Uitvoeringsopties van het dialoogvenster Pakkethulpprogramma uitvoeren om runtimeopties voor het pakket op te geven.

Opties

Mislukt pakket bij validatiewaarschuwingen
Geef aan of het pakket mislukt als er een validatiewaarschuwing optreedt.

Pakket valideren zonder uit te voeren
Geef aan of het pakket enkel is gevalideerd.

Maximum aantal gelijktijdige uitvoerbare bestanden
Geef aan of u het maximum aantal uitvoerbare bestanden wilt opgeven dat tegelijkertijd in het pakket kan worden uitgevoerd. Nadat u dit selectievakje hebt ingeschakeld, gebruikt u het spinvak om het maximum aantal uitvoerbare bestanden op te geven.

Pakketcontrolepunten inschakelen
Geef aan of pakketcontrolepunten moeten worden ingeschakeld.

Controlepuntbestand
Vermeld het controlepuntbestand dat door het pakket wordt gebruikt, als u pakketcontrolepunten inschakelt.

navigeren
Klik op de bladerknop (...) om het controlepuntbestand te zoeken met behulp van het dialoogvenster Openen als u pakketcontrolepunten inschakelt. Als er al een controlepuntbestand is opgegeven, wordt het vervangen door het geselecteerde bestand.

Opties voor opnieuw opstarten overschrijven
Geef aan of herstartopties buiten werking moeten worden gesteld als u pakketcontrolepunten inschakelt.

Opnieuw opstarten optie
Selecteer hoe u controlepunten gebruikt als u opties voor opnieuw opstarten overschrijft.

uitvoeren
Klik hier om het pakket uit te voeren.

sluiten
Klik om het dialoogvenster Pakkethulpprogramma uitvoeren te sluiten.

Rapportagepagina

Gebruik de rapportagepagina van het dialoogvenster Pakkethulpprogramma uitvoeren om de gebeurtenissen en informatie over het pakket op te geven die moeten worden geregistreerd bij de console wanneer het pakket wordt uitgevoerd.

Opties

Console-gebeurtenissen
Geef de gebeurtenissen en typen berichten aan die moeten worden rapporteren.

Geen
Selecteer deze optie voor geen rapportage.

Fouten
Selecteer deze optie om foutberichten te rapporteren.

Waarschuwingen
Selecteer deze optie om waarschuwingsberichten te rapporteren.

Aangepaste gebeurtenissen
Selecteer deze optie om aangepaste gebeurtenisberichten te rapporteren.

Pijplijn gebeurtenissen
Selecteer deze optie om berichten over gegevensstroomgebeurtenissen te rapporteren.

Informatie
Selecteer deze optie om informatieberichten te rapporteren.

Uitvoerig
Selecteer deze optie om uitgebreide rapportage te gebruiken.

Consolelogboekregistratie
Geef de informatie op die u naar het logboek wilt schrijven wanneer de geselecteerde gebeurtenis plaatsvindt.

Naam
Selecteer deze optie om de naam te rapporteren van de persoon die het pakket heeft gemaakt.

Computer
Selecteer deze optie om de naam te rapporteren van de computer waarop het pakket wordt uitgevoerd.

Bediener
Selecteer deze optie om de naam te rapporteren van de persoon die het pakket heeft gestart.

Bronnaam
Selecteer deze optie om de pakketnaam te rapporteren.

Bron-GUID
Selecteer deze optie om de pakket-GUID te rapporteren.

Uitvoerings-GUID
Selecteer om de GUID van het pakketuitvoeringsvoorbeeld te rapporteren.

Bericht
Selecteer dit om berichten te rapporteren.

Begin- en eindtijd
Selecteer deze optie om te rapporteren wanneer het pakket is begonnen en voltooid.

uitvoeren
Klik hier om het pakket uit te voeren.

sluiten
Klik om het dialoogvenster Pakkethulpprogramma uitvoeren te sluiten.

Inlogpagina

Gebruik de pagina Logboekregistratie van het dialoogvenster Pakketuitvoeringshulpprogramma om logboekproviders tijdens uitvoertijd beschikbaar te maken voor het pakket. Geef het type pakketlogboekprovider en de verbindingsreeks op om verbinding te maken met het logboek. Elke vermelding van de logboekprovider voegt een /LOGGERclassid-optie toe aan de opdrachtprompt.

Opties

Logprovider
Selecteer een logboekprovider in de lijst.

Configuratietekenreeks
Selecteer de naam van het verbindingsbeheer in het pakket dat verwijst naar de logboeklocatie of typ de verbindingsreeks om verbinding te maken met de logboekprovider.

verwijderen
Selecteer een logboekprovider en klik om deze te verwijderen.

uitvoeren
Klik hier om het pakket uit te voeren.

sluiten
Klik om het dialoogvenster Pakkethulpprogramma uitvoeren te sluiten.

Pagina Waarden instellen

Gebruik de pagina Waarden instellen van het dialoogvenster Pakkethulpprogramma uitvoeren om de eigenschapswaarden van pakketten, uitvoerbare bestanden, verbindingen, variabelen en logboekproviders in te stellen door de paden van eigenschappen en de eigenschapswaarden te typen. Elke padvermelding voegt een /SETeigenschapspad;waarde-optie toe aan de opdrachtprompt.

Opties

Eigenschapspad
Voer het pad van de eigenschap in. De padsyntaxis maakt gebruik van een backslash (\) om aan te geven dat het volgende item een container is, een punt (.) om aan te geven dat het volgende item een eigenschap is, en vierkante haken om aan te geven dat het een verzamelingslid betreft. Het lid kan worden geïdentificeerd door de index of de naam ervan. Het eigenschapspad van een pakketvariabele is bijvoorbeeld \Package.Variables[MyVariable]. Waarde.

Waarde
Typ de waarde van de eigenschap.

verwijderen
Selecteer een eigenschapspad en klik om het te verwijderen.

uitvoeren
Klik hier om het pakket uit te voeren.

sluiten
Klik om het dialoogvenster Pakkethulpprogramma uitvoeren te sluiten.

Verificatiepagina

Gebruik de pagina Verificatie van het dialoogvenster Pakket uitvoeren om criteria in te stellen voor het verifiëren van het pakket.

Opties

Alleen ondertekende pakketten uitvoeren
Selecteer deze optie om alleen pakketten uit te voeren die zijn ondertekend.

Pakketbuild controleren
Selecteer deze optie om de pakketbuild te controleren.

Bouwen
Geef het opeenvolgende buildnummer op dat is gekoppeld aan de build.

Pakket-id verifiëren
Selecteer deze optie om de pakket-id te verifiëren.

Pakket-ID
Geef het pakketidentificatienummer op.

Versie-id controleren
Selecteer deze optie om de versie-id te controleren.

Versie-id
Geef het versie-id-nummer op.

uitvoeren
Klik hier om het pakket uit te voeren.

sluiten
Klik om het dialoogvenster Pakkethulpprogramma uitvoeren te sluiten.

Opdrachtregelpagina

Gebruik het opdrachtregelknooppunt van het dialoogvenster Pakkethulpprogramma uitvoeren om de opdrachtregel te bewerken die is gegenereerd door de opties die door de verschillende dialoogvensters zijn gemaakt.

Opties

De oorspronkelijke opties herstellen
Klik om de opdrachtregel te herstellen naar de oorspronkelijke staat. Gebruik deze optie als u wijzigingen hebt aangebracht met de opdrachtregeloptie Handmatig bewerken en de oorspronkelijke opdrachtregelopties wilt herstellen.

De opdrachtregel handmatig bewerken
Klik hier om de opdrachtregel in het tekstvak Opdrachtregel te bewerken.

Opdrachtregel
Geeft de huidige opdrachtregel weer. Bewerkbaar als u de optie hebt geselecteerd om de opdrachtregel handmatig te bewerken.

uitvoeren
Klik hier om het pakket uit te voeren.

sluiten
Klik om het dialoogvenster Pakkethulpprogramma uitvoeren te sluiten.

Zie ook

dtexec-hulpprogramma