Destinazione ADO NET

  • Articolo

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

La destinazione ADO NET consente di caricare i dati in un'ampia gamma di database compatibili con ADO.NET che usano una tabella o una vista di database. È disponibile l'opzione per caricare i dati in una tabella o in una vista esistenti o è possibile creare una nuova tabella e caricare i dati in essa.

È possibile usare la destinazione ADO.NET per connettersi al database SQL di Microsoft Azure. La connessione al database SQL tramite OLE DB non è supportata. Per altre informazioni sul database SQL, vedere Linee guida generali e limitazioni (database SQL di Azure).

Risoluzione dei problemi relativi alla destinazione ADO NET

È possibile registrare le chiamate eseguite dalla destinazione ADO NET a provider di dati esterni. Questa nuova funzionalità di registrazione può essere utilizzata per risolvere i problemi relativi al salvataggio di dati in origini di dati esterne da parte della destinazione ADO NET. Per registrare le chiamate eseguite dalla destinazione ADO NET a provider di dati esterni, abilitare la registrazione dei pacchetti e selezionare l'evento Diagnostica a livello di pacchetto. Per altre informazioni, vedere Risoluzione dei problemi relativi agli strumenti per l'esecuzione del pacchetto.

Configurazione della destinazione ADO NET

Per connettersi a un'origine dati, questa destinazione usa una gestione connessione ADO.NET che specifica il provider ADO.NET da usare. Per altre informazioni, vedere Gestione connessione ADO.NET.

Una destinazione ADO NET include i mapping tra le colonne di input e quelle nell'origine dei dati della destinazione. Non è necessario eseguire il mapping delle colonne di input su tutte le colonne di destinazione. Tuttavia, le proprietà di alcune colonne di destinazione possono richiedere il mapping delle colonne di input. In caso contrario, potrebbero verificarsi degli errori. Se ad esempio una colonna di destinazione non consente valori Null, sarà necessario eseguire il mapping di una colonna di input sulla colonna di destinazione. È inoltre necessario che i tipi di dati delle colonne di cui è stato eseguito il mapping siano compatibili. Ad esempio, non è possibile eseguire il mapping di una colonna di input con un tipo di dati stringa su una colonna di destinazione con un tipo di dati numerici se il provider ADO.NET non supporta questo mapping.

Nota

SQL Server non supporta l'inserimento di testo nelle colonne il cui tipo di dati è impostato su immagine. Per altre informazioni sui tipi di dati di SQL Server, vedere Tipi di dati (Transact-SQL).

Nota

La destinazione ADO NET non supporta l'esecuzione del mapping di una colonna di input il cui tipo è impostato su DT_DBTIME su una colonna del database il cui tipo è impostato su datetime. Per altre informazioni sui tipi di dati di Integration Services, vedere Tipi di dati di Integration Services.

La destinazione ADO NET include un input regolare e un output degli errori.

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

Nella finestra di dialogo Editor avanzato sono disponibili le proprietà che è possibile impostare a livello di codice. Per ulteriori informazioni sulle proprietà che è possibile impostare nella finestra di dialogo Editor avanzato o a livello di codice, fare clic su uno degli argomenti seguenti:

Per altre informazioni su come impostare le proprietà, vedere Impostazione delle proprietà di un componente del flusso di dati.

Editor destinazione ADO NET (pagina Gestione connessione)

Usare la pagina Gestione connessione della finestra di dialogo Editor destinazione ADO NET per selezionare la connessione ADO.NET per la destinazione. Tramite questa pagina è inoltre possibile selezionare una tabella o una vista del database.

Per aprire la pagina Gestione connessione

  1. In SQL Server Data Tools (SSDT) aprire il pacchetto di Integration Services che include la destinazione ADO.NET.

  2. Nella scheda Flusso di dati fare doppio clic sulla destinazione ADO NET.

  3. In Editor destinazione ADO NETfare clic su Gestione connessione.

Opzioni statiche

Connection manager
Selezionare una gestione connessione esistente nell'elenco o crearne una nuova facendo clic su Nuova.

New
Consente di creare una nuova gestione connessione usando la finestra di dialogo Configura gestione connessione ADO.NET .

Tabella o vista
Consente di selezionare una tabella o vista esistente nell'elenco oppure di creare una nuova tabella facendo clic su Nuova.

New
Consente di creare una nuova tabella o vista usando la finestra di dialogo Crea tabella .

Nota

Quando si fa clic su Nuova, Integration Services genera un'istruzione CREATE TABLE predefinita basata sull'origine dati connessa. Questa istruzione CREATE TABLE predefinita non includerà l'attributo FILESTREAM anche se la tabella di origine include una colonna con l'attributo FILESTREAM dichiarato. Per eseguire un componente Integration Services con l'attributo FILESTREAM, implementare innanzitutto l'archiviazione di FILESTREAM nel database di destinazione. Aggiungere quindi l'attributo FILESTREAM all'istruzione CREATE TABLE nella finestra di dialogo Crea tabella . Per altre informazioni, vedere Dati BLOB (Binary Large Object) (SQL Server).

Anteprima
Consente di visualizzare in anteprima i risultati nella finestra di dialogo Anteprima risultati query . L'anteprima supporta la visualizzazione di un massimo di 200 righe.

Utilizza inserimento bulk, se disponibile
Specificare se usare l'interfaccia SqlBulkCopy per migliorare le prestazioni delle operazioni di inserimento bulk.

Solo i provider ADO.NET che restituiscono un oggetto SqlConnection supportano l'uso dell'interfaccia SqlBulkCopy . Il provider di dati .NET per SQL Server (SqlClient) restituisce un oggetto SqlConnection e un provider personalizzato può restituire un oggetto SqlConnection .

È possibile usare il provider di dati .NET per SQL Server (SqlClient) per connettersi al database SQL di Microsoft Azure.

Se si seleziona Usa Inserimento bulk quando possibilee si imposta l'opzione Errore su Reindirizza riga, il batch di dati che la destinazione reindirizza all'output degli errori può includere righe corrette. Per altre informazioni sulla gestione degli errori nelle operazioni bulk, vedere Gestione degli errori nei dati. Per altre informazioni sull'opzione Errore, vedere Editor destinazione ADO NET (pagina Output degli errori).

Nota

Se una tabella di origine SQL Server o Sybase include una colonna Identity, è necessario usare Esegui attività di SQL per abilitare IDENTITY_INSERT prima della destinazione ADO NET e per disabilitarla di nuovo in seguito. La proprietà della colonna Identity specifica un valore incrementale per la colonna. L'istruzione SET IDENTITY_INSERT consente l'inserimento di valori espliciti della tabella di origine nella colonna Identity della tabella di destinazione.

Per eseguire correttamente le istruzioni SET IDENTITY_INSERT e il caricamento dei dati, è necessario eseguire le operazioni seguenti.
1. Usare la stessa gestione connessione ADO.NET per le attività Esegui SQL e la destinazione ADO.NET.
2. Nella gestione connessione impostare le proprietà RetainSameConnection e MultipleActiveResultSets su True.
3. Nella destinazione ADO.NET impostare la proprietà UseBulkInsertWhenPossible su False.

Per altre informazioni, vedere SET IDENTITY_INSERT (Transact-SQL) e IDENTITY (proprietà) (Transact-SQL).

Risorse esterne

Articolo tecnico relativo alla modalità rapida di caricamento di dati nel database SQL di Azure nel sito Web sqlcat.com

Editor destinazione ADO NET (pagina Mapping)

Utilizzare la pagina Mapping della finestra di dialogo Editor destinazione ADO NET per eseguire il mapping tra colonne di input e colonne di destinazione.

Per aprire la pagina Mapping

  1. In SQL Server Data Tools (SSDT) aprire il pacchetto di Integration Services che include la destinazione ADO.NET.

  2. Nella scheda Flusso di dati fare doppio clic sulla destinazione ADO NET.

  3. In Editor destinazione ADO NET, fare clic su Mapping.

Opzioni

Colonne di input disponibili
Consente di visualizzare l'elenco delle colonne di input disponibili. Eseguire un'operazione di trascinamento della selezione per impostare il mapping tra le colonne di input disponibili nella tabella e le colonne di destinazione.

Colonne di destinazione disponibili
Consente di visualizzare l'elenco delle colonne di destinazione disponibili. Eseguire un'operazione di trascinamento della selezione per impostare il mapping tra le colonne di destinazione disponibili nella tabella e le colonne di input.

Colonna di input
Consente di visualizzare le colonne di input selezionate dall'utente. È possibile rimuovere i mapping selezionando < ignora > per escludere colonne dall'output.

Colonna di destinazione
Consente di visualizzare ogni colonna di destinazione disponibile, indipendentemente dal fatto che sia mappata o meno.

Editor destinazione ADO NET (pagina Output errori)

Usare la pagina Output errori della finestra di dialogo Editor destinazione ADO NET per specificare le opzioni di gestione degli errori.

Per aprire la pagina Output errori

  1. In SQL Server Data Tools (SSDT) aprire il pacchetto di Integration Services che include la destinazione ADO.NET.

  2. Nella scheda Flusso di dati fare doppio clic sulla destinazione ADO NET.

  3. In Editor destinazione ADO NETfare clic su Output errori.

Opzioni

Input o output
Consente di visualizzare il nome dell'input.

Istogramma
Non utilizzato.

Errore
Consente di specificare l'azione da eseguire in caso di errori, ovvero ignorare l'errore, reindirizzare la riga o interrompere il componente.

Argomenti correlati:Gestione degli errori nei dati

Troncamento
Non utilizzato.

Descrizione
Consente di visualizzare la descrizione dell'operazione.

Imposta questo valore nelle celle selezionate
Consente di specificare l'azione che dovrà interessare tutte le celle selezionate in caso di errore o troncamento: ignorare l'errore, reindirizzare la riga o interrompere il componente.

Applica
Consente di applicare l'opzione di gestione degli errori alle celle selezionate.