Origine Excel

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

L'origine dati di Excel estrae dati da fogli di lavoro o da intervalli nelle cartelle di lavoro di Microsoft Excel.

Importante

Per informazioni dettagliate sulla connessione ai file di Excel e sulle limitazioni e i problemi noti per il caricamento di dati da o a file di Excel, vedere Caricare i dati da o in Excel con SQL Server Integration Services (SSIS).

Modalità di accesso

L'origine dati Excel offre quattro diverse modalità di accesso ai dati per estrarre i dati:

  • Una tabella o vista.

  • Una tabella o una vista specificata in una variabile.

  • I risultati di un'istruzione SQL. La query può essere una query parametrizzata.

  • Risultati di un'istruzione SQL archiviata in una variabile.

L'origine Excel utilizza una gestione connessioni di Excel per connettersi a un'origine dati e tale gestione connessioni specifica il file della cartella di lavoro da utilizzare. Per altre informazioni, vedere Excel Gestione connessioni.

L'origine dati di Excel ha un output normale e un output di errore.

Configurazione dell'origine Excel

È 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 informazioni sull'esecuzione di un ciclo attraverso un gruppo di file Excel, vedere Eseguire un ciclo su file e tabelle di Excel utilizzando un contenitore Foreach Loop.

Editor dell'origine Excel (pagina Gestione connessioni)

Usare il nodo Gestione connessione della finestra di dialogo Editor origine Excel per selezionare la cartella di lavoro di Microsoft Excel da usare come origine. L’origine dati di Excel legge i dati da un foglio di lavoro o da un intervallo con nome in una cartella di lavoro esistente.

Nota

La proprietà CommandTimeout dell'origine Excel non è disponibile nell' Editor origine Excel, tuttavia può essere impostata usando l' Editor avanzato. Per altre informazioni su questa proprietà, vedere la sezione relativa all'origine Excel in Proprietà personalizzate di Excel.

Opzioni statiche

Gestione connessione OLE DB
Consente di selezionare una gestione connessione Excel esistente dall'elenco o di creare una nuova connessione facendo clic su Nuova.

Nuovo
Creare un nuovo gestore connessioni utilizzando la finestra di dialogo Gestore connessioni Excel.

Modalità di accesso ai dati
Consente di specificare il metodo per la selezione dei dati dall'origine.

Valore Descrizione
Tabella o vista Consente di recuperare dati da un foglio di lavoro o da un intervallo denominato nel file di Excel.
Variabile del nome della tabella o della vista Consente di specificare il foglio di lavoro o il nome dell'intervallo in una variabile.

Informazioni correlate: Utilizzo di variabili nei pacchetti
Comando SQL Consente di recuperare dati dal file di Excel utilizzando una query SQL.
Comando SQL da variabile Consente di specificare il testo della query SQL in una variabile.

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

Opzioni dinamiche relative alla modalità di accesso ai dati

Modalità di accesso ai dati = Tabella o vista

Nome del foglio di Excel
Consente di selezionare il nome del foglio di lavoro o dell'intervallo denominato in un elenco di fogli di lavoro o intervalli disponibili nella cartella di lavoro di Excel.

Modalità di accesso ai dati = Variabile del nome della tabella o della vista

Nome variabile
Consente di selezionare la variabile contenente il nome del foglio di lavoro o dell'intervallo denominato.

Modalità di accesso ai dati = Comando SQL

Testo comando SQL
È possibile digitare il testo di una query SQL, compilare la query facendo clic su Compila queryo cercare il file contenente il testo della query facendo clic su Sfoglia.

Parametri
Se è stata immessa una query con parametri utilizzando ? come segnaposto per il parametro nel testo della query, usare la finestra di dialogo Imposta parametri query per eseguire il mapping tra i parametri di input della query e le variabili del pacchetto.

Compila query
Usare la finestra di dialogo Generatore query per creare la query SQL con strumenti grafici visuali.

Sfoglia
Usare la finestra di dialogo Apri per individuare il file contenente il testo della query SQL.

Analizza la query
Consente di verificare la sintassi del testo della query.

Modalità di accesso ai dati = Comando SQL da variabile

Nome variabile
Consente di selezionare la variabile contenente il testo della query SQL.

Editor origine Excel (pagina Colonne)

Usare la pagina Colonne della finestra di dialogo Editor origine Excel per eseguire il mapping tra una colonna di output e ogni colonna (di origine) esterna.

Opzioni

Colonne esterne disponibili
Consente di visualizzare l'elenco delle colonne esterne disponibili nell'origine dei dati. Non è possibile utilizzare questa tabella per l'aggiunta o l'eliminazione di colonne.

Colonna esterna
Consente di visualizzare le colonne esterne (origine) nell'ordine in cui verranno lette dall'attività. È possibile modificare l'ordine deselezionando innanzitutto le colonne selezionate nella tabella sopra descritta e quindi selezionando le colonne esterne nell'elenco secondo un ordine diverso.

Colonna di output
Consente di specificare un nome univoco per ogni colonna di output. Per impostazione predefinita viene suggerito il nome della colonna esterna (di origine) selezionata. È comunque possibile scegliere qualsiasi nome descrittivo univoco. Il nome fornito verrà visualizzato in SSIS Designer.

Editor origine Excel (pagina di output degli errori)

Usare la pagina Output degli errori della finestra di dialogo Editor di origine Excel per selezionare le opzioni di gestione degli errori e impostare le proprietà delle colonne di output degli errori.

Opzioni

Input o output
Consente di visualizzare il nome dell'origine dei dati.

Colonna
Visualizza le colonne esterne (di origine) che hai selezionato nella pagina Gestione connessione della finestra di dialogo Editor origine Excel.

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
Consente di specificare l'azione da eseguire in caso di troncamenti, ovvero ignorare l'errore, reindirizzare la riga o interrompere il componente.

Descrizione
Consente di visualizzare la descrizione dell'errore.

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.