Memecahkan masalah konektor di Azure Data Factory dan Azure Synapse Analytics
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.
- Penyimpanan Blob Azure
- Azure Cosmos DB (termasuk konektor Azure Cosmos DB for NoSQL)
- Azure Data Lake (Gen1 dan Gen2)
- Azure Database untuk PostgreSQL
- Penyimpanan Azure Files
- Azure Synapse Analytics, Azure SQL Database, dan SQL Server
- DB2
- Format teks terpisah
- Dynamics 365, Dataverse (Common Data Service), dan Dynamics CRM
- FTP, SFTP, dan HTTP
- Hive
- Oracle
- Format ORC
- Format Parquet
- REST
- Salesforce dan Salesforce Service Cloud
- Daftar Online SharePoint
- Format XML
Kesalahan Aktivitas Penyalinan Umum
Kesalahan berikut bersifat umum untuk aktivitas salin dan dapat terjadi dengan konektor apa pun.
Kode kesalahan: 2200 - UserErrorOdbcOperationFailed
Pesan:
The underlying connection was closed: An unexpected error occurred on a send.Penyebab: Ini biasanya menunjukkan kegagalan autentikasi selama operasi transfer data. Ini dapat terjadi ketika pihak jarak jauh menutup aliran transportasi.
Reccomendation:
- Verifikasi koneksi sumber dan uji untuk memastikan koneksi berfungsi dengan benar.
- Periksa metode autentikasi yang digunakan untuk koneksi.
- Tinjau pengaturan konfigurasi firewall untuk Azure Cosmos DB untuk memastikan mereka mengizinkan lalu lintas yang diperlukan.
Kode kesalahan: 20000 - 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: 20002 - JniException
Pesan:
An error occurred when invoking Java Native Interface.Penyebab: Jika pesan kesalahan berisi "Tidak dapat membuat JVM: JNI mengembalikan kode [-6][panggilan JNI gagal: Argumen tidak valid.]," penyebab yang mungkin adalah bahwa JVM tidak dapat dibuat karena beberapa argumen ilegal (global) ditetapkan.
Rekomendasi: Masuk ke komputer yang menghosting 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: 20020 - 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, dan evaluasi apakah Anda dapat menonaktifkan FIPS pada komputer IR yang dihost sendiri.
Atau, jika Anda hanya ingin melewati FIPS dan membuat aktivitas berjalan berhasil, lakukan langkah-langkah berikut:
Buka folder tempat IR yang dihost sendiri diinstal. Jalurnya biasanya C:\Program Files\Microsoft Integration Runtime <versi IR>\Shared.
Buka file diawp.exe.config lalu, di akhir bagian
<runtime>, tambahkan<enforceFIPSPolicy enabled="false"/>, seperti yang diperlihatkan di sini:
Simpan file, lalu mulai ulang mesin IR yang dihost sendiri.
Kode kesalahan: 20150 - 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: 20151 - 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: 20152 - OAuth2AccessTokenTypeNotSupported
Pesan:
The token 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: 20153 - 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: 20523 - 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: 20551 - QueryMissingFormatSettingsInDataset
Pesan:
The format settings are missing in dataset %dataSetName;.Penyebab: Jenis 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: 20552 - 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: 20701 - 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 diizinkan.
Kode kesalahan: 20703 - 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 diizinkan.
Kode kesalahan: 20704 - 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: 20705 - 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: 20741 - 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: 20742 - 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: 20743 - 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: 20744 - SkipForbiddenFileNotSupportedForThisConnector
Pesan:
Skip forbidden file is not supported for this connector: ('%connectorName;').Recommendation: Hapus 'fileForbidden' dari pengaturan skipErrorFile di payload aktivitas salin.
Kode kesalahan: 20745 - 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: 20746 - SkipInvalidFileNameNotSupportedForSource
Pesan:
Skip invalid file name is not supported for '%connectorName;' source.Recommendation: Hapus 'invalidFileName' dari pengaturan skipErrorFile di payload aktivitas salin.
Kode kesalahan: 20747 - SkipInvalidFileNameNotSupportedForSink
Pesan:
Skip invalid file name is not supported for '%connectorName;' sink.Recommendation: Hapus 'invalidFileName' dari pengaturan skipErrorFile di payload aktivitas salin.
Kode kesalahan: 20748 - 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: 20771 - 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: 20772 - DeleteFilesAfterCompletionNotSupportedForThisConnector
Pesan:
'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').Recommendation: Hapus pengaturan 'deleteFilesAfterCompletion' di payload aktivitas salin.
Kode kesalahan: 27002 - 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: 9611 - 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 nonkueri dan penyimpanan data Anda didukung. Atau, pertimbangkan untuk menggunakan prosedur tersimpan yang mengembalikan hasil dummy untuk menjalankan skrip nonkueri Anda.
Kode kesalahan: 11775
Pesan:
Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'Penyebab: Penyebab pasti tergantung pada teks yang dikembalikan di
'%'. Jika waktu operasi habis, itu bisa terjadi karena instans PostgreSQL dihentikan atau karena metode konektivitas jaringan yang dikonfigurasi untuk instans Anda tidak mengizinkan koneksi dari Integration Runtime yang dipilih. Pengguna atau kata sandi yang disediakan salah. Jika 28P01: autentikasi kata sandi gagal untuk pengguna <yang Anda gunakan>, itu berarti bahwa pengguna yang disediakan tidak ada dalam instans atau kata sandi salah. Jika itu adalah 28000: tidak ada entri pg_hba.conf untuk host "###.##", pengguna "<youruser>", database "<yourdatabase>", tidak ada enkripsi, itu berarti bahwa metode enkripsi yang dipilih tidak kompatibel dengan konfigurasi server.Rekomendasi: Konfirmasikan bahwa pengguna yang disediakan ada dalam instans PostgreSQL Anda dan bahwa kata sandi sesuai dengan yang saat ini ditetapkan untuk pengguna tersebut. Pastikan bahwa metode enkripsi yang dipilih diterima oleh instans PostgreSQL Anda, berdasarkan konfigurasinya saat ini. Jika metode konektivitas jaringan instans Anda dikonfigurasi untuk akses Privat (integrasi jaringan virtual), gunakan Runtime Integrasi yang Dihost sendiri (IR) untuk menyambungkannya. Jika dikonfigurasi untuk Akses publik (alamat IP yang diizinkan), disarankan untuk menggunakan runtime integrasi Azure dengan jaringan virtual terkelola dan menyebarkan titik akhir privat terkelola untuk menyambungkan ke instans Anda. Saat dikonfigurasi untuk Akses publik (alamat IP yang diizinkan) alternatif yang kurang direkomendasikan terdiri dari pembuatan aturan firewall dalam instans Anda untuk memungkinkan lalu lintas yang berasal dari alamat IP yang digunakan oleh Runtime integrasi Azure yang Anda gunakan.
Konten terkait
Untuk bantuan pemecahan masalah lainnya, coba sumber daya ini: