Memecahkan masalah konektor di Azure Data Factory dan Azure Synapse Analytics

Artikel
10/20/2023

BERLAKU UNTUK:Azure Data Factory Azure Synapse Analytics

Tip

Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!

Artikel ini menjelaskan cara memecahkan masalah konektor di Azure Data Factory dan Azure Synapse Analytics.

Masalah spesifik konektor

Anda dapat merujuk ke halaman pemecahan masalah untuk setiap konektor untuk melihat masalah khusus dengan penjelasan tentang penyebabnya dan rekomendasi untuk mengatasinya.

Kesalahan Aktivitas Penyalinan Umum

Kesalahan di bawah ini umum untuk aktivitas salin dan bisa terjadi dengan konektor apa pun.

Kode kesalahan: JreNotFound

Pesan: 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.
Penyebab: IR yang dihost sendiri tidak dapat menemukan Java Runtime. Java Runtime diperlukan untuk membaca sumber tertentu.
Rekomendasi: Periksa lingkungan runtime integrasi Anda, lihat Menggunakan Runtime Integrasi yang dihost sendiri.

Kode kesalahan: WildcardPathSinkNotSupported

Pesan: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.
Penyebab: Himpunan data sink tidak mendukung nilai kartu bebas.
Rekomendasi: Periksa himpunan data sink, dan tulis ulang jalur tanpa menggunakan nilai wildcard.

Masalah FIPS

Gejala: Aktivitas salin gagal pada mesin IR yang dihost sendiri yang diaktifkan FIPS dengan pesan kesalahan berikut: This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.
Penyebab: Kesalahan ini mungkin terjadi saat Anda menyalin data dengan konektor seperti Azure Blob, SFTP, dan sebagainya. Standar Pemrosesan Informasi Federal (FIPS) mendefinisikan seperangkat algoritma kriptografi tertentu yang diizinkan untuk digunakan. Ketika mode FIPS diaktifkan pada mesin, beberapa kelas kriptografi yang menyalin aktivitas tergantung pada diblokir dalam beberapa skenario.
Resolusi: Pelajari mengapa kami tidak merekomendasikan "Mode FIPS" lagi, danevaluasi apakah Anda dapat menonaktifkan FIPS pada mesin IR yang dihost sendiri.

Atau, jika hanya ingin melewati FIPS dan membuat aktivitas berjalan berhasil, lakukan hal berikut:
1. Buka folder tempat IR yang dihost sendiri diinstal. Jalurnya biasanya C:\Program Files\Microsoft Integration Runtime <versi IR>\Shared.
2. Buka file diawp.exe.config lalu, di akhir bagian <runtime>, tambahkan <enforceFIPSPolicy enabled="false"/>, seperti yang diperlihatkan di sini:
3. Simpan file, lalu mulai ulang mesin IR yang dihost sendiri.

Kode kesalahan: JniException

Pesan: An error occurred when invoking Java Native Interface.
Penyebab: Jika pesan kesalahan berisi "Tidak dapat membuat JVM: kode pengembalian JNI [-6][JNI panggilan gagal: Argumen tidak valid.]", kemungkinan penyebabnya adalah bahwa JVM tidak dapat dibuat karena beberapa argumen ilegal (global) ditetapkan.
Rekomendasi: Masuk ke mesin yang meng-host setiap simpul runtime integrasi yang dihost sendiri. Periksa untuk memastikan bahwa variabel sistem diatur dengan benar, sebagai berikut: _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G. Mulai ulang semua simpul runtime integrasi, lalu jalankan ulang alur tersebut.

Kode kesalahan: GetOAuth2AccessTokenErrorResponse

Pesan: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.
Penyebab: ID klien atau rahasia klien Anda tidak valid, dan autentikasi gagal di server otorisasi Anda.
Recommendation: Perbaiki semua pengaturan aliran kredensial klien OAuth2 dari server otorisasi Anda.

Kode kesalahan: FailedToGetOAuth2AccessToken

Pesan: Failed to get access token from your token endpoint. Error message: %errorMessage;.
Penyebab: Setelan alur kredensial klien OAuth2 tidak valid.
Recommendation: Perbaiki semua pengaturan aliran kredensial klien OAuth2 dari server otorisasi Anda.

Kode kesalahan: OAuth2AccessTokenTypeNotSupported

Pesan: The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.
Penyebab: Server otorisasi Anda tidak didukung.
Recommendation: Gunakan server otorisasi yang dapat mengembalikan token dengan jenis token yang didukung.

Kode kesalahan: OAuth2ClientIdColonNotAllowed

Pesan: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.
Penyebab: Klien Anda menyertakan karakter yang tidak valid titik dua (:).
Recommendation: Gunakan ID klien yang valid.

Kode kesalahan: ManagedIdentityCredentialObjectNotSupported

Pesan: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Recommendation: Periksa versi yang didukung dan tingkatkan runtime integrasi ke versi yang lebih tinggi.

Kode kesalahan: QueryMissingFormatSettingsInDataset

Pesan: The format settings are missing in dataset %dataSetName;.
Penyebab: Tipe himpunan data adalah Biner, yang tidak didukung.
Recommendation: Gunakan himpunan data DelimitedText, Json, Avro, Orc, atau Parquet sebagai gantinya.
Penyebab: Untuk penyimpanan file, pengaturan format hilang dalam himpunan data.
Recommendation: Batal pilih "Salinan biner" dalam himpunan data, dan atur pengaturan format yang benar.

Kode kesalahan: QueryUnsupportedCommandBehavior

Pesan: The command behavior "%behavior;" is not supported.
Recommendation: Jangan menambahkan perilaku perintah sebagai parameter untuk pratinjau atau URL permintaan GetSchema API.

Kode kesalahan: DataConsistencyFailedToGetSourceFileMetadata

Pesan: Failed to retrieve source file ('%name;') metadata to validate data consistency.
Penyebab: Ada masalah sementara pada penyimpanan data sink, atau mengambil metadata dari penyimpanan data sink tidak diperbolehkan.

Kode kesalahan: DataConsistencyFailedToGetSinkFileMetadata

Pesan: Failed to retrieve sink file ('%name;') metadata to validate data consistency.
Penyebab: Ada masalah sementara pada penyimpanan data sink, atau mengambil metadata dari penyimpanan data sink tidak diperbolehkan.

Kode kesalahan: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

Pesan: Data consistency validation is not supported in current copy activity settings.
Penyebab: Validasi konsistensi data hanya didukung dalam skenario salinan biner langsung.
Recommendation: Hapus properti 'validateDataConsistency' di payload aktivitas salin.

Kode kesalahan: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

Pesan: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.
Recommendation: Periksa versi runtime integrasi yang didukung dan tingkatkan ke versi yang lebih tinggi, atau hapus properti 'validateDataConsistency' dari aktivitas salin.

Kode kesalahan: SkipMissingFileNotSupportedForNonDirectBinaryCopy

Pesan: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Recommendation: Hapus 'fileMissing' dari pengaturan skipErrorFile di payload aktivitas salin.

Kode kesalahan: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

Pesan: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.
Recommendation: Hapus 'dataInconsistency' dari pengaturan skipErrorFile di payload aktivitas salin.

Kode kesalahan: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

Pesan: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Recommendation: Hapus 'fileForbidden' dari pengaturan skipErrorFile di payload aktivitas salin.

Kode kesalahan: SkipForbiddenFileNotSupportedForThisConnector

Pesan: Skip forbidden file is not supported for this connector: ('%connectorName;').
Recommendation: Hapus 'fileForbidden' dari pengaturan skipErrorFile di payload aktivitas salin.

Kode kesalahan: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

Pesan: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.
Recommendation: Hapus 'invalidFileName' dari pengaturan skipErrorFile di payload aktivitas salin.

Kode kesalahan: SkipInvalidFileNameNotSupportedForSource

Pesan: Skip invalid file name is not supported for '%connectorName;' source.
Recommendation: Hapus 'invalidFileName' dari pengaturan skipErrorFile di payload aktivitas salin.

Kode kesalahan: SkipInvalidFileNameNotSupportedForSink

Pesan: Skip invalid file name is not supported for '%connectorName;' sink.
Recommendation: Hapus 'invalidFileName' dari pengaturan skipErrorFile di payload aktivitas salin.

Kode kesalahan: SkipAllErrorFileNotSupportedForNonBinaryCopy

Pesan: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.
Recommendation: Hapus 'allErrorFile' di pengaturan skipErrorFile di payload aktivitas salin.

Kode kesalahan: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

Pesan: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.
Recommendation: Hapus pengaturan 'deleteFilesAfterCompletion' atau gunakan salinan biner langsung.

Kode kesalahan: DeleteFilesAfterCompletionNotSupportedForThisConnector

Pesan: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').
Recommendation: Hapus pengaturan 'deleteFilesAfterCompletion' di payload aktivitas salin.

Kode kesalahan: FailedToDownloadCustomPlugins

Pesan: Failed to download custom plugins.
Penyebab: Tautan unduhan tidak valid atau masalah konektivitas sementara.
Recommendation: Coba kembali jika pesan menunjukkan bahwa hal tersebut adalah masalah sementara. Jika masalah berlanjut, hubungi tim dukungan.

Kesalahan konektor umum

Kode kesalahan: UserErrorOdbcInvalidQueryString

Pesan: The following ODBC Query is not valid: '%'.
Penyebab: Anda memberikan kueri yang salah atau tidak valid untuk mengambil data/skema.
Rekomendasi: Verifikasi bahwa kueri Anda valid dan dapat mengembalikan data/skema. Gunakan Aktivitas skrip jika Anda ingin menjalankan skrip non-kueri dan penyimpanan data Anda didukung. Atau, pertimbangkan untuk menggunakan prosedur tersimpan yang mengembalikan hasil dummy untuk menjalankan skrip non-kueri Anda.

Kode kesalahan: FailToResolveParametersInExploratoryController

Pesan: The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.
Penyebab: Layanan memiliki batasan untuk mendukung layanan tertaut yang mereferensikan layanan tertaut lain dengan parameter untuk koneksi pengujian atau data pratinjau. Misalnya, meneruskan parameter dari Key Vault ke layanan tertaut dapat terjadi masalah.
Rekomendasi: Hapus parameter dalam layanan tertaut yang dirujuk untuk menghilangkan kesalahan. Jika tidak, jalankan alur tanpa menguji koneksi atau mempratinjau data.

Untuk bantuan pemecahan masalah lainnya, coba sumber daya ini: