Azure Data Factory veya Azure Synapse Analytics kullanarak Dynamics 365 (Microsoft Dataverse) veya Dynamics CRM'de verileri kopyalama ve dönüştürme

GEÇERLİDİR: 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, Verileri Dynamics 365 (Microsoft Dataverse) veya Dynamics CRM'den veya Dynamics CRM'den kopyalamak için Azure Data Factory veya Synapse işlem hatlarında kopyalama etkinliğinin nasıl kullanılacağı ve Dynamics 365 (Microsoft Dataverse) veya Dynamics CRM'deki verileri dönüştürmek için veri akışının nasıl kullanılacağı özetlenmiştir. Daha fazla bilgi edinmek için Azure Data Factory ve Azure Synapse Analytics giriş makalelerini okuyun.

Desteklenen özellikler

Bu bağlayıcı aşağıdaki etkinlikler için desteklenir:

Desteklenen özellikler	Kızılötesi
Kopyalama etkinliği (kaynak/hedef)	(1) (2)
Veri akışı eşleme (kaynak/çıkış)	(1)
Arama etkinliği	(1) (2)

(1) Azure tümleştirme çalışma zamanı (2) Kendi kendine barındırılan tümleştirme çalışma zamanı

Kopyalama etkinliğinin kaynak ve havuz olarak desteklediği veri depolarının listesi için Desteklenen veri depoları tablosuna bakın.

Dikkat

Kasım 2020'den itibaren geçerli olacak şekilde, Common Data Service Microsoft Dataverse olarak yeniden adlandırıldı. Bu makale en son terminolojiyi yansıtacak şekilde güncelleştirildi.

Bu Dynamics bağlayıcısı hem çevrimiçi hem de şirket içi için Dynamics 7 ile 9 arası sürümleri destekler. Daha açık belirtmek gerekirse:

• Sürüm 7, Dynamics CRM 2015'e karşılık gelir.
• Sürüm 8, Dynamics CRM 2016 ve Dynamics 365'in ilk sürümüne karşılık gelir.
• Sürüm 9, Dynamics 365'in daha sonraki sürümüyle örtüşür.

Aşağıdaki Dynamics sürümleri ve ürünleri için desteklenen kimlik doğrulama türleri ve yapılandırmaları tablosuna bakın.

Dynamics sürümleri	Kimlik doğrulama türleri	Bağlı hizmet örnekleri
Dataverse Dynamics 365 çevrimiçi Dynamics CRM Online	Microsoft Entra hizmet sorumlusu Office 365 Kullanıcı atamalı yönetilen kimlik	Dynamics online ve Microsoft Entra hizmet sorumlusu veya Office 365 kimlik doğrulaması
İnternet'e yönelik dağıtım (IFD) ile şirket içi Dynamics 365 IFD ile şirket içi Dynamics CRM 2016 IFD ile şirket içi Dynamics CRM 2015	IFD	IFD ve IFD kimlik doğrulaması ile şirket içi Dynamics

Dikkat

Bölgesel Bulma Hizmeti'nin kullanımdan kaldırılmasıyla hizmet, Office 365 Kimlik Doğrulaması'nı kullanırken genel Bulma Hizmeti'nden yararlanacak şekilde yükseltildi.

Önemli

Kiracınız ve kullanıcınız koşullu erişim için Microsoft Entra Id'de yapılandırılmışsa ve/veya Multi-Factor Authentication gerekiyorsa, Office 365 Kimlik Doğrulama türünü kullanamazsınız. Bu gibi durumlarda Microsoft Entra hizmet sorumlusu kimlik doğrulamasını kullanmanız gerekir.

Özellikle Dynamics 365 için aşağıdaki uygulama türleri desteklenir:

• Dynamics 365 for Sales
• Dynamics 365 for Customer Service
• Saha Hizmeti için Dynamics 365
• Project Service Automation için Dynamics 365
• Dynamics 365 for Marketing

Bu bağlayıcı Finance, Operations ve Talent gibi diğer uygulama türlerini desteklemez.

İpucu

Dynamics 365 Finance and Operations'tan veri kopyalamak için Dynamics AX bağlayıcısını kullanabilirsiniz.

Bu Dynamics bağlayıcısı, Dynamics XRM araçlarının üzerine kurulmuştur.

Önkoşullar

Bu bağlayıcıyı Microsoft Entra hizmet sorumlusu kimlik doğrulamasıyla kullanmak için Dataverse veya Dynamics'te sunucudan sunucuya (S2S) kimlik doğrulamasını ayarlamanız gerekir. İlk olarak uygulama kullanıcısını (Hizmet Sorumlusu) Microsoft Entra Id'ye kaydedin. Bunun nasıl yapıldığını burada bulabilirsiniz. Uygulama kaydı sırasında bu kullanıcıyı Dataverse veya Dynamics'te oluşturmanız ve izinler vermeniz gerekir. Bu izinler, uygulama kullanıcısını Dataverse veya Dynamics'te izin verilmiş bir ekibe ekleyerek doğrudan veya dolaylı olarak verilebilir. Dataverse ile kimlik doğrulaması yapmak için bir uygulama kullanıcısını ayarlama hakkında daha fazla bilgiyi burada bulabilirsiniz.

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:

• Veri Kopyalama aracı
• Azure portal
• .NET SDK'sı
• Python SDK'sı
• Azure PowerShell
• The REST API
• Azure Resource Manager şablonu

Kullanıcı arabirimini kullanarak Dynamics 365 (Microsoft Dataverse) veya Dynamics CRM'e bağlı hizmet oluşturma

Azure portalı kullanıcı arabiriminde Dynamics 365'e 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:

   Azure Data Factory

   

   Azure Synapse

   

2. Dynamics veya Dataverse'i arayın ve Dynamics 365 (Microsoft Dataverse) veya Dynamics CRM bağlayıcısını seçin.

   

   

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

   

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

Aşağıdaki bölümlerde Dynamics'e özgü varlıkları tanımlamak için kullanılan özelliklerle ilgili ayrıntılar sağlanır.

Bağlı hizmet özellikleri

Dynamics bağlı hizmeti için aşağıdaki özellikler desteklenir.

Dynamics 365 ve Dynamics CRM online

Mülk	Açıklama	Gerekli
Tip	Tür özelliği "Dynamics", "DynamicsCrm" veya "CommonDataServiceForApps" olarak ayarlanmalıdır.	Evet
dağıtım türü	Dynamics örneğinin dağıtım türü. Değerin Dynamics online için "Çevrimiçi" olması gerekir.	Evet
serviceUri	Tarayıcıdan erişdiğiniz Dynamics örneğinizin hizmet URL'si. Bir örnek olarak "https://<organization-name>.crm[x].dynamics.com" verilebilir.	Evet
kimlik doğrulama türü	Bir Dynamics sunucusuna bağlanmak için kimlik doğrulama türü. Geçerli değerler "AADServicePrincipal", "Office365" ve "ManagedIdentity" değerleridir.	Evet
"servicePrincipalId (hizmet principalID'si)"	Microsoft Entra uygulamasının istemci kimliği.	Kimlik doğrulaması "AADServicePrincipal" olduğunda evet
hizmetPrensipKimlikBilgisiTürü	Hizmet ilkesi kimlik doğrulaması için kullanılacak kimlik belgesi türü. Geçerli değerler "ServicePrincipalKey" ve "ServicePrincipalCert" değerleridir. Not: ServicePrincipalKey kullanılması önerilir. ServicePrincipalCert kimlik bilgisi türü için, hizmetin anahtar kasasından gizliyi alamaması geçici bir sorunla karşılaşabileceği bilinen bir sınırlama vardır.	Kimlik doğrulaması "AADServicePrincipal" olduğunda evet
servicePrincipalCredential	Hizmet sorumlusu kimlik bilgileri. Kimlik bilgisi türü olarak "ServicePrincipalKey" kullandığınızda, servicePrincipalCredential bağlı hizmet dağıtımında hizmetin şifrelediği bir dize olabilir. Veya Azure Key Vault'taki bir gizli anahtara veya sırra başvuru olabilir. Kimlik bilgisi olarak "ServicePrincipalCert" kullandığınızda, servicePrincipalCredential Azure Key Vault'taki bir sertifikaya başvuru olmalıdır ve sertifika içerik türünün PKCS #12 olduğundan emin olun.	Kimlik doğrulaması "AADServicePrincipal" olduğunda evet
kullanıcı adı	Dynamics'e bağlanmak için kullanılan kullanıcı adı.	Kimlik doğrulaması "Office365" olduğunda evet
şifre	Kullanıcı adı olarak belirttiğiniz kullanıcı hesabının parolası. Güvenli bir şekilde depolamak için bu alanı "SecureString" ile işaretleyin veya Azure Key Vault'ta depolanan bir gizli diziye başvurun.	Kimlik doğrulaması "Office365" olduğunda evet
kimlik bilgileri	Kimlik bilgisi nesnesi olarak kullanıcı tarafından atanan yönetilen kimliği belirtin. Kullanıcı tarafından atanan bir veya birden çok yönetilen kimlik oluşturun, bunları veri fabrikanıza atayın ve kullanıcı tarafından atanan her yönetilen kimlik için kimlik bilgileri oluşturun.	Kimlik doğrulaması "ManagedIdentity" olduğunda evet
connectVia (Bağlan)	Veri deposuna bağlanmak için kullanılacak tümleştirme çalışma zamanı . Değer belirtilmezse, özelliği varsayılan Azure tümleştirme çalışma zamanını kullanır.	Hayır

Dikkat

Dynamics bağlayıcısı daha önce Dynamics CRM veya Dynamics 365 çevrimiçi örneğinizi tanımlamak için isteğe bağlı organizationName özelliğini kullanıyordu. Bu özellik çalışmaya devam ederken, örnek bulma için daha iyi performans elde etmek için bunun yerine yeni serviceUri özelliğini belirtmenizi öneririz.

Örnek: Microsoft Entra hizmet sorumlusu ve anahtar kimlik doğrulaması kullanarak Dynamics online

{  
    "name": "DynamicsLinkedService",  
    "properties": {  
        "type": "Dynamics",  
        "typeProperties": {  
            "deploymentType": "Online",  
            "serviceUri": "https://<organization-name>.crm[x].dynamics.com",  
            "authenticationType": "AADServicePrincipal",  
            "servicePrincipalId": "<service principal id>",  
            "servicePrincipalCredentialType": "ServicePrincipalKey",  
            "servicePrincipalCredential": "<service principal key>"
        },  
        "connectVia": {  
            "referenceName": "<name of Integration Runtime>",  
            "type": "IntegrationRuntimeReference"  
        }  
    }  
}  

Örnek: Microsoft Entra hizmet sorumlusu ve sertifika kimlik doğrulaması kullanarak Dynamics online

{ 
    "name": "DynamicsLinkedService", 
    "properties": { 
        "type": "Dynamics", 
        "typeProperties": { 
            "deploymentType": "Online", 
            "serviceUri": "https://<organization-name>.crm[x].dynamics.com", 
            "authenticationType": "AADServicePrincipal", 
            "servicePrincipalId": "<service principal id>", 
            "servicePrincipalCredentialType": "ServicePrincipalCert", 
            "servicePrincipalCredential": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<AKV reference>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<certificate name in AKV>" 
            } 
        }, 
        "connectVia": { 
            "referenceName": "<name of Integration Runtime>", 
            "type": "IntegrationRuntimeReference" 
        } 
    } 
} 

Örnek: Office 365 kimlik doğrulaması kullanarak Dynamics online

{
    "name": "DynamicsLinkedService",
    "properties": {
        "type": "Dynamics",
        "typeProperties": {
            "deploymentType": "Online",
            "serviceUri": "https://<organization-name>.crm[x].dynamics.com",
            "authenticationType": "Office365",
            "username": "test@contoso.onmicrosoft.com",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Örnek: Kullanıcı tarafından atanan yönetilen kimlik kimlik doğrulaması kullanarak Dynamics online

{
    "name": "DynamicsLinkedService",
    "properties": {
        "type": "Dynamics",
        "typeProperties": {
            "deploymentType": "Online",
            "serviceUri": "https://<organization-name>.crm[x].dynamics.com",
            "authenticationType": "ManagedIdentity",
            "credential": {
                "referenceName": "credential1",
                "type": "CredentialReference"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

DYNAMICS 365 ve DYNAMICS CRM IFD ile şirket içi

Dynamics online ile karşılaştırıldığında ek özellikler hostName ve bağlantı noktasıdır.

Mülk	Açıklama	Gerekli
Tip	Tür özelliği "Dynamics", "DynamicsCrm" veya "CommonDataServiceForApps" olarak ayarlanmalıdır.	Evet
dağıtım türü	Dynamics örneğinin dağıtım türü. Değer, IFD ile şirket içi Dynamics uygulamaları için "OnPremisesWithIfd" olmalıdır.	Evet
hostName	Şirket içi Dynamics sunucusunun ana bilgisayar adı.	Evet
liman	Şirket içi Dynamics sunucusunun portu.	Hayır Varsayılan değer 443'dür.
Organizasyon Adı	Dynamics örneğinin kuruluş adı.	Evet
kimlik doğrulama türü	Dynamics sunucusuna bağlanmak için kimlik doğrulama türü. IFD ile şirket içi Dynamics için "ActiveDirectoryAuthentication" değerini belirtin.	Evet
etki alanı	Kullanıcı kimlik bilgilerini doğrulayacak Active Directory etki alanı.	Evet
kullanıcı adı	Dynamics'e bağlanmak için kullanılan kullanıcı adı.	Evet
şifre	Kullanıcı adı için belirttiğiniz kullanıcı hesabının parolası. Güvenli bir şekilde depolamak için bu alanı "SecureString" ile işaretleyebilirsiniz. İsterseniz Key Vault'ta bir parola depolayabilir ve veri kopyalama işlemi sırasında kopyalama etkinliğinin oradan çekmesine izin verebilirsiniz. Key Vault'ta kimlik bilgilerini depolama bölümünden daha fazla bilgi edinin.	Evet
connectVia (Bağlan)	Veri deposuna bağlanmak için kullanılacak tümleştirme çalışma zamanı . Değer belirtilmezse, özelliği varsayılan Azure tümleştirme çalışma zamanını kullanır.	Hayır

Dikkat

Ifd kimlik doğrulama türünün 31 Ağustos 2024'e kadar gün batımından dolayı, şu anda kullanıyorsanız lütfen tarihten önce Active Directory Kimlik Doğrulama türüne yükseltin.

Örnek: Active Directory kimlik doğrulaması kullanan IFD ile şirket içi Dynamics

{
    "name": "DynamicsLinkedService",
    "properties": {
        "type": "Dynamics",
        "description": "Dynamics on-premises with IFD linked service using IFD authentication",
        "typeProperties": {
            "deploymentType": "OnPremisesWithIFD",
            "hostName": "contosodynamicsserver.contoso.com",
            "port": 443,
            "organizationName": "admsDynamicsTest",
            "authenticationType": "ActiveDirectoryAuthentication",
            "domain": "< Active Directory domain >", 
            "username": "test@contoso.onmicrosoft.com",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "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 Dynamics veri kümesi tarafından desteklenen özelliklerin listesi sağlanır.

Dynamics'ten ve Dynamics'e veri kopyalamak için aşağıdaki özellikler desteklenir:

Mülk	Açıklama	Gerekli
Tip	Veri kümesinin tür özelliği "DynamicsEntity", "DynamicsCrmEntity" veya "CommonDataServiceForAppsEntity" olarak ayarlanmalıdır.	Evet
varlıkAdı	Alınması gereken varlığın mantıksal adı.	Etkinlik kaynağı "sorgu" olarak belirtilirse kaynak için hayır ve havuz için evet

Örnek

{
    "name": "DynamicsDataset",
    "properties": {
        "type": "DynamicsEntity",
        "schema": [],
        "typeProperties": {
            "entityName": "account"
        },
        "linkedServiceName": {
            "referenceName": "<Dynamics 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, Dynamics kaynak ve havuz türleri tarafından desteklenen özelliklerin listesi sağlanır.

Kaynak türü olarak Dynamics

Dynamics'ten veri kopyalamak için kopyalama etkinliği kaynağı bölümü aşağıdaki özellikleri destekler:

Mülk	Açıklama	Gerekli
Tip	Kopyalama etkinliği kaynağının tür özelliği "DynamicsSource", "DynamicsCrmSource" veya "CommonDataServiceForAppsSource" olarak ayarlanmalıdır.	Evet
sorgu	FetchXML, Dynamics çevrimiçi ve şirket içinde kullanılan özel bir sorgu dilidir. Aşağıdaki örneğe bakın. Daha fazla bilgi edinmek için bkz . FetchXML ile sorgu oluşturma.	Eğer veri kümesinde entityName belirtilmemişse hayır

Dikkat

FetchXML sorgusunda yapılandırdığınız sütun projeksiyonu bunu içermese bile PK sütunu her zaman kopyalanır.

Önemli

• Dynamics'ten veri kopyaladığınızda, Dynamics'ten havuza açık sütun eşleme isteğe bağlıdır. Ancak, belirli bir kopyalama sonucu elde etmek için eşlemeyi şiddetle tavsiye ederiz.
• Hizmet yazma kullanıcı arabiriminde bir şemayı içeri aktardığında şemayı çıkarsar. Kaynak sütun listesini başlatmak için Dynamics sorgu sonucundaki en üst satırları örnekleme yoluyla bunu yapar. Bu durumda, üst satırlarda değer içermeyen sütunlar atlanır. Aynı davranış, açık eşleme yoksa veri önizleme ve kopyalama yürütmeleri için de geçerlidir. Eşlemeyi gözden geçirebilir ve kopyalama çalışma zamanı sırasında kabul edilen daha fazla sütun ekleyebilirsiniz.

Örnek

"activities":[
    {
        "name": "CopyFromDynamics",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Dynamics input dataset>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "DynamicsSource",
                "query": "<FetchXML Query>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Örnek FetchXML sorgusu

<fetch>
  <entity name="account">
    <attribute name="accountid" />
    <attribute name="name" />
    <attribute name="marketingonly" />
    <attribute name="modifiedon" />
    <order attribute="modifiedon" descending="false" />
    <filter type="and">
      <condition attribute ="modifiedon" operator="between">
        <value>2017-03-10 18:40:00z</value>
        <value>2017-03-12 20:40:00z</value>
      </condition>
    </filter>
  </entity>
</fetch>

Lavabo türü olarak Dynamics

Verileri Dynamics'e kopyalamak için kopyalama etkinliği havuzu bölümü aşağıdaki özellikleri destekler:

Mülk	Açıklama	Gerekli
Tip	Kopyalama etkinliği havuzu tür özelliği "DynamicsSink", "DynamicsCrmSink" veya "CommonDataServiceForAppsSink" olarak ayarlanmalıdır.	Evet.
yazDavranışı	İşlemin yazma davranışı. Değer "Upsert" olmalıdır.	Evet
alternatifAnahtarAdı	Varlığınızda bir güncelleme veya ekleme yapmak için tanımlanan alternatif anahtar adı.	Hayır
writeBatchSize (yazmaToplamBoyutu)	Her toplu işlemde Dynamics'e yazılan verilerin satır sayısı.	Hayır Varsayılan değer 10'dur.
NullDeğerleriYoksay	Yazma işlemi sırasında anahtar alanlar dışındaki giriş verilerindeki null değerlerin yoksayılıp yoksayılmayacağı. Geçerli değerler DOĞRU ve YANLIŞ'tır: 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. YANLIŞ: Upsert veya update işlemi yaptığınızda hedef nesnedeki verileri null değere güncelleştirin. Ekleme işlemi yaparken null değer ekleyin.	Hayır Varsayılan değer YANLIŞ'tır.
Maksimum Eşzamanlı Bağlantılar	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
İş Mantığı Yürütmesini Atlama	Özel eklentileri ve iş akışlarını devre dışı bırakmak için özel iş mantığını atla:  • Temel Microsoft Dataverse sisteminin veya Microsoft'un yayımcı olduğu bir çözümün parçası olan eklentiler.  • Microsoft'un yayımcı olduğu bir çözüme dahil edilen iş akışları. Değer CustomSync, CustomAsync, CustomSync,CustomAsync olabilir. Ayrıca, hangi kayıtlı eklenti adımlarının atlanacağını belirtmek için GUID'leri (virgülle ayırarak) manuel olarak girebilirsiniz. Bu, tüm zaman uyumlu ve zaman uyumsuz özel mantık yerine belirtilen eklenti adımını atlamanızı sağlar. Dikkat edin ki prvBypassCustomBusinessLogic ayrıcalığına sahip olmanız gerekiyor. Varsayılan olarak, yalnızca sistem yöneticisi güvenlik rolüne sahip kullanıcıların bu ayrıcalığı vardır. Sahip türüne sahip bir Dataverse ekibine ait olan tüm Dataverse kullanıcıları, ekibin güvenlik rolleriyle ilişkili ayrıcalıkları otomatik olarak devralır. Daha fazla bilgi için bu makaleye bakın.	Hayır
Power Automate Akışlarını Atla	Power Automate akışlarını atlama. Daha fazla bilgi için bu makaleye bakın.	Hayır

Dikkat

Hem lavabonun writeBatchSize hem de Dynamics lavabosu için kopyalama etkinliği parallelCopies için varsayılan değer 10'dur. Bu nedenle, varsayılan olarak Dynamics'e 100 kayıt eşzamanlı olarak gönderilir.

Dynamics 365 online için kuruluş başına 52 eşzamanlı toplu çağrı sınırı vardır. Bu sınır aşılırsa, ilk istek hiç çalıştırılmadan önce "Sunucu Meşgul" özel durumu oluşturulur. Eşzamanlı çağrıların sınırlanmasını önlemek için writeBatchSize'ı 10 veya daha düşük bir değerde tutun.

writeBatchSize ve parallelCopies'in en uygun birleşimi varlığınızın şemasına bağlıdır. Şema öğeleri sütun sayısını, satır boyutunu ve bu çağrılara bağlı eklenti, iş akışı veya iş akışı etkinliği sayısını içerir. Varsayılan writeBatchSize (10) × parallelCopies (10) ayarı Dynamics hizmetine göre öneridir. Bu değer çoğu Dynamics varlığı için çalışır, ancak en iyi performansı vermeyebilir. Kopyalama etkinliği ayarlarınızdaki bileşimi ayarlayarak performansı ayarlayabilirsiniz.

Örnek

"activities":[
    {
        "name": "CopyToDynamics",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<Dynamics output dataset>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "DynamicsSink",
                "writeBehavior": "Upsert",
                "writeBatchSize": 10,
                "ignoreNullValues": true
            }
        }
    }
]

Kopyalama etkinliği veri havuzunda elastik tabloları seçtiğinizde sütunu partitionid bağlayıcı eşlemesi destekler. Kaynak veri sütununuzu havuzun partitionid sütununa eşleyebilirsiniz. Eşlenmemişse, birincil anahtar değeri sütun için partitionid varsayılan değer olarak kullanılır.

partitionid yazma yolundaki Dataverse alternatif anahtarlarında veya birincil anahtar senaryolarında kullanılabilir. Her elastik tablo sistem tanımlı partitionid bir sütun içerir ve tablonun birincil anahtarını sütunla birleştiren adlı KeyForNoSqlEntityWithPKPartitionIdalternatif bir anahtara partitionid sahiptir. Daha fazla bilgi için bu makaleye bakın.

Görünümlerden veri alma

Dynamics görünümlerinden veri almak için görünümün kaydedilmiş sorgusunu almanız ve verileri almak için sorguyu kullanmanız gerekir.

Farklı görünüm türlerini depolayan iki varlık vardır: "kaydedilen sorgu" sistem görünümünü depolar ve "kullanıcı sorgusu" kullanıcı görünümünü depolar. Görünümlerin bilgilerini almak için aşağıdaki FetchXML sorgusuna bakın ve "TARGETENTITY" ifadesini savedquery veya userquery ile değiştirin. Her varlık türünün, ihtiyacınıza göre sorguya ekleyebileceğiniz daha fazla kullanılabilir özniteliği vardır. Kayıtlı sorgu varlığı ve kullanıcı sorgusu varlığı hakkında daha fazla bilgi edinin.

<fetch top="5000" >
  <entity name="<TARGETENTITY>">
    <attribute name="name" />
    <attribute name="fetchxml" />
    <attribute name="returnedtypecode" />
    <attribute name="querytype" />
  </entity>
</fetch>

Görünümleri filtrelemek için filtreler de ekleyebilirsiniz. Örneğin, hesap varlığında "Etkin Hesaplarım" adlı bir görünüm elde etmek için aşağıdaki filtreyi ekleyin.

<filter type="and" >
    <condition attribute="returnedtypecode" operator="eq" value="1" />
    <condition attribute="name" operator="eq" value="My Active Accounts" />
</filter>

Dynamics için veri türü eşlemesi

Dynamics'ten veri kopyaladığınızda, aşağıdaki tabloda Dynamics veri türlerinden hizmet içindeki ara veri türlerine eşlemeler gösterilmektedir. Bir kopyalama etkinliğinin kaynak şemayla nasıl eşleştiğini ve veri türünün bir havuzla nasıl eşleştiğini öğrenmek için bkz Şema ve veri türü eşlemeleri.

Aşağıdaki eşleme tablosunu kullanarak kaynak Dynamics veri türünüzü temel alan bir veri kümesi yapısında karşılık gelen ara veri türünü yapılandırın:

Dynamics veri türü	Hizmet ara veri türü	Kaynak olarak desteklenir	Havuz olarak desteklenir
AttributeTypeCode.BigInt	Uzun	✓	✓
AttributeTypeCode.Boolean	Boolean (Boole Mantığı)	✓	✓
AttributeType.Müşteri	GUID	✓	✓ (Rehberliğe bakın)
ÖznitelikTürü.TarihSaat	Tarih ve Saat	✓	✓
AttributeType.Decimal	Ondalık	✓	✓
AttributeType.Double	Çift	✓	✓
AttributTipi.VarlıkAdı	Dize	✓	✓
AttributeType.Integer	Int32	✓	✓
ÖznitelikTürü.Arama	GUID	✓	✓ (Rehberliğe bakın)
AttributeType.YönetilenÖzellik	Boolean (Boole Mantığı)	✓
AttributeType.Memo	Dize	✓	✓
AttributeType.Money	Ondalık	✓	✓
AttributeType.Owner	GUID	✓	✓ (Rehberliğe bakın)
AttributeType.Seçim Listesi	Int32	✓	✓
AttributeType.Uniqueidentifier	GUID	✓	✓
AttributeType.String	Dize	✓	✓
ÖznitelikTürü.Durum	Int32	✓	✓
ÖzellikTürü.Durum	Int32	✓	✓

Dikkat

AttributeType.CalendarRules, AttributeType.MultiSelectPicklist ve AttributeType.PartyList Dynamics veri türleri desteklenmez.

Arama alanına veri yazma

Müşteri ve Sahip gibi birden çok hedefi olan bir arama alanına veri yazmak için şu kılavuzu ve örneği izleyin:

1. Kaynağınızın hem alan değerini hem de karşılık gelen hedef varlık adını içermesini sağlayın.

   • Tüm kayıtlar aynı hedef varlığa eşlenirse aşağıdaki koşullardan birini sağlayın:
     • Kaynak verilerinizin hedef varlık adını depolayan bir sütunu vardır.
     • Hedef varlığı tanımlamak için kopyalama etkinliği kaynağına ek bir sütun eklediniz.
   • Farklı kayıtlar farklı hedef varlıklarla eşlenirse, kaynak verilerinizin ilgili hedef varlık adını depolayan bir sütunu olduğundan emin olun.

2. Değer ve varlık referansı sütunlarını kaynaktan havuza eşleyin. Varlık referansı sütunu, özel adlandırma desenine {lookup_field_name}@EntityReference sahip bir sanal sütuna eşleştirilmelidir. Sütun Dynamics'te gerçekten yok. Bu sütunun, verilen çok hedefli arama alanının meta veri sütunu olduğunu belirtmek için kullanılır.

Sahip alanını ayarlama

Dynamics 365 (Microsoft Dataverse) veya Dynamics CRM'de Sahip alanını ayarlarken geçerli bir başvuru sağlamak önemlidir. için @EntityReference geçerli seçenekler şunlardır:

• systemuser: Bu, sistem içindeki tek bir kullanıcıyı ifade eder.
• team: Bu, kuruluş içindeki bir kullanıcı ekibini ifade eder.

Veri dönüştürme sırasında oluşan hataları önlemek için sağlanan değerin bu seçeneklerden birine karşılık olduğundan emin olun.

Örneğin, kaynağın şu iki sütunu olduğunu varsayalım:

• Dynamics'teki hedef varlığın birincil anahtar değeri olan GUID türünde CustomerField sütunu.
• Hedef varlığın mantıksal adı olan Target sütunu, türü String.

Ayrıca, CustomerField türündeki Dynamics varlık alanı Müşteri havuzuna bu tür verileri kopyalamak istediğinizi varsayalım.

Kopyalama etkinliği sütun eşlemesinde iki sütunu aşağıdaki gibi eşleyin:

• CustomerField'i CustomerField'a. Bu eşleme normal alan eşlemesidir.
• TargetCustomerField@EntityReference. Sınır sütunu, varlık referansını temsil eden sanal bir sütundur. Şemalar tarafından görünmeyebildikleri için, eşlemeye bu tür alan adlarını girin.

Tüm kaynak kayıtlarınız aynı hedef varlığa eşleniyorsa ve kaynak verileriniz hedef varlık adını içermiyorsa, şu kısayolu bulabilirsiniz: kopyalama etkinliği kaynağında ek bir sütun ekleyin. Desenini {lookup_field_name}@EntityReferencekullanarak yeni sütunu adlandırın, değeri hedef varlık adına ayarlayın, ardından sütun eşlemesine her zamanki gibi devam edin. Kaynak ve havuz sütun adlarınız aynıysa, varsayılan olarak kopyalama etkinliği sütunları ada göre eşlediğinden, açık sütun eşlemesini de atlayabilirsiniz.

Alternatif anahtarlar aracılığıyla arama alanına veri yazma

Alternatif anahtar sütunlarını kullanarak arama alanına veri yazmak için şu kılavuzu ve örneği izleyin:

1. Kaynağınızın tüm arama anahtarı sütunlarını içerdiğinden emin olun.

2. Alternatif anahtar sütunları, özel adlandırma düzenine {lookup_field_name}@{alternate_key_column_name}sahip sütuna eşlenmelidir. Sütun Dynamics'te yok. Bu sütunun hedef varlıktaki kaydı aramak için kullanıldığını belirtmek için kullanılır.

3. Eşleme veri akışlarının bağlama dönüşümünde Eşleme sekmesine gidin. Arama alanının altında çıkış sütunları olarak alternatif anahtarı seçin. Sonra gelen değer, bu alternatif anahtarın anahtar sütunlarını gösterir.

   

4. Seçildikten sonra, alternatif anahtar sütunları otomatik olarak aşağıda görüntülenir.

   

5. Soldaki giriş sütunlarınızı çıkış sütunlarıyla eşleyin.

   

Dikkat

Şu anda bu yalnızca eşleme veri akışlarının havuz dönüşümünde satır içi modu kullandığınızda desteklenir.

Eşleme veri akışı özellikleri

Eşleme veri akışındaki verileri dönüştürürken, Dynamics'teki tablolardan okuyabilir ve tablolara yazabilirsiniz. Daha fazla bilgi için bkz. kaynak dönüştürme ve sink dönüşümü eşleme veri akışlarında. Kaynak ve havuz türü olarak Dynamics veri kümesini veya satır içi veri kümesini kullanmayı seçebilirsiniz.

Kaynak dönüştürme

Aşağıdaki tabloda Dynamics tarafından desteklenen özellikler listelenmiştir. Bu özellikleri Kaynak seçenekleri sekmesinde düzenleyebilirsiniz.

Veri Akışı Adı	Açıklama	Gerekli	İzin verilen değerler	Veri akışı betiği özelliği
Varlık adı	Alınması gereken varlığın mantıksal adı.	Satır içi veri kümesi kullanılırken Evet	-	(yalnızca satır içi veri kümesi için) varlık
Sorgu	FetchXML, Dynamics çevrimiçi ve şirket içinde kullanılan özel bir sorgu dilidir. Aşağıdaki örneğe bakın. Daha fazla bilgi edinmek için bkz . FetchXML ile sorgu oluşturma.	Hayır	Dize	sorgu

Dikkat

Giriş türü olarak Sorgu'yu seçerseniz, tablolardan sütun türü alınamıyor. Varsayılan olarak dize olarak değerlendirilir.

Dynamics kaynak betiği örneği

Kaynak türü olarak Dynamics veri kümesini kullandığınızda, ilişkili veri akışı betiği şöyledir:

source(allowSchemaDrift: true,
	validateSchema: false,
	query: '<fetch mapping='logical' count='3 paging-cookie=''><entity name='new_dataflow_crud_test'><attribute name='new_name'/><attribute name='new_releasedate'/></entity></fetch>') ~> DynamicsSource

Satır içi veri kümesi kullanıyorsanız, ilişkili veri akışı betiği şu şekildedir:

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'dynamics',
	format: 'dynamicsformat',
	entity: 'Entity1',
	query: '<fetch mapping='logical' count='3 paging-cookie=''><entity name='new_dataflow_crud_test'><attribute name='new_name'/><attribute name='new_releasedate'/></entity></fetch>') ~> DynamicsSource

Lavabo dönüşümü

Aşağıdaki tabloda Dynamics havuzu tarafından desteklenen özellikler listelenmektedir. Bu özellikleri Havuz seçenekleri sekmesinde düzenleyebilirsiniz.

Veri Akışı Adı	Açıklama	Gerekli	İzin verilen değerler	Veri akışı betiği özelliği
Alternatif anahtar adı	Bir güncelleştirme, yükseltme veya silme işlemi yapmak için varlığınızda tanımlanan alternatif anahtar adı.	Hayır	-	alternatifAnahtarAdı
Güncelleştirme yöntemi	Veritabanı hedefinizde hangi işlemlere izin verileceğini belirtin. Varsayılan değer yalnızca eklemelere izin vermektir. Satırları güncelleştirmek, ekleyip güncellemek veya silmek için bu eylemler için satırları etiketlemek üzere bir Satır değiştirme dönüşümü gerekir.	Evet	true veya false	eklenebilir güncelleştirilebilir eklenebilir/güncellenebilir silinebilir
Varlık adı	Yazılacak varlığın mantıksal adı.	Satır içi veri kümesi kullanılırken Evet	-	(yalnızca satır içi veri kümesi için) varlık

Dynamics havuz betiği örneği

Dynamics veri kümesini havuz türü olarak kullandığınızda, ilişkili veri akışı betiği şöyledir:

IncomingStream sink(allowSchemaDrift: true,
    validateSchema: false,
    deletable:true,
    insertable:true,
    updateable:true,
    upsertable:true,
    skipDuplicateMapInputs: true,
    skipDuplicateMapOutputs: true) ~> DynamicsSink

Satır içi veri kümesi kullanıyorsanız, ilişkili veri akışı betiği şu şekildedir:

IncomingStream sink(allowSchemaDrift: true,
    validateSchema: false,
    store: 'dynamics',
    format: 'dynamicsformat',
    entity: 'Entity1',
    deletable: true,
    insertable: true,
    updateable: true,
    upsertable: true,
    skipDuplicateMapInputs: true,
    skipDuplicateMapOutputs: true) ~> DynamicsSink

Sorgu etkinliği özellikleri

Özellikler hakkında ayrıntılı bilgi edinmek için Arama etkinliği kısmına bakın.

İlgili içerik

Desteklenen veri depolarının, kaynak ve havuz olarak kopyalama etkinliğinde nasıl kullanıldığını gösteren liste için bkz: Desteklenen veri depoları.