Trasformazione Esporta colonnaExport Column Transformation

La trasformazione Esporta colonna legge dati in un flusso di dati e li inserisce in un file.The Export Column transformation reads data in a data flow and inserts the data into a file. Se ad esempio il flusso di dati contiene informazioni sui prodotti, ad esempio l'immagine di ogni prodotto, è possibile utilizzare la trasformazione Esporta colonna per salvare tali immagini in uno o più file.For example, if the data flow contains product information, such as a picture of each product, you could use the Export Column transformation to save the images to files.

Opzioni Accoda e troncaAppend and Truncate Options

Nella tabella seguente vengono descritti gli effetti delle impostazioni delle opzioni relative all'accodamento e al troncamento sui risultati.The following table describes how the settings for the append and truncate options affect results.

AccodaAppend TroncamentoTruncate File esistenteFile exists RisultatiResults
FalseFalse FalseFalse NoNo La trasformazione crea un nuovo file e vi scrive i dati.The transformation creates a new file and writes the data to the file.
TrueTrue FalseFalse NoNo La trasformazione crea un nuovo file e vi scrive i dati.The transformation creates a new file and writes the data to the file.
FalseFalse TrueTrue NoNo La trasformazione crea un nuovo file e vi scrive i dati.The transformation creates a new file and writes the data to the file.
TrueTrue TrueTrue NoNo La trasformazione non supera la convalida in fase di progettazione.The transformation fails design time validation. Non è consentito impostare su trueentrambe le proprietà.It is not valid to set both properties to true.
FalseFalse FalseFalse Yes Viene generato un errore di run-time.A run-time error occurs. Il file esiste ma la trasformazione non è in grado di scrivervi.The file exists, but the transformation cannot write to it.
FalseFalse TrueTrue Yes La trasformazione elimina e ricrea il file e vi scrive i dati.The transformation deletes and re-creates the file and writes the data to the file.
TrueTrue FalseFalse Yes La trasformazione apre il file e scrive i dati alla fine.The transformation opens the file and writes the data at the end of the file.
TrueTrue TrueTrue Yes La trasformazione non supera la convalida in fase di progettazione.The transformation fails design time validation. Non è consentito impostare su trueentrambe le proprietà.It is not valid to set both properties to true.

Configurazione della trasformazione Esporta colonnaConfiguration of the Export Column Transformation

Per configurare la trasformazione Esporta colonna, procedere nel modo seguente:You can configure the Export Column transformation in the following ways:

  • Specificare le colonne di dati e le colonne contenenti i percorsi dei file in cui scrivere i dati.Specify the data columns and the columns that contain the path of files to which to write the data.

  • Specificare se durante l'operazione di inserimento dei dati in file esistenti i dati vengono troncati o accodati.Specify whether the data-insertion operation appends or truncates existing files.

  • Specificare se scrivere un indicatore dell'ordine dei byte nel file.Specify whether a byte-order mark (BOM) is written to the file.

    Nota

    L'indicatore dell'ordine dei byte viene scritto solo se i dati non vengono accodati a un file esistente e hanno tipo di dati DT_NTEXT.A BOM is written only when the data is not appended to an existing file and the data has the DT_NTEXT data type.

    La trasformazione utilizza coppie di colonne di input: una contenente un nome di file e una contenente i dati.The transformation uses pairs of input columns: One column contains a file name, and the other column contains data. Ogni riga nel set di dati può specificare un file diverso.Each row in the data set can specify a different file. A mano a mano che la trasformazione elabora una riga, i dati vengono inseriti nel file specificato.As the transformation processes a row, the data is inserted into the specified file. In fase di esecuzione la trasformazione crea i file, se non esistono ancora, e quindi vi scrive i dati.At run time, the transformation creates the files, if they do not already exist, and then the transformation writes the data to the files. I dati da scrivere devono avere tipo di dati DT_TEXT, DT_NTEXT o DT_IMAGE.The data to be written must have a DT_TEXT, DT_NTEXT, or DT_IMAGE data type. Per altre informazioni, vedere Tipi di dati di Integration Services.For more information, see Integration Services Data Types.

    Questa trasformazione include un input, un output e un output degli errori.This transformation has one input, one output, 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.

    Nella finestra di dialogo Editor avanzato sono disponibili le proprietà che è possibile impostare a livello di codice.The Advanced Editor dialog box reflects 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:

  • Proprietà comuniCommon Properties

  • Proprietà personalizzate delle trasformazioniTransformation Custom Properties

    Per altre informazioni su come impostare le proprietà, vedere Impostazione delle proprietà di un componente del flusso di dati.For more information about how to set properties, see Set the Properties of a Data Flow Component.

Editor trasformazione Esportazione colonna (pagina Colonne)Export Column Transformation Editor (Columns Page)

Utilizzare la pagina Colonne della finestra di dialogo Editor trasformazione Esportazione colonna per specificare le colonne nel flusso di dati da estrarre in file.Use the Columns page of the Export Column Transformation Editor dialog box to specify columns in the data flow to extract to files. È possibile indicare se la trasformazione Esporta colonna deve accodare i dati a un file oppure sovrascrivere un file esistente.You can specify whether the Export Column transformation appends data to a file or overwrites an existing file.

OpzioniOptions

Colonna estrazioneExtract Column
Consente di eseguire una selezione dall'elenco di colonne di input contenenti dati di tipo text o image.Select from the list of input columns that contain text or image data. In tutte le righe devono essere presenti definizioni per Colonna estrazione e Colonna percorso file.All rows should have definitions for Extract Column and File Path Column.

Colonna percorso fileFile Path Column
Consente di eseguire una selezione dall'elenco di colonne di input contenenti nomi e percorsi di file.Select from the list of input columns that contain file paths and file names. In tutte le righe devono essere presenti definizioni per Colonna estrazione e Colonna percorso file.All rows should have definitions for Extract Column and File Path Column.

Consenti accodamentoAllow Append
Consente di indicare se la trasformazione accoderà i dati ai file esistenti.Specify whether the transformation appends data to existing files. Il valore predefinito è false.The default is false.

Forza troncamentoForce Truncate
Consente di indicare se la trasformazione eliminerà il contenuto di file esistenti prima di scrivere i dati.Specify whether the transformation deletes the contents of existing files before writing data. Il valore predefinito è false.The default is false.

Scrivi indicatore ordine byteWrite BOM
Consente di specificare se scrivere un indicatore ordine byte (BOM) nel file.Specify whether to write a byte-order mark (BOM) to the file. L'indicatore dell'ordine dei byte viene scritto solo se i dati hanno il tipo di dati DT_NTEXT o DT_WSTR e non sono accodati a un file di dati esistente.A BOM is only written if the data has the DT_NTEXT or DT_WSTR data type and is not appended to an existing data file.

Editor trasformazione Esportazione colonna (pagina Output degli errori)Export Column Transformation Editor (Error Output Page)

Utilizzare la pagina Output degli errori della finestra di dialogo Editor trasformazione Esportazione colonna per specificare le opzioni di gestione degli errori.Use the Error Output page of the Export Column Transformation Editor dialog box to specify how to handle errors.

OpzioniOptions

Input/OutputInput/Output
Consente di visualizzare il nome dell'output.View the name of the output. Fare clic sul nome per espandere la visualizzazione e includere le colonne.Click the name to expand the view to include columns.

ColonnaColumn
Consente di visualizzare le colonne di output selezionate nella pagina Colonne della finestra di dialogo Editor trasformazione Esportazione colonna .View the output columns that you selected on the Columns page of the Export Column Transformation Editor dialog box.

ErroreError
Consente di specificare l'azione che deve essere eseguita in caso di errori, ovvero ignorare l'errore, reindirizzare la riga o interrompere l'esecuzione del componente.Specify what you want to happen if an error occurs: ignore the failure, redirect the row, or fail the component.

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

DescriptionDescription
Consente di visualizzare la descrizione dell'operazione.View the description of the operation.

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.