Aracılığıyla paylaş


Azure Data Factory veya Azure Synapse Analytics kullanarak Salesforce Service Cloud'dan ve buluta veri kopyalama

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

İpucu

Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!

Bu makalede Azure Data Factory ve Azure Synapse işlem hatlarında Salesforce Service Cloud'dan ve buluta veri kopyalamak için Kopyalama Etkinliği'nin nasıl kullanılacağı özetlenmiştir. Kopyalama etkinliğine genel bir genel bakış sunan Kopyalama Etkinliğine genel bakış makalesini oluşturur.

Önemli

Yeni Salesforce Service Cloud bağlayıcısı geliştirilmiş yerel Salesforce Service Cloud desteği sağlar. Çözümünüzde eski Salesforce Service Cloud bağlayıcısını kullanıyorsanız lütfen Salesforce Service Cloud bağlayıcınızı 11 Ekim 2024'e kadar yükseltin. Eski ve en son sürüm arasındaki fark hakkında ayrıntılı bilgi için bu bölüme bakın.

Desteklenen özellikler

Bu Salesforce Service Cloud bağlayıcısı aşağıdaki özellikler için desteklenir:

Desteklenen özellikler IR
Kopyalama etkinliği (kaynak/havuz) (1) (2)
Arama etkinliği (1) (2)

(1) Azure tümleştirme çalışma zamanı (2) Şirket içinde barındırılan tümleştirme çalışma zamanı

Kaynak veya havuz olarak desteklenen veri depolarının listesi için Desteklenen veri depoları tablosuna bakın.

Özellikle, bu Salesforce Service Cloud bağlayıcısı şunları destekler:

  • Salesforce Developer, Professional, Enterprise veya Unlimited sürümleri.
  • özel etki alanından ve etki alanına veri kopyalama (Özel etki alanı hem üretim hem de korumalı alan ortamlarında yapılandırılabilir).

Bağlı hizmetteki özellik aracılığıyla apiVersion verileri okumak/yazmak için kullanılan API sürümünü açıkça ayarlayabilirsiniz. Verileri Salesforce Service Cloud'a kopyalarken bağlayıcı BULK API 2.0 kullanır.

Önkoşullar

  • API izni Salesforce'ta etkinleştirilmelidir.

  • Bu resmi belgeyi veya bu makaledeki önerideki adım adım kılavuzumuzu kullanarak Salesforce portalında Bağlı Uygulamaları yapılandırmanız gerekir.

    Önemli

    • Yürütme kullanıcısının Yalnızca API izni olmalıdır.
    • Erişim Belirteci'nin süresi, yenileme belirteci yerine oturum ilkeleri aracılığıyla değiştirilebilir.

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.

Kullanmaya başlayın

İşlem hattıyla Kopyalama etkinliği gerçekleştirmek için aşağıdaki araçlardan veya SDK'lardan birini kullanabilirsiniz:

Kullanıcı arabirimini kullanarak Salesforce Service Cloud'a bağlı hizmet oluşturma

Azure portalı kullanıcı arabiriminde Salesforce Service Cloud'a bağlı bir hizmet oluşturmak için aşağıdaki adımları kullanın.

  1. Azure Data Factory veya Synapse çalışma alanınızda Yönet sekmesine göz atın ve Bağlı Hizmetler'i seçin, ardından Yeni'ye tıklayın:

  2. Salesforce için arama yapın ve Salesforce Service Cloud bağlayıcısını seçin.

    Salesforce Service Cloud bağlayıcısının ekran görüntüsü.

  3. Hizmet ayrıntılarını yapılandırın, bağlantıyı test edin ve yeni bağlı hizmeti oluşturun.

    Salesforce Service Cloud için bağlı hizmet yapılandırmasının ekran görüntüsü.

Bağlayıcı yapılandırma ayrıntıları

Aşağıdaki bölümlerde Salesforce Service Cloud bağlayıcısına özgü varlıkları tanımlamak için kullanılan özelliklerle ilgili ayrıntılar sağlanır.

Bağlı hizmet özellikleri

Salesforce Service Cloud bağlı hizmeti için aşağıdaki özellikler desteklenir.

Özellik Açıklama Gerekli
Tür Tür özelliği SalesforceServiceCloudV2 olarak ayarlanmalıdır. Yes
environmentUrl Salesforce Service Cloud örneğinin URL'sini belirtin.
Örneğin, verileri özel etki alanından kopyalamak için belirtin "https://<domainName>.my.salesforce.com" . Bu makaleye başvurarak özel etki alanınızı yapılandırmayı veya görüntülemeyi öğrenin.
Yes
authenticationType Salesforce Service Cloud'a bağlanmak için kullanılan kimlik doğrulama türü.
İzin verilen değer OAuth2ClientCredentials değeridir.
Yes
clientId Salesforce OAuth 2.0 Bağlı Uygulamasının istemci kimliğini belirtin. Daha fazla bilgi için bu makaleye gidin Yes
clientSecret Salesforce OAuth 2.0 Bağlı Uygulamasının istemci gizli dizisini belirtin. Daha fazla bilgi için bu makaleye gidin Yes
apiVersion Kullanılacak Salesforce Toplu API 2.0 sürümünü belirtin; örneğin. 52.0 Toplu API 2.0 yalnızca API sürümü >= 47.0'i destekler. Toplu API 2.0 sürümü hakkında bilgi edinmek için makaleye bakın. Daha düşük bir API sürümü kullanırsanız hataya neden olur. Yes
connectVia Veri deposuna bağlanmak için kullanılacak tümleştirme çalışma zamanı . Belirtilmezse, varsayılan Azure Integration Runtime'ı kullanır. Hayır

Örnek: Kimlik bilgilerini depolama

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

Örnek: Kimlik bilgilerini Key Vault'ta depolama

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

Veri kümesi özellikleri

Veri kümelerini tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için Veri kümeleri makalesine bakın. Bu bölümde Salesforce Service Cloud veri kümesi tarafından desteklenen özelliklerin listesi sağlanır.

Ve'den Salesforce Service Cloud'a veri kopyalamak için veri kümesinin tür özelliğini SalesforceServiceCloudV2Object olarak ayarlayın. Aşağıdaki özellikler desteklenir.

Özellik Açıklama Gerekli
Tür Tür özelliği SalesforceServiceCloudV2Object olarak ayarlanmalıdır. Yes
objectApiName Verileri almak için Salesforce Service Cloud nesne adı. Geçerli şirket içinde barındırılan tümleştirme çalışma zamanı sürümü 5.44.8984.1 veya üzeridir. Kaynak için hayır (kaynakta "sorgu" belirtilirse), havuz için Evet
reportId Verileri almak için Salesforce Service Cloud raporunun kimliği. Havuz'da desteklenmez. Raporları kullanırken sınırlamalar olduğunu unutmayın. Geçerli şirket içinde barındırılan tümleştirme çalışma zamanı sürümü 5.44.8984.1 veya üzeridir. Kaynak için hayır (kaynakta "sorgu" belirtilirse), havuzu desteklemez

Önemli

API Adı'nın "__c" bölümü herhangi bir özel nesne için gereklidir.

Salesforce bağlantı API'si Adı

Örnek:

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

Kopyalama etkinliğinin özellikleri

Etkinlikleri tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için İşlem hatları makalesine bakın. Bu bölümde Salesforce Service Bulut kaynağı ve havuzu tarafından desteklenen özelliklerin listesi sağlanır.

Kaynak türü olarak Salesforce Service Cloud

Salesforce Service Cloud'dan veri kopyalamak için kopyalama etkinliğindeki kaynak türünü SalesforceServiceCloudV2Source olarak ayarlayın. Kopyalama etkinliği kaynağı bölümünde aşağıdaki özellikler desteklenir.

Özellik Açıklama Gerekli
Tür Kopyalama etkinliği kaynağının tür özelliği SalesforceServiceCloudV2Source olarak ayarlanmalıdır. Yes
query Verileri okumak için özel sorguyu kullanın. Salesforce Nesne Sorgu Dili (SOQL) sorgusunu yalnızca sınırlamalarla kullanabilirsiniz. SOQL sınırlamaları için bu makaleye bakın. Sorgu belirtilmezse, veri kümesindeki "objectApiName/reportId" içinde belirtilen Salesforce nesnesinin tüm verileri alınır. Hayır (veri kümesinde "objectApiName/reportId" belirtilirse)
includeDeletedObjects Var olan kayıtların mı yoksa silinenler de dahil olmak üzere tüm kayıtların mı sorgulanıp sorgulanmayacağını gösterir. Belirtilmezse, varsayılan davranış false olur.
İzin verilen değerler: false (varsayılan), true.
Hayır

Önemli

API Adı'nın "__c" bölümü herhangi bir özel nesne için gereklidir.

Salesforce bağlantı API'si Ad listesi

Örnek:

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

Havuz türü olarak Salesforce Service Cloud

Salesforce Service Cloud'a veri kopyalamak için kopyalama etkinliğindeki havuz türünü SalesforceServiceCloudV2Sink olarak ayarlayın. Kopyalama etkinliği havuzu bölümünde aşağıdaki özellikler desteklenir.

Özellik Açıklama Gerekli
Tür Kopyalama etkinliği havuzu type özelliği SalesforceServiceCloudV2Sink olarak ayarlanmalıdır. Yes
writeBehavior İşlemin yazma davranışı.
İzin verilen değerler Insert ve Upsert değerleridir.
Hayır (varsayılan değer Ekle'dir)
externalIdFieldName Upsert işleminin dış kimlik alanının adı. Belirtilen alan Salesforce Service Cloud nesnesinde "Dış Kimlik Alanı" olarak tanımlanmalıdır. Karşılık gelen giriş verilerinde NULL değerleri olamaz. "Upsert" için Evet
writeBatchSize Her toplu işlemde Salesforce Service Cloud'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. Hayır (varsayılan değer 100.000'dir)
ignoreNullValues Yazma işlemi sırasında giriş verilerinden NULL değerlerin yoksayılıp yoksayılmayacağını gösterir.
İzin verilen değerler true ve false değerleridir.
- Doğru: 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.
- False: 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.
Hayır (varsayılan değer false)
 maxConcurrentConnections 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.  Hayır

Örnek: Kopyalama etkinliğinde Salesforce Service Cloud havuzu

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

Salesforce Service Cloud için veri türü eşlemesi

Salesforce Service Cloud'dan veri kopyaladığınızda, aşağıdaki eşlemeler Salesforce Service Cloud veri türlerinden hizmet içindeki ara veri türlerine dahili olarak kullanılır. Kopyalama etkinliğinin kaynak şemayı ve veri türünü havuza nasıl eşlediğini öğrenmek için bkz . Şema ve veri türü eşlemeleri.

Salesforce Service Cloud veri türü Hizmet ara veri türü
Otomatik Numara String
Onay kutusu Boolean
Para birimi Ondalık
Tarih DateTime
Tarih/Zaman DateTime
E-posta adresi String
Kimlik String
Arama İlişkisi String
Çoklu Seçim Seçme Listesi String
Sayı Ondalık
Yüzde Ondalık
Phone String
Picklist String
Metin String
Metin Alanı String
Metin Alanı (Uzun) String
Metin Alanı (Zengin) String
Metin (Şifrelenmiş) String
URL String

Not

Salesforce Hizmeti Bulut Numarası türü, Hizmet ara veri türü olarak Azure Data Factory ve Azure Synapse işlem hatlarındaki Ondalık türüne eşleniyor. Ondalık türü tanımlı duyarlığı ve ölçeği dikkate alır. Ondalık basamakları tanımlı ölçeği aşan veriler için değeri önizleme verilerinde yuvarlanır ve kopyalanır. Azure Data Factory ve Azure Synapse işlem hatlarında böyle bir duyarlık kaybı yaşamamak için Salesforce Service Cloud'un Özel Alan Tanımı Düzenleme sayfasında ondalık basamakları makul bir büyük değere yükseltmeyi göz önünde bulundurun.

Arama etkinliği özellikleri

Özellikler hakkında ayrıntılı bilgi edinmek için Arama etkinliği'ne bakın.

Salesforce Service Cloud bağlı hizmetini yükseltme

Bağlı hizmetinizi ve ilgili sorgularınızı yükseltmenize yardımcı olan adımlar şunlardır:

  1. Önkoşullar'a başvurarak Salesforce portalında bağlı uygulamaları yapılandırın.

  2. Yeni bir Salesforce Service Cloud bağlı hizmeti oluşturun ve Bağlı hizmet özelliklerine başvurarak yapılandırın.

  3. Kopyalama etkinliği kaynağında veya eski bağlı hizmete başvuran arama etkinliğinde SQL sorgusu kullanıyorsanız, bunları SOQL sorgusuna dönüştürmeniz gerekir. Kaynak türü olarak Salesforce Service Cloud'dan soql sorgusu ve Salesforce Nesne Sorgu Dili (SOQL) hakkında daha fazla bilgi edinin.

  4. readBehavior, kopyalama etkinliği kaynağındaki veya arama etkinliğindeki includeDeletedObjects ile değiştirilir. Ayrıntılı yapılandırma için bkz . Kaynak türü olarak Salesforce Service Cloud.

Salesforce Service Cloud ile Salesforce Service Cloud (eski) arasındaki farklar

Salesforce Service Cloud bağlayıcısı yeni işlevler sunar ve Salesforce Service Cloud (eski) bağlayıcısının çoğu özelliğiyle uyumludur. Aşağıdaki tabloda Salesforce Service Cloud ile Salesforce Service Cloud (eski) arasındaki özellik farklılıkları gösterilmektedir.

Salesforce Service Cloud Salesforce Service Cloud (eski)
Salesforce Bulk API 2.0 içinde SOQL desteği.
SOQL sorguları için:
• GROUP BY, LIMIT, ORDER BY, OFFSET veya TYPEOF yan tümceleri desteklenmez.
• COUNT() gibi toplu işlevler desteklenmez; bunları uygulamak için Salesforce raporlarını kullanabilirsiniz.
• GROUP BY yan tümcelerindeki tarih işlevleri desteklenmez, ancak WHERE yan tümcesinde desteklenir.
• Bileşik adres alanları veya bileşik coğrafi konum alanları desteklenmez. Alternatif olarak, bileşik alanların bileşenlerini tek tek sorgular.
• Üst-alt ilişki sorguları desteklenmezken, alt öğeden üst öğeye ilişki sorguları desteklenir.
Hem SQL hem de SOQL söz dizimlerini destekler.
İkili alanlar içeren nesneler sorgu belirtilirken desteklenmez. sorgu belirtilirken ikili alanlar içeren nesneler desteklenir.
Sorguyu belirtirken Toplu API içindeki nesneleri destekleyin. Sorgu belirtilirken Toplu API ile desteklenmeyen nesneleri destekleyin.
Bir rapor kimliği seçerek raporu destekleyin. Gibi {call "<report name>"}rapor sorgusu söz dizimlerini destekleyin.

Kopyalama etkinliği tarafından kaynak ve havuz olarak desteklenen veri depolarının listesi için bkz . Desteklenen veri depoları.