Pianificare un pacchetto tramite SQL Server Agent
Nella procedura riportata di seguito vengono illustrati i passaggi per automatizzare l'esecuzione di un pacchetto tramite un passaggio di processo di SQL Server Agent per eseguire il pacchetto.
Per automatizzare l'esecuzione dei pacchetti tramite SQL Server Agent
In SQL Server Management Studio connettersi all'istanza di SQL Server in cui si desidera creare un processo oppure all'istanza contenente il processo a cui si desidera aggiungere un passaggio.
Espandere il nodo SQL Server Agent in Esplora oggetti ed eseguire una delle attività seguenti:
Per creare un nuovo processo, fare clic con il pulsante destro del mouse su Processi, quindi scegliere Nuovo processo.
Per aggiungere un passaggio a un processo esistente, espandere il nodo Processi, fare clic con il pulsante destro del mouse sul processo, quindi scegliere Proprietà.
Nella pagina Generale, se si crea un nuovo processo specificare un nome per il processo, selezionare un proprietario e una categoria di processo e, facoltativamente, fornire una descrizione.
Per rendere il processo disponibile per la pianificazione, selezionare Abilitato.
Per creare un passaggio di processo per il pacchetto che si desidera pianificare, fare clic su Passaggi, quindi su Nuovo.
Selezionare Pacchetto di Integration Services per il tipo di passaggio di processo.
Nell'elenco Esegui come selezionare Account del servizio SQL Server Agent oppure selezionare un account proxy che dispone delle credenziali che verranno utilizzate dal passaggio di processo. Per informazioni sulla creazione di un account proxy, vedere Creazione di un proxy di SQL Server Agent.
L'utilizzo di un account proxy anziché dell'Account del servizio SQL Server Agent può risolvere i problemi comuni che possono verificarsi quando si esegue un pacchetto tramite SQL Server Agent. Per ulteriori informazioni su questi problemi, vedere l'articolo della Microsoft Knowledge Base relativo a un pacchetto SSIS che non viene eseguito quando viene chiamato da un passaggio di processo di SQL Server Agent.
[!NOTA]
Se viene modificata la password per le credenziali utilizzate dall'account proxy, è necessario aggiornare la password delle credenziali. In caso contrario, il passaggio di processo avrà esito negativo.
Per informazioni sulla configurazione dell'account del servizio SQL Server Agent, vedere Impostazione dell'account di avvio del servizio SQL Server Agent (Gestione configurazione SQL Server).
Nella casella di riepilogo Origine pacchetto fare clic sull'origine del pacchetto e quindi configurare le opzioni per il passaggio di processo.
Nella tabella seguente vengono descritte le possibili origini pacchetto.
Origine pacchetto
Descrizione
Catalogo SSIS
Pacchetti archiviati nel database SSISDB. I pacchetti sono contenuti nei progetti di Integration Services distribuiti nel server Integration Services.
SQL Server
Pacchetti archiviati nel database MSDB. Utilizzare il servizio Integration Services per gestire i pacchetti.
Archivio pacchetti SSIS
Pacchetti archiviati nella cartella predefinita nel computer. La cartella predefinita è <unità>:\Programmi\Microsoft SQL Server\110\DTS\Packages. Utilizzare il servizio Integration Services per gestire i pacchetti.
[!NOTA]
È possibile specificare un'altra cartella o specificare cartelle aggiuntive nel file system da gestire tramite il servizio Integration Services, modificando il file di configurazione per Integration Services. Per ulteriori informazioni, vedere Configurazione del servizio Integration Services (servizio SSIS).
File system
Pacchetti archiviati in qualsiasi cartella nel computer locale.
Nelle tabelle seguenti vengono descritte le opzioni di configurazione disponibili per il passaggio di processo in base all'origine del pacchetto selezionata.
Importante Se il pacchetto è protetto da password, quando si fa clic su una delle schede nella pagina Generale della finestra di dialogo Nuovo passaggio di processo, ad eccezione della scheda Pacchetto, è necessario immettere la password nella finestra di dialogo Password pacchetto che viene visualizzata. In caso contrario, il processo di SQL Server Agent non sarà in grado di eseguire il pacchetto.
Origine pacchetto: catalogo SSIS
Scheda
Opzioni
Pacchetto
Server
Digitare o selezionare il nome dell'istanza del server di database che ospita il catalogo SSISDB.
Quando Catalogo SSIS è l'origine del pacchetto, è possibile accedere al server utilizzando solo un account utente di Microsoft Windows. L'autenticazione SQL Server non è disponibile.
Pacchetto
Fare clic sul pulsante con i puntini di sospensione e selezionare un pacchetto.
Viene selezionato un pacchetto in una cartella nel nodo Cataloghi di Integration Services in Esplora oggetti.
Parametri
Si trova nella scheda Configurazione.
Immettere nuovi valori per i parametri contenuti nel pacchetto. È possibile immettere un valore letterale o utilizzare il valore contenuto in una variabile di ambiente server di cui è già stato eseguito il mapping al parametro.
Per immettere il valore letterale, fare clic sul pulsante con i puntini di sospensione accanto a un parametro. Viene visualizzata la finestra di dialogo Modifica valore letterale per l'esecuzione.
Per utilizzare una variabile di ambiente, fare clic su Ambiente e selezionare l'ambiente che contiene la variabile da utilizzare.
Importante Se è stato eseguito il mapping di più parametri e/o delle proprietà di gestione connessione alle variabili contenute in più ambienti, in SQL Server Agent viene visualizzato un messaggio di errore. Per un'esecuzione specifica, un pacchetto può essere eseguito solo con i valori contenuti in un ambiente server singolo.
Per informazioni sulla creazione di un ambiente server e il mapping di una variabile a un parametro, vedere Creare ed eseguire il mapping di un ambiente server.
Nella scheda Parametri sono visualizzati i parametri aggiunti dopo la progettazione del pacchetto, ad esempio tramite SQL Server Data Tools (SSDT). Nella scheda sono inoltre visualizzati i parametri aggiunti al pacchetto durante la conversione del progetto di Integration Services dal modello di distribuzione del pacchetto nel modello di distribuzione del progetto. La Conversione guidata progetto di Integration Services consente di sostituire le configurazioni del pacchetto con i parametri.
Gestioni connessioni
Si trova nella scheda Configurazione.
Modificare i valori per le proprietà di gestione connessione. Ad esempio, è possibile modificare il nome del server.
I parametri vengono automaticamente generati nel server SSIS per le proprietà di gestione connessione.
Per modificare il valore di una proprietà, è possibile immettere un valore letterale o utilizzare il valore contenuto in una variabile di ambiente server di cui è già stato eseguito il mapping alla proprietà di gestione connessione.
Per immettere il valore letterale, fare clic sul pulsante con i puntini di sospensione accanto a un parametro. Viene visualizzata la finestra di dialogo Modifica valore letterale per l'esecuzione.
Per utilizzare una variabile di ambiente, fare clic su Ambiente e selezionare l'ambiente che contiene la variabile da utilizzare.
Importante Se è stato eseguito il mapping di più parametri e/o delle proprietà di gestione connessione alle variabili contenute in più ambienti, in SQL Server Agent viene visualizzato un messaggio di errore. Per un'esecuzione specifica, un pacchetto può essere eseguito solo con i valori contenuti in un ambiente server singolo.
Per informazioni sulla creazione di un ambiente server e il mapping di una variabile a una proprietà di gestione connessione, vedere Creare ed eseguire il mapping di un ambiente server.
Avanzate
Si trova nella scheda Configurazione.
Configurare le impostazioni aggiuntive seguenti per l'esecuzione del pacchetto.
- Override proprietà
Fare clic su Aggiungi per immettere un nuovo valore per una proprietà del pacchetto, specificare il percorso della proprietà e indicare se il valore della proprietà è sensibile. Il server Integration Services crittografa i dati sensibili.
Per modificare o rimuovere le impostazioni per una proprietà, fare clic su una riga nel contenitore di override Proprietà, quindi fare clic su Modifica o Rimuovi.
È possibile trovare il percorso della proprietà effettuando una delle operazioni seguenti.
Copiare il percorso della proprietà dal file di configurazione XML (*.dtsconfig). Il percorso è elencato nella sezione Configurazione del file, come valore dell'attributo Path. Di seguito è riportato un esempio del percorso per la proprietà MaximumErrorCount.
\Package.Properties[MaximumErrorCount]
Eseguire la Configurazione guidata pacchetto e copiare i percorsi delle proprietà dalla pagina finale Completamento procedura guidata. È possibile annullare la procedura guidata.
[!NOTA]
L'opzione Override di proprietà è destinata ai pacchetti con configurazioni aggiornate da una versione precedente di Integration Services. I pacchetti creati tramite SQL Server 2012 Integration Services (SSIS) e distribuiti al server Integration Services utilizzano parametri anziché configurazioni.
- Livello di registrazione
Selezionare uno dei livelli di registrazione seguenti per l'esecuzione del pacchetto.
La selezione del livello di registrazione Prestazioni o Dettagliato può influire sulle prestazioni di esecuzione del pacchetto.
Nessuno
La registrazione è disabilitata. Solo lo stato dell'esecuzione del pacchetto viene registrato.
Di base
Tutti gli eventi sono registrati, ad eccezione di eventi personalizzati e di diagnostica. È il valore predefinito per il livello di registrazione.
Prestazioni
Vengono registrati solo le statistiche sulle prestazioni e gli eventi OnError e OnWarning.
Dettagliato
Tutti gli eventi vengono registrati, inclusi gli eventi personalizzati e di diagnostica.
Il livello di registrazione selezionato determina le informazioni visualizzate nelle viste SSISDB e nei report per il server Integration Services. Per ulteriori informazioni, vedere Abilitare la registrazione per l'esecuzione di pacchetti nel server SSIS.
- Dump su errori
Specificare se vengono generati file di dump del debug quando si verifica un errore durante l'esecuzione del pacchetto.
I file contengono le informazioni sull'esecuzione del pacchetto che possono consentire di risolvere i problemi dell'esecuzione.
Quando si seleziona questa opzione e si verifica un errore durante l'esecuzione, Integration Services crea un file con estensione MDMP (file binario) e un file con estensione TMP (file di testo). Per impostazione predefinita, i file vengono archiviati da Integration Services nella cartella <unità>:\Programmi\Microsoft SQL Server\110\Shared\ErrorDumps.
- Runtime a 32 bit
Indicare se eseguire il pacchetto utilizzando la versione a 32 bit dell'utilità dtexec in un computer a 64 bit con la versione a 64 bit di SQL Server e SQL Server Agent installato.
Potrebbe essere necessario eseguire il pacchetto utilizzando la versione a 32 bit di dtexec se, ad esempio, il pacchetto utilizza un provider OLE DB nativo che non è disponibile in una versione a 64 bit. Per ulteriori informazioni, vedere Considerazioni a 64r bit per Integration Services.
Per impostazione predefinita, quando si seleziona il tipo di passaggio di processo Pacchetto di SQL Server Integration Services, SQL Server Agent esegue il pacchetto utilizzando la versione dell'utilità dtexec che è richiamata automaticamente dal sistema. Il sistema richiama la versione a 32 bit o la versione a 64 bit dell'utilità a seconda del processore del computer e la versione di SQL Server e di SQL Server Agent in esecuzione nel computer.
Origine pacchetto: SQL Server, archivio pacchetti SSIS o file system
Molte delle opzioni che è possibile impostare per i pacchetti archiviati in SQL Server, nell'archivio pacchetti SSIS o nel file system corrispondono alle opzioni della riga di comando per l'utilità del prompt dei comandi dtexec. Per ulteriori informazioni sull'utilità e sulle opzioni della riga di comando, vedere Utilità dtexec.
Scheda
Opzioni
Pacchetto
Di seguito sono riportate le opzioni della scheda per i pacchetti archiviati in SQL Server o nell'archivio pacchetti SSIS.
Server
Digitare o selezionare il nome dell'istanza del server di database per SQL Server o il servizio Integration Services.
Usa autenticazione di Windows
Selezionare questa opzione per accedere al server mediante un account utente di Microsoft Windows.
Usa autenticazione di SQL Server
Quando un utente si connette con un nome di account di accesso e una password da una connessione non trusted, l'autenticazione viene eseguita da SQL Server che controlla se è stato impostato un account di accesso di SQL Server e se la password specificata corrisponde a quella registrata in precedenza. Se SQL Server non riesce a trovare l'account di accesso, l'autenticazione ha esito negativo e viene visualizzato un messaggio di errore.
Nome utente
Password
Pacchetto
Fare clic sul pulsante con i puntini di sospensione e selezionare il pacchetto.
Viene selezionato un pacchetto in una cartella nel nodo Pacchetti archiviati in Esplora oggetti.
Pacchetto
Di seguito sono riportate le opzioni della scheda per i pacchetti archiviati nel file system.
Pacchetto
Digitare il percorso completo del file del pacchetto oppure fare clic sul pulsante con i puntini di sospensione per selezionare il pacchetto.
Configurazioni
Aggiungere un file di configurazione XML per eseguire il pacchetto con una configurazione specifica. Per aggiornare i valori delle proprietà del pacchetto in fase di esecuzione utilizzare una configurazione di pacchetto.
Questa opzione corrisponde all'opzione /ConfigFile per dtexec.
Per informazioni sull'applicazione delle configurazioni dei pacchetti, vedere Configurazioni di pacchetto. Per informazioni su come creare la configurazione di un pacchetto, vedere Creazione di configurazioni dei pacchetti.
File di comando
Specificare le opzioni aggiuntive da eseguire con dtexec, in un file separato.
Ad esempio, è possibile includere un file contenente l'opzione /Dump errorcode, per generare file di dump del debug quando uno o più eventi specificati si verificano durante l'esecuzione del pacchetto.
È possibile eseguire un pacchetto con diversi set di opzioni creando più file e specificando il file appropriato tramite l'opzione File di comando.
L'opzione File di comando corrisponde all'opzione /CommandFile per dtexec.
Origini dati
Visualizzare le gestioni connessioni contenute nel pacchetto. Per modificare una stringa di connessione, fare clic sulla gestione connessione e quindi fare clic sulla stringa di connessione.
Questa opzione corrisponde all'opzione /Connection per dtexec.
Opzioni di esecuzione
- Interrompi il pacchetto in caso di avvisi di convalida
Indica se un messaggio di avviso viene considerato un errore. Se si seleziona questa opzione e viene generato un avviso durante la convalida, il pacchetto ha esito negativo durante la convalida. Questa opzione corrisponde all'opzione /WarnAsError per dtexec.
- Convalida pacchetto senza esecuzione
Indica se l'esecuzione del pacchetto viene arrestata dopo la fase di convalida, senza eseguire effettivamente il pacchetto. Questa opzione corrisponde all'opzione /Validate per dtexec.
- Esegui override proprietà MaxConcurrentExecutables
Consente di specificare il numero di file eseguibili che il pacchetto è in grado di eseguire contemporaneamente. Il valore -1 indica che il pacchetto può eseguire un numero massimo di file eseguibili uguale al numero totale di processori nel computer in cui è eseguito il pacchetto, più due. Questa opzione corrisponde all'opzione /MaxConcurrent per dtexec.
- Abilita checkpoint pacchetto
Indica se il pacchetto utilizzerà checkpoint durante l'esecuzione del pacchetto. Per ulteriori informazioni, vedere Riavvio dei pacchetti tramite checkpoint.
Le opzioni corrispondono all'opzione /CheckPointing per dtexec.
- Ignora opzioni di riavvio
Indica se è impostato un nuovo valore per la proprietà CheckpointUsage del pacchetto. Selezionare un valore nell'elenco a discesa Opzione di avvio.
Questa opzione corrisponde all'opzione /Restart per dtexec.
- Utilizza run-time a 32 bit
Indicare se eseguire il pacchetto utilizzando la versione a 32 bit dell'utilità dtexec in un computer a 64 bit con la versione a 64 bit di SQL Server e SQL Server Agent installato.
Potrebbe essere necessario eseguire il pacchetto utilizzando la versione a 32 bit di dtexec se, ad esempio, il pacchetto utilizza un provider OLE DB nativo che non è disponibile in una versione a 64 bit. Per ulteriori informazioni, vedere Considerazioni a 64r bit per Integration Services.
Per impostazione predefinita, quando si seleziona il tipo di passaggio di processo Pacchetto di SQL Server Integration Services, SQL Server Agent esegue il pacchetto utilizzando la versione dell'utilità dtexec che è richiamata automaticamente dal sistema. Il sistema richiama la versione a 32 bit o la versione a 64 bit dell'utilità a seconda del processore del computer e la versione di SQL Server e di SQL Server Agent in esecuzione nel computer.
Registrazione
Associare un provider di log all'esecuzione del pacchetto.
- Provider di log SSIS per file di testo
Scrive le voci di log in file di testo ASCII
- Provider di log SSIS per SQL Server
Scrive le voci di log nella tabella sysssislog nel database MSDB.
- Provider di log SSIS per SQL Server Profiler
Scrive tracce che è possibile visualizzare utilizzando SQL Server Profiler.
- Provider di log SSIS per il registro eventi di Windows
Scrive voci di log nel log applicazioni nel registro eventi di Windows.
- Provider di log SSIS per file XML
Scrive file di log in un file XML.
Per il file di testo, il file XML e i provider di log di SQL Server Profiler, si selezionano gestioni connessione file contenute nel pacchetto. Per il provider di log di SQL Server, si seleziona una gestione connessione OLE DB contenuta nel pacchetto.
Questa opzione corrisponde all'opzione /Logger per dtexec.
Imposta valori
Eseguire l'override dell'impostazione delle proprietà di un pacchetto. Nella casella Proprietà immettere i valori nelle colonne Percorso proprietà e Valore . Dopo avere immesso valori per una proprietà, viene visualizzata una riga vuota nella casella Proprietà che consente di immettere valori per un'altra proprietà.
Per rimuovere una proprietà dalla casella Proprietà, fare clic sulla riga e quindi su Rimuovi.
È possibile trovare il percorso della proprietà effettuando una delle operazioni seguenti.
Copiare il percorso della proprietà dal file di configurazione XML (*.dtsconfig). Il percorso è elencato nella sezione Configurazione del file, come valore dell'attributo Path. Di seguito è riportato un esempio del percorso per la proprietà MaximumErrorCount.
\Package.Properties[MaximumErrorCount]
Eseguire la Configurazione guidata pacchetto e copiare i percorsi delle proprietà dalla pagina finale Completamento procedura guidata. È possibile annullare la procedura guidata.
Verifica
- Esegui solo pacchetti firmati
Indica se la firma del pacchetto è controllata. Se il pacchetto non è firmato o se la firma non è valida, il pacchetto ha esito negativo. Questa opzione corrisponde all'opzione /VerifySigned per dtexec.
- Verifica build pacchetto
Indica se il numero di build del pacchetto viene verificato rispetto al numero di build immesso nella casella Compilazione accanto all'opzione. Se i numeri non corrispondono, il pacchetto non verrà eseguito. Questa opzione corrisponde all'opzione /VerifyBuild per dtexec.
- Verifica ID pacchetto
Indica se il GUID del pacchetto viene verificato, confrontandolo con l'ID pacchetto immesso nella casella ID pacchetto accanto all'opzione. Questa opzione corrisponde all'opzione /VerifyPackageID per dtexec.
- Verifica ID versione
Indica se il GUID della versione del pacchetto viene verificato, confrontandolo con l'ID versione immesso nella casella ID versione accanto all'opzione. Questa opzione corrisponde all'opzione /VerifyVersionID per dtexec.
Riga di comando
Modificare le opzioni della riga di comando per dtexec. Per ulteriori informazioni sulle opzioni, vedere Utilità dtexec.
Suggerimento È possibile copiare la riga di comando in una finestra del prompt dei comandi, aggiungere dtexec ed eseguire il pacchetto dalla riga di comando. Si tratta di testo della riga di comando facile da generare.
- Ripristina opzioni originali
Utilizzare le opzioni della riga di comando impostate nelle schede Pacchetto, Configurazioni, File di comando, Origini dati, Opzioni di esecuzione, Registrazione, Imposta valori e Verifica della finestra di dialogo Proprietà set processo.
- Modificare il comando manualmente
Digitare opzioni della riga di comando aggiuntive nella casella Riga di comando.
Prima di fare clic su OK per salvare le modifiche apportate al passaggio di processo, è possibile rimuovere tutte le opzioni aggiuntive digitate nella casella Riga di comando facendo clic su Ripristina opzioni originali.
Scegliere OK per salvare le impostazioni e chiudere la finestra di dialogo Nuovo passaggio di processo.
[!NOTA]
Per i pacchetti archiviati nel Catalogo SSIS il pulsante OK è disabilitato se è presente un parametro o un'impostazione della proprietà di gestione connessione non risolto. Un'impostazione non risolta si verifica quando si utilizza un valore contenuto in una variabile di ambiente server per impostare il parametro o la proprietà e si verifica una delle seguenti condizioni.
-
La casella di controllo Ambiente nella scheda Configurazione non è selezionata.
-
L'ambiente server che contiene la variabile non è selezionato nella casella di riepilogo della scheda Configurazione.
-
Per creare una pianificazione per un passaggio di processo, fare clic su Pianificazioni nel riquadro Selezione pagina. Per informazioni su come configurare una pianificazione, vedere Pianificare un processo.
Suggerimento Quando si assegna un nome alla pianificazione, utilizzare un nome univoco e descrittivo in modo da distinguere più facilmente la pianificazione da altre pianificazioni di SQL Server Agent.