Formato binario per Data Factory in Microsoft Fabric

Questo articolo illustra come configurare il formato binario in Data Factory.

Funzionalità supportate

Il formato binario è supportato per le attività e i connettori seguenti come origine e destinazione.

Category Connessione or/attività
Connettore supportato Amazon S3
Archiviazione BLOB di Azure
Azure Data Lake Storage Gen1
Azure Data Lake Storage Gen2
Google Cloud Storage
HTTP
Attività supportata attività Copy
Attività GetMetadata
Attività Delete

Formato binario nell'attività di copia

Per configurare il formato binario, scegliere la connessione nell'origine o nella destinazione dell'attività di copia della pipeline di dati e quindi selezionare Binario nell'elenco a discesa Formato file. Selezionare Impostazioni per ulteriori configurazioni di questo formato.

Screenshot showing file settings button.

Nota

Quando si usa il formato binario in un'attività di copia, l'origine e la destinazione devono usare entrambi il formato binario.

Binario come origine

Dopo aver selezionato Impostazioni nella sezione Formato file nella scheda Origine, nella finestra di dialogo Impostazioni formato file popup vengono visualizzate le proprietà seguenti.

Screenshot showing file format settings.

  • Tipo di compressione: codec di compressione usato per leggere i file binari. È possibile scegliere tra il tipo None, bzip2, gzip, deflate, ZipDeflate, TarGzip o tar nell'elenco a discesa.

    Se si seleziona ZipDeflate come tipo di compressione, mantenere il nome del file ZIP come cartella viene visualizzato nelle impostazioni avanzate nella scheda Origine .

    • Mantieni il nome del file ZIP come cartella: indica se mantenere il nome del file ZIP di origine come struttura di cartelle durante la copia.
      • Se questa casella è selezionata (impostazione predefinita), il servizio scrive i file decompressi in <specified file path>/<folder named as source zip file>/.
      • Se questa casella è deselezionata, il servizio scrive i file decompressi direttamente in <specified file path>. Assicurarsi di non avere nomi di file duplicati in file ZIP di origine diversi per evitare corse o comportamenti imprevisti.

    Se si seleziona TarGzip/tar come tipo di compressione, mantenere il nome del file di compressione come cartella viene visualizzato nelle impostazioni avanzate nella scheda Origine .

    • Mantieni il nome del file di compressione come cartella: indica se mantenere il nome del file compresso di origine come struttura di cartelle durante la copia.
      • Se questa casella è selezionata (impostazione predefinita), il servizio scrive i file decompressi in <specified file path>/<folder named as source compressed file>/.
      • Se questa casella è deselezionata, il servizio scrive i file decompressi direttamente in <specified file path>. Assicurarsi di non avere nomi di file duplicati in file ZIP di origine diversi per evitare corse o comportamenti imprevisti.
  • Livello di compressione: rapporto di compressione. È possibile scegliere tra Ottimale o Più veloce.

    • Più veloce: l'operazione di compressione deve essere completata il più rapidamente possibile, anche se il file risultante non è compresso in modo ottimale.
    • Optimal: l'operazione di compressione deve comprimere il file in modo ottimale, anche se il completamento richiede più tempo. Per altre informazioni, vedere l'articoloLivello di compressione.

In Impostazioni avanzate nella scheda Origine vengono visualizzate altre proprietà correlate al formato binario.

  • Elimina file dopo il completamento: indica se i file binari vengono eliminati dall'archivio di origine dopo il corretto spostamento nell'archivio di destinazione. L'eliminazione del file è per ogni file. Pertanto, quando un'attività di copia ha esito negativo, alcuni file sono già stati copiati nella destinazione ed eliminati dall'origine, mentre altri rimangono ancora nell'archivio di origine.

Binaria come destinazione

Dopo aver selezionato Impostazioni nella sezione Formato file nella scheda Destinazione, nella finestra di dialogo Impostazioni formato file popup vengono visualizzate le proprietà seguenti.

Screenshot showing selecting file format.

  • Tipo di compressione: codec di compressione usato per scrivere file binari. È possibile scegliere tra il tipo None, bzip2, gzip, deflate, ZipDeflate, TarGzip o tar nell'elenco a discesa.

  • Livello di compressione: rapporto di compressione. È possibile scegliere tra Ottimale o Più veloce.

    • Più veloce: l'operazione di compressione deve essere completata il più rapidamente possibile, anche se il file risultante non è compresso in modo ottimale.
    • Optimal: l'operazione di compressione deve comprimere il file in modo ottimale, anche se il completamento richiede più tempo. Per altre informazioni, vedere l'articolo Livello di compressione.

Riepilogo tabella

Binario come origine

Le proprietà seguenti sono supportate nella sezione Origine dell'attività di copia quando si usa il formato binario.

Nome Descrizione Valore Richiesto Proprietà script JSON
Formato file Formato di file che si desidera utilizzare. Binario type (in datasetSettings):
Binario
Tipo di compressione Codec di compressione usato per leggere i file binari. Scegliere tra:
Nessuno
bzip2
Gzip
Sgonfiare
ZipDeflate
TarGzip
Tar
No type (in compression):

bzip2
gzip
Sgonfiare
ZipDeflate
TarGzip
Tar
Livello di compressione Rapporto di compressione. I valori consentiti sono Optimal o Fastest. Ottimale o più veloce No livello (in compression):
Il più rapido
Ottimale
Mantenere il nome del file ZIP come cartella Indica se mantenere il nome del file ZIP di origine come struttura di cartelle durante la copia. Selezionato o deselezionato No preserveZipFileNameAsFolder
(under compressionProperties->type as ZipDeflateReadSettings)
Mantenere il nome del file di compressione come cartella Indica se mantenere il nome del file compresso di origine come struttura di cartelle durante la copia. Selezionato o deselezionato No preserveCompressionFileNameAsFolder
(in compressionProperties->type come TarGZipReadSettings o TarReadSettings)
Eliminare i file dopo il completamento Indica se i file binari vengono eliminati dall'archivio di origine dopo il corretto spostamento nell'archivio di destinazione. Selezionato o deselezionato No deleteFilesAfterCompletion:
true o false

Binaria come destinazione

Nella sezione Destinazione dell'attività di copia sono supportate le proprietà seguenti quando si usa il formato binario.

Nome Descrizione Valore Richiesto Proprietà script JSON
Formato file Formato di file che si desidera utilizzare. Binario type (in datasetSettings):
Binario
Tipo di compressione Codec di compressione utilizzato per scrivere file binari. Scegliere tra:
Nessuno
bzip2
Gzip
Sgonfiare
ZipDeflate
TarGzip
Tar
No type (in compression):

bzip2
gzip
Sgonfiare
ZipDeflate
TarGzip
Tar
Livello di compressione Rapporto di compressione. I valori consentiti sono Optimal o Fastest. Ottimale o più veloce No livello (in compression):
Il più rapido
Ottimale