Come creare e configurare il runtime di integrazione di AzureHow to create and configure Azure Integration Runtime

Il runtime di integrazione è l'infrastruttura di calcolo usata da Azure Data Factory per fornire le funzionalità di integrazione di dati in diversi ambienti di rete.The Integration Runtime (IR) is the compute infrastructure used by Azure Data Factory to provide data integration capabilities across different network environments. Per altre informazioni sul runtime di integrazione, vedere Integration runtime (Runtime di integrazione).For more information about IR, see Integration runtime.

Il runtime di integrazione di Azure fornisce una funzionalità di calcolo completamente gestita per eseguire in modo nativo lo spostamento dei dati e inviare le attività di trasformazione dei dati ai servizi di calcolo, ad esempio HDInsight.Azure IR provides a fully managed compute to natively perform data movement and dispatch data transformation activities to compute services like HDInsight. È ospitato nell'ambiente Azure e supporta la connessione alle risorse nell'ambiente di rete pubblica con endpoint accessibili pubblicamente.It is hosted in Azure environment and supports connecting to resources in public network environment with public accessible endpoints.

Questo documento illustra come creare e configurare il runtime di integrazione di Azure.This document introduces how you can create and configure Azure Integration Runtime.

Nota

Questo articolo è stato aggiornato per usare il nuovo modulo Az di Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. È comunque possibile usare il modulo AzureRM, che continuerà a ricevere correzioni di bug almeno fino a dicembre 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Per altre informazioni sul nuovo modulo Az e sulla compatibilità di AzureRM, vedere Introduzione del nuovo modulo Az di Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Per istruzioni sull'installazione del modulo Az, vedere Installare Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Runtime di integrazione di Azure predefinitoDefault Azure IR

Per impostazione predefinita, ogni data factory ha un runtime di integrazione di Azure nel back-end che supporta le operazioni negli archivi dati cloud e i servizi di calcolo nella rete pubblica.By default, each data factory has an Azure IR in the backend that supports operations on cloud data stores and compute services in public network. La località di tale runtime di integrazione di Azure viene risolta automaticamente.The location of that Azure IR is auto-resolve. Se la proprietà connectVia non viene specificata nella definizione del servizio collegato, viene usato il runtime di integrazione di Azure predefinito.If connectVia property is not specified in the linked service definition, the default Azure IR is used. È necessario creare in modo esplicito un runtime di integrazione di Azure solo quando si vuole definire in modo esplicito la località del runtime di integrazione o si vogliono raggruppare le esecuzioni di attività in runtime di integrazione diversi a scopo di gestione.You only need to explicitly create an Azure IR when you would like to explicitly define the location of the IR, or if you would like to virtually group the activity executions on different IRs for management purpose.

Creare il runtime di integrazione di AzureCreate Azure IR

È possibile creare Integration Runtime usando il cmdlet di PowerShell set-AzDataFactoryV2IntegrationRuntime .Integration Runtime can be created using the Set-AzDataFactoryV2IntegrationRuntime PowerShell cmdlet. Per creare un runtime di integrazione di Azure, specificare il nome, la località e il tipo nel comando.To create an Azure IR, you specify the name, location and type to the command. Ecco un comando di esempio per creare un runtime di integrazione di Azure con la località impostata su "West Europe":Here is a sample command to create an Azure IR with location set to "West Europe":

Set-AzDataFactoryV2IntegrationRuntime -DataFactoryName "SampleV2DataFactory1" -Name "MySampleAzureIR" -ResourceGroupName "ADFV2SampleRG" -Type Managed -Location "West Europe"

Per il runtime di integrazione di Azure, il tipo deve essere impostato su Managed.For Azure IR, the type must be set to Managed. Non è necessario specificare i dettagli del calcolo perché è completamente gestito in modo elastico nel cloud.You do not need to specify compute details because it is fully managed elastically in cloud. Specificare i dettagli del calcolo, ad esempio le dimensioni del nodo e il numero di nodi, quando si vuole creare un runtime di integrazione SSIS di Azure.Specify compute details like node size and node count when you would like to create Azure-SSIS IR. Per altre informazioni, vedere Creare e configurare il runtime di integrazione SSIS di Azure.For more information, see Create and Configure Azure-SSIS IR.

È possibile configurare un Azure IR esistente per modificarne il percorso usando il cmdlet di PowerShell set-AzDataFactoryV2IntegrationRuntime.You can configure an existing Azure IR to change its location using the Set-AzDataFactoryV2IntegrationRuntime PowerShell cmdlet. Per altre informazioni sulla località di un runtime di integrazione di Azure, vedere Introduction to integration runtime (Introduzione al runtime di integrazione).For more information about the location of an Azure IR, see Introduction to integration runtime.

Usare il runtime di integrazione di AzureUse Azure IR

Dopo la creazione di un runtime di integrazione di Azure, è possibile farvi riferimento nella definizione del servizio collegato.Once an Azure IR is created, you can reference it in your Linked Service definition. Segue un esempio di come fare riferimento al runtime di integrazione di Azure creato sopra da un servizio collegato Archiviazione di Azure:Below is a sample of how you can reference the Azure Integration Runtime created above from an Azure Storage Linked Service:

{
    "name": "MyStorageLinkedService",
    "properties": {
      "type": "AzureStorage",
      "typeProperties": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myaccountname;AccountKey=..."
      },
      "connectVia": {
        "referenceName": "MySampleAzureIR",
        "type": "IntegrationRuntimeReference"
      }   
    }
}

Passaggi successiviNext steps

Per creare altri tipi di runtime di integrazione, vedere gli articoli seguenti:See the following articles on how to create other types of integration runtimes: