Origine file flat

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

L'origine Flat File legge i dati da un file di testo. Tale file può essere in formato delimitato, a larghezza fissa o misto.

  • Nel formato delimitato per definire le righe e le colonne vengono utilizzati delimitatori di riga e colonna.

  • Nel formato a larghezza fissa per definire le righe e le colonne viene utilizzata la larghezza. In questo formato è inoltre previsto un carattere di riempimento da utilizzare per portare i campi alla lunghezza massima.

  • Nel formato non allineato a destra tutte le colonne sono definite in base alla larghezza, ad eccezione dell'ultima che è delimitata dal delimitatore di riga.

È possibile configurare l'origine Flat File nei modi seguenti:

  • Aggiungere all'output della trasformazione una colonna contenente il nome del file di testo da cui l'origine file flat estrae i dati.

  • Specificare se l'origine file flat interpreta le stringhe di lunghezza zero nelle colonne come valori null.

    Nota

    Il gestore connessioni File Flat usato dall'origine File Flat deve essere configurato per usare un formato delimitato, in modo da interpretare come valori null le stringhe di lunghezza zero. Se la gestione connessione utilizza un formato a larghezza fissa o non allineato a destra, i dati costituiti da spazi non potranno essere interpretati come valori Null.

Le colonne di output nell'output dell'origine file flat includono la proprietà FastParse. FastParse indica se la colonna usa le routine di analisi più veloci ma indipendenti dalle impostazioni locali disponibili in Integration Services oppure le routine di analisi standard dipendenti dalle impostazioni locali. Per altre informazioni, vedere Analisi veloce e Analisi standard.

Le colonne di output includono anche la proprietà UseBinaryFormat, Si utilizza questa proprietà per implementare il supporto dei dati binari, ad esempio dei dati nel formato packed decimal, nei file. Per impostazione predefinita, la proprietà UseBinaryFormat è impostata su false. Se si preferisce usare un formato binario, impostare UseBinaryFormat su true e il tipo di dati nella colonna di output su DT_BYTES. In questo modo, nell'origine file flat viene saltata la conversione dei dati e i dati vengono passati alla colonna di output così come sono. È quindi possibile usare una trasformazione, ad esempio Colonna derivata o Conversione dati, per eseguire il cast dei dati DT_BYTES in un diverso tipo di dati oppure scrivere uno script personalizzato in una trasformazione Script per interpretare i dati. Per l'interpretazione dei dati è inoltre possibile scrivere un componente del flusso di dati personalizzato. Per altre informazioni sui tipi di dati in cui può essere eseguito il cast di DT_BYTES, vedere Cast (espressione SSIS).

Questa origine utilizza un gestore di connessione file flat per accedere al file di testo. Impostando le proprietà di tale gestione connessione è possibile fornire informazioni sul file e le singole colonne contenute, nonché specificare la modalità con cui l'origine file flat deve gestire i dati del file di testo. È ad esempio possibile specificare i caratteri che delimitano le righe e le colonne del file, oltre al tipo di dati e alla lunghezza di ogni colonna. Per ulteriori informazioni, vedere Flat File Gestione connessioni.

Questa sorgente ha un output e un output di errore.

Configurazione dell'origine del file flat

È 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 su come impostare le proprietà di un componente del flusso di dati, vedere Impostazione delle proprietà di un componente del flusso di dati.

Editor origine file flat (pagina Gestione connessioni)

Utilizzare la pagina Gestione connessioni della finestra di dialogo Editor dell'origine file flat per selezionare la gestione connessioni che l'origine file flat utilizzerà. L'origine file flat legge i dati da un file di testo. I dati possono essere in formato delimitato, a larghezza fissa o misto.

Un'origine file flat può utilizzare uno dei tipi seguenti di gestione connessione:

  • Un gestore connessioni file flat se l'origine dati è un singolo file flat. Per ulteriori informazioni, vedere Flat File Gestione connessioni.

  • Un gestore connessioni per file flat multipli se l'origine è costituita da più file flat e l'attività Flusso di dati si trova all'interno di un contenitore di ciclo, ad esempio il contenitore Ciclo For. In ogni ciclo del contenitore, l'origine file flat carica dati dal nome file successivo fornito dalla gestione connessione per più file. Per ulteriori informazioni, vedere Multiple Flat Files Gestione connessioni.

Opzioni

Gestore connessione file piatto
Consente di selezionare una gestione connessione esistente nell'elenco o di creare una nuova gestione connessione facendo clic su Nuova.

Nuovo
Creare un nuovo gestore connessioni utilizzando la finestra di dialogo Editor Gestore connessioni file flat.

Mantieni i valori Null dell'origine come valori Null nel flusso di dati
Consente di specificare se mantenere i valori Null durante l'estrazione dei dati. Il valore predefinito della proprietà è false. Quando questo valore è false, l'origine file flat sostituisce i valori Null dai dati di origine con valori predefiniti appropriati per ogni colonna, ad esempio stringhe vuote per le colonne stringa e zero per le colonne numeriche.

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.

Editor dell'origine file flat (pagina Colonne)

Usare il nodo Colonne della finestra di dialogo Editor origine file flat per eseguire il mapping tra una colonna di output e ogni colonna esterna (di origine).

Nota

La proprietà FileNameColumnName dell'origine file flat e la proprietà FastParse delle relative colonne di output non sono disponibili nell' Editor origine file flat, tuttavia possono essere impostate utilizzando l' Editor avanzato. Per ulteriori informazioni su queste proprietà, vedere la sezione Origine file flat di Flat File Custom Properties.

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 della tabella selezionate e quindi selezionando dall'elenco le colonne esterne in 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 della sorgente file flat (pagina di output degli errori)

Utilizzare la pagina Output degli errori della finestra di dialogo Editor dell'origine file flat per selezionare le opzioni di gestione degli errori e impostare le proprietà delle colonne di output degli errori.\

Opzioni

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

Colonna
Consente di visualizzare le colonne esterne (di origine) selezionate nella pagina Gestione connessione della finestra di dialogo Editor origine file flat .

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.