Destinazione ExcelExcel Destination

La destinazione Excel consente di caricare dati in fogli di lavoro o intervalli di una cartella di lavoro di MicrosoftMicrosoft Excel.The Excel destination loads data into worksheets or ranges in MicrosoftMicrosoft Excel workbooks.

Modalità di accessoAccess Modes

Sono disponibili tre diverse modalità di accesso ai dati per il caricamento dei dati:The Excel destination provides three different data access modes for loading 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.

Importante

In Excel un intervallo o un foglio di lavoro equivale a una vista o tabella.In Excel, a worksheet or range is the equivalent of a table or view. Nell'elenco delle tabelle disponibili degli editor dell'origine e della destinazione Excel vengono visualizzati solo i fogli di lavoro (riconoscibili dalla presenza del simbolo $ in fondo al nome del foglio di lavoro, ad esempio Sheet1$) e gli intervalli denominati (riconoscibili dall'assenza del simbolo $, ad esempio MyRange) esistenti.The lists of available tables in the Excel Source and Destination editors display only existing worksheets (identified by the $ sign appended to the worksheet name, such as Sheet1$) and named ranges (identified by the absence of the $ sign, such as MyRange).

Considerazioni sull'utilizzoUsage Considerations

La gestione connessione Excel usa il provider OLE DB MicrosoftMicrosoft per Jet 4.0 e il relativo driver ISAM (Indexed Sequential Access Method, metodo di accesso sequenziale indicizzato) di Excel di supporto per stabilire la connessione con le origini dati Excel, quindi leggere e scrivere informazioni.The Excel Connection Manager uses the MicrosoftMicrosoft OLE DB Provider for Jet 4.0 and its supporting Excel ISAM (Indexed Sequential Access Method) driver to connect and read and write data to Excel data sources.

Il comportamento di questo provider e del relativo driver è documentato in molti articoli della MicrosoftMicrosoft Knowledge Base e, sebbene tali articoli non siano specifici di Integration ServicesIntegration Services o del suo predecessore, Data Transformation Services, consentono di ottenere informazioni circa i comportamenti che possono produrre risultati imprevisti.Many existing MicrosoftMicrosoft Knowledge Base articles document the behavior of this provider and driver, and although these articles are not specific to Integration ServicesIntegration Services or its predecessor Data Transformation Services, you may want to know about certain behaviors that can lead to unexpected results. Per informazioni generali sull'utilizzo e sul comportamento del driver per Excel, vedere HOWTO: Utilizzare ADO con dati di Excel da Visual Basic o VBA.For general information on the use and behavior of the Excel driver, see HOWTO: Use ADO with Excel Data from Visual Basic or VBA.

I seguenti comportamenti del provider Jet incluso nel driver per Excel possono produrre risultati imprevisti durante il salvataggio di dati in una destinazione Excel.The following behaviors of the Jet provider that is included with the Excel driver can lead to unexpected results when saving data to an Excel destination.

  • Salvataggio di dati di testo.Saving text data. Quando salva dati di testo in una destinazione Excel, il driver per Excel antepone una virgoletta singola (') al testo in ogni cella, per garantire che i valori salvati verranno interpretati come testo.When the Excel driver saves text data values to an Excel destination, the driver precedes the text in each cell with the single quote character (') to ensure that the saved values will be interpreted as text values. Se si usano o si sviluppano altre applicazioni che leggono o elaborano i dati salvati, può essere necessario includere istruzioni specifiche per la gestione della virgoletta singola (') che precede ogni valore di testo.If you have or develop other applications that read or process the saved data, you may need to include special handling for the single quote character that precedes each text value.

    Per informazioni su come evitare di includere la virgoletta singola, vedere il post di blog seguente relativo all' aggiunta della virgoletta singola a tutte le stringhe quando i dati sono trasformati in Excel tramite il componente per flusso di dati di destinazione di Excel in un pacchetto SSIS, su msdn.com.For information on how to avoid including the single quote, see this blog post, Single quote is appended to all strings when data is transformed to excel when using Excel destination data flow component in SSIS package, on msdn.com.

  • Salvataggio di dati memo (ntext).Saving memo (ntext) data. Per poter salvare correttamente stringhe di oltre 255 caratteri in una colonna Excel, il driver deve riconoscere il tipo di dati della colonna di destinazione come memo invece di string.Before you can successfully save strings longer than 255 characters to an Excel column, the driver must recognize the data type of the destination column as memo and not string. Se la tabella di destinazione contiene già righe di dati, le prime righe campionate dal driver devono contenere almeno un'istanza di un valore composto da più di 255 caratteri nella colonna con tipo di dati memo.If the destination table already contains rows of data, then the first few rows that are sampled by the driver must contain at least one instance of a value longer than 255 characters in the memo column. Se la tabella di destinazione viene creata durante la progettazione del pacchetto o in fase di esecuzione, l'istruzione CREATE TABLE deve usare LONGTEXT (o uno dei sinonimi) come tipo di dati della colonna con tipo di dati memo.If the destination table is created during package design or at run time, then the CREATE TABLE statement must use LONGTEXT (or one of its synonyms) as the data type of the the memo column.

  • Tipi di dati.Data types. Il driver per Excel riconosce solo un set limitato di tipi di dati.The Excel driver recognizes only a limited set of data types. Tutte le colonne numeriche vengono interpretate come valori double (DT_R8) e tutte le colonne di tipo stringa (con tipo di dati diverso da memo) vengono interpretate come stringhe Unicode di 255 caratteri (DT_WSTR).For example, all numeric columns are interpreted as doubles (DT_R8), and all string columns (other than memo columns) are interpreted as 255-character Unicode strings (DT_WSTR). Integration ServicesIntegration Services esegue il mapping dei tipi di dati di Excel nel modo seguente: maps the Excel data types as follows:

    • Numero Numero a virgola mobile e precisione doppia (DT_R8)Numeric double-precision float (DT_R8)

    • Valuta Valuta (DT_CY)Currency currency (DT_CY)

    • Valore booleano Valore booleano (DT_BOOL)Boolean Boolean (DT_BOOL)

    • Data/ora Data/ora (DT_DATE)Date/time datetime (DT_DATE)

    • Stringa Stringa Unicode di 255 caratteri (DT_WSTR)String Unicode string, length 255 (DT_WSTR)

    • Memo Flusso di testo Unicode (DT_NTEXT)Memo Unicode text stream (DT_NTEXT)

  • Conversione di tipi di dati e lunghezze.Data type and length conversions. Integration ServicesIntegration Services non viene eseguita la conversione implicita dei tipi di dati. does not implicitly convert data types. Può essere pertanto necessario usare le trasformazioni Colonna derivata o Conversione dati per convertire i dati di Excel in modo esplicito prima di caricarli in una destinazione diversa da Excel oppure per convertire dati non di Excel prima di caricarli in una destinazione Excel.As a result, you may need to use the Derived Column or Data Conversion transformations to convert Excel data explicitly before loading it into a non-Excel destination, or to convert non-Excel data before loading it into an Excel destination. In questo caso può essere conveniente creare il pacchetto iniziale usando Importazione/Esportazione guidata SQL Server, che configura automaticamente le conversioni necessarie.In this case, it may be useful to create the initial package by using the Import and Export Wizard, which configures the necessary conversions for you. Di seguito sono riportati alcuni esempi di tali conversioni:Some examples of the conversions that may be required include the following:

    • Conversione tra colonne di Excel di tipo stringa Unicode e colonne di tipo stringa non Unicode con tabelle codici specificheConversion between Unicode Excel string columns and non-Unicode string columns with specific codepages.

    • Conversione tra colonne di Excel di tipo stringa di 255 caratteri e colonne di tipo stringa di lunghezze diverseConversion between 255-character Excel string columns and string columns of different lengths.

    • Conversione tra colonne di Excel di tipo numerico a precisione doppia e colonne numeriche di altro tipoConversion between double-precision Excel numeric columns and numeric columns of other types.

Configurazione della destinazione ExcelConfiguration of the Excel Destination

Per connettersi a un'origine dei dati, la destinazione Excel usa una gestione connessione Excel che specifica il file di cartella di lavoro da usare.The Excel destination 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.

La destinazione Excel include un input regolare e un output degli errori.The Excel destination has one regular input and one error output.

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

Per altre informazioni sulle proprietà che è possibile impostare nella finestra di dialogo Editor destinazione Excel , fare clic su uno degli argomenti seguenti:For more information about the properties that you can set in the Excel Destination Editor dialog box, click one of the following topics:

Vedere ancheSee Also

Origine Excel Excel Source
Integration Services ( SSIS ) Variabili Integration Services (SSIS) Variables
Flusso di dati Data Flow
Utilizzo dei file di Excel con l'attività ScriptWorking with Excel Files with the Script Task