Copiare dati da e verso Salesforce Service Cloud usando Azure Data Factory o Azure Synapse Analytics

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Questo articolo descrive come usare l'attività di copia in Azure Data Factory e nelle pipeline di Azure Synapse per copiare dati da e verso Salesforce Service Cloud. Si basa sull'articolo di panoramica dell'attività di copia che presenta informazioni generali sull'attività di copia.

Funzionalità supportate

Questo connettore Salesforce Service Cloud è supportato per le funzionalità seguenti:

① Azure Integration Runtime ② Runtime di integrazione self-hosted

Per un elenco degli archivi dati supportati come origini o sink, vedere la tabella Archivi dati supportati.

In particolare, questo connettore Salesforce Service Cloud supporta:

• Le edizioni Developer, Professional, Enterprise o Unlimited di Salesforce.
• Copia di dati da e verso un dominio personalizzato (il dominio personalizzato può essere configurato sia in ambienti di produzione che in ambienti sandbox).

È possibile impostare in modo esplicito la versione dell'API usata per leggere/scrivere dati tramite la proprietà apiVersion nel servizio collegato. Quando si copiano dati in Salesforce Service Cloud, il connettore usa l'API BULK 2.0.

Prerequisiti

• In Salesforce deve essere abilitata l'autorizzazione API.

• È necessario configurare le app connesse nel portale di Salesforce facendo riferimento a questo documento ufficiale o alle linee guida dettagliate riportate nei suggerimenti di questo articolo.

  Importante

  • L'utente di esecuzione deve avere l'autorizzazione Solo API.
  • L'ora di scadenza del token di accesso può essere modificata tramite i criteri di sessione anziché il token di aggiornamento.

Limiti dell'API Bulk 2.0 di Salesforce

Per eseguire query e inserire dati viene usata l'API Bulk 2.0 di Salesforce. Nell'API Bulk 2.0 i batch vengono creati automaticamente. È possibile inviare fino a 15.000 batch per periodo di 24 ore in sequenza. Se i batch superano il limite, verranno visualizzati errori.

Nell'API Bulk 2.0, solo i processi di inserimento consumano batch. Ciò non avviene per i processi di query. Per informazioni dettagliate, vedere Come vengono elaborate le richieste nella Guida per sviluppatori dell'API Bulk 2.0.

Per altre informazioni, vedere la sezione "Limiti generali" in Limiti per sviluppatori di Salesforce.

Operazioni preliminari

Per eseguire l'attività di copia con una pipeline, è possibile usare uno degli strumenti o SDK seguenti:

• Strumento Copia dati
• Il portale di Azure
• .NET SDK
• SDK di Python
• Azure PowerShell
• API REST
• Modello di Azure Resource Manager

Creare un servizio collegato a Salesforce Service Cloud usando l'interfaccia utente

Seguire questa procedura per creare un servizio collegato a Salesforce Service Cloud nell'interfaccia utente del portale di Azure.

1. Passare alla scheda Gestisci nell'area di lavoro di Azure Data Factory o Synapse e selezionare Servizi collegati, quindi fare clic su Nuovo:

   • Azure Data Factory
   • Azure Synapse

   

2. Cercare Salesforce e selezionare il connettore Salesforce Service Cloud.

   

3. Configurare i dettagli del servizio, testare la connessione e creare il nuovo servizio collegato.

   

Dettagli di configurazione del connettore

Le sezioni seguenti riportano informazioni dettagliate sulle proprietà usate per definire entità specifiche per il connettore Salesforce Service Cloud.

Proprietà del servizio collegato

Per il servizio collegato di Salesforce Service Cloud sono supportate le proprietà seguenti.

Esempio: archiviare le credenziali

{
    "name": "SalesforceServiceCloudLinkedService",
    "properties": {
        "type": "SalesforceServiceCloudV2",
        "typeProperties": {
            "environmentUrl": "<environment URL>",
            "authenticationType": "OAuth2ClientCredentials",
            "clientId": "<client ID>",
            "clientSecret": {
                "type": "SecureString",
                "value": "<client secret>"
            },
            "apiVersion": "<API Version>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Esempio: Archiviare le credenziali in Key Vault

{
    "name": "SalesforceServiceCloudLinkedService",
    "properties": {
        "type": "SalesforceServiceCloudV2",
        "typeProperties": {
            "environmentUrl": "<environment URL>",
            "authenticationType": "OAuth2ClientCredentials",
            "clientId": "<client ID>",
            "clientSecret": {
                "type": "AzureKeyVaultSecret",
                "secretName": "<secret name of client secret in AKV>",
                "store":{
                    "referenceName": "<Azure Key Vault linked service>",
                    "type": "LinkedServiceReference"
                }
            },
            "apiVersion": "<API Version>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Proprietà del set di dati

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione dei set di dati, vedere l'articolo Set di dati. Questa sezione presenta un elenco delle proprietà supportate dal set di dati Salesforce Service Cloud.

Per copiare dati da e in Salesforce Service Cloud, impostare la proprietà type del set di dati su SalesforceServiceCloudV2Object. Sono supportate le proprietà seguenti.

Esempio:

{
    "name": "SalesforceServiceCloudDataset",
    "properties": {
        "type": "SalesforceServiceCloudV2Object",
        "typeProperties": {
            "objectApiName": "MyTable__c"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Salesforce Service Cloud linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Proprietà dell'attività di copia

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere l'articolo sulle pipeline. Questa sezione presenta un elenco delle proprietà supportate dall'origine e dal sink di Salesforce Service Cloud.

Salesforce Service Cloud come tipo di origine

Per copiare dati da Salesforce Service Cloud, impostare il tipo di origine nell'attività di copia su SalesforceServiceCloudV2Source. Nella sezione source dell'attività di copia sono supportate le proprietà seguenti.

Esempio:

"activities":[
    {
        "name": "CopyFromSalesforceServiceCloud",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Salesforce Service Cloud input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SalesforceServiceCloudV2Source",
                "query": "SELECT Col_Currency__c, Col_Date__c, Col_Email__c FROM AllDataType__c",
                "includeDeletedObjects": false
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Salesforce Service Cloud come tipo di sink

Per copiare i dati in Salesforce Service Cloud, impostare il tipo di sink nell'attività di copia su SalesforceServiceCloudV2Sink. Nella sezione sink dell'attività di copia sono supportate le proprietà seguenti.

Esempio: sink di Salesforce Service Cloud in un'attività di copia

"activities":[
    {
        "name": "CopyToSalesforceServiceCloud",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<Salesforce Service Cloud output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "SalesforceServiceCloudV2Sink",
                "writeBehavior": "Upsert",
                "externalIdFieldName": "CustomerId__c",
                "writeBatchSize": 10000,
                "ignoreNullValues": true
            }
        }
    }
]

Mapping dei tipi di dati per Salesforce Service Cloud

Quando si copiano dati da Salesforce Service Cloud, vengono usati i mapping seguenti tra i tipi di dati di Salesforce Service Cloud e i tipi di dati provvisori internamente al servizio. Per informazioni su come l'attività di copia esegue il mapping dello schema di origine e del tipo di dati al sink, vedere Mapping dello schema e del tipo di dati.

Proprietà dell'attività Lookup

Per altre informazioni sulle proprietà, vedere Attività Lookup.

Aggiornare il servizio collegato Salesforce Service Cloud

Ecco i passaggi che consentono di aggiornare il servizio collegato e le query correlate:

1. Configurare le app connesse nel portale di Salesforce facendo riferimento ai Prerequisiti.

2. Creare un nuovo servizio collegato Salesforce Service Cloud e configurarlo facendo riferimento alle Proprietà del servizio collegato.

3. Se si usa una query SQL nell'origine dell'attività di copia o nell'attività di ricerca che fa riferimento al servizio collegato legacy, è necessario convertirla nella query SOQL. Altre informazioni sulla query SOQL da Salesforce Service Cloud come tipo di origine e Salesforce Object Query Language (SOQL).

4. readBehavior viene sostituito con includeDeletedObjects nell'origine dell'attività di copia o nell'attività di ricerca. Per la configurazione dettagliata, vedere Salesforce Service Cloud come tipo di origine.

Differenze tra Salesforce Service Cloud e Salesforce Service Cloud (legacy)

Il connettore Salesforce Service Cloud offre nuove funzionalità ed è compatibile con la maggior parte delle funzionalità del connettore Salesforce Service Cloud (legacy). La tabella seguente illustra le differenze di funzionalità tra Salesforce Service Cloud e Salesforce Service Cloud (legacy).

Contenuto correlato

Per un elenco degli archivi dati supportati come origini e sink dall'attività di copia, vedere Archivi dati supportati.