Formato binario in Azure Data FactoryBinary format in Azure Data Factory

Il formato binario è supportato per i connettori seguenti: Amazon S3, BLOB di Azure, Azure Data Lake storage Gen1, Azure Data Lake storage Gen2, archiviazione file di Azure, file System, FTP, Google Archiviazione cloud, HDFS, httpe SFTP.Binary format is supported for the following connectors: Amazon S3, Azure Blob, Azure Data Lake Storage Gen1, Azure Data Lake Storage Gen2, Azure File Storage, File System, FTP, Google Cloud Storage, HDFS, HTTP, and SFTP.

È possibile usare il set di dati binario nell'attività di copia, l' attività GetMetadatao l' attività Delete.You can use Binary dataset in Copy activity, GetMetadata activity, or Delete activity. Quando si usa un set di dati binario, ADF non analizza il contenuto del file ma lo considera così com'è.When using Binary dataset, ADF does not parse file content but treat it as-is.

Nota

Quando si usa un set di dati binario nell'attività di copia, è possibile copiare solo dal set di dati binario al set di dati binario.When using Binary dataset in copy activity, you can only copy from Binary dataset to Binary dataset.

Proprietà del set di datiDataset properties

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione dei set di dati, vedere l'articolo Set di dati.For a full list of sections and properties available for defining datasets, see the Datasets article. Questa sezione presenta un elenco delle proprietà supportate dal set di dati binario.This section provides a list of properties supported by the Binary dataset.

ProprietàProperty DescrizioneDescription ObbligatorioRequired
typetype La proprietà Type del set di dati deve essere impostata su Binary.The type property of the dataset must be set to Binary. Yes
locationlocation Impostazioni del percorso dei file.Location settings of the file(s). Ogni connettore basato su file ha un tipo di percorso e proprietà supportate in location.Each file-based connector has its own location type and supported properties under location. Per informazioni dettagliate, vedere l'articolo connettore-> sezione Proprietà set di dati.See details in connector article -> Dataset properties section. Yes
compressionecompression Gruppo di proprietà per configurare la compressione dei file.Group of properties to configure file compression. Configurare questa sezione quando si desidera eseguire la compressione/decompressione durante l'esecuzione dell'attività.Configure this section when you want to do compression/decompression during activity execution. NoNo
typetype Codec di compressione utilizzato per leggere/scrivere file binari.The compression codec used to read/write binary files.
I valori consentiti sono bzip2, gzip, deflate, ZipDeflate.Allowed values are bzip2, gzip, deflate, ZipDeflate. da usare quando si salva il file.to use when saving the file.
NoNo
levellevel Rapporto di compressione.The compression ratio. Applicare quando il set di dati viene usato nel sink dell'attività di copia.Apply when dataset is used in Copy activity sink.
I valori consentiti sono ottimali o più veloci.Allowed values are Optimal or Fastest.
- più veloce: l'operazione di compressione deve essere completata il più rapidamente possibile, anche se il file risultante non è compresso in modo ottimale.- Fastest: The compression operation should complete as quickly as possible, even if the resulting file is not optimally compressed.
- ottimale: l'operazione di compressione deve essere compressa in modo ottimale, anche se il completamento dell'operazione richiede più tempo.- Optimal: The compression operation should be optimally compressed, even if the operation takes a longer time to complete. Per maggiori informazioni, vedere l'argomento relativo al livello di compressione .For more information, see Compression Level topic.
NoNo

Di seguito è riportato un esempio di set di dati binario nell'archivio BLOB di Azure:Below is an example of Binary dataset on Azure Blob Storage:

{
    "name": "BinaryDataset",
    "properties": {
        "type": "Binary",
        "linkedServiceName": {
            "referenceName": "<Azure Blob Storage linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties": {
            "location": {
                "type": "AzureBlobStorageLocation",
                "container": "containername",
                "folderPath": "folder/subfolder",
            },
            "compression": {
                "type": "ZipDeflate"
            }
        }
    }
}

Proprietà dell'attività di copiaCopy activity properties

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere l'articolo sulle pipeline.For a full list of sections and properties available for defining activities, see the Pipelines article. Questa sezione presenta un elenco delle proprietà supportate dall'origine e dal sink binario.This section provides a list of properties supported by the Binary source and sink.

Nota

Quando si usa un set di dati binario nell'attività di copia, è possibile copiare solo dal set di dati binario al set di dati binario.When using Binary dataset in copy activity, you can only copy from Binary dataset to Binary dataset.

Binario come origineBinary as source

Le proprietà seguenti sono supportate nella sezione *origine* dell'attività di copia.The following properties are supported in the copy activity *source* section.

ProprietàProperty DescrizioneDescription ObbligatorioRequired
typetype La proprietà Type dell'origine dell'attività di copia deve essere impostata su BinarySource.The type property of the copy activity source must be set to BinarySource. Yes
storeSettingsstoreSettings Un gruppo di proprietà su come leggere i dati da un archivio dati.A group of properties on how to read data from a data store. Ogni connettore basato su file ha le proprie impostazioni di lettura supportate in storeSettings.Each file-based connector has its own supported read settings under storeSettings. Per informazioni dettagliate, vedere l'articolo connettore > sezione proprietà dell'attività di copia.See details in connector article -> Copy activity properties section. NoNo

Binario come sinkBinary as sink

Le proprietà seguenti sono supportate nella sezione *sink* dell'attività di copia.The following properties are supported in the copy activity *sink* section.

ProprietàProperty DescrizioneDescription ObbligatorioRequired
typetype La proprietà Type dell'origine dell'attività di copia deve essere impostata su BinarySink.The type property of the copy activity source must be set to BinarySink. Yes
storeSettingsstoreSettings Gruppo di proprietà su come scrivere dati in un archivio dati.A group of properties on how to write data to a data store. Ogni connettore basato su file ha le proprie impostazioni di scrittura supportate in storeSettings.Each file-based connector has its own supported write settings under storeSettings. Per informazioni dettagliate, vedere l'articolo connettore > sezione proprietà dell'attività di copia.See details in connector article -> Copy activity properties section. NoNo

Passaggi successiviNext steps