Gestore connessioni per file piatti multipli

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

Una gestione connessione per più file flat consente a un pacchetto di accedere a dati contenuti in più file flat. Ad esempio, un'origine File flat può utilizzare una gestione connessioni per più file flat quando l'attività Flusso di dati si trova all'interno di un contenitore di ciclo, ad esempio il contenitore For Loop. In ogni ciclo del contenitore, l'origine file flat carica dati dal nome file successivo fornito dalla gestione connessione per più file.

Quando si aggiunge una gestione connessione per più file flat a un pacchetto, SQL Server Integration Services crea una gestione connessione che in fase di esecuzione verrà risolta in una connessione per più file flat, imposta le proprietà della gestione connessione per più file flat e quindi la aggiunge alla raccolta Connections del pacchetto.

La proprietà ConnectionManagerType della gestione connessione viene impostata su MULTIFLATFILE.

Per configurare la gestione connessione per più file flat, procedere nel modo seguente:

  • Specificare i file, le impostazioni locali e la tabella codici da utilizzare. Le impostazioni locali vengono utilizzate per interpretare i dati con formato dipendente dalla lingua, come le date, mentre la tabella codici viene utilizzata per convertire i dati stringa in formato Unicode.

  • Specificare il formato dei file. È possibile utilizzare un formato delimitato, a larghezza fissa o a bandiera a destra.

  • Specificare i delimitatori della riga di intestazione, delle righe di dati e delle colonne. I delimitatori delle colonne possono essere impostati a livello di file e sovrascritti a livello di colonna.

  • Indicare se la prima riga dei file contiene i nomi delle colonne.

  • Specificare un carattere qualificatore del testo. Ogni colonna può essere configurata in modo da riconoscere un qualificatore di testo.

  • Impostare proprietà quali il nome, il tipo di dati e la larghezza massima delle singole colonne.

Quando il gestore connessioni Multiple Flat Files fa riferimento a più file, i percorsi dei file sono separati dal carattere barra verticale (|). La proprietà ConnectionString della gestione connessione ha il formato seguente:

< sentiero>|<sentiero>

È inoltre possibile specificare più file utilizzando caratteri jolly. Per fare riferimento, ad esempio, a tutti i file di testo sull'unità C è possibile impostare il valore della proprietà ConnectionString su C:\*.txt.

Se un gestore connessioni Multiple Flat Files fa riferimento a più file, tutti i file devono avere lo stesso formato.

Per impostazione predefinita la gestione connessione per più file flat imposta la lunghezza delle colonne di tipo stringa su 50 caratteri. Nella finestra di dialogo Editor gestione connessione per più file flat è possibile valutare dati di esempio e modificare automaticamente la lunghezza di tali colonne, in modo da evitare il troncamento dei dati o il superamento della larghezza massima delle colonne. La lunghezza della colonna rimane invariata per tutto il flusso di dati, a meno che non venga modificata in un'origine file flat o in una trasformazione. Se su tali colonne viene eseguito il mapping a colonne di destinazione di larghezza inferiore, verrà visualizzato un avviso nell'interfaccia utente e in fase di esecuzione potrebbero verificarsi errori dovuti al troncamento dei dati. È possibile ridimensionare le colonne in modo che siano compatibili con le colonne di destinazione nella gestione connessione file flat, nell'origine file flat o in una trasformazione. Per modificare la lunghezza di una colonna di output, è necessario impostare la proprietà Length della colonna di output nella scheda Proprietà input e output della finestra di dialogo Editor avanzato .

Se, dopo avere aggiunto e configurato l'origine file flat che utilizza la gestione connessione, si modifica la lunghezza delle colonne nella gestione connessione per più file flat, non sarà necessario ridimensionare manualmente le colonne di output nell'origine file flat. Quando si apre la finestra di dialogo Origine file flat, l'origine file flat offre un'opzione per sincronizzare i metadati delle colonne.

Configurazione della gestione connessione per più file flat

È possibile impostare le proprietà tramite Progettazione SSIS o a livello di codice.

Per informazioni sulla configurazione di una gestione connessioni a livello di codice, vedere ConnectionManager e Aggiunta di connessioni a livello di codice.

Editor di gestione connessioni per file flat multipli (pagina Generale)

Utilizzare la pagina Generale della finestra di dialogo Editor gestione connessione per più file flat per selezionare un gruppo di file con lo stesso formato di dati e per specificare il loro formato dei dati. Una connessione per più file flat consente la connessione di un pacchetto a un gruppo di file di testo aventi lo stesso formato.

Per ulteriori informazioni sul gestore connessioni Multiple Flat Files, vedere Multiple Flat Files Gestione connessioni.

Opzioni

Nome del gestore connessioni
Specificare un nome univoco per la connessione a più file flat nel flusso di lavoro. Il nome fornito verrà visualizzato in SSIS Designer.

Descrizione
Descrivi la connessione. È consigliabile includere nella descrizione informazioni sugli scopi della connessione, in modo da ottenere pacchetti autodocumentati e semplificarne quindi la gestione.

Nomi dei file
Digitare il percorso e i nomi dei file da usare nella connessione Multiple Flat Files. È possibile specificare più file usando caratteri jolly, ad esempio "C:\*.txt", oppure il carattere barra verticale (|) per separare più nomi di file. Tutti i file devono avere lo stesso formato data.

Sfoglia
Consente di cercare i nomi dei file da utilizzare nella connessione per più file flat. È possibile selezionare più file. Tutti i file devono avere lo stesso formato data.

impostazioni locali
Specificare la posizione per fornire informazioni sui criteri di ordinamento e sulla conversione di data e ora.

Unicode
Indica se utilizzare il formato Unicode. L'utilizzo di Unicode impedisce di specificare una tabella codici.

Tabella codici
Specificare la pagina codici per il testo non Unicode.

Formato
Consente di indicare se utilizzare la formattazione non allineata a destra, a larghezza fissa o delimitata. Tutti i file devono avere lo stesso formato data.

Valore Descrizione
Delimitato Le colonne sono separate dai delimitatori specificati nella pagina Colonne .
Larghezza fissa Le colonne hanno una larghezza fissa, specificata trascinando le linee dei marcatori nella pagina Colonne .
Allineato a sinistra I file con allineamento irregolare a destra sono file in cui ogni colonna ha una larghezza fissa, ad eccezione dell'ultima colonna, che è delimitata dal delimitatore di riga specificato nella pagina Colonne.

Qualificatore di testo
Consente di specificare il qualificatore di testo da utilizzare. È possibile, ad esempio, racchiudere il testo tra virgolette.

Delimitatore della riga di intestazione
Selezionare dall'elenco dei delimitatori per le righe di intestazione oppure immettere il testo del delimitatore.

Valore Descrizione
{CR}{LF} La riga di intestazione è delimitata dalla combinazione di ritorno carrello e avanzamento riga.
{CR} La riga di intestazione è delimitata da un ritorno carrello.
{LF} La riga di intestazione è delimitata da un carattere di nuova riga.
Punto e virgola {;} La riga di intestazione è separata da un punto e virgola.
Due punti {:} La riga di intestazione è delimitata da due punti.
Virgola {,} La riga di intestazione è delimitata da una virgola.
Tab {t} La riga di intestazione è delimitata da una tabulazione.
Barra verticale {|} La riga di intestazione è delimitata da una barra verticale.

Righe di intestazione da ignorare
Specificare il numero di righe di intestazione da ignorare, se presenti.

Nomi di colonna nella prima riga di dati
Consente di indicare se prevedere o fornire nomi di colonne nella prima riga di dati.

Editor di gestione connessioni per più file flat (pagina Colonne)

Utilizzare il nodo Colonne della finestra di dialogo Editor di gestione connessioni a più file flat per specificare le informazioni su righe e colonne e visualizzare l'anteprima del primo file selezionato.

Per ulteriori informazioni sul gestore connessioni Multiple Flat Files, vedere Multiple Flat Files Gestione connessioni.

Opzioni statiche

Nome del gestore connessioni
Specificare un nome univoco per la connessione a più file flat nel flusso di lavoro. Il nome fornito verrà visualizzato in SSIS Designer.

Descrizione
Descrivi la connessione. È consigliabile includere nella descrizione informazioni sugli scopi della connessione, in modo da ottenere pacchetti autodocumentati e semplificarne quindi la gestione.

Opzioni dinamiche relative al formato file flat

Formato = Delimitato

Delimitatore di riga
Consente di selezionare il delimitatore di riga desiderato nell'elenco dei delimitatori disponibili oppure di immettere il testo per il delimitatore.

Valore Descrizione
{CR}{LF} Le righe sono delimitate dalla combinazione di caratteri ritorno a capo/avanzamento riga.
{CR} Le righe sono delimitate da un ritorno carrello.
{LF} Le righe sono delimitate da un avanzamento riga.
Punto e virgola {;} Le righe sono delimitate da un punto e virgola.
Due punti {:} Le righe sono delimitate dal carattere due punti.
Virgola {,} Le righe sono delimitate da una virgola.
Tab {t} Le righe sono delimitate da un tab.
Barra verticale {|} Le righe sono delimitate da una barra verticale.

Delimitatore di colonna
Consente di selezionare il delimitatore di colonna desiderato nell'elenco dei delimitatori disponibili oppure di immettere il testo per il delimitatore.

Valore Descrizione
{CR}{LF} Le colonne sono delimitate dalla combinazione di ritorno a capo e avanzamento riga.
{CR} Le colonne sono delimitate da un ritorno carrello.
{LF} Le colonne sono delimitate da un avanzamento riga.
Punto e virgola {;} Le colonne sono delimitate da un punto e virgola.
Due punti {:} Le colonne sono delimitate da due punti.
Virgola {,} Le colonne sono delimitate da una virgola.
Tab {t} Le colonne sono delimitate da una tabulazione.
Barra verticale {|} Le colonne sono delimitate da una barra verticale.

Reimposta colonne
Il pulsante Reimposta colonneconsente di rimuovere tutte le colonne tranne quelle originali.

Formato = A larghezza fissa

Font
Consente di selezionare il tipo di carattere per la visualizzazione in anteprima dei dati.

Colonne dati di origine
Per modificare la larghezza della riga, trascinare l'indicatore di riga verticale, mentre per modificare la larghezza delle colonne, fare clic sul righello nella parte superiore della finestra di anteprima.

Larghezza della riga
Consente di specificare la larghezza della riga prima dell'aggiunta dei delimitatori per le singole colonne. In alternativa, trascinare la linea verticale nella finestra di anteprima per contrassegnare la fine della riga. Il valore relativo alla larghezza della riga viene aggiornato automaticamente.

Reimposta colonne
Il pulsante Reimposta colonneconsente di rimuovere tutte le colonne tranne quelle originali.

Formato = Non allineato a destra

Nota

Nei file con formato non allineato a destra, ogni colonna ha una larghezza fissa, ad eccezione dell'ultima colonna. È delimitato dal delimitatore di riga.

Font
Consente di selezionare il tipo di carattere per la visualizzazione in anteprima dei dati.

Colonne dati di origine
Per modificare la larghezza della riga, trascinare l'indicatore di riga verticale, mentre per modificare la larghezza delle colonne, fare clic sul righello nella parte superiore della finestra di anteprima.

Delimitatore di riga
Consente di selezionare il delimitatore di riga desiderato nell'elenco dei delimitatori disponibili oppure di immettere il testo per il delimitatore.

Valore Descrizione
{CR}{LF} Le righe sono delimitate dalla combinazione di caratteri ritorno a capo/avanzamento riga.
{CR} Le righe sono delimitate da un ritorno carrello.
{LF} Le righe sono delimitate da un avanzamento riga.
Punto e virgola {;} Le righe sono delimitate da un punto e virgola.
Due punti {:} Le righe sono delimitate dal carattere due punti.
Virgola {,} Le righe sono delimitate da una virgola.
Tab {t} Le righe sono delimitate da un tab.
Barra verticale {|} Le righe sono delimitate da una barra verticale.

Reimposta colonne
Il pulsante Reimposta colonneconsente di rimuovere tutte le colonne tranne quelle originali.

Editor di gestione connessioni per file flat multipli (pagina Avanzate)

Usare la pagina Avanzate della finestra di dialogo Editor gestione connessione per più file flat per impostare proprietà come il tipo di dati e i delimitatori di ogni colonna nei file di testo a cui si connette la gestione connessione per i file flat.

Per impostazione predefinita, la lunghezza delle colonne di stringhe è di 50 caratteri. È possibile valutare i dati di esempio e ridimensionare automaticamente la lunghezza di queste colonne per evitare che i dati siano troncati o che la colonna sia eccessivamente larga. È possibile aggiornare anche altri metadati per attivare la compatibilità con le colonne di destinazione. È possibile ad esempio modificare il tipo di dati di una colonna che contiene solo dati integer impostando un tipo di dati numeric, come DT_I2.

Per ulteriori informazioni sul gestore connessioni Multiple Flat Files, vedere Multiple Flat Files Gestione connessioni.

Opzioni

Nome del gestore connessioni
Consente di specificare un nome univoco per la gestione connessione per più file flat nel flusso di lavoro. Il nome specificato verrà visualizzato nell'area Gestioni connessioni in Progettazione SSIS.

Descrizione
Descrivere il gestore connessioni. È consigliabile includere nella descrizione informazioni sugli scopi della gestione connessione, in modo da ottenere pacchetti autodocumentati e semplificarne quindi la gestione.

Configurare le proprietà delle singole colonne
È possibile selezionare una colonna nel riquadro sinistro per visualizzarne le proprietà in quello destro. Nella tabella seguente è disponibile una descrizione delle proprietà dei tipi di dati. Alcune delle proprietà incluse nell'elenco possono essere configurate solo per alcuni formati di file flat.

Proprietà Descrizione
ColumnType Indica se una colonna è delimitata, a larghezza fissa o irregolare a destra. Questa proprietà è di sola lettura. I file non allineati a destra sono file in cui ogni colonna ha una larghezza fissa ad eccezione dell'ultima, per la quale viene utilizzato il delimitatore di riga.
OutputColumnWidth Consente di specificare il valore da archiviare come conteggio di byte. Nel caso dei file Unicode tale valore verrà visualizzato come conteggio di caratteri. Nell'attività Flusso di dati questo valore viene utilizzato per impostare la larghezza della colonna di output per l'origine file flat.

Nota: nel modello a oggetti il nome di questa proprietà è MaximumWidth.
Tipo di Dato Consente di selezionare i tipi di dati disponibili nell'apposito elenco. Per altre informazioni, vedere Tipi di dati di Integration Services.
TextQualified Consente di specificare se i dati di testo sono qualificati usando un carattere qualificatore di testo:

True: i dati di tipo testo nel file flat sono qualificati.

False: i dati di tipo testo nel file flat non sono qualificati.
Nome Specificare un nome di colonna. Per impostazione predefinita, si tratta di un elenco numerato di colonne. È comunque possibile scegliere qualsiasi nome descrittivo univoco.
DataScale Consente di specificare la scala dei dati numerici. Per scala si intende il numero di posizioni decimali. Per altre informazioni, vedere Tipi di dati di Integration Services.
ColumnDelimiter Consente di selezionare i delimitatori di colonna disponibili nell'apposito elenco. Scegliere come delimitatori caratteri che non siano già presenti nel testo. Questo valore viene ignorato per le colonne a larghezza fissa.

{CR}{LF} - le colonne sono delimitate dalla combinazione di caratteri ritorno carrello e avanzamento riga

{CR} - le colonne sono delimitate da un ritorno carrello

{LF}: le colonne sono delimitate da un avanzamento riga

Punto e virgola {;}: le colonne sono delimitate da un punto e virgola

Due punti {:}: le colonne sono delimitate da due punti

Virgola {,}{,}: le colonne sono delimitate da una virgola

Tabulazione {t}: le colonne sono delimitate da una tabulazione

Barra verticale {|}: le colonne sono delimitate da una barra verticale
DataPrecision Consente di specificare la precisione dei dati numerici. Per precisione si intende il numero di cifre. Per altre informazioni, vedere Tipi di dati di Integration Services.
InputColumnWidth Consente di specificare il valore da archiviare come conteggio di byte. Nel caso dei file Unicode tale valore verrà visualizzato come conteggio di caratteri. Questo valore viene ignorato nelle colonne delimitate.

Nota : nel modello a oggetti il nome di questa proprietà è ColumnWidth.

Nuovo
Aggiungi una nuova colonna facendo clic su New. Per impostazione predefinita, il pulsante Nuova aggiunge una colonna alla fine dell'elenco. Il pulsante offre inoltre le opzioni seguenti che è possibile selezionare dall'elenco a discesa.

Valore Descrizione
Aggiungi colonna Consente di aggiungere una nuova colonna alla fine dell'elenco.
Inserisci prima Consente di inserire una nuova colonna prima di quella selezionata.
Inserisci dopo Consente di inserire una nuova colonna dopo quella selezionata.

Elimina
Seleziona una colonna, quindi rimuovila facendo clic su Elimina.

Suggerisci tipi
Usare la finestra di dialogo Suggerisci tipi di colonne per restituire dati di esempio nel primo file selezionato e ottenere suggerimenti relativi al tipo di dati e alla lunghezza di ogni colonna. Per altre informazioni, vedere Riferimento all'interfaccia utente della finestra di dialogo Suggerisci tipi di colonne.

Editor di gestione connessioni per più file flat (pagina di anteprima)

Usare la pagina Anteprima della finestra di dialogo Editor gestione connessione per più file flat per visualizzare il contenuto del primo file di origine selezionato suddiviso in colonne in base alle impostazioni definite in precedenza.

Per ulteriori informazioni sul gestore connessioni Multiple Flat Files, vedere Multiple Flat Files Gestione connessioni.

Opzioni

Nome del gestore connessioni
Specificare un nome univoco per la connessione a più file flat nel flusso di lavoro. Il nome specificato verrà visualizzato nell'area Gestioni connessioni in Progettazione SSIS.

Descrizione
Descrivi la connessione. È consigliabile includere nella descrizione informazioni sugli scopi della connessione, in modo da ottenere pacchetti autodocumentati e semplificarne quindi la gestione.

Righe di dati da ignorare
Consente di specificare il numero di righe che devono essere ignorate all'inizio del file flat.

Anteprima delle righe
Consente di visualizzare dati di esempio del primo flat file selezionato, suddivisi in righe e colonne in base alle opzioni selezionate.