Konfigurace Salesforce v aktivitě kopírování
Tento článek popisuje, jak pomocí aktivity kopírování v datovém kanálu kopírovat data z a do Salesforce.
Podporovaná konfigurace
Konfigurace každé karty v aktivitě kopírování najdete v následujících částech.
OBECNÉ
Informace o konfiguraci karty Obecné nastavení najdete v doprovodných materiálech k obecným nastavením.
Zdroj
Pro Salesforce na kartě Zdroj aktivity kopírování jsou podporovány následující vlastnosti.
Jsou vyžadovány následující vlastnosti:
- Připojení: Ze seznamu připojení vyberte připojení Salesforce. Pokud žádné připojení neexistuje, vytvořte nové připojení Salesforce výběrem možnosti Nový.
- Použít dotaz: Vyberte z rozhraní API objektu, sestavy nebo dotazu SOQL.
Pokud vyberete rozhraní API objektu:
- Rozhraní API objektu: Zadejte název objektu Salesforce, ze které se mají načítat data. V rozevíracím seznamu vyberte název.
Pokud vyberete Možnost Sestava:
ID sestavy: Zadejte ID sestavy Salesforce, ze které se mají načítat data. V cíli se nepodporuje. Při používání sestav existují omezení .
Pokud vyberete dotaz SOQL:
Dotaz SOQL: Ke čtení dat použijte vlastní dotaz. Dotaz salesforce Object Query Language (SOQL) můžete používat pouze s omezeními Principy hromadného dotazu API 2.0. Pokud nezadáte dotaz SOQL, načtou se všechna data objektu Salesforce zadaného v rozhraní API objektu nebo ID sestavy.
V části Upřesnit můžete zadat následující pole:
- Zahrnout odstraněné objekty: Určete, zda se má dotazovat na existující záznamy (nevybrané), nebo dotazovat všechny záznamy včetně odstraněných (vybraných).
- Další sloupce: Přidejte další datové sloupce pro ukládání relativní cesty nebo statické hodnoty zdrojových souborů. U druhého výrazu se podporuje.
Cíl
Pro Salesforce na kartě Cíl aktivity kopírování se podporují následující vlastnosti.
Jsou vyžadovány následující vlastnosti:
- Připojení: Ze seznamu připojení vyberte připojení Salesforce. Pokud žádné připojení neexistuje, vytvořte nové připojení Salesforce výběrem možnosti Nový.
- Rozhraní API objektu: Zadejte název objektu Salesforce pro zápis dat do. V rozevíracím seznamu vyberte název.
V části Upřesnit můžete zadat následující pole:
Chování zápisu: Zadejte chování zápisu pro operaci. Povolené hodnoty jsou Insert a Upsert. V rozevíracím seznamu můžete zvolit chování.
Pokud vyberete možnost Upsert:
Pole Externí ID: Název pole externího ID pro operaci upsertu. Zadané pole musí být definováno jako pole externího ID v objektu Salesforce. V odpovídajících vstupních datech nemůže mít hodnoty NULL.
Ignorovat hodnoty null: Určete, zda se mají ignorovat hodnoty NULL ze vstupních dat během operace zápisu.
- Je-li vybrána: Při operaci upsertu nebo aktualizace ponechte data v cílovém objektu beze změny. Při operaci vložení vložte definovanou výchozí hodnotu.
- Pokud není vybrána: Při provedení operace upsert nebo aktualizace aktualizujte data v cílovém objektu na hodnotu NULL. Pokud provedete operaci vložení, vložte hodnotu NULL.
Velikost dávky zápisu: Zadejte počet řádků dat zapsaných do Salesforce v každé dávce. Nastavte tuto hodnotu od 10 000 do 200 000. Příliš málo řádků v každé dávce snižuje výkon kopírování. Příliš mnoho řádků v každé dávce může způsobit vypršení časového limitu rozhraní API.
Maximální počet souběžných připojení: Horní limit souběžných připojení vytvořených k úložišti dat během spuštění aktivity. Zadejte hodnotu pouze v případech, kdy chcete omezit souběžná připojení.
mapování.
Konfigurace karty Mapování naleznete v části Konfigurace mapování na kartě mapování.
Nastavení
V části Konfigurace karty Nastavení přejděte na Konfigurovat další nastavení na kartě Nastavení.
Souhrn tabulky
Následující tabulky obsahují další informace o aktivitě kopírování v Salesforce.
Informace o zdroji
| Název | Popis | Hodnota | Požaduje se | Vlastnost skriptu JSON |
|---|---|---|---|---|
| Připojení | Vaše připojení ke zdrojovému úložišti dat. | <připojení Salesforce> | Ano | připojení |
| Typ připojení: | Typ připojení. Vyberte objekty Salesforce. | SalesforceObject | Ano | / |
| Použití dotazu | Způsob čtení dat ze Salesforce. | • Rozhraní API pro objekty • Sestava • Dotaz SOQL |
Ano | / |
| Pro rozhraní API objektu | ||||
| Rozhraní API pro objekty | Zadejte název objektu Salesforce, ze které chcete načíst data. | < název objektu > | Ano | objectApiName |
| Sestava | ||||
| ID sestavy | ID sestavy Salesforce pro načtení dat. V cíli se nepodporuje. Při používání sestav existují omezení . | <ID sestavy> | Ano | reportId |
| Dotaz SOQL | ||||
| Dotaz SOQL | Ke čtení dat použijte vlastní dotaz. Dotaz salesforce Object Query Language (SOQL) můžete používat pouze s omezeními Principy hromadného dotazu API 2.0. Pokud nezadáte dotaz SOQL, načtou se všechna data objektu Salesforce zadaného v rozhraní API objektu nebo ID sestavy. | < dotaz SOQL > | Ano | query |
| Zahrnout odstraněné objekty | Označuje, zda se má dotazovat na existující záznamy, nebo dotazovat všechny záznamy včetně odstraněných záznamů. | vybraná nebo nevybraná (výchozí) | No | includeDeletedObjects: true nebo false (výchozí) |
| Další sloupce | Přidejte další datové sloupce pro ukládání relativní cesty ke zdrojovým souborům nebo statické hodnotě. U druhého výrazu se podporuje. | • Jméno •Hodnota |
No | additionalColumns: •Jméno •hodnota |
Informace o cíli
| Název | Popis | Hodnota | Požaduje se | Vlastnost skriptu JSON |
|---|---|---|---|---|
| Připojení | Vaše připojení k cílovému úložišti dat. | <připojení Salesforce> | Ano | připojení |
| Rozhraní API pro objekty | Zadejte název objektu Salesforce pro zápis dat do. | < název objektu > | Ano | objectApiName |
| Chování zápisu | Chování zápisu operace. Povolené hodnoty jsou Insert a Upsert. V rozevíracím seznamu můžete zvolit chování. | •Vložit • Upsert |
Ne (výchozí hodnota je Vložit) | writeBehavior: insert upsert |
| Pole Externí ID | Název pole externího ID pro operaci upsertu. Zadané pole musí být definováno jako pole externího ID v objektu Salesforce. V odpovídajících vstupních datech nemůže mít hodnoty NULL. | < pole vašeho externího ID > | Ano pro upsert | externalIdFieldName |
| Ignorovat hodnoty null | Určuje, zda se mají ignorovat hodnoty NULL ze vstupních dat během operace zápisu. | vybraná nebo nevybraná (výchozí) | No | ignoreNullValues: true nebo false (výchozí) |
| Velikost dávky zápisu | Počet řádků dat zapsaných do Salesforce v každé dávce. Nastavte tuto hodnotu od 10 000 do 200 000. Příliš málo řádků v každé dávce snižuje výkon kopírování. Příliš mnoho řádků v každé dávce může způsobit vypršení časového limitu rozhraní API. | <počet řádků> (celé číslo) |
Ne (výchozí hodnota je 100 000) | writeBatchSize |
| Maximální počet souběžných připojení | Horní limit souběžných připojení vytvořených k úložišti dat během spuštění aktivity. Zadejte hodnotu pouze v případech, kdy chcete omezit souběžná připojení. | <maximální počet souběžných připojení> | No | maxConcurrentConnections |
Omezení rozhraní Bulk API salesforce 2.0
K dotazování a ingestování dat používáme Salesforce Bulk API 2.0. V rozhraní Bulk API 2.0 se dávky vytvoří automaticky. Můžete odeslat až 15 000 dávek za 24hodinovou dobu. Pokud dávky překročí limit, dojde k selháním.
V rozhraní Bulk API 2.0 spotřebovávají dávky pouze úlohy ingestování. Úlohy dotazů se netýknou. Podrobnosti najdete v tématu Zpracování požadavků v Průvodci pro vývojáře hromadným rozhraním API 2.0.
Další informace najdete v části Obecné limity v omezeních pro vývojáře Salesforce.