Konfigurowanie usługi Salesforce w działaniu kopiowania
W tym artykule opisano sposób używania działania kopiowania w potoku danych do kopiowania danych z i do usługi Salesforce.
Obsługiwana konfiguracja
W przypadku konfiguracji każdej karty w działaniu kopiowania przejdź odpowiednio do poniższych sekcji.
Ogólne
Zapoznaj się ze wskazówkami dotyczącymi ustawień ogólnych, aby skonfigurować kartę Ustawienia ogólne.
Źródło
Następujące właściwości są obsługiwane dla usługi Salesforce na karcie Źródło działania kopiowania.
Wymagane są następujące właściwości:
- Połączenie: wybierz połączenie usługi Salesforce z listy połączeń. Jeśli połączenie nie istnieje, utwórz nowe połączenie usługi Salesforce, wybierając pozycję Nowy.
- Użyj zapytania: wybierz z poziomu interfejsu API obiektów, raportu lub zapytania SOQL.
W przypadku wybrania interfejsu API obiektów:
- Interfejs API obiektów: określ nazwę obiektu salesforce, z których mają być pobierane dane. Wybierz nazwę z listy rozwijanej.
W przypadku wybrania pozycji Raport:
Identyfikator raportu: określ identyfikator raportu usługi Salesforce do pobrania danych. Nie jest obsługiwany w miejscu docelowym. Istnieją ograniczenia dotyczące korzystania z raportów.
Jeśli wybierzesz zapytanie SOQL:
Zapytanie SOQL: użyj zapytania niestandardowego, aby odczytać dane. Zapytania SOQL (Salesforce Object Query Language) można używać tylko z ograniczeniami Understanding Bulk API 2.0 Query (Omówienie zapytania interfejsu API zbiorczego 2.0). Jeśli nie określisz zapytania SOQL, zostaną pobrane wszystkie dane obiektu Salesforce określonego w interfejsie API obiektów lub identyfikatorze raportu.
W obszarze Zaawansowane można określić następujące pola:
- Uwzględnij usunięte obiekty: określ, czy chcesz wykonywać zapytania dotyczące istniejących rekordów (niezaznaczone) lub wykonywać zapytania dotyczące wszystkich rekordów, w tym usuniętych (wybranych).
- Dodatkowe kolumny: Dodaj dodatkowe kolumny danych, aby przechowywać ścieżkę względną plików źródłowych lub wartość statyczną. Wyrażenie jest obsługiwane w przypadku tych ostatnich.
Element docelowy
Następujące właściwości są obsługiwane dla usługi Salesforce na karcie Miejsce docelowe działania kopiowania.
Wymagane są następujące właściwości:
- Połączenie: wybierz połączenie usługi Salesforce z listy połączeń. Jeśli połączenie nie istnieje, utwórz nowe połączenie usługi Salesforce, wybierając pozycję Nowy.
- Interfejs API obiektów: określ nazwę obiektu salesforce, do których mają być zapisywane dane. Wybierz nazwę z listy rozwijanej.
W obszarze Zaawansowane można określić następujące pola:
Zachowanie zapisu: określ zachowanie zapisu dla operacji. Dozwolone wartości to Insert i Upsert. Możesz wybrać zachowanie z listy rozwijanej.
W przypadku wybrania opcji Upsert:
Pole identyfikatora zewnętrznego: nazwa pola identyfikatora zewnętrznego dla operacji upsert. Określone pole musi być zdefiniowane jako pole identyfikatora zewnętrznego w obiekcie Salesforce. Nie może mieć wartości NULL w odpowiednich danych wejściowych.
Ignoruj wartości null: określ, czy podczas operacji zapisu mają być ignorowane wartości NULL z danych wejściowych.
- Po wybraniu: pozostaw dane w obiekcie docelowym bez zmian podczas wykonywania operacji upsert lub update. Wstaw zdefiniowaną wartość domyślną podczas wykonywania operacji wstawiania.
- Gdy jest on niezaznaczony: zaktualizuj dane w obiekcie docelowym na wartość NULL, gdy wykonujesz operację upsert lub aktualizuj. Wstaw wartość NULL podczas wykonywania operacji wstawiania.
Rozmiar partii zapisu: określ liczbę wierszy zapisanych w usłudze Salesforce 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 zmniejsza wydajność kopiowania. Zbyt wiele wierszy w każdej partii może spowodować przekroczenie limitu czasu interfejsu API.
Maksymalna liczba połączeń współbieżnych: 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.
Mapowanie
Aby uzyskać informacje o konfiguracji karty Mapowanie , zobacz Konfigurowanie mapowań na karcie mapowania.
Ustawienia
W obszarze Konfiguracja karty Ustawienia przejdź do sekcji Konfigurowanie innych ustawień na karcie ustawienia.
Podsumowanie tabeli
Poniższe tabele zawierają więcej informacji o działaniu kopiowania w usłudze Salesforce.
Informacje źródłowe
Nazwa/nazwisko | Opis | Wartość | Wymagania | Właściwość skryptu JSON |
---|---|---|---|---|
Połączenie | Połączenie ze źródłowym magazynem danych. | <połączenie usługi Salesforce> | Tak | połączenie |
Connection type (Typ połączenia) | Typ połączenia. Wybierz pozycję Obiekty usługi Salesforce. | SalesforceObject | Tak | / |
Korzystanie z zapytania | Sposób odczytywania danych z usługi Salesforce. | • Interfejs API obiektów • Raport • Zapytanie SOQL |
Tak | / |
Dla interfejsu API obiektów | ||||
Interfejs API obiektów | Określ nazwę obiektu salesforce, z których mają być pobierane dane. | < nazwa obiektu > | Tak | objectApiName |
W przypadku raportu | ||||
Identyfikator raportu | Identyfikator raportu usługi Salesforce do pobrania danych. Nie jest obsługiwany w miejscu docelowym. Istnieją ograniczenia dotyczące korzystania z raportów. | <identyfikator raportu> | Tak | reportId |
Dla zapytania SOQL | ||||
Zapytanie SOQL | Użyj zapytania niestandardowego, aby odczytać dane. Zapytania SOQL (Salesforce Object Query Language) można używać tylko z ograniczeniami Understanding Bulk API 2.0 Query (Omówienie zapytania interfejsu API zbiorczego 2.0). Jeśli nie określisz zapytania SOQL, zostaną pobrane wszystkie dane obiektu Salesforce określonego w interfejsie API obiektów lub identyfikatorze raportu. | < zapytanie SOQL > | Tak | zapytanie |
Dołączanie usuniętych obiektów | 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. | wybrane lub niezaznaczone (ustawienie domyślne) | Nie. | includeDeletedObjects: true lub false (wartość domyślna) |
Dodatkowe kolumny | Dodaj dodatkowe kolumny danych, aby przechowywać ścieżkę względną plików źródłowych lub wartość statyczną. Wyrażenie jest obsługiwane w przypadku tych ostatnich. | • Nazwa •Wartość |
Nie. | additionalColumns: •nazwa •wartość |
Informacje o lokalizacji docelowej
Nazwa/nazwisko | Opis | Wartość | Wymagania | Właściwość skryptu JSON |
---|---|---|---|---|
Połączenie | Połączenie z docelowym magazynem danych. | <połączenie usługi Salesforce> | Tak | połączenie |
Interfejs API obiektów | Określ nazwę obiektu salesforce, do których mają być zapisywane dane. | < nazwa obiektu > | Tak | objectApiName |
Zachowanie zapisu | Zachowanie zapisu dla operacji. Dozwolone wartości to Insert i Upsert. Możesz wybrać zachowanie z listy rozwijanej. | •Wstawiać • Upsert |
Nie (wartość domyślna to Wstaw) | writeBehavior: insert upsert |
Pole identyfikatora zewnętrznego | Nazwa pola identyfikatora zewnętrznego dla operacji upsert. Określone pole musi być zdefiniowane jako pole identyfikatora zewnętrznego w obiekcie Salesforce. Nie może mieć wartości NULL w odpowiednich danych wejściowych. | < pole identyfikatora zewnętrznego > | Tak dla "Upsert" | externalIdFieldName |
Ignoruj wartości null | Wskazuje, czy podczas operacji zapisu mają być ignorowane wartości NULL z danych wejściowych. | wybrane lub niezaznaczone (ustawienie domyślne) | Nie. | ignoreNullValues: true lub false (wartość domyślna) |
Rozmiar partii zapisu | Liczba wierszy zapisanych w usłudze Salesforce 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 zmniejsza wydajność kopiowania. Zbyt wiele wierszy w każdej partii może spowodować przekroczenie limitu czasu interfejsu API. | <liczba wierszy> (liczba całkowita) |
Nie (wartość domyślna to 100 000) | writeBatchSize |
Maksymalna liczba połączeń współbieżnych | 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. | <maksymalna liczba połączeń współbieżnych> | Nie. | maxConcurrentConnections |
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, wystąpią 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 deweloperów usługi Salesforce.