Attività di copia in Azure Data FactoryCopy activity in Azure Data Factory

In Azure Data Factory, è possibile usare l'attività di copia per copiare i dati tra archivi dati locali e nel cloud.In Azure Data Factory, you can use the Copy activity to copy data among data stores located on-premises and in the cloud. Dopo aver copiato i dati, è possibile usare altre attività per trasformarli e analizzarli.After you copy the data, you can use other activities to further transform and analyze it. È anche possibile usare l'attività di copia per pubblicare i risultati di trasformazione e analisi per business intelligence (BI) e l'utilizzo di applicazioni.You can also use the Copy activity to publish transformation and analysis results for business intelligence (BI) and application consumption.

Ruolo dell'attività di copia

L'attività di copia viene eseguita in un runtime di integrazione.The Copy activity is executed on an integration runtime. È possibile usare diversi tipi di runtime di integrazione per diversi scenari di copia dei dati:You can use different types of integration runtimes for different data copy scenarios:

  • Quando si copiano dati tra due archivi dati accessibili pubblicamente tramite Internet da qualsiasi IP, è possibile usare il runtime di integrazione di Azure per l'attività di copia.When you're copying data between two data stores that are publicly accessible through the internet from any IP, you can use the Azure integration runtime for the copy activity. Questo runtime di integrazione è sicuro, affidabile, scalabile e disponibile a livello globale.This integration runtime is secure, reliable, scalable, and globally available.
  • Quando si copiano dati da e verso archivi dati che si trovano in locale o in una rete con controllo di accesso (ad esempio, una rete virtuale di Azure), è necessario configurare un runtime di integrazione self-hosted.When you're copying data to and from data stores that are located on-premises or in a network with access control (for example, an Azure virtual network), you need to set up a self-hosted integration runtime.

Un runtime di integrazione deve essere associato a ogni archivio dati di origine e sink.An integration runtime needs to be associated with each source and sink data store. Per informazioni sul modo in cui l'attività di copia determina il runtime di integrazione da usare, vedere determinazione dell'IR da usare.For information about how the Copy activity determines which integration runtime to use, see Determining which IR to use.

Per copiare dati da un'origine a un sink, il servizio che esegue l'attività di copia esegue i passaggi seguenti:To copy data from a source to a sink, the service that runs the Copy activity performs these steps:

  1. Legge i dati dall'archivio dati di origine.Reads data from a source data store.
  2. Esegue la serializzazione/deserializzazione, la compressione/decompressione, il mapping di colonne e così via.Performs serialization/deserialization, compression/decompression, column mapping, and so on. Questa operazione viene eseguita in base alla configurazione del set di dati di input, del set di dati di output e dell'attività di copia.It performs these operations based on the configuration of the input dataset, output dataset, and Copy activity.
  3. Scrive i dati nell'archivio dati sink/di destinazione.Writes data to the sink/destination data store.

Panoramica dell'attività di copia

Archivi dati e formati supportatiSupported data stores and formats

CategoriaCategory Archivio datiData store Supportato come origineSupported as a source Supportato come sinkSupported as a sink Supportato dal runtime di integrazione di AzureSupported by Azure IR Supportato dal runtime di integrazione self-hostedSupported by self-hosted IR
AzzurroAzure Archivio BLOB di AzureAzure Blob storage
  Azure Cosmos DB (API SQL)Azure Cosmos DB (SQL API)
  API di Azure Cosmos DB per MongoDBAzure Cosmos DB's API for MongoDB
  Esplora dati di AzureAzure Data Explorer
  Azure Data Lake Storage Gen1Azure Data Lake Storage Gen1
  Azure Data Lake Storage Gen2Azure Data Lake Storage Gen2
  Database di Azure per MariaDBAzure Database for MariaDB
  Database di Azure per MySQLAzure Database for MySQL
  Database di Azure per PostgreSQLAzure Database for PostgreSQL
  Archiviazione file di AzureAzure File Storage
  Database SQL di AzureAzure SQL Database
  Istanza gestita di database SQL di AzureAzure SQL Database Managed Instance
  Azure SQL Data WarehouseAzure SQL Data Warehouse
  Indice ricerca cognitiva di AzureAzure Cognitive Search index
  Archivio tabelle di AzureAzure Table storage
DatabaseDatabase Amazon RedshiftAmazon Redshift
  DB2DB2
  Drill.Drill
  Google BigQueryGoogle BigQuery
  GreenplumGreenplum
  HBaseHBase
  HiveHive
  Apache ImpalaApache Impala
  InformixInformix
  MariaDBMariaDB
  Microsoft AccessMicrosoft Access
  MySQLMySQL
  NetezzaNetezza
  OracleOracle
  PhoenixPhoenix
  PostgreSQLPostgreSQL
  Presto (anteprima)Presto (Preview)
  SAP Business Warehouse tramite hub apertoSAP Business Warehouse via Open Hub
  SAP Business Warehouse via MDXSAP Business Warehouse via MDX
  SAP HANASAP HANA
  Tabella SAPSAP table
  SparkSpark
  SQL ServerSQL Server
  SybaseSybase
  TeradataTeradata
  VerticaVertica
NoSQLNoSQL CassandraCassandra
  Couchbase (anteprima)Couchbase (Preview)
  MongoDBMongoDB
FileFile Amazon S3Amazon S3
  File systemFile system
  FTPFTP
  Google Cloud StorageGoogle Cloud Storage
  HDFSHDFS
  SFTPSFTP
Protocollo genericoGeneric protocol HTTP genericoGeneric HTTP
  OData genericoGeneric OData
  ODBC genericoGeneric ODBC
  REST genericoGeneric REST
Servizi e appServices and apps Amazon Marketplace Web ServiceAmazon Marketplace Web Service
  Common Data ServiceCommon Data Service
  Concur (anteprima)Concur (Preview)
  Dynamics 365Dynamics 365
  Dynamics AXDynamics AX
  Dynamics CRMDynamics CRM
  Google AdWordsGoogle AdWords
  HubSpot (anteprima)HubSpot (Preview)
  JiraJira
  Magento (anteprima)Magento (Preview)
  Marketo (anteprima)Marketo (Preview)
  Office 365Office 365
  Oracle Eloqua (anteprima)Oracle Eloqua (Preview)
  Oracle Responsys (anteprima)Oracle Responsys (Preview)
  Oracle Service Cloud (anteprima)Oracle Service Cloud (Preview)
  PayPal (anteprima)PayPal (Preview)
  QuickBooks (anteprima)QuickBooks (Preview)
  SalesforceSalesforce
  Cloud del servizio SalesforceSalesforce Service Cloud
  Cloud marketing di SalesforceSalesforce Marketing Cloud
  SAP Cloud for Customer (C4C)SAP Cloud for Customer (C4C)
  SAP ECCSAP ECC
  ServiceNowServiceNow
  Shopify (anteprima)Shopify (Preview)
  Square (anteprima)Square (Preview)
  Tabella Web (tabella HTML)Web table (HTML table)
  XeroXero
  Zoho (anteprima)Zoho (Preview)

Nota

Se un connettore è contrassegnato come Anteprima, è possibile provarlo e inviare commenti e suggerimenti.If a connector is marked Preview, you can try it out and give us feedback. Se si vuole creare una dipendenza dai connettori di anteprima nella soluzione, contattare il supporto tecnico di Azure.If you want to take a dependency on preview connectors in your solution, contact Azure support.

Formati di file supportatiSupported file formats

È possibile usare l'attività di copia per copiare i file così come sono tra due archivi dati basati su file.You can use the Copy activity to copy files as is between two file-based data stores. In questo caso, i dati vengono copiati in modo efficiente senza serializzazione o deserializzazione.In this case, the data is copied efficiently without any serialization or deserialization.

Azure Data Factory supportano i formati di file seguenti.Azure Data Factory support the following file formats. Fare riferimento a ogni articolo sulle impostazioni basate sul formato.Refer to each article on format-based settings.

È ad esempio possibile eseguire le attività di copia seguenti:For example, you can perform the following copy activities:

  • Copiare i dati da un database di SQL Server locale e scrivere i dati in Azure Data Lake Storage Gen2 in formato parquet.Copy data from an on-premises SQL Server database and write the data to Azure Data Lake Storage Gen2 in Parquet format.
  • Copiare i file in formato testo (CSV) da un file system locale e scrivere nell'archiviazione BLOB di Azure nel formato avro.Copy files in text (CSV) format from an on-premises file system and write to Azure Blob storage in Avro format.
  • Copiare i file compressi da un file system locale, decomprimerli e scriverli nel Azure Data Lake Storage Gen2.Copy zipped files from an on-premises file system, decompress them, and write them to Azure Data Lake Storage Gen2.
  • Copiare i dati nel formato di testo compresso gzip dall'archiviazione BLOB di Azure e scriverli nel database SQL di Azure.Copy data in Gzip compressed-text (CSV) format from Azure Blob storage and write it to Azure SQL Database.
  • Molte altre attività che richiedono la serializzazione/deserializzazione o la compressione/decompressione.Many more activities that require serialization/deserialization or compression/decompression.

Aree supportateSupported regions

Il servizio che Abilita l'attività di copia è disponibile a livello globale nelle aree geografiche elencate in percorsi di runtime di integrazione di Azure.The service that enables the Copy activity is available globally in the regions and geographies listed in Azure integration runtime locations. La topologia disponibile a livello globale garantisce uno spostamento di dati efficiente e di solito consente di evitare passaggi tra diverse aree.The globally available topology ensures efficient data movement that usually avoids cross-region hops. Vedere i prodotti in base all'area per verificare la disponibilità di data factory e lo spostamento dei dati in un'area specifica.See Products by region to check the availability of Data Factory and data movement in a specific region.

ConfigurazioneConfiguration

Per usare l'attività di copia in Azure Data Factory, è necessario:To use the Copy activity in Azure Data Factory, you need to:

  1. Creare servizi collegati per l'archivio dati di origine e l'archivio dati sink.Create linked services for the source data store and the sink data store. Per informazioni sulla configurazione e sulle proprietà supportate, vedere la sezione "proprietà del servizio collegato" dell'articolo del connettore.Refer to the connector article's "Linked service properties" section for configuration information and supported properties. È possibile trovare l'elenco dei connettori supportati nella sezione archivi dati e formati supportati di questo articolo.You can find the list of supported connectors in the Supported data stores and formats section of this article.
  2. Creare set di dati per l'origine e il sink.Create datasets for the source and sink. Per informazioni sulla configurazione e sulle proprietà supportate, vedere le sezioni "proprietà dei set di dati" degli articoli sui connettori di origine e sink.Refer to the "Dataset properties" sections of the source and sink connector articles for configuration information and supported properties.
  3. Creare una pipeline con l'attività di copia.Create a pipeline with the Copy activity. Nella sezione seguente viene illustrato un esempio.The next section provides an example.

SintassiSyntax

Il modello seguente di un'attività di copia contiene un elenco completo delle proprietà supportate.The following template of a Copy activity contains a complete list of supported properties. Specificare quelle più adatte per il proprio scenario.Specify the ones that fit your scenario.

"activities":[
    {
        "name": "CopyActivityTemplate",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<source dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<sink dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>",
                <properties>
            },
            "sink": {
                "type": "<sink type>"
                <properties>
            },
            "translator":
            {
                "type": "TabularTranslator",
                "columnMappings": "<column mapping>"
            },
            "dataIntegrationUnits": <number>,
            "parallelCopies": <number>,
            "enableStaging": true/false,
            "stagingSettings": {
                <properties>
            },
            "enableSkipIncompatibleRow": true/false,
            "redirectIncompatibleRowSettings": {
                <properties>
            }
        }
    }
]

Dettagli sintassiSyntax details

ProprietàProperty DESCRIZIONEDescription Obbligatorio?Required?
typetype Per un'attività di copia, impostare su CopyFor a Copy activity, set to Copy Yes
inputsinputs Specificare il set di dati creato che fa riferimento ai dati di origine.Specify the dataset that you created that points to the source data. L'attività di copia supporta solo un singolo input.The Copy activity supports only a single input. Yes
outputsoutputs Specificare il set di dati creato che punta ai dati del sink.Specify the dataset that you created that points to the sink data. L'attività di copia supporta solo un singolo output.The Copy activity supports only a single output. Yes
typePropertiestypeProperties Specificare le proprietà per configurare l'attività di copia.Specify properties to configure the Copy activity. Yes
sourcesource Specificare il tipo di origine della copia e le proprietà corrispondenti per il recupero dei dati.Specify the copy source type and the corresponding properties for retrieving data.

Per ulteriori informazioni, vedere la sezione "proprietà dell'attività di copia" nell'articolo del connettore elencato in archivi dati e formati supportati.For more information, see the "Copy activity properties" section in the connector article listed in Supported data stores and formats.
Yes
sinksink Specificare il tipo di sink di copia e le proprietà corrispondenti per la scrittura dei dati.Specify the copy sink type and the corresponding properties for writing data.

Per ulteriori informazioni, vedere la sezione "proprietà dell'attività di copia" nell'articolo del connettore elencato in archivi dati e formati supportati.For more information, see the "Copy activity properties" section in the connector article listed in Supported data stores and formats.
Yes
translatortranslator Specificare il mapping esplicito di colonne da origine a sink.Specify explicit column mappings from source to sink. Questa proprietà si applica quando il comportamento di copia predefinito non soddisfa le proprie esigenze.This property applies when the default copy behavior doesn't meet your needs.

Per ulteriori informazioni, vedere mapping dello schema nell'attività di copia.For more information, see Schema mapping in copy activity.
NoNo
dataIntegrationUnitsdataIntegrationUnits Specificare una misura che rappresenta la quantità di energia utilizzata dal runtime di integrazione di Azure per la copia dei dati.Specify a measure that represents the amount of power that the Azure integration runtime uses for data copy. Queste unità erano precedentemente note come unità di spostamento dati cloud (spostamento dati).These units were formerly known as cloud Data Movement Units (DMU).

Per ulteriori informazioni, vedere Data Integration Unit.For more information, see Data Integration Units.
NoNo
parallelCopiesparallelCopies Specificare il parallelismo che si desidera venga utilizzato dall'attività di copia durante la lettura dei dati dall'origine e la scrittura dei dati nel sink.Specify the parallelism that you want the Copy activity to use when reading data from the source and writing data to the sink.

Per ulteriori informazioni, vedere copia parallela.For more information, see Parallel copy.
NoNo
enableStagingenableStaging
stagingSettingsstagingSettings
Consente di specificare se organizzare temporaneamente i dati provvisori nell'archivio BLOB anziché copiare direttamente i dati dall'origine al sink.Specify whether to stage the interim data in Blob storage instead of directly copying data from source to sink.

Per informazioni sugli scenari e i dettagli di configurazione utili, vedere la pagina relativa alla copia temporanea.For information about useful scenarios and configuration details, see Staged copy.
NoNo
enableSkipIncompatibleRowenableSkipIncompatibleRow
redirectIncompatibleRowSettingsredirectIncompatibleRowSettings
Scegliere come gestire le righe incompatibili durante la copia dei dati dall'origine al sink.Choose how to handle incompatible rows when you copy data from source to sink.

Per altre informazioni, vedere tolleranza di errore.For more information, see Fault tolerance.
NoNo

MonitoraggioMonitoring

È possibile monitorare l'esecuzione dell'attività di copia in Azure Data Factory autore & monitorare l'interfaccia utente o a livello di codice.You can monitor the Copy activity run in the Azure Data Factory Author & Monitor UI or programmatically.

Monitorare visivamenteMonitor visually

Per monitorare visivamente l'esecuzione dell'attività di copia, passare alla data factory, quindi passare a crea & monitoraggio.To visually monitor the Copy activity run, go to your data factory and then go to Author & Monitor. Nella scheda monitoraggio viene visualizzato un elenco di esecuzioni di pipeline con un pulsante Visualizza esecuzione attività nella colonna azioni :On the Monitor tab, you see a list of pipeline runs with a View Activity Run button in the Actions column:

Monitorare le esecuzioni di pipeline

Selezionare Visualizza esecuzioni attività per visualizzare l'elenco delle attività nell'esecuzione della pipeline.Select View Activity Runs to see the list of activities in the pipeline run. Nella colonna azioni vengono visualizzati i collegamenti all'input dell'attività di copia, l'output, gli errori (se l'esecuzione dell'attività di copia ha esito negativo) e i dettagli:In the Actions column, you see links to the Copy activity input, output, errors (if the Copy activity run fails), and details:

Monitorare le esecuzioni delle attività

Selezionare il pulsante Dettagli nella colonna azioni per visualizzare i dettagli sull'esecuzione dell'attività di copia e le caratteristiche delle prestazioni.Select the Details button in the Actions column to see the Copy activity's execution details and performance characteristics. Vengono visualizzate informazioni quali volume/numero di righe/numero di file di dati copiati dall'origine al sink, la velocità effettiva, i passaggi che l'attività di copia passa con le durate corrispondenti e le configurazioni usate per lo scenario di copia.You see information like volume/number of rows/number of files of data copied from source to sink, throughput, steps the Copy activity goes through with corresponding durations, and configurations used for your copy scenario.

Suggerimento

In alcuni scenari verranno visualizzati anche i suggerimenti per l' ottimizzazione delle prestazioni nella parte superiore della pagina di monitoraggio della copia.In some scenarios, you'll also see Performance tuning tips at the top of the copy monitoring page. Questi suggerimenti indicano i colli di bottiglia identificati e forniscono informazioni sugli elementi da modificare per aumentare la velocità effettiva della copia.These tips tell you about identified bottlenecks and provide information on what to change to boost copy throughput. Per un esempio, vedere la sezione prestazioni e ottimizzazione di questo articolo.For an example, see the Performance and tuning section of this article.

Esempio: copiare da Amazon S3 a Azure Data Lake Store monitorare i dettagli dell'esecuzione dell'attivitàExample: Copy from Amazon S3 to Azure Data Lake Store Monitor activity run details

Esempio: copiare dal database SQL di Azure a Azure SQL data warehouse con la copia di staging i dettagli dell'esecuzione dell'attività monitorExample: Copy from Azure SQL Database to Azure SQL Data Warehouse with staged copy Monitor activity run details

Monitorare a livello di codiceMonitor programmatically

I dettagli dell'esecuzione dell'attività di copia e le caratteristiche delle prestazioni vengono restituiti anche nella sezione Risultati esecuzione attività di copia > output .Copy activity execution details and performance characteristics are also returned in the Copy Activity run result > Output section. Di seguito è riportato un elenco completo delle proprietà che possono essere restituite.Following is a complete list of properties that might be returned. Verranno visualizzate solo le proprietà applicabili allo scenario di copia.You'll see only the properties that are applicable to your copy scenario. Per informazioni su come monitorare le esecuzioni delle attività, vedere monitorare un'esecuzione della pipeline.For information about how to monitor activity runs, see Monitor a pipeline run.

Nome proprietàProperty name DESCRIZIONEDescription UnitàUnit
dataReaddataRead Quantità di dati letti dall'origine.Amount of data read from source. Valore Int64, in byteInt64 value, in bytes
dataWrittendataWritten Quantità di dati scritti nel sink.Amount of data written to sink. Valore Int64, in byteInt64 value, in bytes
filesReadfilesRead Numero di file copiati durante la copia dall'archiviazione file.Number of files copied during copy from file storage. Valore Int64 (senza unità)Int64 value (no unit)
filesWrittenfilesWritten Numero di file copiati durante la copia nell'archiviazione file.Number of files copied during copy to file storage. Valore Int64 (senza unità)Int64 value (no unit)
sourcePeakConnectionssourcePeakConnections Numero massimo di connessioni simultanee stabilite nell'archivio dati di origine durante l'esecuzione dell'attività di copia.Peak number of concurrent connections established to the source data store during the Copy activity run. Valore Int64 (senza unità)Int64 value (no unit)
sinkPeakConnectionssinkPeakConnections Numero massimo di connessioni simultanee stabilite nell'archivio dati sink durante l'esecuzione dell'attività di copia.Peak number of concurrent connections established to the sink data store during the Copy activity run. Valore Int64 (senza unità)Int64 value (no unit)
rowsReadrowsRead Numero di righe lette dall'origine (non applicabile per la copia binaria).Number of rows read from the source (not applicable for binary copy). Valore Int64 (senza unità)Int64 value (no unit)
rowsCopiedrowsCopied Numero di righe copiate nel sink (non applicabile per la copia binaria).Number of rows copied to sink (not applicable for binary copy). Valore Int64 (senza unità)Int64 value (no unit)
rowsSkippedrowsSkipped Numero di righe non compatibili ignorate.Number of incompatible rows that were skipped. È possibile abilitare l'omissione di righe incompatibili impostando enableSkipIncompatibleRow su true.You can enable incompatible rows to be skipped by setting enableSkipIncompatibleRow to true. Valore Int64 (senza unità)Int64 value (no unit)
copyDurationcopyDuration Durata dell'esecuzione della copia.Duration of the copy run. Valore Int32, in secondiInt32 value, in seconds
throughputthroughput Frequenza di trasferimento dei dati.Rate of data transfer. Numero a virgola mobile, in KBpsFloating point number, in KBps
sourcePeakConnectionssourcePeakConnections Numero massimo di connessioni simultanee stabilite nell'archivio dati di origine durante l'esecuzione dell'attività di copia.Peak number of concurrent connections established to the source data store during the Copy activity run. Valore Int32 (nessuna unità)Int32 value (no unit)
sinkPeakConnectionssinkPeakConnections Numero massimo di connessioni simultanee stabilite nell'archivio dati sink durante l'esecuzione dell'attività di copia.Peak number of concurrent connections established to the sink data store during the Copy activity run. Valore Int32 (nessuna unità)Int32 value (no unit)
sqlDwPolyBasesqlDwPolyBase Indica se la polibase viene utilizzata quando i dati vengono copiati in SQL Data Warehouse.Whether PolyBase is used when data is copied into SQL Data Warehouse. BooleanoBoolean
redshiftUnloadredshiftUnload Indica se lo SCARICAmento viene utilizzato quando i dati vengono copiati da spostamento verso il suoWhether UNLOAD is used when data is copied from Redshift. BooleanoBoolean
hdfsDistcphdfsDistcp Indica se DistCp viene usato quando i dati vengono copiati da HDFS.Whether DistCp is used when data is copied from HDFS. BooleanoBoolean
effectiveIntegrationRuntimeeffectiveIntegrationRuntime Runtime di integrazione (IR) o Runtime usati per l'esecuzione dell'attività, nel formato <IR name> (<region if it's Azure IR>).The integration runtime (IR) or runtimes used to power the activity run, in the format <IR name> (<region if it's Azure IR>). Testo (stringa)Text (string)
usedDataIntegrationUnitsusedDataIntegrationUnits Le unità di integrazione dati effettive durante la copia.The effective Data Integration Units during copy. Valore Int32Int32 value
usedParallelCopiesusedParallelCopies Proprietà parallelCopies effettiva durante la copia.The effective parallelCopies during copy. Valore Int32Int32 value
redirectRowPathredirectRowPath Percorso del log delle righe non compatibili ignorate nell'archivio BLOB configurato nella proprietà redirectIncompatibleRowSettings.Path to the log of skipped incompatible rows in the blob storage you configure in the redirectIncompatibleRowSettings property. Vedere tolleranza di errore più avanti in questo articolo.See Fault tolerance later in this article. Testo (stringa)Text (string)
executionDetailsexecutionDetails Ulteriori dettagli sulle fasi dell'attività di copia e sui passaggi, le durate, le configurazioni e così via corrispondenti.More details on the stages the Copy activity goes through and the corresponding steps, durations, configurations, and so on. Non è consigliabile analizzare questa sezione perché potrebbe cambiare.We don't recommend that you parse this section because it might change.

Data Factory segnala anche le durate (in secondi) dedicate alle varie fasi della detailedDurations.Data Factory also reports the detailed durations (in seconds) spent on various stages under detailedDurations. Le durate di questi passaggi sono esclusive.The durations of these steps are exclusive. Vengono visualizzate solo le durate valide per l'esecuzione dell'attività di copia specificata:Only durations that apply to the given Copy activity run appear:
Durata di Accodamento (queuingDuration): quantità di tempo prima che l'attività di copia venga effettivamente avviata nel runtime di integrazione.Queuing duration (queuingDuration): The amount of time before the Copy activity actually starts on the integration runtime. Se si usa un runtime di integrazione self-hosted e questo valore è elevato, controllare la capacità e l'utilizzo di IR e aumentare o ridurre le prestazioni in base al carico di lavoro.If you use a self-hosted IR and this value is large, check the IR capacity and usage, and scale up or out according to your workload.
Durata dello script di pre-copia (preCopyScriptDuration): tempo trascorso tra il momento in cui l'attività di copia inizia nell'IR e quando l'attività di copia termina l'esecuzione dello script di pre-copia nell'archivio dati sink.Pre-copy script duration (preCopyScriptDuration): The time elapsed between when the Copy activity starts on the IR and when the Copy activity finishes running the pre-copy script in the sink data store. Si applica quando si configura lo script di pre-copia.Applies when you configure the pre-copy script.
Tempo per il primo byte (timeToFirstByte): tempo trascorso tra la fine del passaggio precedente e l'ora in cui il runtime di integrazione riceve il primo byte dall'archivio dati di origine.Time to first byte (timeToFirstByte): The time elapsed between the end of the previous step and the time when the IR receives the first byte from the source data store. Si applica alle origini non basate su file.Applies to non-file-based sources. Se questo valore è elevato, controllare e ottimizzare la query o il server.If this value is large, check and optimize the query or server.
Durata trasferimento (transferDuration): tempo trascorso tra la fine del passaggio precedente e l'ora in cui il runtime di integrazione trasferisce tutti i dati dall'origine al sink.Transfer duration (transferDuration): The time elapsed between the end of the previous step and the time when the IR transfers all the data from source to sink.
ArrayArray
perfRecommendationperfRecommendation Copia suggerimenti per l'ottimizzazione delle prestazioni.Copy performance tuning tips. Per informazioni dettagliate, vedere prestazioni e ottimizzazione .See Performance and tuning for details. ArrayArray
"output": {
    "dataRead": 6198358,
    "dataWritten": 19169324,
    "filesRead": 1,
    "sourcePeakConnections": 1,
    "sinkPeakConnections": 2,
    "rowsRead": 39614,
    "rowsCopied": 39614,
    "copyDuration": 1325,
    "throughput": 4.568,
    "errors": [],
    "effectiveIntegrationRuntime": "DefaultIntegrationRuntime (West US)",
    "usedDataIntegrationUnits": 4,
    "usedParallelCopies": 1,
    "executionDetails": [
        {
            "source": {
                "type": "AzureBlobStorage"
            },
            "sink": {
                "type": "AzureSqlDatabase"
            },
            "status": "Succeeded",
            "start": "2019-08-06T01:01:36.7778286Z",
            "duration": 1325,
            "usedDataIntegrationUnits": 4,
            "usedParallelCopies": 1,
            "detailedDurations": {
                "queuingDuration": 2,
                "preCopyScriptDuration": 12,
                "transferDuration": 1311
            }
        }
    ],
    "perfRecommendation": [
        {
            "Tip": "Sink Azure SQL Database: The DTU utilization was high during the copy activity run. To achieve better performance, you are suggested to scale the database to a higher tier than the current 1600 DTUs.",
            "ReferUrl": "https://go.microsoft.com/fwlink/?linkid=2043368",
            "RuleName": "AzureDBTierUpgradePerfRecommendRule"
        }
    ]
}

Mapping dello schema e dei tipi di datiSchema and data type mapping

Per informazioni sul modo in cui l'attività di copia esegue il mapping dei dati di origine al sink, vedere mapping tra schemi e tipi di dati .See Schema and data type mapping for information about how the Copy activity maps your source data to your sink.

Tolleranza di erroreFault tolerance

Per impostazione predefinita, l'attività di copia interrompe la copia dei dati e restituisce un errore quando le righe di dati di origine non sono compatibili con le righe di dati del sink.By default, the Copy activity stops copying data and returns a failure when source data rows are incompatible with sink data rows. Per fare in modo che la copia abbia esito positivo, è possibile configurare l'attività di copia in modo da ignorare e registrare le righe incompatibili e copiare solo i dati compatibili.To make the copy succeed, you can configure the Copy activity to skip and log the incompatible rows and copy only the compatible data. Per informazioni dettagliate, vedere tolleranza di errore dell'attività di copia .See Copy activity fault tolerance for details.

Prestazioni e ottimizzazionePerformance and tuning

La Guida alla scalabilità e alle prestazioni dell'attività di copia descrive i fattori chiave che influiscono sulle prestazioni dello spostamento dei dati tramite l'attività di copia in Azure Data Factory.The Copy activity performance and scalability guide describes key factors that affect the performance of data movement via the Copy activity in Azure Data Factory. Vengono inoltre elencati i valori delle prestazioni osservati durante i test e viene illustrato come ottimizzare le prestazioni dell'attività di copia.It also lists the performance values observed during testing and discusses how to optimize the performance of the Copy activity.

In alcuni scenari, quando si esegue un'attività di copia in Data Factory, verranno visualizzati i suggerimenti per l' ottimizzazione delle prestazioni nella parte superiore della pagina Monitoraggio attività di copia, come illustrato nell'esempio seguente.In some scenarios, when you run a Copy activity in Data Factory, you'll see Performance tuning tips at the top of the Copy activity monitoring page, as shown in the following example. I suggerimenti indicano il collo di bottiglia identificato per l'esecuzione della copia specificata.The tips tell you the bottleneck identified for the given copy run. Forniscono anche informazioni sugli elementi da modificare per aumentare la velocità effettiva della copia.They also provide information on what to change to boost copy throughput. I suggerimenti per l'ottimizzazione delle prestazioni offrono attualmente suggerimenti come l'uso di polibase quando si copiano dati in Azure SQL Data Warehouse, aumentando Azure Cosmos DB ur o il database SQL di Azure DTU quando la risorsa sul lato archivio dati è il collo di bottiglia e la rimozione copie di gestione temporanea non necessarie.The performance tuning tips currently provide suggestions like using PolyBase when copying data into Azure SQL Data Warehouse, increasing Azure Cosmos DB RUs or Azure SQL Database DTUs when the resource on the data store side is the bottleneck, and removing unnecessary staged copies.

Esempio: copiare nel database SQL di Azure con un suggerimento per l'ottimizzazione delle prestazioniExample: Copy into Azure SQL Database, with a performance tuning tip

In questo esempio, durante l'esecuzione di una copia, Data Factory tiene traccia di un elevato utilizzo di DTU nel database SQL di Azure sink.In this sample, during a copy run, Data Factory tracks a high DTU utilization in the sink Azure SQL Database. Questa condizione rallenta le operazioni di scrittura.This condition slows down write operations. Il suggerimento consiste nell'aumentare la DTU nel livello del database SQL di Azure:The suggestion is to increase the DTUs on the Azure SQL Database tier:

Monitoraggio della copia con suggerimenti per l'ottimizzazione delle prestazioni

Copia incrementaleIncremental copy

Data Factory consente di copiare in modo incrementale i dati differenziali da un archivio dati di origine a un archivio dati sink.Data Factory enables you to incrementally copy delta data from a source data store to a sink data store. Per informazioni dettagliate, vedere esercitazione: copiare i dati in modo incrementale.For details, see Tutorial: Incrementally copy data.

Passaggi successiviNext steps

Vedere le guide rapide, le esercitazioni e gli esempi seguenti:See the following quickstarts, tutorials, and samples: