Origine ExcelExcel Source

L'origine Excel consente di estrarre dati da fogli di lavoro o intervalli di una cartella di lavoro di MicrosoftMicrosoft Excel.The Excel source extracts data from worksheets or ranges in MicrosoftMicrosoft Excel workbooks.

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).For detailed info about connecting to Excel files, and about limitations and known issues for loading data from or to Excel files, see Load data from or to Excel with SQL Server Integration Services (SSIS).

Modalità di accessoAccess Modes

Sono disponibili quattro diverse modalità di accesso ai dati per l'estrazione dei dati:The Excel source provides four different data access modes for extracting data:

  • Vista o tabella.A table or view.

  • Vista o tabella specificata in una variabile.A table or view specified in a variable.

  • Risultato di un'istruzione SQL.The results of an SQL statement. La query può essere con parametri.The query can be a parameterized query.

  • Risultato di un'istruzione SQL archiviata in una variabile.The results of an SQL statement stored in a variable.

    Per connettersi a un'origine dei dati l'origine Excel utilizza una gestione connessione Excel che specifica il file di cartella di lavoro da utilizzare.The Excel source uses an Excel connection manager to connect to a data source, and the connection manager specifies the workbook file to use. Per altre informazioni, vedere Excel Connection Manager.For more information, see Excel Connection Manager.

    L'origine Excel include un output regolare e un output degli errori.The Excel source has one regular output and one error output.

Configurazione dell'origine ExcelExcel Source Configuration

È possibile impostare le proprietà tramite Progettazione SSISSSIS o a livello di codice.You can set properties through SSISSSIS Designer or programmatically.

Nella finestra di dialogo Editor avanzato sono disponibili le proprietà che è possibile impostare a livello di codice.The Advanced Editor dialog box reflects all the properties that can be set programmatically. 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:For more information about the properties that you can set in the Advanced Editor dialog box or programmatically, click one of the following topics:

Editor origine Excel (pagina Gestione connessione)Excel Source Editor (Connection Manager Page)

Usare il nodo Gestione connessione della finestra di dialogo Editor origine Excel per selezionare la cartella di lavoro di Microsoft ExcelMicrosoft Excel da usare come origine.Use the Connection Manager node of the Excel Source Editor dialog box to select the Microsoft ExcelMicrosoft Excel workbook for the source to use. L'origine Excel legge i dati da un foglio di lavoro o da un intervallo denominato in una cartella di lavoro esistente.The Excel source reads data from a worksheet or named range in an existing workbook.

Nota

La proprietà CommandTimeout dell'origine Excel non è disponibile nell' Editor origine Excel, tuttavia può essere impostata usando l' Editor avanzato.The CommandTimeout property of the Excel source is not available in the Excel Source Editor, but can be set by using the Advanced Editor. Per altre informazioni su questa proprietà, vedere la sezione relativa all'origine Excel in Proprietà personalizzate di Excel.For more information on this property, see the Excel Source section of Excel Custom Properties.

Opzioni staticheStatic Options

Gestione connessione OLE DBOLE DB connection manager
Consente di selezionare una gestione connessione Excel esistente dall'elenco o di creare una nuova connessione facendo clic su Nuova.Select an existing Excel connection manager from the list, or create a new connection by clicking New.

NuovaNew
Consente di creare una nuova gestione connessione nella finestra di dialogo Gestione connessione Excel .Create a new connection manager by using the Excel Connection Manager dialog box.

Modalità di accesso ai datiData access mode
Consente di specificare il metodo per la selezione dei dati dall'origine.Specify the method for selecting data from the source.

valoreValue DescrizioneDescription
Tabella o vistaTable or view Consente di recuperare dati da un foglio di lavoro o da un intervallo denominato nel file di Excel.Retrieve data from a worksheet or named range in the Excel file.
Variabile nome vista o nome tabellaTable name or view name variable Consente di specificare il foglio di lavoro o il nome dell'intervallo in una variabile.Specify the worksheet or range name in a variable.

Informazioni correlate: Utilizzo di variabili nei pacchettiRelated information: Use Variables in Packages
Comando SQLSQL command Consente di recuperare dati dal file di Excel utilizzando una query SQL.Retrieve data from the Excel file by using a SQL query.
Comando SQL da variabileSQL command from variable Consente di specificare il testo della query SQL in una variabile.Specify the SQL query text in a variable.

AnteprimaPreview
Consente di visualizzare in anteprima i risultati nella finestra di dialogo Vista dati .Preview results by using the Data View dialog box. L'anteprima supporta la visualizzazione di un massimo di 200 righe.Preview can display up to 200 rows.

Opzioni dinamiche relative alla modalità di accesso ai datiData Access Mode Dynamic Options

Modalità di accesso ai dati = Tabella o vistaData access mode = Table or view

Nome del foglio di ExcelName of the Excel sheet
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.Select the name of the worksheet or named range from a list of those available in the Excel workbook.

Modalità di accesso ai dati = Variabile nome vista o nome tabellaData access mode = Table name or view name variable

Nome variabileVariable name
Consente di selezionare la variabile contenente il nome del foglio di lavoro o dell'intervallo denominato.Select the variable that contains the name of the worksheet or named range.

Modalità di accesso ai dati = Comando SQLData access mode = SQL command

Testo comando SQLSQL command text
È 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.Enter the text of a SQL query, build the query by clicking Build Query, or browse to the file that contains the query text by clicking Browse.

ParametriParameters
Se è stata immessa una query con parametri utilizzando ?If you have entered a parameterized query by using ? 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.as a parameter placeholder in the query text, use the Set Query Parameters dialog box to map query input parameters to package variables.

Build queryBuild query
Usare la finestra di dialogo Generatore query per creare la query SQL con strumenti grafici.Use the Query Builder dialog box to construct the SQL query visually.

SfogliaBrowse
Usare la finestra di dialogo Apri per individuare il file contenente il testo della query SQL.Use the Open dialog box to locate the file that contains the text of the SQL query.

Analizza queryParse query
Consente di verificare la sintassi del testo della query.Verify the syntax of the query text.

Modalità di accesso ai dati = Comando SQL da variabileData access mode = SQL command from variable

Nome variabileVariable name
Consente di selezionare la variabile contenente il testo della query SQL.Select the variable that contains the text of the SQL query.

Editor origine Excel (pagina Colonne)Excel Source Editor (Columns Page)

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.Use the Columns page of the Excel Source Editor dialog box to map an output column to each external (source) column.

OpzioniOptions

Colonne esterne disponibiliAvailable External Columns
Consente di visualizzare l'elenco delle colonne esterne disponibili nell'origine dei dati.View the list of available external columns in the data source. Non è possibile utilizzare questa tabella per l'aggiunta o l'eliminazione di colonne.You cannot use this table to add or delete columns.

Colonna esternaExternal Column
Consente di visualizzare le colonne esterne (origine) nell'ordine in cui verranno lette dall'attività.View external (source) columns in the order in which the task will read them. È 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.You can change this order by first clearing the selected columns in the table discussed above, and then selecting external columns from the list in a different order.

Colonna di outputOutput Column
Consente di specificare un nome univoco per ogni colonna di output.Provide a unique name for each output column. Per impostazione predefinita viene suggerito il nome della colonna esterna (di origine) selezionata. È comunque possibile scegliere qualsiasi nome descrittivo univoco.The default is the name of the selected external (source) column; however, you can choose any unique, descriptive name. Il nome specificato verrà visualizzato in Progettazione SSISSSIS .The name provided will be displayed within SSISSSIS Designer.

Editor origine Excel (pagina Output degli errori)Excel Source Editor (Error Output Page)

Usare la pagina Output degli errori della finestra di dialogo Editor origine Excel per selezionare le opzioni di gestione degli errori e impostare le proprietà delle colonne di output degli errori.Use the Error Output page of the Excel Source Editor dialog box to select error handling options and to set properties on error output columns.

OpzioniOptions

Input o outputInput or Output
Consente di visualizzare il nome dell'origine dei dati.View the name of the data source.

ColonnaColumn
Consente di visualizzare le colonne esterne (di origine) selezionate nella pagina Gestione connessione della finestra di dialogo Editor origine Excel.View the external (source) columns that you selected on the Connection Manager page of the Excel Source Editordialog box.

ErroreError
Consente di specificare l'azione da eseguire in caso di errori, ovvero ignorare l'errore, reindirizzare la riga o interrompere il componente.Specify what should happen when an error occurs: ignore the failure, redirect the row, or fail the component.

Argomenti correlati: Gestione degli errori nei datiRelated Topics: Error Handling in Data

TroncamentoTruncation
Consente di specificare l'azione da eseguire in caso di troncamenti, ovvero ignorare l'errore, reindirizzare la riga o interrompere il componente.Specify what should happen when a truncation occurs: ignore the failure, redirect the row, or fail the component.

DescrizioneDescription
Consente di visualizzare la descrizione dell'errore.View the description of the error.

Imposta questo valore nelle celle selezionateSet this value to selected cells
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.Specify what should happen to all the selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

ApplicaApply
Consente di applicare l'opzione di gestione degli errori alle celle selezionate.Apply the error handling option to the selected cells.

Caricare i dati da o in Excel con SQL Server Integration Services (SSIS)Load data from or to Excel with SQL Server Integration Services (SSIS)
Destinazione ExcelExcel Destination
Gestione connessione ExcelExcel Connection Manager