Destinazione del file non elaborato

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

La destinazione File raw scrive dati grezzi in un file. Poiché il formato dei dati è nativo della destinazione, non è necessaria alcuna conversione e quasi nessuna analisi dei dati. Questo significa che la destinazione file raw è in grado di scrivere i dati più rapidamente rispetto ad altre destinazioni, come le destinazioni File Flat e OLE DB.

Oltre alla scrittura di dati non elaborati in un file, la destinazione file non elaborato può essere utilizzata anche per generare un file non elaborato vuoto contenente solo le colonne (file di soli metadati), senza dover eseguire il pacchetto. Si utilizza l'origine file non elaborato per recuperare dati non elaborati scritti in precedenza dalla destinazione. È anche possibile indirizzare l'origine del file non elaborato al file contenente solo metadati.

Nel formato di file non elaborato sono contenute informazioni di ordinamento. La Destinazione file non elaborati salva tutte le informazioni di ordinamento, incluse le opzioni di confronto per le colonne di tipo stringa. Con l'origine file non elaborato è possibile leggere e riconoscere le informazioni di ordinamento. È possibile configurare l'Origine file raw in modo che ignori i flag di ordinamento presenti nel file tramite l'Editor avanzato. Per ulteriori informazioni sui flag di confronto, vedere Confronto tra dati di tipo stringa.

È possibile configurare la destinazione del file non elaborato nei modi seguenti:

  • Specificare una modalità di accesso, ossia il nome del file o una variabile che contiene il nome del file nel quale scrive la destinazione file raw.

  • Indicare se la destinazione del file non elaborato deve accodare i dati a un file esistente che ha lo stesso nome o creare un nuovo file.

La destinazione file raw viene spesso utilizzata per scrivere risultati intermedi di dati parzialmente elaborati tra un'esecuzione del pacchetto e l'altra. Se si archiviano i dati non elaborati, sarà possibile rileggerli rapidamente tramite un'origine file non elaborato e quindi trasformarli ulteriormente prima di caricarli nella destinazione finale. Ad esempio, un pacchetto potrebbe essere eseguito più volte e, ogni volta, scrivere dati non elaborati in file. Successivamente, un pacchetto diverso può usare l'origine Raw File per leggere i dati da ciascun file, usare una trasformazione Union All per unire i dati in un unico set di dati e quindi applicare ulteriori trasformazioni che riassumono i dati prima di caricarli nella destinazione finale, ad esempio una tabella di SQL Server.

Nota

La destinazione file raw supporta i dati null, ma non i dati BLOB.

Nota

La destinazione File non elaborati non utilizza un gestore connessioni.

Questa origine dati ha un solo input normale. Non supporta un output degli errori.

Opzioni di aggiunta e nuovo file

La proprietà WriteOption include opzioni per accodare dati a un file esistente o crearne uno nuovo.

La tabella seguente descrive le opzioni disponibili per la proprietà WriteOption.

Opzione Descrizione
Aggiungi Accoda i dati a un file esistente. I metadati dei dati accodati devono corrispondere al formato del file.
Crea sempre Crea sempre un nuovo file.
Crea una sola volta Crea un nuovo file. Se il file esiste, il componente fallisce.
Tronca e aggiungi Tronca un file esistente e quindi scrive i dati nel file. I metadati dei dati accodati devono corrispondere al formato del file.

Di seguito sono riportati elementi importanti relativi all'accodamento dei dati:

  • L'accodamento dei dati in un file non elaborato esistente non comporta il riordinamento dei dati.

    È necessario assicurarsi che le chiavi ordinate rimangano nell'ordine corretto.

  • L'aggiunta di dati a un file raw esistente non modifica i metadati del file (informazioni di ordinamento).

Ad esempio, in un pacchetto vengono letti i dati ordinati sul ProductKey (PK). Con il flusso di dati del pacchetto, i dati vengono accodati in un file non elaborato esistente. Alla prima esecuzione del pacchetto, vengono ricevute tre righe (PK 1000, 1100, 1200). Nel file non elaborato sono ora contenuti i dati riportati di seguito.

  • 1000, prodottoA

  • 1100, prodottoB

  • 1200, prodottoC

Alla seconda esecuzione del pacchetto, vengono ricevute due nuove righe (PK 1001, 1300). Nel file non elaborato sono ora contenuti i dati riportati di seguito.

  • 1000, prodottoA

  • 1100, prodottoB

  • 1200, prodottoC

  • 1001, prodottoD

  • 1300, prodottoE

I nuovi dati vengono accodati alla fine del file grezzo e le chiavi ordinate (PK) risultano fuori ordine. Inoltre, l'operazione di accodamento non ha modificato i metadati del file (informazioni di ordinamento). Se il file viene letto utilizzando l'origine Raw File, il componente indica che il file è ancora ordinato in base a PK anche se i dati nel file non sono più nell'ordine corretto.

Per mantenere le chiavi ordinate nell'ordine corretto mentre si accodano i dati, è possibile progettare il flusso di dati del pacchetto nel modo seguente:

  1. Recupera le nuove righe usando l'origine A.

  2. Recuperare le righe esistenti da RawFile1 utilizzando l'origine B.

  3. Combinare gli input di Origine A e Origine B utilizzando la trasformazione Union All.

  4. Ordina per PK.

  5. Scrivere in RawFile2 utilizzando la destinazione File non elaborato.

    RawFile1 viene bloccato perché ne viene eseguita la lettura nel flusso di dati.

  6. Sostituire RawFile1 con RawFile2.

Utilizzo della destinazione file non elaborato in un ciclo

Se il flusso di dati che utilizza la destinazione file non elaborato si trova in un ciclo, può rivelarsi utile creare il file una sola volta e quindi accodare i dati al file quando il ciclo viene ripetuto. Per accodare i dati al file, è necessario che i dati accodati corrispondano al formato del file esistente.

Per creare il file nella prima iterazione del ciclo e quindi accodare righe nelle iterazioni successive, è necessario eseguire le operazioni seguenti in fase di progettazione:

  1. Impostare la proprietà WriteOption su CreateOnce o CreateAlways ed eseguire un'iterazione del ciclo. Il file viene creato e viene garantita così la corrispondenza tra i metadati dei dati accodati e il file.

  2. Reimpostare la proprietà WriteOption su Append e impostare la proprietà ValidateExternalMetadata su False.

Se si usa l'opzione TruncateAppend invece di Append , le righe aggiunte in qualsiasi iterazione precedente verranno troncate e quindi verranno accodate nuove righe. Per usare l'opzione TruncateAppend , è anche necessario che i dati corrispondano al formato del file.

Configurazione della destinazione del file non elaborato

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

Editor di destinazione file non elaborato (pagina di Gestione connessioni)

Utilizzare l'Editor destinazione file non elaborato per configurare la destinazione file non elaborato in modo da scrivere dati non elaborati in un file.

Che cosa vuoi fare?

Aprire l'Editor destinazione file non elaborato

  1. Aggiungere la destinazione file non elaborato a un pacchetto di Integration Services in SQL Server Data Tools (SSDT).

  2. Fare clic con il pulsante destro del mouse sul componente e quindi scegliere Modifica.

Impostare le opzioni nella scheda Gestione connessione

Modalità di accesso
Selezionare come il nome file viene specificato. Selezionare Nome file per immettere direttamente il nome file e il percorso o Nome file da variabile per specificare una variabile che contiene il nome file.

Nome file o Nome variabile
Immettere il nome e il percorso del file non elaborato o selezionare la variabile contenente il nome file.

Opzione scrittura
Selezionare il metodo utilizzato per creare e scrivere nel file.

Genera file grezzo iniziale
Fare clic sul pulsante per generare un file non elaborato vuoto contenente solo le colonne (file di soli metadati) senza dover eseguire il pacchetto. Il file contiene le colonne selezionate nella pagina Colonne di Editor della destinazione del file non elaborato. È possibile indirizzare l'origine del file raw a questo file contenente solo metadati.

Quando si fa clic su Genera file non elaborato iniziale, viene visualizzata una finestra di messaggio. Fare clic su OK per procedere con la creazione del file. Fare clic su Annulla per selezionare un elenco diverso di colonne nella pagina Colonne .

Impostare le opzioni nella scheda Colonne

Colonne di input disponibili
Selezionare una o più colonne di input da scrivere nel file raw.

Colonna di input
Una colonna di input viene aggiunta automaticamente a questa tabella quando la si seleziona in Colonne di input disponibilio è possibile selezionare direttamente la colonna di input in questa tabella.

Alias di output
Specificare un nome alternativo da utilizzare per la colonna di output.

Editor destinazione del file grezzo (pagina delle colonne)

Utilizzare l'Editor destinazione file non elaborato per configurare la destinazione file non elaborato in modo da scrivere dati non elaborati in un file.

Che cosa vuoi fare?

Aprire l'Editor destinazione file non elaborato

  1. Aggiungere la destinazione file non elaborato a un pacchetto di Integration Services in SQL Server Data Tools (SSDT).

  2. Fare clic con il pulsante destro del mouse sul componente e quindi scegliere Modifica.

Impostare le opzioni nella scheda Gestione connessione

Modalità di accesso
Selezionare come il nome file viene specificato. Selezionare Nome file per immettere direttamente il nome file e il percorso o Nome file da variabile per specificare una variabile che contiene il nome file.

Nome file o Nome variabile
Immettere il nome e il percorso del file non elaborato o selezionare la variabile contenente il nome file.

Opzione scrittura
Selezionare il metodo utilizzato per creare e scrivere nel file.

Genera file grezzo iniziale
Fare clic sul pulsante per generare un file non elaborato vuoto contenente solo le colonne (file di soli metadati) senza dover eseguire il pacchetto. È possibile indirizzare l'origine del file non elaborato al file contenente solo metadati.

Quando si fa clic sul pulsante, viene visualizzato un elenco delle colonne. È possibile fare clic su Annulla e modificare le colonne o fare clic su OK per procedere con la creazione del file.

Impostare le opzioni nella scheda Colonne

Colonne di input disponibili
Selezionare una o più colonne di input da scrivere nel file raw.

Colonna di input
Una colonna di input viene aggiunta automaticamente a questa tabella quando la si seleziona in Colonne di input disponibilio è possibile selezionare direttamente la colonna di input in questa tabella.

Alias di output
Specificare un nome alternativo da utilizzare per la colonna di output.