Salesforce'ı kopyalama etkinliğinde yapılandırma
Bu makalede, Salesforce'tan ve Salesforce'a veri kopyalamak için veri işlem hattındaki kopyalama etkinliğinin nasıl kullanılacağı özetlenmiştir.
Desteklenen yapılandırma
Kopyalama etkinliği altındaki her sekmenin yapılandırması için sırasıyla aşağıdaki bölümlere gidin.
Genel
Genel ayarlar sekmesini yapılandırmak için Genel ayarlar kılavuzuna bakın.
Kaynak
Aşağıdaki özellikler salesforce için bir kopyalama etkinliğinin Kaynak sekmesinde desteklenir.
Aşağıdaki özellikler gereklidir:
- Bağlantı: Bağlantı listesinden bir Salesforce bağlantısı seçin. Bağlantı yoksa Yeni'yi seçerek yeni bir Salesforce bağlantısı oluşturun.
- Sorguyu kullan: Nesne API'sinden, Rapordan veya SOQL Sorgusundan seçim yapın.
Nesne API'si'yi seçerseniz:
- Nesne API'si: Veri alınacak Salesforce nesne adını belirtin. Açılan listeden adı seçin.
Rapor'ı seçerseniz:
Rapor Kimliği: Veri alınacak Salesforce raporunun kimliğini belirtin. Hedefte desteklenmez. Raporları kullanırken sınırlamalar vardır.
SOQL Sorgusu'yu seçerseniz:
SOQL Sorgusu: Verileri okumak için özel sorguyu kullanın. Salesforce Nesne Sorgu Dili (SOQL) sorgusunu yalnızca Toplu API 2.0 Sorgusunu Anlama sınırlamalarıyla kullanabilirsiniz. SOQL sorgusu belirtmezseniz, Nesne API'sinde veya Rapor Kimliği'nde belirtilen Salesforce nesnesinin tüm verileri alınır.
Gelişmiş'in altında aşağıdaki alanları belirtebilirsiniz:
- Silinen nesneleri dahil et: Var olan kayıtların (seçilmemiş) sorgulanıp sorgulanmayacağını veya silinenler (seçili) dahil olmak üzere tüm kayıtların sorgulanıp sorgulanmayacağını belirtin.
- Ek sütunlar: Kaynak dosyaların göreli yolunu veya statik değerini depolamak için ek veri sütunları ekleyin. İfade, ikincisi için desteklenir.
Hedef
Kopyalama etkinliğinin Hedef sekmesi altında Salesforce için aşağıdaki özellikler desteklenir.
Aşağıdaki özellikler gereklidir:
- Bağlantı: Bağlantı listesinden bir Salesforce bağlantısı seçin. Bağlantı yoksa Yeni'yi seçerek yeni bir Salesforce bağlantısı oluşturun.
- Nesne API'si: Veri yazılacak Salesforce nesne adını belirtin. Açılan listeden adı seçin.
Gelişmiş'in altında aşağıdaki alanları belirtebilirsiniz:
Yazma davranışı: İşlem için yazma davranışını belirtin. İzin verilen değerler Insert ve Upsert değerleridir. Açılan listeden bir davranış seçebilirsiniz.
Yukarı Ekle'yi seçerseniz:
Dış Kimlik alanı: Upsert işleminin dış kimlik alanının adı. Belirtilen alan Salesforce nesnesinde Dış Kimlik Alanı olarak tanımlanmalıdır. Karşılık gelen giriş verilerinde NULL değerleri olamaz.
Null değerleri yoksay: Yazma işlemi sırasında giriş verilerindeki NULL değerlerin yoksayılıp yoksayılmayacağını belirtin.
- Seçildiğinde: Bir upsert veya update işlemi yaptığınızda hedef nesnedeki verileri değiştirmeden bırakın. Ekleme işlemi yaparken tanımlı bir varsayılan değer ekleyin.
- Seçilmediğinde: Bir upsert veya update işlemi yaptığınızda hedef nesnedeki verileri NULL olarak güncelleştirin. Ekleme işlemi yaparken NULL değer ekleyin.
Toplu iş boyutu yazma: Her toplu işlemde Salesforce'a yazılan verilerin satır sayısını belirtin. Öneri bu değeri 10.000'den 200.000'e ayarlayın. Her toplu işlemde çok az satır kopyalama performansını azaltır. Her toplu işlemde çok fazla satır api zaman aşımına neden olabilir.
En fazla eşzamanlı bağlantı: Etkinlik çalıştırması sırasında veri deposuna kurulan eş zamanlı bağlantıların üst sınırı. Yalnızca eşzamanlı bağlantıları sınırlamak istediğinizde bir değer belirtin.
Eşleme
Eşleme sekmesi yapılandırması için bkz. Eşleme sekmesinin altında eşlemelerinizi yapılandırma.
Ayarlar
Ayarlar sekmesi yapılandırması için Ayarlar sekmesinin altındaki Diğer ayarlarınızı yapılandırma'ya gidin.
Tablo özeti
Aşağıdaki tablolar Salesforce'taki kopyalama etkinliği hakkında daha fazla bilgi içerir.
Kaynak bilgileri
| Veri Akışı Adı | Açıklama | Değer | Zorunlu | JSON betik özelliği |
|---|---|---|---|---|
| Bağlantı | Kaynak veri deposuyla bağlantınız. | <Salesforce bağlantınız> | Yes | bağlantı |
| Bağlantı türü | Bağlantı türünüz. Salesforce nesneleri'ne tıklayın. | SalesforceObject | Yes | / |
| Sorguyu kullanma | Salesforce'tan veri okuma yolu. | • Nesne API'si • Rapor • SOQL Sorgusu |
Yes | / |
| Nesne API'si için | ||||
| Nesne API'si | Veri alınacak Salesforce nesne adını belirtin. | < nesnenizin adı > | Yes | objectApiName |
| Rapor için | ||||
| Rapor Kimliği | Verileri almak için Salesforce raporunun kimliği. Hedefte desteklenmez. Raporları kullanırken sınırlamalar vardır. | <rapor kimliğiniz> | Yes | reportId |
| SOQL Sorgusu için | ||||
| SOQL Sorgusu | Verileri okumak için özel sorguyu kullanın. Salesforce Nesne Sorgu Dili (SOQL) sorgusunu yalnızca Toplu API 2.0 Sorgusunu Anlama sınırlamalarıyla kullanabilirsiniz. SOQL sorgusu belirtmezseniz, Nesne API'sinde veya Rapor Kimliği'nde belirtilen Salesforce nesnesinin tüm verileri alınır. | < SOQL sorgunuz > | Yes | query |
| Silinen nesneleri dahil et | Var olan kayıtların mı yoksa silinenler de dahil olmak üzere tüm kayıtların mı sorgulanıp sorgulanmayacağını gösterir. | seçili veya seçilmemiş (varsayılan) | Hayır | includeDeletedObjects: true veya false (varsayılan) |
| Ek sütunlar | Kaynak dosyaların göreli yolunu veya statik değerini depolamak için ek veri sütunları ekleyin. İfade, ikincisi için desteklenir. | • Adı •Değer |
Hayır | additionalColumns: •ad •değer |
Hedef bilgileri
| Veri Akışı Adı | Açıklama | Değer | Zorunlu | JSON betik özelliği |
|---|---|---|---|---|
| Bağlantı | Hedef veri deposuna bağlantınız. | <Salesforce bağlantınız> | Yes | bağlantı |
| Nesne API'si | Veri yazılacak Salesforce nesne adını belirtin. | < nesnenizin adı > | Yes | objectApiName |
| Yazma davranışı | İşlemin yazma davranışı. İzin verilen değerler Insert ve Upsert değerleridir. Açılan listeden bir davranış seçebilirsiniz. | •Sokmak • Upsert |
Hayır (varsayılan değer Ekle'dir) | writeBehavior: insert upsert |
| Dış Kimlik alanı | Upsert işleminin dış kimlik alanının adı. Belirtilen alan Salesforce nesnesinde Dış Kimlik Alanı olarak tanımlanmalıdır. Karşılık gelen giriş verilerinde NULL değerleri olamaz. | < dış kimlik alanınız > | "Upsert" için Evet | externalIdFieldName |
| Null değerleri yoksay | Yazma işlemi sırasında giriş verilerinden NULL değerlerin yoksayılıp yoksayılmayacağını gösterir. | seçili veya seçilmemiş (varsayılan) | Hayır | ignoreNullValues: true veya false (varsayılan) |
| Toplu iş boyutu yazma | Her toplu işlemde Salesforce'a yazılan verilerin satır sayısı. Öneri bu değeri 10.000'den 200.000'e ayarlayın. Her toplu işlemde çok az satır kopyalama performansını azaltır. Her toplu işlemde çok fazla satır api zaman aşımına neden olabilir. | <satır sayısı> (tamsayı) |
Hayır (varsayılan değer 100.000'dir) | writeBatchSize |
| En fazla eşzamanlı bağlantı | Etkinlik çalıştırması sırasında veri deposuna kurulan eş zamanlı bağlantıların üst sınırı. Yalnızca eşzamanlı bağlantıları sınırlamak istediğinizde bir değer belirtin. | <en fazla eşzamanlı bağlantı> | Hayır | maxConcurrentConnections |
Salesforce Toplu API 2.0 Sınırları
Verileri sorgulamak ve almak için Salesforce Bulk API 2.0'ı kullanırız. Toplu API 2.0'da toplu işlemler sizin için otomatik olarak oluşturulur. Sıralı 24 saatlik dönem başına en fazla 15.000 toplu işlem gönderebilirsiniz. Toplu işlemler sınırı aşarsa hatalarla karşılaşırsınız.
Toplu API 2.0'da yalnızca alma işleri toplu işleri kullanır. Sorgu işleri bunu yapamaz. Ayrıntılar için Bkz . Toplu API 2.0 Geliştirici Kılavuzu'nda İsteklerin İşlenme Şekli.
Daha fazla bilgi için Salesforce geliştirici sınırları bölümündeki Genel Sınırlar bölümüne bakın.