Kopiowanie danych z i do usługi Salesforce Service Cloud przy użyciu usługi Azure Data Factory lub Azure Synapse Analytics

Artykuł
10/14/2024

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

W tym artykule opisano sposób używania działania kopiowania w potokach usługi Azure Data Factory i Azure Synapse w celu kopiowania danych z i do usługi Salesforce Service Cloud. Jest on oparty na artykule Omówienie działania kopiowania, który przedstawia ogólne omówienie działania kopiowania.

Ważne

Nowy łącznik Salesforce Service Cloud zapewnia ulepszoną natywną obsługę usługi Salesforce Service w chmurze. Jeśli używasz starszego łącznika salesforce Service Cloud w swoim rozwiązaniu, uaktualnij łącznik Salesforce Service Cloud przed 11 października 2024 r. Zapoznaj się z tą sekcją , aby uzyskać szczegółowe informacje na temat różnicy między starszą i najnowszą wersją.

Obsługiwane możliwości

Ten łącznik usługi Salesforce Service Cloud jest obsługiwany w następujących funkcjach:

Obsługiwane możliwości	IR
działanie Kopiuj (źródło/ujście)	(1) (2)
Działanie Lookup	(1) (2)

(1) Środowisko Azure Integration Runtime (2) Self-hosted Integration Runtime

Aby uzyskać listę magazynów danych obsługiwanych jako źródła lub ujścia, zobacz tabelę Obsługiwane magazyny danych.

W szczególności ten łącznik usługi Salesforce Service Cloud obsługuje następujące elementy:

Wersje Salesforce Developer, Professional, Enterprise lub Unlimited.
Kopiowanie danych z i do domeny niestandardowej (domena niestandardowa można skonfigurować zarówno w środowiskach produkcyjnych, jak i piaskownicy).

Możesz jawnie ustawić wersję interfejsu API używaną do odczytu/zapisu danych za pośrednictwem apiVersion właściwości w połączonej usłudze. Podczas kopiowania danych do usługi Salesforce Service Cloud łącznik używa interfejsu API BULK 2.0.

Wymagania wstępne

Uprawnienia interfejsu API muszą być włączone w usłudze Salesforce.
Musisz skonfigurować portal Connected Apps w usłudze Salesforce odwołując się do tego oficjalnego dokumentu lub wskazówek krok po kroku w rekomendacji w tym artykule.
Ważne
- Użytkownik wykonywania musi mieć uprawnienie Tylko interfejs API.
- Czas wygaśnięcia tokenu dostępu można zmienić za pomocą zasad sesji zamiast tokenu odświeżania.

Limity interfejsu API zbiorczego usługi Salesforce 2.0

Do wykonywania zapytań i pozyskiwania danych używamy interfejsu API zbiorczego usługi Salesforce 2.0. W przypadku zbiorczego interfejsu API 2.0 partie są tworzone automatycznie. Można przesłać maksymalnie 15 000 partii na okres 24-godzinny. Jeśli partie przekraczają limit, zostaną wyświetlone błędy.

W przypadku zbiorczego interfejsu API 2.0 tylko zadania pozyskiwania zużywają partie. Zadania zapytań nie są wykonywane. Aby uzyskać szczegółowe informacje, zobacz How Requests are Processed in the Bulk API 2.0 Developer Guide (Jak żądania są przetwarzane w przewodniku dla deweloperów interfejsu API zbiorczego 2.0).

Aby uzyskać więcej informacji, zobacz sekcję "Ogólne limity" w temacie Limity dla deweloperów usługi Salesforce.

Rozpocznij

Aby wykonać działanie Kopiuj za pomocą potoku, możesz użyć jednego z następujących narzędzi lub zestawów SDK:

Tworzenie połączonej usługi z usługą Salesforce Service Cloud przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć połączoną usługę z usługą Salesforce Service Cloud w interfejsie użytkownika witryny Azure Portal.

Przejdź do karty Zarządzanie w obszarze roboczym usługi Azure Data Factory lub Synapse i wybierz pozycję Połączone usługi, a następnie kliknij pozycję Nowy:
- Azure Data Factory
- Azure Synapse
Wyszukaj pozycję Salesforce i wybierz łącznik Salesforce Service Cloud.
Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

Szczegóły konfiguracji łącznika

Poniższe sekcje zawierają szczegółowe informacje o właściwościach używanych do definiowania jednostek specyficznych dla łącznika usługi Salesforce Service Cloud.

Właściwości połączonej usługi

Następujące właściwości są obsługiwane dla połączonej usługi Salesforce Service w chmurze.

Właściwości	Opis	Wymagania
type	Właściwość type musi być ustawiona na SalesforceServiceCloudV2.	Tak
environmentUrl	Określ adres URL wystąpienia usługi Salesforce Service w chmurze. Na przykład określ `"https://<domainName>.my.salesforce.com"` , aby skopiować dane z domeny niestandardowej. Dowiedz się, jak skonfigurować lub wyświetlić domenę niestandardową, korzystając z tego artykułu.	Tak
authenticationType	Typ uwierzytelniania używanego do nawiązywania połączenia z usługą Salesforce Service Cloud. Dozwolona wartość to OAuth2ClientCredentials.	Tak
clientId	Określ identyfikator klienta połączonej aplikacji OAuth 2.0 usługi Salesforce. Aby uzyskać więcej informacji, przejdź do tego artykułu	Tak
clientSecret	Określ wpis tajny klienta połączonej aplikacji OAuth 2.0 usługi Salesforce. Aby uzyskać więcej informacji, przejdź do tego artykułu	Tak
apiVersion	Określ wersję interfejsu API zbiorczego usługi Salesforce w wersji 2.0, np. `52.0`. Interfejs API zbiorczy 2.0 obsługuje tylko wersję >interfejsu API = 47.0. Aby dowiedzieć się więcej o wersji zbiorczego interfejsu API 2.0, zobacz artykuł. Jeśli używasz niższej wersji interfejsu API, spowoduje to niepowodzenie.	Tak
connectVia	Środowisko Integration Runtime do nawiązania połączenia z magazynem danych. Jeśli nie zostanie określony, używa domyślnego środowiska Azure Integration Runtime.	Nie.

Przykład: Przechowywanie poświadczeń

{
    "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"
        }
    }
}

Przykład: przechowywanie poświadczeń w usłudze 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"
        }
    }
}

Właściwości zestawu danych

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania zestawów danych, zobacz artykuł Zestawy danych. Ta sekcja zawiera listę właściwości obsługiwanych przez zestaw danych salesforce Service Cloud.

Aby skopiować dane z i do usługi Salesforce Service Cloud, ustaw właściwość type zestawu danych na SalesforceServiceCloudV2Object. Obsługiwane są następujące właściwości.

Właściwości	Opis	Wymagania
type	Właściwość type musi być ustawiona na SalesforceServiceCloudV2Object.	Tak
objectApiName	Nazwa obiektu usługi Salesforce Service w chmurze do pobierania danych. Odpowiednia wersja własnego środowiska Integration Runtime to 5.44.8984.1 lub nowsza.	Nie dla źródła (jeśli określono "zapytanie" w źródle), tak dla ujścia
reportId	Identyfikator raportu usługi Salesforce Service w chmurze do pobrania danych. Nie jest obsługiwany w ujściu. Należy pamiętać, że w przypadku korzystania z raportów obowiązują ograniczenia. Odpowiednia wersja własnego środowiska Integration Runtime to 5.44.8984.1 lub nowsza.	Nie dla źródła (jeśli określono "zapytanie" w źródle), nie obsługuje ujścia

Ważne

Część "__c" nazwy interfejsu API jest wymagana dla dowolnego obiektu niestandardowego.

Nazwa interfejsu API połączenia usługi Salesforce

Przykład:

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

Właściwości działania kopiowania

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz artykuł Pipelines (Potoki ). Ta sekcja zawiera listę właściwości obsługiwanych przez źródło i ujście usługi Salesforce Service.

Salesforce Service Cloud jako typ źródła

Aby skopiować dane z usługi Salesforce Service Cloud, ustaw typ źródła w działaniu kopiowania na SalesforceServiceCloudV2Source. Poniższe właściwości są obsługiwane w sekcji źródła działania kopiowania.

Właściwości	Opis	Wymagania
type	Właściwość type źródła działania kopiowania musi być ustawiona na SalesforceServiceCloudV2Source.	Tak
zapytanie	Użyj zapytania niestandardowego, aby odczytać dane. Zapytania SOQL (Salesforce Object Query Language) można używać tylko z ograniczeniami. Aby uzyskać informacje o ograniczeniach SOQL, zobacz ten artykuł. Jeśli zapytanie nie zostanie określone, zostaną pobrane wszystkie dane obiektu Salesforce określone w parametrze "objectApiName/reportId" w zestawie danych.	Nie (jeśli określono parametr "objectApiName/reportId" w zestawie danych)
includeDeletedObjects	Wskazuje, czy należy wykonywać zapytania dotyczące istniejących rekordów, czy wykonywać zapytania dotyczące wszystkich rekordów, w tym usuniętych rekordów. Jeśli nie zostanie określony, domyślne zachowanie to false. Dozwolone wartości: false (wartość domyślna), true.	Nie.

Ważne

Część "__c" nazwy interfejsu API jest wymagana dla dowolnego obiektu niestandardowego.

Lista nazw interfejsu API połączeń usługi Salesforce

Przykład:

"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 jako typ ujścia

Aby skopiować dane do usługi Salesforce Service Cloud, ustaw typ ujścia w działaniu kopiowania na SalesforceServiceCloudV2Sink. Poniższe właściwości są obsługiwane w sekcji ujścia działania kopiowania.

Właściwości	Opis	Wymagania
type	Właściwość type ujścia działania kopiowania musi być ustawiona na SalesforceServiceCloudV2Sink.	Tak
writeBehavior	Zachowanie zapisu dla operacji. Dozwolone wartości to Insert i Upsert.	Nie (wartość domyślna to Wstaw)
externalIdFieldName	Nazwa pola identyfikatora zewnętrznego dla operacji upsert. Określone pole musi być zdefiniowane jako "Pole identyfikatora zewnętrznego" w obiekcie Salesforce Service Cloud. Nie może mieć wartości NULL w odpowiednich danych wejściowych.	Tak dla "Upsert"
writeBatchSize	Liczba wierszy zapisanych w usłudze Salesforce Service Cloud w każdej partii. Zasugeruj ustawienie tej wartości z zakresu od 10 000 do 200 000. Zbyt mało wierszy w każdej partii zmniejszy wydajność kopiowania. Zbyt wiele wierszy w każdej partii może spowodować przekroczenie limitu czasu interfejsu API.	Nie (wartość domyślna to 100 000)
ignoreNullValues	Wskazuje, czy podczas operacji zapisu mają być ignorowane wartości NULL z danych wejściowych. Dozwolone wartości to true i false. - Prawda: pozostaw dane w obiekcie docelowym bez zmian podczas wykonywania operacji upsert lub update. Wstaw zdefiniowaną wartość domyślną podczas wykonywania operacji wstawiania. - Fałsz: Zaktualizuj dane w obiekcie docelowym na wartość NULL podczas wykonywania operacji upsert lub update. Wstaw wartość NULL podczas wykonywania operacji wstawiania.	Nie (wartość domyślna to false)
maxConcurrentConnections	Górny limit połączeń współbieżnych ustanowionych z magazynem danych podczas uruchamiania działania. Określ wartość tylko wtedy, gdy chcesz ograniczyć połączenia współbieżne.	Nie

Przykład: ujście usługi Salesforce Service w chmurze w działaniu kopiowania

"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
            }
        }
    }
]

Mapowanie typów danych dla usługi Salesforce Service Cloud

Podczas kopiowania danych z usługi Salesforce Service Cloud następujące mapowania są używane z typów danych usługi Salesforce Service w chmurze do tymczasowych typów danych w ramach usługi wewnętrznie. Aby dowiedzieć się, jak działanie kopiowania mapuje schemat źródłowy i typ danych na ujście, zobacz Mapowania schematu i typu danych.

Typ danych usługi Salesforce Service w chmurze	Typ danych tymczasowych usługi
Automatyczny numer	String
Pole wyboru	Wartość logiczna
Waluta	Dziesiętne
Date	DateTime
Data/godzina	DateTime
Email	String
IDENTYFIKATOR	String
Relacja odnośnika	String
Lista wyboru wielokrotnego wyboru	String
Liczba	Dziesiętny
Procent	Dziesiętne
Phone	String
Picklist	String
Tekst	String
Obszar tekstu	String
Obszar tekstu (długi)	String
Obszar tekstu (sformatowany)	String
Tekst (zaszyfrowany)	String
URL	String

Uwaga

Typ numeru chmury usługi Salesforce jest mapowana na typ dziesiętny w potokach usługi Azure Data Factory i Azure Synapse jako typ danych tymczasowych usługi. Typ dziesiętny honoruje zdefiniowaną precyzję i skalę. W przypadku danych, których miejsca dziesiętne przekraczają zdefiniowaną skalę, jego wartość zostanie zaokrąglona w danych podglądu i skopiowaniu. Aby uniknąć utraty dokładności w potokach usługi Azure Data Factory i Azure Synapse, rozważ zwiększenie liczby miejsc dziesiętnych do dość dużej wartości na stronie Edycja definicji pola niestandardowego w chmurze usługi Salesforce Service.

Właściwości działania wyszukiwania

Aby dowiedzieć się więcej o właściwościach, sprawdź działanie Wyszukiwania.

Uaktualnianie połączonej usługi Salesforce Service w chmurze

Poniżej przedstawiono kroki ułatwiające uaktualnienie połączonej usługi i powiązanych zapytań:

Skonfiguruj połączone aplikacje w portalu usługi Salesforce, korzystając z sekcji Wymagania wstępne.
Utwórz nową połączoną usługę Salesforce Service w chmurze i skonfiguruj ją, odwołując się do właściwości połączonej usługi.
Jeśli używasz zapytania SQL w źródle działania kopiowania lub działania wyszukiwania odwołującego się do starszej połączonej usługi, musisz przekonwertować je na zapytanie SOQL. Dowiedz się więcej o zapytaniu SOQL z usługi Salesforce Service Cloud jako typu źródłowego i języka zapytań SOQL (Salesforce Object Query Language).
element readBehavior jest zastępowany elementem includeDeletedObjects w źródle działania kopiowania lub działaniem wyszukiwania. Aby uzyskać szczegółową konfigurację, zobacz Salesforce Service Cloud jako typ źródła.

Różnice między usługą Salesforce Service Cloud i usługą Salesforce Service Cloud (starsza wersja)

Łącznik Salesforce Service Cloud oferuje nowe funkcje i jest zgodny z większością funkcji łącznika Salesforce Service Cloud (starsza wersja). W poniższej tabeli przedstawiono różnice funkcji między usługą Salesforce Service Cloud i usługą Salesforce Service Cloud (starsza wersja).

Salesforce Service Cloud	Salesforce Service Cloud (starsza wersja)
Obsługa protokołu SOQL w interfejsie API zbiorczym usługi Salesforce w wersji 2.0. W przypadku zapytań SOQL: • Klauzule GROUP BY, LIMIT, ORDER BY, OFFSET lub TYPEOF nie są obsługiwane. • Funkcje agregujące, takie jak COUNT() nie są obsługiwane, można użyć raportów usługi Salesforce do ich zaimplementowania. • Funkcje daty w klauzulach GROUP BY nie są obsługiwane, ale są obsługiwane w klauzuli WHERE. • Pola adresów złożonych lub złożone pola geolokalizacji nie są obsługiwane. Alternatywnie wykonaj zapytanie dotyczące poszczególnych składników pól złożonych. • Zapytania relacji nadrzędny-podrzędny nie są obsługiwane, natomiast obsługiwane są zapytania relacji podrzędnych-nadrzędnych.	Obsługa składni SQL i SOQL.
Obiekty zawierające pola binarne nie są obsługiwane podczas określania zapytania.	Obiekty zawierające pola binarne są obsługiwane podczas określania zapytania.
Obsługa obiektów w interfejsie API zbiorczym podczas określania zapytania.	Obsługa obiektów, które nie są obsługiwane za pomocą interfejsu API zbiorczego podczas określania zapytania.
Raport pomocy technicznej, wybierając identyfikator raportu.	Obsługa składni zapytań raportu, takich jak `{call "<report name>"}`.

Aby uzyskać listę magazynów danych obsługiwanych jako źródła i ujścia działania kopiowania, zobacz Obsługiwane magazyny danych.

Udostępnij za pośrednictwem

Kopiowanie danych z i do usługi Salesforce Service Cloud przy użyciu usługi Azure Data Factory lub Azure Synapse Analytics

Obsługiwane możliwości

Wymagania wstępne

Limity interfejsu API zbiorczego usługi Salesforce 2.0

Rozpocznij

Tworzenie połączonej usługi z usługą Salesforce Service Cloud przy użyciu interfejsu użytkownika

Szczegóły konfiguracji łącznika

Właściwości połączonej usługi

Właściwości zestawu danych

Właściwości działania kopiowania

Salesforce Service Cloud jako typ źródła

Salesforce Service Cloud jako typ ujścia

Mapowanie typów danych dla usługi Salesforce Service Cloud

Właściwości działania wyszukiwania

Uaktualnianie połączonej usługi Salesforce Service w chmurze

Różnice między usługą Salesforce Service Cloud i usługą Salesforce Service Cloud (starsza wersja)

Opinia

Dodatkowe zasoby

Udostępnij za pośrednictwem

Kopiowanie danych z i do usługi Salesforce Service Cloud przy użyciu usługi Azure Data Factory lub Azure Synapse Analytics

Obsługiwane możliwości

Wymagania wstępne

Limity interfejsu API zbiorczego usługi Salesforce 2.0

Rozpocznij

Tworzenie połączonej usługi z usługą Salesforce Service Cloud przy użyciu interfejsu użytkownika

Szczegóły konfiguracji łącznika

Właściwości połączonej usługi

Właściwości zestawu danych

Właściwości działania kopiowania

Salesforce Service Cloud jako typ źródła

Salesforce Service Cloud jako typ ujścia

Mapowanie typów danych dla usługi Salesforce Service Cloud

Właściwości działania wyszukiwania

Uaktualnianie połączonej usługi Salesforce Service w chmurze

Różnice między usługą Salesforce Service Cloud i usługą Salesforce Service Cloud (starsza wersja)

Powiązana zawartość

Opinia

Dodatkowe zasoby