Azure Data Factory ve Azure Synapse Analytics bağlayıcılarıyla ilgili sorunları giderme

Makale
10/20/2023

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 Analytics'te bağlayıcı sorunlarını giderme adımları açıklanmaktadır.

Bağlan veya özel sorunlar

Her bağlayıcının sorun giderme sayfalarına başvurarak, her bağlayıcıya özgü sorunları ve bunların nedenlerinin açıklamalarını ve bunları çözmeye yönelik önerileri görebilirsiniz.

Genel kopyalama etkinliği hataları

Aşağıdaki hatalar kopyalama etkinliği için geneldir ve herhangi bir bağlayıcıda oluşabilir.

Hata kodu: JreNotFound

İleti: Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.
Neden: Şirket içinde barındırılan IR Java Çalışma Zamanı'nı bulamıyor. Belirli kaynakları okumak için Java Çalışma Zamanı gereklidir.
Öneri: Tümleştirme çalışma zamanı ortamınızı denetleyin, bkz . Şirket içinde barındırılan Integration Runtime kullanma.

Hata kodu: WildcardPathSinkNotSupported

İleti: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Neden: Havuz veri kümesi joker karakter değerlerini desteklemez.
Öneri: Havuz veri kümesini denetleyin ve joker karakter değeri kullanmadan yolu yeniden yazın.

FIPS sorunu

Belirtiler: Kopyalama etkinliği FIPS özellikli şirket içinde barındırılan bir IR makinesinde aşağıdaki hata iletisiyle başarısız oluyor:This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.
Neden: Azure Blob, SFTP gibi bağlayıcılarla veri kopyaladığınızda bu hata oluşabilir. Federal Bilgi İşleme Standartları (FIPS), kullanılmasına izin verilen belirli bir şifreleme algoritmaları kümesini tanımlar. Makinede FIPS modu etkinleştirildiğinde, kopyalama etkinliğinin bağımlı olduğu bazı şifreleme sınıfları bazı senaryolarda engellenir.
Çözüm: Neden artık "FIPS Modu" önermediğimiz hakkında bilgi edinin ve şirket içinde barındırılan IR makinenizde FIPS'yi devre dışı bırakıp devre dışı bırakamayacağınızı değerlendirin.

Alternatif olarak, yalnızca FIPS'yi atlamak ve etkinlik çalıştırmalarının başarılı olmasını sağlamak istiyorsanız aşağıdakileri yapın:
1. Şirket içinde barındırılan IR'nin yüklü olduğu klasörü açın. Yol genellikle C:\Program Files\Microsoft Integration Runtime <IR version>\Shared şeklindedir.
2. diawp.exe.config dosyasını açın ve bölümün <runtime> sonunda, burada gösterildiği gibi öğesini ekleyin<enforceFIPSPolicy enabled="false"/>:
3. Dosyayı kaydedin ve şirket içinde barındırılan IR makinesini yeniden başlatın.

Hata kodu: JniException

İleti: An error occurred when invoking Java Native Interface.
Neden: Hata iletisi "JVM oluşturulamıyor: JNI dönüş kodu [-6][JNI çağrısı başarısız oldu: Geçersiz bağımsız değişkenler.]" içeriyorsa, olası neden bazı geçersiz (genel) bağımsız değişkenler ayarlandığından JVM'nin oluşturulamamasıdır.
Öneri: Şirket içinde barındırılan tümleştirme çalışma zamanınızın her düğümünü barındıran makinede oturum açın. Sistem değişkeninin aşağıdaki gibi doğru ayarlandığından emin olun: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Tümleştirme çalışma zamanı düğümlerini yeniden başlatın ve işlem hattını yeniden çalıştırın.

Hata kodu: GetOAuth2AccessTokenErrorResponse

İleti: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
Neden: İstemci kimliğiniz veya gizli anahtarınız geçersiz ve kimlik doğrulaması yetkilendirme sunucunuzda başarısız oldu.
Öneri: Yetkilendirme sunucunuzun tüm OAuth2 istemci kimlik bilgisi akışı ayarlarını düzeltin.

Hata kodu: FailedToGetOAuth2AccessToken

İleti: Failed to get access token from your token endpoint. Error message: %errorMessage;.
Neden: OAuth2 istemci kimlik bilgisi akışı ayarları geçersiz.
Öneri: Yetkilendirme sunucunuzun tüm OAuth2 istemci kimlik bilgisi akışı ayarlarını düzeltin.

Hata kodu: OAuth2AccessTokenTypeNotSupported

İleti: The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
Neden: Yetkilendirme sunucunuz desteklenmiyor.
Öneri: Desteklenen belirteç türlerine sahip belirteçleri döndürebilen bir yetkilendirme sunucusu kullanın.

Hata kodu: OAuth2ClientIdColonNotAllowed

İleti: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
Neden: İstemci kimliğiniz geçersiz karakter iki nokta üst üste (): içeriyor.
Öneri: Geçerli bir istemci kimliği kullanın.

Hata kodu: ManagedIdentityCredentialObjectNotSupported

İleti: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Öneri: Desteklenen sürümü denetleyin ve tümleştirme çalışma zamanını daha yüksek bir sürüme yükseltin.

Hata kodu: QueryMissingFormat Ayarlar InDataset

İleti: The format settings are missing in dataset %dataSetName;.
Neden: Veri kümesi türü, desteklenmeyen İkili'dir.
Öneri: Bunun yerine DelimitedText, Json, Avro, Orc veya Parquet veri kümesini kullanın.
Neden: Dosya depolama için, veri kümesinde biçim ayarları eksik.
Öneri: Veri kümesindeki "İkili kopya" seçimini kaldırın ve doğru biçim ayarlarını yapın.

Hata kodu: QueryUnsupportedCommandBehavior

İleti: The command behavior "%behavior;" is not supported.
Öneri: Komut davranışını önizleme veya GetSchema API istek URL'si için parametre olarak eklemeyin.

Hata kodu: DataConsistencyFailedToGetSourceFileMetadata

İleti: Failed to retrieve source file ('%name;') metadata to validate data consistency.
Neden: Havuz veri deposunda geçici bir sorun var veya havuz veri deposundan meta verileri almaya izin verilmiyor.

Hata kodu: DataConsistencyFailedToGetSinkFileMetadata

İleti: Failed to retrieve sink file ('%name;') metadata to validate data consistency.
Neden: Havuz veri deposunda geçici bir sorun var veya havuz veri deposundan meta verileri almaya izin verilmiyor.

Hata kodu: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

İleti: Data consistency validation is not supported in current copy activity settings.
Neden: Veri tutarlılığı doğrulaması yalnızca doğrudan ikili kopyalama senaryosunda desteklenir.
Öneri: Kopyalama etkinliği yükündeki 'validateDataConsistency' özelliğini kaldırın.

Hata kodu: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

İleti: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Öneri: Desteklenen tümleştirme çalışma zamanı sürümünü denetleyin ve daha yüksek bir sürüme yükseltin veya kopyalama etkinliklerinden 'validateDataConsistency' özelliğini kaldırın.

Hata kodu: SkipMissingFileNotSupportedForNonDirectBinaryCopy

İleti: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Öneri: Kopyalama etkinliği yükünde skipErrorFile ayarının 'fileMissing'ini kaldırın.

Hata kodu: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

İleti: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
Öneri: Kopyalama etkinliği yükündeki skipErrorFile ayarının 'dataInconsistency' öğesini kaldırın.

Hata kodu: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

İleti: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Öneri: Kopyalama etkinliği yükündeki skipErrorFile ayarının 'fileForbidden' öğesini kaldırın.

Hata kodu: SkipForbiddenFileNotSupportedForThis Bağlan or

İleti: Skip forbidden file is not supported for this connector: ('%connectorName;').
Öneri: Kopyalama etkinliği yükündeki skipErrorFile ayarının 'fileForbidden' öğesini kaldırın.

Hata kodu: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

İleti: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Öneri: Kopyalama etkinliği yükündeki skipErrorFile ayarının 'invalidFileName' öğesini kaldırın.

Hata kodu: SkipInvalidFileNameNotSupportedForSource

İleti: Skip invalid file name is not supported for '%connectorName;' source.
Öneri: Kopyalama etkinliği yükündeki skipErrorFile ayarının 'invalidFileName' öğesini kaldırın.

Hata kodu: SkipInvalidFileNameNotSupportedForSink

İleti: Skip invalid file name is not supported for '%connectorName;' sink.
Öneri: Kopyalama etkinliği yükündeki skipErrorFile ayarının 'invalidFileName' öğesini kaldırın.

Hata kodu: SkipAllErrorFileNotSupportedForNonBinaryCopy

İleti: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
Öneri: Kopyalama etkinliği yükündeki skipErrorFile ayarındaki 'allErrorFile' öğesini kaldırın.

Hata kodu: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

İleti: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
Öneri: 'deleteFilesAfterCompletion' ayarını kaldırın veya doğrudan ikili kopyayı kullanın.

Hata kodu: DeleteFilesAfterCompletionNotSupportedForThis Bağlan or

İleti: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Öneri: Kopyalama etkinliği yükündeki 'deleteFilesAfterCompletion' ayarını kaldırın.

Hata kodu: FailedToDownloadCustomPlugins

İleti: Failed to download custom plugins.
Neden: Geçersiz indirme bağlantıları veya geçici bağlantı sorunları.
Öneri: İletinin geçici bir sorun olduğunu göstermesi durumunda yeniden deneyin. Sorun devam ederse destek ekibine başvurun.

Genel bağlayıcı hataları

Hata kodu: UserErrorOdbcInvalidQueryString

İleti: The following ODBC Query is not valid: '%'.
Neden: Verileri/şemaları getirmek için yanlış veya geçersiz bir sorgu sağlarsınız.
Öneri: Sorgunuzun geçerli olduğunu ve veri/şema döndürebildiğini doğrulayın. Sorgu olmayan betikleri yürütmek istiyorsanız ve veri deponuz destekleniyorsa Betik etkinliğini kullanın. Alternatif olarak, sorgu olmayan betiklerinizi yürütmek için sahte bir sonuç döndüren saklı yordamı kullanmayı göz önünde bulundurun.

Hata kodu: FailToResolveParametersInExploratoryController

İleti: The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
Neden: Hizmetin, test bağlantısı veya önizleme verileri parametreleriyle başka bir bağlı hizmete başvuran bağlı hizmeti desteklemeye yönelik sınırlamaları vardır. Örneğin, key vault'tan bağlı bir hizmete parametre geçirme sorunu oluşabilir.
Öneri: Hatayı ortadan kaldırmak için başvuruda bulunılan bağlı hizmetteki parametreleri kaldırın. Aksi takdirde, bağlantıyı test etmeden veya verileri önizlemeden işlem hattını çalıştırın.

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