Attività di trasferimento dei messaggi di errore

Si applica a:SQL Server SSIS Integration Runtime in Azure Data Factory

L'attività Trasferisci messaggi di errore trasferisce uno o più messaggi di errore definiti dall'utente di SQL Server tra istanze di SQL Server. I messaggi definiti dall'utente sono messaggi con un identificatore che è uguale o maggiore di 50000. I messaggi con identificatore minore di 50000 sono messaggi di errore di sistema e non possono essere trasferiti utilizzando l'attività Trasferisci messaggi di errore.

È possibile configurare l'attività Trasferisci messaggi di errore per il trasferimento di tutti i messaggi di errore o dei soli messaggi di errore specificati. I messaggi di errore definiti dall'utente possono essere disponibili in lingue diverse. È possibile configurare l'attività per il trasferimento dei soli messaggi nelle lingue selezionate. Nel server di destinazione deve esistere una versione us_english del messaggio che utilizza la tabella codici 1033 prima di poter trasferire su tale server le versioni del messaggio in altre lingue.

La tabella sysmessages del database master contiene tutti i messaggi di errore, sia di sistema che definiti dall'utente, usati in SQL Server.

I messaggi definiti dall'utente da trasferire potrebbero essere già presenti nella destinazione. Un messaggio di errore è considerato duplicato se l'identificatore e la lingua corrispondono a quelli di un messaggio di errore esistente. È possibile configurare l'attività Transfer Error Messages per gestire i messaggi di errore esistenti nei modi seguenti:

• Sovrascrivi i messaggi di errore esistenti.

• Contrassegna l'attività come non riuscita quando sono presenti messaggi duplicati.

• I messaggi di errore duplicati vengono ignorati.

In fase di esecuzione l'attività Trasferisci messaggi di errore si connette al server di origine e al server di destinazione utilizzando una o più gestioni connessioni SMO. Il gestore connessioni SMO viene configurato separatamente dall'attività Trasferisci messaggi di errore e quindi viene richiamato in tale attività. Le gestioni connessioni SMO specificano il server e la modalità di autenticazione da adottare per l'accesso al server. Per ulteriori informazioni, vedere SMO Gestione connessioni.

L'attività Trasferisci messaggi di errore supporta un'origine e una destinazione di SQL Server. Non esiste alcuna limitazione relativamente alla versione da utilizzare come origine o destinazione.

Eventi

L'attività genera un evento informativo che riporta il numero di messaggi di errore che sono stati trasferiti.

L’attività Trasferisci messaggi di errore non segnala l’avanzamento incrementale del trasferimento dei messaggi di errore; riporta solo il completamento allo 0% e al 100%.

Valore di esecuzione

Il valore di esecuzione, definito nella proprietà ExecutionValue dell'attività, restituisce il numero di messaggi di errore trasferiti. Se si assegna una variabile definita dall'utente alla proprietà ExecValueVariable dell'attività, le informazioni sul trasferimento dei messaggi di errore possono essere rese disponibili ad altri oggetti del pacchetto. Per altre informazioni, vedere Variabili di Integration Services (SSIS) e Utilizzo di variabili nei pacchetti.

Voci di log

L'attività Trasferisci messaggi di errore include le voci di log personalizzate seguenti:

• TransferErrorMessagesTaskStartTransferringObjects Questa voce di registro segnala che il trasferimento è iniziato. La voce di log include l'ora di inizio.

• TransferErrorMessagesTaskFinishedTransferringObjects Questa voce di registro segnala che il trasferimento si è concluso. La voce di log include l'ora di fine.

Una voce di log per l'evento OnInformation indica inoltre il numero di messaggi di errore che sono stati trasferiti e viene scritta una voce di log per l' evento OnWarning per ogni messaggio di errore sovrascritto nella destinazione.

Sicurezza e autorizzazioni

Per creare nuovi messaggi di errore, l'utente che esegue il pacchetto deve essere membro del ruolo del server sysadmin o serveradmin sul server di destinazione.

Configurazione dell'attività Trasferisci messaggi di errore

È possibile impostare le proprietà tramite Progettazione SSIS o a livello di codice.

Per altre informazioni sulle proprietà che è possibile impostare in Progettazione SSIS, fare clic sull'argomento seguente:

• Pagina delle espressioni

Per informazioni sull'impostazione di queste proprietà a livello di codice, fare clic sull'argomento seguente:

• TransferErrorMessagesTask

Attività correlate

Per altre informazioni sull'impostazione di queste proprietà in Progettazione SSIS, fare clic sull'argomento seguente:

• Impostare le proprietà di un'attività o di un contenitore

Editor attività Trasferimento dei messaggi di errore (Pagina generale)

Utilizzare la pagina Generale della finestra di dialogo Editor attività Trasferisci messaggi di errore per assegnare un nome e una descrizione all'attività Trasferisci messaggi di errore. L'attività Trasferisci messaggi di errore trasferisce uno o più messaggi di errore definiti dall'utente di SQL Server tra istanze di SQL Server.

Opzioni

Nome
Consente di digitare un nome univoco per l'attività Trasferisci messaggi di errore. Tale nome viene utilizzato come etichetta nell'icona dell'attività.

Descrizione
Inserisci una descrizione dell'attività Messaggi di errore di trasferimento.

Editor dell'attività Trasferisci messaggi di errore (pagina Messaggi)

Usare la pagina Messaggi della finestra di dialogo Editor attività Trasferisci messaggi di errore per specificare le proprietà relative alla copia di uno o più messaggi di errore definiti dall'utente di SQL Server tra due istanze di SQL Server.

Opzioni

SourceConnection
Selezionare una gestione connessione SMO nell'elenco o fare clic su <Nuova connessione> per creare una nuova connessione al server di origine.

DestinationConnection
Selezionare una gestione connessione SMO nell'elenco o fare clic su <Nuova connessione> per creare una nuova connessione al server di destinazione.

IfObjectExists
Indicare se l'attività deve sovrascrivere i messaggi di errore definiti dall'utente esistenti, ignorare i messaggi esistenti oppure interrompersi in caso nel server di destinazione esistano già messaggi di errore con lo stesso nome.

TransferAllErrorMessages
Indicare se l'attività deve copiare dal server di origine al server di destinazione tutti i messaggi di errore definiti dall'utente o solo quelli specificati.

Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente:

ErrorMessagesList
Fare clic sul pulsante sfoglia (...) per selezionare i messaggi di errore da copiare.

ErrorMessageLanguagesList
Fare clic sul pulsante sfoglia (...) per selezionare le lingue per cui copiare i messaggi di errore definiti dall'utente nel server di destinazione. Per poter trasferire versioni del messaggio in altre lingue nel server di destinazione, è necessario che in tale server esista una versione us_english (tabella codici 1033) del messaggio.

Contenuti correlati

• Attività di Integration Services
• Flusso di controllo