Errore Restituisce functoid

 

Usare ) per acquisire informazioni sugli errori, ad esempio errori di connessione al database, che si verificano durante l'esecuzione.

Input

Parametro 1: Collegamento da un functoid ricerca database .

Output

Output 1: Stringa di errore, se presente, restituita da Open Database Connectivity (ODBC) quando si usa il functoid.

Commenti

Usare questo functoid insieme ai functoid di ricerca del database e functoid dell'estrattore valore per acquisire e mappare le informazioni sugli errori. Tra gli scenari che possono risultare utili:

• Quando la mappa ha un functoid di ricerca del database o del functoid value extractor che non si comporta come previsto. Per visualizzare il messaggio di errore, eseguire temporaneamente il mapping del functoid a un campo dello schema di output.

• Se l'applicazione prevede un contenuto del messaggio diverso quando le operazioni di database hanno esito negativo. È possibile usare il functoid Restituito errori per rilevare un errore e eseguire il mapping del messaggio di errore a una struttura alternativa in modo che le applicazioni downstream possano reagire in modo controllato.

Per evitare errori rilevati solo in fase di esecuzione, assicurarsi che il parametro 1 per il functoid Restituito errore sia l'output di un functoid Ricerca database e non l'output di nessun altro functoid nella categoria Database .

Esempio

Nel mapping seguente viene usato un functoid Ricerca database per recuperare il cognome di una persona in base al nome. Se non viene rilevato alcun errore e esiste un cognome, il functoid value extractor lo copia nello schema di destinazione. Qualsiasi errore generato dal functoid Ricerca database durante la query verrà rilevato dal functoid Restituito errore e copiato nel campo messaggio di errore nello schema di destinazione.

Mappa di esempio di Restituzione errore

Per seguire il test, configurare il functoid Ricerca nel database con una tabella non valida come illustrato in basso.

Nome tabella non valido per il functoid Ricerca nel database

Il valore per Input[1] è "Provider=SQLNCLI10;Server=localhost;Database=Contoso; Trusted_Connection=yes;

Se il nome della tabella di ricerca non è valido il messaggio di output sarà analogo al seguente. Se "authors" è un nome di tabella non valido, viene visualizzato un messaggio di errore, successivamente archiviato nel nodo "Messaggio di errore".

<ns0:SampleSource xmlns:ns0="http://Sample">  
    <Person>  
        <FirstName>FirstName_0</FirstName>  
        <LastName />  
        <ErrorMessage>Invalid object name 'authors'.</ErrorMessage>  
    </Person>  
</ns0:SampleSource>  

Si tratta di un esempio di messaggio di errore. Vi sono molti tipi differenti di possibili messaggi di errore compresi errori di connessione, problemi relativi a stored procedure, problemi relativi all'ambiente, eccezioni SQL e così via. I processi downstream sono in grado di monitorare il campo Messaggio di errore e di elaborare o indirizzare il messaggio in modo appropriato.

Vedere anche

Informazioni di riferimento sui functoid di database
Functoid di database
Come aggiungere functoid di base a una mappa