Attività Trasferisci 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. È necessario che nel server di destinazione sia inclusa la versione del messaggio che utilizza la tabella codici 1033, corrispondente all'inglese americano, per poter trasferire su tale server 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à Trasferisci messaggi di errore per la gestione dei messaggi di errore duplicati nei modi seguenti:

  • I messaggi di errore duplicati vengono sovrascritti.

  • In presenza di messaggi di errore duplicati l'attività ha esito negativo.

  • 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. Le gestioni connessioni SMO vengono configurate separatamente dall'attività Trasferisci messaggi di errore, che tuttavia vi fa riferimento. Le gestioni connessioni SMO specificano il server e la modalità di autenticazione da adottare per l'accesso al server. Per altre informazioni, vedere Gestione connessione file.

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à Trasferisci messaggi di errore genera un evento informativo in cui è indicato il numero di messaggi di errore trasferiti.

Non viene riportato lo stato incrementale del trasferimento, ma solo il completamento 0% e 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 Indica che il trasferimento è iniziato. La voce di log include l'ora di inizio.

  • TransferErrorMessagesTaskFinishedTransferringObjects Indica che il trasferimento è stato completato. 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 poter creare messaggi di errore, l'utente che esegue il pacchetto deve essere un membro del ruolo del server sysadmin o serveradmin nel 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:

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

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

Editor attività Trasferisci 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à.

Nota

I nomi delle attività devono essere univoci all'interno di un pacchetto.

Descrizione
Consente di digitare una descrizione dell'attività Trasferisci messaggi di errore.

Editor 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:

Valore Descrizione
Vero Copia tutti i messaggi definiti dall'utente.
Falso Copia solo i messaggi definiti dall'utente specificati.

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

Nota

È necessario specificare la proprietà SourceConnection prima di poter selezionare i messaggi di errore di cui eseguire la copia.

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.

Nota

È necessario specificare la proprietà SourceConnection prima di poter selezionare i messaggi di errore di cui eseguire la copia.

Vedi anche

Attività di Integration Services
Flusso di controllo