Aracılığıyla paylaş

Azure Data Factory ve Azure Synapse'te Dynamics 365, Dataverse (Common Data Service) ve Dynamics CRM bağlayıcılarıyla ilgili sorunları giderme

  • Makale

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'teki Dynamics 365, Dataverse (Common Data Service) ve Dynamics CRM bağlayıcılarıyla ilgili yaygın sorunları gidermeye yönelik öneriler sağlanır.

Hata kodu: DynamicsCreateServiceClientError

  • İleti: This is a transient issue on Dynamics server side. Try to rerun the pipeline.

  • Neden: Sorun, Dynamics sunucu tarafında geçici bir sorundur.

  • Öneri: İşlem hattını yeniden çalıştırın. Yeniden başarısız olursa paralelliği azaltmayı deneyin. Sorun devam ederse Dynamics desteğine başvurun.

Şema veya önizleme verilerini içeri aktarırken eksik sütunlar

  • Belirtiler: Şema veya önizleme verilerini içeri aktardığınızda bazı sütunlar eksik. Hata mesajı: The valid structure information (column name and type) are required for Dynamics source.

  • Neden: Data Factory ve Synapse işlem hatları ilk 10 kayıtta değer içermeyen sütunları gösteremediğinden bu sorun tasarım gereğidir. Eklediğiniz sütunların doğru biçimde olduğundan emin olun.

  • Öneri: Sütunları eşleme sekmesine el ile ekleyin. Daha fazla ayrıntı için açık eşleme bölümüne bakın.

Hata kodu: DynamicsMissingTargetForMultiTargetLookupField

  • İleti: Cannot find the target column for multi-target lookup field: '%fieldName;'.

  • Neden: Hedef sütun kaynakta veya sütun eşlemesinde yok.

  • Öneri:

    1. Kaynağın hedef sütunu içerdiğinden emin olun.
    2. Hedef sütunu sütun eşlemesine ekleyin. Havuz sütununun {fieldName}@EntityReference biçiminde olduğundan emin olun.

Hata kodu: DynamicsInvalidTargetForMultiTargetLookupField

  • İleti: The provided target: '%targetName;' is not a valid target of field: '%fieldName;'. Valid targets are: '%validTargetNames;'

  • Neden: Çok hedefli arama alanının hedef varlığı olarak yanlış varlık adı sağlanmış.

  • Öneri: Çok hedefli arama alanı için geçerli bir varlık adı sağlayın.

Hata kodu: DynamicsInvalidTypeForMultiTargetLookupField

  • İleti: The provided target type is not a valid string. Field: '%fieldName;'.

  • Neden: Hedef sütundaki değer bir dize değil.

  • Öneri: Çok hedefli arama hedef sütununda geçerli bir dize sağlayın.

Hata kodu: DynamicsFailedToRequetServer

  • İleti: The Dynamics server or the network is experiencing issues. Check network connectivity or check Dynamics server log for more details.

  • Neden: Dynamics sunucusu kararsız veya erişilemez durumda ya da ağda sorunlar yaşanıyor.

  • Öneri: Daha fazla ayrıntı için ağ bağlantısını denetleyin veya Dynamics sunucu günlüğünü denetleyin. Daha fazla yardım için Dynamics desteğine başvurun.

Hata kodu: DynamicsFailedToConnect

  • İleti: Failed to connect to Dynamics: %message;

  • Nedenler ve öneriler: Farklı nedenler bu hataya neden olabilir. Olası neden analizi ve ilgili öneri için aşağıdaki listeye bakın.

    Neden analizi Öneri
    Kullanım örneğinizin aşağıdaki üç koşulun tümünü karşılayıp karşılamadiğini görüyor veya başka bir şekilde Unable to Login to Dynamics CRM, message:ERROR REQUESTING Token FROM THE Authentication context - USER intervention required but not permitted by prompt behavior AADSTS50079: Due to a configuration change made by your administrator, or because you moved to a new location, you must enroll in multi-factor authentication to access '00000007-0000-0000-c000-000000000000' görüyorsunuzERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled.:
  • Dynamics 365, Common Data Service veya Dynamics CRM'e bağlanıyorsanız.
  • Office365 Kimlik Doğrulaması kullanıyorsunuz.
  • Kiracınız ve kullanıcınız koşullu erişim için Microsoft Entra Id'de yapılandırılmıştır ve/veya Multi-Factor Authentication gereklidir (Dataverse belgesinin bu bağlantısına bakın).
    • Bu koşullar altında, 8/6/2021'e kadar başarılı olmak için kullanılan bağlantı. 9/6/2021 tarihinden itibaren bölgesel Bulma Hizmeti'nin kullanımdan kaldırılması nedeniyle bağlantı başarısız olmaya başlayacaktır (bu bağlantıya bakın).    		 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, 8/6/2021'in ardından kimlik doğrulaması yapmak için 'Microsoft Entra hizmet sorumlusu' kullanmanız gerekir. Ayrıntılı adımlar için bu bağlantıya bakın.
    Hata iletisinde görüyorsanız Office 365 auth with OAuth failed , sunucunuzda OAuth ile uyumlu olmayan bazı yapılandırmalar olabilir.
  • Yardım için ayrıntılı hata iletisiyle Dynamics destek ekibine başvurun.
  • Hizmet sorumlusu kimlik doğrulamasını kullandığınızda şu makaleye başvurabilirsiniz: Örnek: Microsoft Entra hizmet sorumlusu ve sertifika kimlik doğrulaması kullanarak Dynamics online.
    		•
    Hata iletisinde görüyorsanız Unable to retrieve authentication parameters from the serviceUri , trafiği kesmek için yanlış Dynamics hizmeti URL'sini veya ara sunucuyu/güvenlik duvarını girdiğiniz anlamına gelir.
  • Bağlı hizmete doğru hizmet URI'sini yerleştirdiğinizden emin olun.
  • Şirket İçinde Barındırılan IR kullanıyorsanız, güvenlik duvarının/ara sunucunun Dynamics sunucusuna yönelik istekleri kesmediğinden emin olun.
    		•
    Hata iletisinde görüyorsanız An unsecured or incorrectly secured fault was received from the other party , bu, sunucu tarafından beklenmeyen yanıtlar alındığını gösterir.
  • Office 365 kimlik doğrulamasını kullanıyorsanız kullanıcı adınızın ve parolanızın doğru olduğundan emin olun.
  • Doğru hizmet URI'sini girdiğinizden emin olun.
  • Bölgesel CRM URL'si kullanıyorsanız (URL'nin 'crm' sonrasında bir numarası vardır), doğru bölgesel tanımlayıcıyı kullandığınızdan emin olun.
  • Yardım için Dynamics destek ekibine başvurun.
    		•
    Hata iletisinde görüyorsanız No Organizations Found , bu durum kuruluşunuzun adının yanlış olduğu veya hizmet URL'sinde yanlış bir CRM bölgesi tanımlayıcısı kullandığınız anlamına gelir.
  • Doğru hizmet URI'sini girdiğinizden emin olun.
  • Bölgesel CRM URL'sini kullanıyorsanız (URL'nin 'crm' sonrasında bir numarası vardır), doğru bölgesel tanımlayıcıyı kullandığınızdan emin olun.
  • Yardım için Dynamics destek ekibine başvurun.
    		•
    Ve Microsoft Entra ile ilgili hata iletisi görüyorsanız 401 Unauthorized , bu hizmet sorumlusuyla ilgili bir sorun olduğu anlamına gelir. Hizmet sorumlusu sorununu düzeltmek için hata iletisindeki yönergeleri izleyin.
    Diğer hatalar için sorun genellikle sunucu tarafındadır. Bağlantı oluşturmak için XrmToolBox kullanın. Hata devam ederse yardım için Dynamics destek ekibine başvurun.

Hata kodu: DynamicsOperationFailed

  • İleti: Dynamics operation failed with error code: %code;, error message: %message;.

  • Neden: İşlem sunucu tarafında başarısız oldu.

  • Öneri: şu hata iletisinden Dynamics operation failed with error code: {code}dynamics işleminin hata kodunu ayıklayın ve daha ayrıntılı bilgi için Web hizmeti hata kodları makalesine bakın. Gerekirse Dynamics destek ekibine başvurabilirsiniz.

Hata kodu: DynamicsInvalidFetchXml

  • İleti: The Fetch Xml query specified is invalid.

  • Neden: Getirme XML'sinde bir hata var.

  • Öneri: GETIRME XML'sindeki hatayı düzeltin.

Hata kodu: DynamicsMissingKeyColumns

  • İleti: Input DataSet must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;

  • Neden: Kaynak veriler havuz varlığının anahtar sütununu içermiyor.

  • Öneri: Anahtar sütunlarının kaynak verilerde bulunduğunu onaylayın veya bir kaynak sütunu havuz varlığındaki anahtar sütununa eşleyin.

Hata kodu: DynamicsPrimaryKeyMustBeGuid

  • İleti: The primary key attribute '%attribute;' must be of type guid.

  • Neden: Birincil anahtar sütununun türü 'Guid' değil.

  • Öneri: Kaynak verilerdeki birincil anahtar sütununun 'Guid' türünde olduğundan emin olun.

Hata kodu: DynamicsAlternateKeyNotFound

  • İleti: Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.

  • Neden: Sağlanan alternatif anahtar yok, bunun nedeni yanlış anahtar adları veya yetersiz izinler olabilir.

  • Öneri:

    • Anahtar adındaki yazım hatalarını düzeltin.
    • Varlık üzerinde yeterli izinlere sahip olduğunuzdan emin olun.

Hata kodu: DynamicsInvalidSchemaDefinition

  • İleti: The valid structure information (column name and type) are required for Dynamics source.

  • Neden: Sütun eşlemesindeki havuz sütunları 'type' özelliğini kaçırır.

  • Öneri: Portalda JSON düzenleyicisini kullanarak sütun eşlemesindeki bu sütunlara 'type' özelliğini ekleyebilirsiniz.

Hata kodu: UserErrorUnsupportedAttributeType

  • İleti: The attribute type 'Lookup' of field %attributeName; is not supported

  • Neden: Verileri Dynamics havuzuna yüklerken Azure Data Factory, arama özniteliğinin meta verilerine doğrulama uygular. Ancak, bazı Dynamics varlıklarının geçerli arama özniteliği meta verilerine sahip olmamasıyla ilgili bilinen bir sorun vardır ve bu da bir hedef listesini barındırarak doğrulamanın başarısız olmasına neden olur.

  • Öneri: Sorunu azaltmak için Dynamics destek ekibine başvurun.

Dynamics 365'ten kopyalama etkinliği gerçek sayıdan daha fazla satır okur

  • Belirtiler: Dynamics 365'in kopyalama etkinliği gerçek sayıdan daha fazla satır okur.

  • Neden: Dynamics 365 sunucusu her zaman daha fazla kullanılabilir kayıt gösterir.

  • Öneri: FetchXML'yi disk belleğiyle test etmek için XrmToolBox kullanın. Bazı yüklü araçlarla XrmToolBox , kayıt sayısını alabilir. Daha fazla bilgi için bkz . XrmToolBox.

Kopyalama etkinliğindeki Dynamics kaynaklarından sanal sütunlara erişilemiyor

  • Belirtiler: Kopyalama etkinliğindeki Dynamics kaynaklarından sanal sütunlara erişemezsiniz.

  • Neden: Sanal sütun şu anda desteklenmiyor.

  • Öneri: Seçenek Kümesi değeri için aşağıdaki seçenekleri izleyerek alın:

Dynamics CRM veri deposundaki paralel kopya

  • Belirtiler: Dynamics CRM veri deposunda paralel kopyayı yapılandırmanın mümkün olup olmadığını ve "Kopya paralelliği derecesi" bölümünde ayarlanabilecek değer aralığını da bilmiyorsunuz.

  • Öneri: Paralel kopya paralelliği denetler ve "Kopya paralelliği derecesi" bölümü sıfır olmayan bir değere ayarlanabilir. Çok fazla sayı Dynamics Server tarafında azaltmaya neden olabilir ve bu da aktarım hızını azaltabilir, ancak şimdi azaltma genel SDK'sı alınarak işlenir.

    Kopya paralellik derecesi bölümünün diyagramı.

Dynamics türü dönüştürme

  • Belirtiler: GUID'yi Dynamics kaynağındaki bir dizeye dönüştürmeye çalışırsınız, ancak bir hatayla karşılaşırsınız.

  • Neden: Kaynak olarak Dynamics kullanıldığında, tür dönüştürme desteklenmez.

  • Öneri: Hazırlamayı etkinleştirin ve yeniden deneyin.

İlgili içerik

Daha fazla sorun giderme yardımı için şu kaynakları deneyin: