Memecahkan masalah alur Azure Data Factory dan Synapse

  • Artikel

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 membahas metode pemecahan masalah umum untuk aktivitas kontrol eksternal di alur Azure Data Factory dan Synapse.

Konektor dan aktivitas penyalinan

Untuk masalah konektor seperti kesalahan pertemuan menggunakan aktivitas penyalinan, lihat artikel Memecahkan Masalah Konektor.

Azure Databricks

Kode Galat: 3200

  • Pesan: Kesalahan 403.

  • Penyebab: The Databricks access token has expired.

  • Rekomendasi: Secara default, token akses Azure Databricks valid selama 90 hari. Buat token baru dan perbarui layanan tertaut.

Kode galat: 3201

  • Pesan: Missing required field: settings.task.notebook_task.notebook_path.

  • Penyebab: Bad authoring: Notebook path not specified correctly.

  • Rekomendasi: Tentukan jalur notebook di aktivitas Databricks.


  • Pesan: Cluster... does not exist.

  • Penyebab: Authoring error: Databricks cluster does not exist or has been deleted.

  • Rekomendasi: Verifikasi bahwa ada kluster Databricks.


  • Pesan: Invalid Python file URI... Please visit Databricks user guide for supported URI schemes.

  • Penyebab: Bad authoring.

  • Rekomendasi: Tentukan jalur absolut untuk skema penanganan ruang kerja, atau dbfs:/folder/subfolder/foo.py untuk file yang disimpan di Databricks File System (DFS).


  • Pesan: {0} LinkedService should have domain and accessToken as required properties.

  • Penyebab: Bad authoring.

  • Rekomendasi: Verifikasi penentuan layanan tertaut.


  • Pesan: {0} LinkedService should specify either existing cluster ID or new cluster information for creation.

  • Penyebab: Bad authoring.

  • Rekomendasi: Verifikasi penentuan layanan tertaut.


  • Pesan: Node type Standard_D16S_v3 is not supported. Supported node types: Standard_DS3_v2, Standard_DS4_v2, Standard_DS5_v2, Standard_D8s_v3, Standard_D16s_v3, Standard_D32s_v3, Standard_D64s_v3, Standard_D3_v2, Standard_D8_v3, Standard_D16_v3, Standard_D32_v3, Standard_D64_v3, Standard_D12_v2, Standard_D13_v2, Standard_D14_v2, Standard_D15_v2, Standard_DS12_v2, Standard_DS13_v2, Standard_DS14_v2, Standard_DS15_v2, Standard_E8s_v3, Standard_E16s_v3, Standard_E32s_v3, Standard_E64s_v3, Standard_L4s, Standard_L8s, Standard_L16s, Standard_L32s, Standard_F4s, Standard_F8s, Standard_F16s, Standard_H16, Standard_F4s_v2, Standard_F8s_v2, Standard_F16s_v2, Standard_F32s_v2, Standard_F64s_v2, Standard_F72s_v2, Standard_NC12, Standard_NC24, Standard_NC6s_v3, Standard_NC12s_v3, Standard_NC24s_v3, Standard_L8s_v2, Standard_L16s_v2, Standard_L32s_v2, Standard_L64s_v2, Standard_L80s_v2.

  • Penyebab: Bad authoring.

  • Rekomendasi: Lihat pesan kesalahan.


Kode galat: 3202

  • Pesan: There were already 1000 jobs created in past 3600 seconds, exceeding rate limit: 1000 job creations per 3600 seconds.

  • Penyebab: Too many Databricks runs in an hour.

  • Rekomendasi: Periksa semua alur yang menggunakan ruang kerja Databricks ini untuk tingkat pembuatan pekerjaan alur tersebut. Jika alur meluncurkan terlalu banyak eksekusi Databricks secara agregat, migrasikan beberapa alur ke ruang kerja baru.


  • Pesan: Could not parse request object: Expected 'key' and 'value' to be set for JSON map field base_parameters, got 'key: "..."' instead.

  • Penyebab: Authoring error: No value provided for the parameter.

  • Rekomendasi: Periksa JSON alur dan pastikan semua parameter di notebook baseParameters menentukan nilai tak kosong.


  • Pesan: User: SimpleUserContext{userId=..., name=user@company.com, orgId=...} is not authorized to access cluster.

  • Penyebab: Pengguna yang membuat token akses tidak diizinkan untuk mengakses kluster Databricks yang ditentukan dalam layanan tertaut.

  • Rekomendasi: Pastikan pengguna memiliki izin yang diperlukan di ruang kerja.


  • Pesan: Job is not fully initialized yet. Please retry later.

  • Penyebab: Pekerjaan belum diinisialisasi.

  • Rekomendasi: Tunggu dan coba lagi nanti.

Kode galat: 3203

  • Pesan: The cluster is in Terminated state, not available to receive jobs. Please fix the cluster or retry later.

  • Penyebaran: Kluster dihentikan. Untuk kluster interaktif, masalah ini mungkin berupa kondisi jenis.

  • Rekomendasi: Untuk menghindari kesalahan ini, gunakan kluster pekerjaan.

Kode galat: 3204

  • Pesan: Job execution failed.

  • Penyebab: Pesan kesalahan menunjukkan berbagai masalah, seperti status kluster yang tidak terduga atau aktivitas tertentu. Pesan kesalahan sering kali tidak muncul.

  • Rekomendasi: N/A

Kode galat: 3208

  • Pesan: An error occurred while sending the request.

  • Penyebab: Koneksi jaringan ke layanan Databricks terganggu.

  • Rekomendasi: Jika Anda menggunakan IR yang dihost sendiri, pastikan koneksi jaringan dapat diandalkan dari simpul runtime integrasi. Jika Anda menggunakan runtime integrasi Azure, upaya coba lagi biasanya berfungsi.

Output eksekusi Boolean mulai datang sebagai string bukan int yang diharapkan

  • Gejala: Output eksekusi Boolean Anda mulai datang sebagai string (misalnya, "0" atau "1") bukan int yang diharapkan (misalnya, 0 atau 1).

    Screenshot of the Databricks pipeline.

    Anda melihat perubahan ini pada tanggal 28 September 2021 sekitar pukul 9 pagi IST saat alur Anda yang mengandalkan output ini mulai gagal. Tidak ada perubahan yang dilakukan pada alur, dan data output Boolean tiba seperti yang diharapkan sebelum kegagalan.

    Screenshot of the difference in the output.

  • Penyebab: Masalah ini disebabkan oleh perubahan baru-baru ini, yaitu menurut desain. Setelah perubahan, jika hasilnya adalah angka yang dimulai dengan nol, Azure Data Factory akan mengonversi angka ke nilai oktal, yang merupakan bug. Angka ini selalu 0 atau 1, yang tidak pernah menyebabkan masalah sebelum perubahan. Jadi, untuk memperbaiki konversi oktal, output string dilewatkan dari eksekusi Notebook sebagaimana adanya.

  • Rekomendasi: Ubah kondisi if menjadi sesuatu seperti if(value=="0").

Azure Data Lake Analytics

Tabel berikut ini berlaku untuk U-SQL.

Kode galat: 2709

  • Pesan: The access token is from the wrong tenant.

  • Penyebab: Penyewa Microsoft Entra salah.

  • Rekomendasi: Penyewa Microsoft Entra salah.


  • Pesan: We cannot accept your job at this moment. The maximum number of queued jobs for your account is 200.

  • Penyebab: Kesalahan ini disebabkan oleh pembatasan pada Data Lake Analytics.

  • Rekomendasi: Kurangi jumlah pekerjaan yang dikirimkan ke Data Lake Analytics. Ubah pemicu dan pengaturan konkurensi pada aktivitas, atau tingkatkan batas pada Data Lake Analytics.


  • Pesan: This job was rejected because it requires 24 AUs. This account's administrator-defined policy prevents a job from using more than 5 AUs.

  • Penyebab: Kesalahan ini disebabkan oleh pembatasan pada Data Lake Analytics.

  • Rekomendasi: Kurangi jumlah pekerjaan yang dikirimkan ke Data Lake Analytics. Ubah pemicu dan pengaturan konkurensi pada aktivitas, atau tingkatkan batas pada Data Lake Analytics.

Kode galat: 2705

  • Pesan: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

  • Penyebab: Sertifikat atau perwakilan layanan tidak memiliki akses ke file dalam penyimpanan.

  • Rekomendasi: Verifikasi bahwa sertifikat atau perwakilan layanan yang disediakan pengguna untuk pekerjaan Data Lake Analytics memiliki akses ke akun Data Lake Analytics, dan instans Data Lake Storage default dari folder akar.

Kode galat: 2711

  • Pesan: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

  • Penyebab: Sertifikat atau perwakilan layanan tidak memiliki akses ke file dalam penyimpanan.

  • Rekomendasi: Verifikasi bahwa sertifikat atau perwakilan layanan yang disediakan pengguna untuk pekerjaan Data Lake Analytics memiliki akses ke akun Data Lake Analytics, dan instans Data Lake Storage default dari folder akar.


  • Pesan: Cannot find the 'Azure Data Lake Store' file or folder.

  • Penyebab: Jalur ke file U-SQL salah, atau info masuk layanan yang ditautkan tidak memiliki akses.

  • Rekomendasi: Verifikasi jalur dan info masuk yang disediakan dalam layanan yang ditautkan.

Kode galat: 2704

  • Pesan: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

  • Penyebab: Sertifikat atau perwakilan layanan tidak memiliki akses ke file dalam penyimpanan.

  • Rekomendasi: Verifikasi bahwa sertifikat atau perwakilan layanan yang disediakan pengguna untuk pekerjaan Data Lake Analytics memiliki akses ke akun Data Lake Analytics, dan instans Data Lake Storage default dari folder akar.

Kode galat: 2707

  • Pesan: Cannot resolve the account of AzureDataLakeAnalytics. Please check 'AccountName' and 'DataLakeAnalyticsUri'.

  • Penyebab: Akun Data Lake Analytics di layanan yang ditautkan salah.

  • Rekomendasi: Verifikasi bahwa akun yang tepat disediakan.

Kode galat: 2703

  • Pesan: Error Id: E_CQO_SYSTEM_INTERNAL_ERROR (or any error that starts with "Error Id:").

  • Penyebab: Kesalahan berasal dari Data Lake Analytics.

  • Rekomendasi: Pekerjaan dikirimkan ke Data Lake Analytics, dan skrip di sana, keduanya gagal. Selidiki di Data Lake Analytics. Di portal, buka akun Data Lake Analytics dan cari pekerjaan dengan menggunakan ID eksekusi aktivitas Data Factory (jangan gunakan ID eksekusi alur). Pekerjaan di sana menyediakan informasi selengkapnya tentang kesalahan, dan akan membantu Anda memecahkan masalah.

    Jika resolusinya tidak jelas, hubungi tim dukungan Data Lake Analytics dan masukkan Universal Resource Locator (URL), yang menyertakan nama akun Anda dan ID pekerjaan.

Fungsi Azure

Kode galat: 3602

  • Pesan: Invalid HttpMethod: '%method;'.

  • Penyebab: Httpmethod yang ditentukan dalam payload aktivitas tidak didukung oleh Aktivitas Fungsi Azure.

  • Rekomendasi: Httpmethods yang didukung antara lain: PUT, POST, GET, DELETE, OPTIONS, HEAD, dan TRACE.

Kode galat: 3603

  • Pesan: Response Content is not a valid JObject.

  • Penyebab: Fungsi Azure yang dipanggil tidak menampilkan Payload JSON dalam respons. Aktivitas fungsi Azure alur Azure Data Factory dan Synapse hanya mendukung konten respons JSON.

  • Rekomendasi: Perbarui fungsi Azure untuk menampilkan Payload JSON yang valid seperti fungsi C# dapat menampilkan (ActionResult)new OkObjectResult("{\"Id\":\"123\"}");

Kode galat: 3606

  • Pesan: Aktivitas fungsi Azure tidak memiliki kunci fungsi.

  • Penyebab: Definisi aktivitas fungsi Azure belum selesai.

  • Rekomendasi: Periksa apakah definisi JSON aktivitas fungsi Azure input memiliki properti bernama functionKey.

Kode galat: 3607

  • Pesan: Azure function activity missing function name.

  • Penyebab: Definisi aktivitas fungsi Azure belum selesai.

  • Rekomendasi: Periksa apakah definisi JSON aktivitas fungsi Azure input memiliki properti bernama functionName.

Kode galat: 3608

  • Pesan: Call to provided Azure function '%FunctionName;' failed with status-'%statusCode;' and message - '%message;'.

  • Penyebab: Detail fungsi Azure dalam definisi aktivitas mungkin salah.

  • Rekomendasi: Perbaiki detail fungsi Azure dan coba lagi.

Kode galat: 3609

  • Pesan: Azure function activity missing functionAppUrl.

  • Penyebab: Definisi aktivitas fungsi Azure belum selesai.

  • Rekomendasi: Periksa apakah definisi JSON aktivitas fungsi Azure input memiliki properti bernama functionAppUrl.

Kode galat: 3610

  • Pesan: There was an error while calling endpoint.

  • Penyebab: URL fungsi mungkin salah.

  • Rekomendasi: Verifikasi bahwa nilai untuk functionAppUrl dalam JSON aktivitas sudah benar dan coba lagi.

Kode galat: 3611

  • Pesan: Azure function activity missing Method in JSON.

  • Penyebab: Definisi aktivitas fungsi Azure belum selesai.

  • Rekomendasi: Periksa apakah definisi JSON aktivitas fungsi Azure input memiliki properti bernama method.

Kode galat: 3612

  • Pesan: Azure function activity missing LinkedService definition in JSON.

  • Penyebab: Definisi aktivitas fungsi Azure belum selesai.

  • Rekomendasi: Pastikan bahwa definisi JSON aktivitas fungsi Azure input memiliki detail layanan yang ditautkan.

Pembelajaran Mesin Azure

Kode galat: 4101

  • Pesan: AzureMLExecutePipeline activity '%activityName;' has invalid value for property '%propertyName;'.

  • Penyebab: Format buruk atau definisi properti %propertyName; hilang.

  • Rekomendasi: Periksa apakah aktivitas %activityName; memiliki properti %propertyName; yang ditentukan dengan data yang benar.

Kode galat: 4110

  • Pesan: AzureMLExecutePipeline activity missing LinkedService definition in JSON.

  • Penyebab: Definisi aktivitas AzureMLExecutePipeline tidak lengkap.

  • Rekomendasi: Pastikan bahwa definisi JSON aktivitas AzureMLExecutePipeline memiliki detail layanan ditautkan dengan benar.

Kode galat: 4111

  • Pesan: AzureMLExecutePipeline activity has wrong LinkedService type in JSON. Expected LinkedService type: '%expectedLinkedServiceType;', current LinkedService type: Expected LinkedService type: '%currentLinkedServiceType;'.

  • Penyebab: Definisi aktivitas salah.

  • Rekomendasi: Pastikan bahwa definisi JSON aktivitas AzureMLExecutePipeline memiliki detail layanan ditautkan dengan benar.

Kode galat: 4112

  • Pesan: AzureMLService linked service has invalid value for property '%propertyName;'.

  • Penyebab: Format buruk atau definisi properti ‘%propertyName;’ hilang.

  • Rekomendasi: Periksa apakah layanan tertaut memiliki properti %propertyName; yang ditentukan dengan data yang benar.

Kode galat: 4121

  • Pesan: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • Penyebab: Info masuk yang digunakan untuk mengakses Azure Machine Learning telah kedaluwarsa.

  • Rekomendasi: Verifikasi bahwa info masuk valid dan coba lagi.

Kode galat: 4122

  • Pesan: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • Penyebab: Info masuk yang disediakan di Layanan Tertaut Azure Machine Learning tidak valid, atau tidak memiliki izin untuk operasi.

  • Rekomendasi: Verifikasi bahwa info masuk di Layanan Tertaut valid, dan memiliki izin untuk mengakses Azure Machine Learning.

Kode galat: 4123

  • Pesan: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • Penyebab: Properti aktivitas seperti pipelineParameters tidak valid untuk alur Azure Machine Learning (ML).

  • Rekomendasi: Periksa apakah nilai properti aktivitas cocok dengan payload yang diharapkan dari alur Azure Pembelajaran Mesin yang diterbitkan yang ditentukan dalam Layanan Tertaut.

Kode galat: 4124

  • Pesan: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • Penyebab: Titik akhir alur Azure Pembelajaran Mesin yang diterbitkan tidak ada.

  • Rekomendasi: Verifikasi bahwa titik akhir alur Azure Machine Learning yang diterbitkan yang ditentukan dalam Layanan Tertaut ada di Azure Machine Learning.

Kode galat: 4125

  • Pesan: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • Penyebab: Terjadi kesalahan server di Azure Machine Learning.

  • Rekomendasi: Coba lagi nanti. Hubungi tim Azure Machine Learning untuk mendapatkan bantuan jika masalah berlanjut.

Kode galat: 4126

  • Pesan: Azure ML pipeline run failed with status: '%amlPipelineRunStatus;'. Azure ML pipeline run Id: '%amlPipelineRunId;'. Please check in Azure Machine Learning for more error logs.

  • Penyebab: Eksekusi alur Azure Pembelajaran Mesin gagal.

  • Rekomendasi: Periksa Azure Machine Learning untuk log kesalahan lainnya, lalu perbaiki alur ML.

Azure Synapse Analytics

Kode galat: 3250

  • Pesan: There are not enough resources available in the workspace, details: '%errorMessage;'

  • Penyebab: Sumber daya tidak mencukupi

  • Rekomendasi: Coba akhiri pekerjaan yang sedang berjalan di ruang kerja, kurangi jumlah vCore yang diminta, tambah kuota ruang kerja, atau gunakan ruang kerja lain.

Kode galat: 3251

  • Pesan: There are not enough resources available in the pool, details: '%errorMessage;'

  • Penyebab: Sumber daya tidak mencukupi

  • Rekomendasi: Coba akhiri tugas yang sedang berjalan di kumpulan, kurangi jumlah vCore yang diminta, tingkatkan ukuran maksimum kumpulan, atau gunakan kumpulan lain.

Kode galat: 3252

  • Pesan: There are not enough vcores available for your spark job, details: '%errorMessage;'

  • Penyebab: Inti virtual tidak mencukup

  • Rekomendasi: Coba kurangi jumlah vCore yang diminta atau tingkatkan kuota vCore Anda. Untuk informasi selengkapnya, lihat Konsep inti Apache Spark.

Kode galat: 3253

  • Pesan: There are substantial concurrent MappingDataflow executions which is causing failures due to throttling under the Integration Runtime used for ActivityId: '%activityId;'.

  • Penyebab: Ambang batas pembatasan tercapai.

  • Rekomendasi: Silakan coba lagi permintaan setelah periode tunggu.

Kode galat: 3254

  • Pesan: AzureSynapseArtifacts linked service has invalid value for property '%propertyName;'.

  • Penyebab: Format buruk atau definisi properti ‘%propertyName;’ hilang.

  • Rekomendasi: Periksa apakah layanan tertaut memiliki properti '%propertyName;' ditentukan dengan data yang benar.

Biasa

Kode galat: 2103

  • Pesan: Please provide value for the required property '%propertyName;'.

  • Penyebab: Nilai yang diperlukan untuk properti belum disediakan.

  • Rekomendasi: Masukkan nilai dari pesan dan coba lagi.

Kode galat: 2104

  • Pesan: The type of the property '%propertyName;' is incorrect.

  • Penyebab: Jenis properti yang disediakan tidak benar.

  • Rekomendasi: Perbaiki jenis properti dan coba lagi.

Kode galat: 2105

  • Pesan: An invalid json is provided for property '%propertyName;'. Encountered an error while trying to parse: '%message;'.

  • Penyebab: Nilai untuk properti tidak valid atau tidak memiliki format yang diharapkan.

  • Rekomendasi: Lihat dokumentasi untuk properti dan verifikasi bahwa nilai yang diberikan menyertakan format dan jenis yang benar.

Kode galat: 2106

  • Pesan: The storage connection string is invalid. %errorMessage;

  • Penyebab: String koneksi untuk penyimpanan tidak valid atau memiliki format tidak benar.

  • Rekomendasi: Buka portal Microsoft Azure dan temukan penyimpanan Anda, lalu salin dan tempel string koneksi ke layanan tertaut Anda dan coba lagi.

Kode galat: 2110

  • Pesan: The linked service type '%linkedServiceType;' is not supported for '%executorType;' activities.

  • Penyebab: Layanan tertaut yang ditentukan dalam aktivitas tidak benar.

  • Rekomendasi: Verifikasi bahwa jenis layanan yang ditautkan adalah salah satu jenis yang didukung untuk aktivitas tersebut. Misalnya, jenis layanan yang ditautkan untuk aktivitas HDI dapat berupa HDInsight atau HDInsightOnDemand.

Kode galat: 2111

  • Pesan: The type of the property '%propertyName;' is incorrect. The expected type is %expectedType;.

  • Penyebab: Jenis properti yang disediakan tidak benar.

  • Rekomendasi: Perbaiki jenis properti dan coba lagi.

Kode galat: 2112

  • Pesan: The cloud type is unsupported or could not be determined for storage from the EndpointSuffix '%endpointSuffix;'.

  • Penyebab: Jenis cloud tidak didukung atau tidak dapat ditentukan untuk penyimpanan dari EndpointSuffix.

  • Rekomendasi: Gunakan penyimpanan di cloud lain dan coba lagi.

Adat

Tabel berikut ini berlaku untuk Azure Batch.

Kode galat: 2500

  • Pesan: Hit unexpected exception and execution failed.

  • Penyebab: Can't launch command, or the program returned an error code.

  • Rekomendasi: Pastikan bahwa file yang dapat dieksekusi ada. Jika program dimulai, verifikasi bahwa stdout.txt dan stderr.txt telah diunggah ke akun penyimpanan. Sebaiknya sertakan log dalam kode Anda untuk penelusuran kesalahan.

Kode galat: 2501

  • Pesan: Cannot access user batch account; please check batch account settings.

  • Penyebab: Nama kumpulan atau kunci akses Batch tidak benar.

  • Rekomendasi: Verifikasi nama kumpulan dan kunci akses Batch di layanan yang ditautkan.

Kode galat: 2502

  • Pesan: Cannot access user storage account; please check storage account settings.

  • Penyebab: Kunci akses atau nama akun penyimpanan salah.

  • Rekomendasi: Verifikasi nama akun penyimpanan dan kunci akses di layanan yang ditautkan.

Kode galat: 2504

  • Pesan: Operation returned an invalid status code 'BadRequest'.

  • Penyebab: Terlalu banyak file dalam folderPath aktivitas kustom. Ukuran total resourceFiles tidak boleh lebih dari 32.768 karakter.

  • Rekomendasi: Hapus file yang tidak perlu, atau buat file Zip dan tambahkan perintah unzip untuk mengekstraknya.

    Misalnya, gunakan powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe

Kode galat: 2505

  • Pesan: Cannot create Shared Access Signature unless Account Key credentials are used.

  • Penyebab: Aktivitas kustom hanya mendukung akun penyimpanan yang menggunakan kunci akses.

  • Rekomendasi: Lihat deskripsi kesalahan.

Kode galat: 2507

  • Pesan: The folder path does not exist or is empty: ...

  • Penyebab: Tidak ada file dalam akun penyimpanan di jalur yang ditentukan.

  • Rekomendasi: Jalur folder harus berisi file yang dapat dieksekusi yang ingin dijalankan.

Kode galat: 2508

  • Pesan: There are duplicate files in the resource folder.

  • Penyebab: Beberapa file dengan nama yang sama berada di sub-folder folderPath yang berbeda.

  • Rekomendasi: Aktivitas kustom meratakan struktur folder di bawah folderPath. Jika Anda perlu mempertahankan struktur folder, buat file zip dan ekstrak di Azure Batch menggunakan perintah unzip.

    Misalnya, gunakan powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe

Kode galat: 2509

  • Pesan: Batch url ... is invalid; it must be in Uri format.

  • Penyebab: URL batch harus mirip dengan https://mybatchaccount.eastus.batch.azure.com

  • Rekomendasi: Lihat deskripsi kesalahan.

Kode galat: 2510

  • Pesan: An error occurred while sending the request.

  • Penyebab: URL batch tidak valid.

  • Rekomendasi: Verifikasi URL batch.

HDInsight

Kode galat: 206

  • Pesan: The batch ID for Spark job is invalid. Please retry your job.

  • Penyebab: Terjadi masalah internal dengan layanan yang menyebabkan kesalahan ini.

  • Rekomendasi: Masalah ini bisa bersifat sementara. Coba lagi tugas setelah beberapa saat.

Kode galat: 207

  • Pesan: Could not determine the region from the provided storage account. Please try using another primary storage account for the on demand HDI.

  • Penyebab: Terjadi kesalahan internal saat mencoba menentukan wilayah dari akun penyimpanan utama.

  • Rekomendasi: Coba penyimpanan lain.

Kode galat: 208

  • Pesan: Service Principal or the MSI authenticator are not instantiated. Please consider providing a Service Principal in the HDI on demand linked service which has permissions to create an HDInsight cluster in the provided subscription and try again.

  • Penyebab: Ada kesalahan internal saat mencoba membaca Perwakilan Layanan atau menginisiasi autentikasi MSI.

  • Rekomendasi: Pertimbangkan untuk menyediakan perwakilan layanan, yang memiliki izin untuk membuat kluster HDInsight dalam langganan yang disediakan dan coba lagi. Verifikasi bahwa Kelola Identitas telah disiapkan dengan benar.

Kode galat: 2300

  • Pesan: Failed to submit the job '%jobId;' to the cluster '%cluster;'. Error: %errorMessage;.

  • Penyebab: Pesan kesalahan berisi pesan yang mirip dengan The remote name could not be resolved.. URI kluster yang disediakan mungkin tidak valid.

  • Rekomendasi: Verifikasi bahwa kluster belum dihapus, dan URI yang disediakan sudah benar. Saat Anda membuka URI di browser, Anda akan melihat UI Ambari. Jika kluster berada dalam jaringan virtual, URI harus berupa URI privat. Untuk membukanya, gunakan Komputer Virtual (VM) yang merupakan bagian dari jaringan virtual yang sama.

    Untuk informasi selengkapnya, lihat Langsung terhubung ke layanan Apache Hadoop.


  • Penyebab: Jika pesan kesalahan berisi pesan yang mirip dengan A task was canceled., waktu pengiriman tugas habis.

  • Rekomendasi: Masalahnya bisa berupa konektivitas HDInsight umum atau konektivitas jaringan. Pertama, konfirmasikan bahwa UI Ambari HDInsight tersedia dari browser apa pun. Kemudian, pastikan bahwa info masuk Anda masih valid.

    Jika Anda menggunakan runtime terintegrasi (IR) yang dihost sendiri, lakukan langkah ini dari VM atau komputer tempat IR yang dihost sendiri diinstal. Lalu coba kirimkan pekerjaan lagi.

    Untuk informasi selengkapnya, baca UI Web Ambari.


  • Penyebab: Jika pesan kesalahan berisi pesan yang mirip User admin is locked out in Ambari dengan atau, kredensial untuk Unauthorized: Ambari user name or password is incorrect HDInsight salah atau telah kedaluwarsa.

  • Rekomendasi: Perbaiki info masuk dan sebarkan ulang layanan tertaut. Pertama, verifikasi bahwa info masuk berfungsi di HDInsight dengan membuka URI kluster di browser apa pun dan mencoba masuk. Jika kredensial tidak berfungsi, Anda dapat mengatur ulang dari portal Microsoft Azure.

    Untuk kluster ESP, atur ulang kata sandi melalui reset kata sandi layanan mandiri.


  • Penyebab: Jika pesan kesalahan berisi pesan yang mirip dengan 502 - Web server received an invalid response while acting as a gateway or proxy server, kesalahan ini akan ditampilkan oleh layanan HDInsight.

  • Rekomendasi: Kesalahan 502 sering terjadi saat proses Server Ambari Anda dimatikan. Anda dapat memulai ulang Layanan Ambari dengan mereboot simpul kepala.

    1. Sambungkan ke salah satu simpul Anda di HDInsight menggunakan SSH.

    2. Identifikasi host simpul kepala aktif Anda dengan menjalankan ping headnodehost.

    3. Sambungkan ke simpul kepala aktif Anda saat Ambari Server berada di simpul kepala yang aktif menggunakan SSH.

    4. Reboot simpul kepala yang aktif.

      Untuk informasi selengkapnya, lihat dokumentasi pemecahan masalah Azure HDInsight. Misalnya:


  • Penyebab: Jika pesan kesalahan berisi pesan yang mirip dengan Unable to service the submit job request as templeton service is busy with too many submit job requests atau Queue root.joblauncher already has 500 applications, cannot accept submission of application, terlalu banyak tugas yang dikirim ke HDInsight secara bersamaan.

  • Rekomendasi: Batasi jumlah tugas bersamaan yang dikirim ke HDInsight. Lihat konkurensi aktivitas jika pekerjaan dikirimkan oleh aktivitas yang sama. Ubah pemicu agar eksekusi alur bersamaan tersebar dari waktu ke waktu.

    Lihat dokumentasi HDInsight menyesuaikan templeton.parallellism.job.submit seperti yang disarankan kesalahan.

Kode galat: 2301

  • Pesan: Could not get the status of the application '%physicalJobId;' from the HDInsight service. Received the following error: %message;. Please refer to HDInsight troubleshooting documentation or contact their support for further assistance.

  • Penyebab: Kluster atau layanan HDInsight mengalami masalah.

  • Rekomendasi: Kesalahan ini terjadi saat layanan tidak menerima respons dari kluster HDInsight saat mencoba meminta status pekerjaan yang sedang berjalan. Masalah ini mungkin ada pada kluster itu sendiri, atau layanan HDInsight mungkin mengalami gangguan.

    Lihat dokumentasi pemecahan masalah HDInsight, atau hubungi dukungan Microsoft untuk bantuan lebih lanjut.

Kode galat: 2302

  • Pesan: Hadoop job failed with exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Contact HDInsight team for further support.

  • Penyebab: Pekerjaan dikirimkan ke kluster HDI dan gagal di sana.

  • Rekomendasi:

  1. Periksa UI Ambari:
    1. Pastikan semua layanan tetap berjalan.
    2. Dari UI Ambari, periksa bagian pemberitahuan di dasbor Anda.
      1. Untuk informasi selengkapnya tentang pemberitahuan dan resolusi untuk pemberitahuan, lihat Mengelola dan Memantau Kluster.
    3. Tinjau memori YARN. Jika memori YARN tinggi, pemrosesan pekerjaan mungkin akan tertunda. Jika Anda tidak memiliki sumber daya yang cukup untuk mengakomodasi aplikasi/pekerjaan Spark Anda, tingkatkan kluster untuk memastikan kluster memiliki memori dan inti yang cukup.
  2. Jalankan Pekerjaan uji sampel.
    1. Jika Anda menjalankan pekerjaan yang sama pada backend HDInsight, periksa apakah ini berhasil. Untuk contoh eksekusi sampel, lihat Jalankan contoh MapReduce yang disertakan di HDInsight
  3. Jika pekerjaan masih gagal di HDInsight, periksa log dan informasi aplikasi, yang akan diberikan kepada Dukungan:
    1. Periksa apakah pekerjaan dikirimkan ke YARN. Jika pekerjaan tidak diserahkan ke yarn, gunakan --master yarn.
    2. Jika aplikasi selesai dieksekusi, kumpulkan waktu mulai dan waktu akhir Aplikasi YARN. Jika aplikasi tidak menyelesaikan eksekusi, kumpulkan Waktu mulai/Waktu peluncuran.
    3. Periksa dan kumpulkan log aplikasi dengan yarn logs -applicationId <Insert_Your_Application_ID>.
    4. Periksa dan kumpulkan log Resource Manager yarn di bagian direktori /var/log/hadoop-yarn/yarn.
    5. Jika langkah belum dapat mengatasi masalah, hubungi tim Azure HDInsight untuk mendapatkan dukungan dan berikan log dan tanda waktu di atas.

Kode galat: 2303

  • Pesan: Hadoop job failed with transient exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Try again or contact HDInsight team for further support.

  • Penyebab: Pekerjaan dikirimkan ke kluster HDI dan gagal di sana.

  • Rekomendasi:

  1. Periksa UI Ambari:
    1. Pastikan semua layanan tetap berjalan.
    2. Dari UI Ambari, periksa bagian pemberitahuan di dasbor Anda.
      1. Untuk informasi selengkapnya tentang pemberitahuan dan resolusi untuk pemberitahuan, lihat Mengelola dan Memantau Kluster.
    3. Tinjau memori YARN. Jika memori YARN tinggi, pemrosesan pekerjaan mungkin akan tertunda. Jika Anda tidak memiliki sumber daya yang cukup untuk mengakomodasi aplikasi/pekerjaan Spark Anda, tingkatkan kluster untuk memastikan kluster memiliki memori dan inti yang cukup.
  2. Jalankan Pekerjaan uji sampel.
    1. Jika Anda menjalankan pekerjaan yang sama pada backend HDInsight, periksa apakah ini berhasil. Untuk contoh eksekusi sampel, lihat Jalankan contoh MapReduce yang disertakan di HDInsight
  3. Jika pekerjaan masih gagal di HDInsight, periksa log dan informasi aplikasi, yang akan diberikan kepada Dukungan:
    1. Periksa apakah pekerjaan dikirimkan ke YARN. Jika pekerjaan tidak diserahkan ke yarn, gunakan --master yarn.
    2. Jika aplikasi selesai dieksekusi, kumpulkan waktu mulai dan waktu akhir Aplikasi YARN. Jika aplikasi tidak menyelesaikan eksekusi, kumpulkan Waktu mulai/Waktu peluncuran.
    3. Periksa dan kumpulkan log aplikasi dengan yarn logs -applicationId <Insert_Your_Application_ID>.
    4. Periksa dan kumpulkan log Resource Manager yarn di bagian direktori /var/log/hadoop-yarn/yarn.
    5. Jika langkah belum dapat mengatasi masalah, hubungi tim Azure HDInsight untuk mendapatkan dukungan dan berikan log dan tanda waktu di atas.

Kode galat: 2304

  • Pesan: MSI authentication is not supported on storages for HDI activities.

  • Penyebab: Layanan tertaut penyimpanan yang digunakan dalam layanan tertaut HDInsight (HDI) atau aktivitas HDI dikonfigurasi dengan autentikasi MSI yang tidak didukung.

  • Rekomendasi: Berikan string koneksi lengkap untuk akun penyimpanan yang digunakan dalam layanan tertaut HDI atau aktivitas HDI.

Kode galat: 2305

  • Pesan: Failed to initialize the HDInsight client for the cluster '%cluster;'. Error: '%message;'

  • Penyebab: Informasi koneksi untuk kluster HDI salah, pengguna yang diberikan tidak memiliki izin untuk melakukan tindakan yang diperlukan, atau layanan HDInsight memiliki masalah dalam menanggapi permintaan dari layanan.

  • Rekomendasi: Verifikasi bahwa informasi pengguna sudah benar, dan UI Ambari untuk kluster HDI dapat dibuka di browser dari VM tempat IR diinstal (untuk IR yang dihost sendiri), atau dapat dibuka dari komputer apa pun (untuk Azure IR).

Kode galat: 2306

  • Pesan: An invalid json is provided for script action '%scriptActionName;'. Error: '%message;'

  • Penyebab: JSON yang disediakan untuk tindakan skrip tidak valid.

  • Rekomendasi: Pesan kesalahan akan membantu mengidentifikasi masalah. Perbaiki konfigurasi json dan coba lagi.

    Untuk informasi selengkapnya, lihat layanan tertaut sesuai permintaan Azure HDInsight.

Kode galat: 2310

  • Pesan: Failed to submit Spark job. Error: '%message;'

  • Penyebab: Layanan mencoba membuat kumpulan di kluster Spark menggunakan Livy API (livy/batch), tetapi menerima kesalahan.

  • Rekomendasi: Ikuti pesan kesalahan untuk memperbaiki masalah. Jika tidak ada cukup informasi untuk menyelesaikannya, hubungi tim HDI dan berikan ID batch dan ID pekerjaan, yang dapat ditemukan dalam output eksekusi aktivitas di halaman Pemantauan layanan. Untuk memecahkan masalah lebih lanjut, kumpulkan log lengkap tugas batch.

    Untuk informasi selengkapnya tentang cara mengumpulkan log lengkap, lihat Mendapatkan log lengkap tugas batch.

Kode galat: 2312

  • Pesan: Spark job failed, batch id:%batchId;. Please follow the links in the activity run Output from the service Monitoring page to troubleshoot the run on HDInsight Spark cluster. Please contact HDInsight support team for further assistance.

  • Penyebab: Pekerjaan gagal di kluster HDInsight Spark.

  • Rekomendasi: Ikuti tautan di Output run aktivitas di halaman Pemantauan layanan untuk memecahkan masalah eksekusi di kluster HDInsight Spark. Hubungi tim dukungan HDInsight untuk mendapatkan bantuan lebih lanjut.

    Untuk informasi selengkapnya tentang cara mengumpulkan log lengkap, lihat Mendapatkan log lengkap tugas batch.

Kode galat: 2313

  • Pesan: The batch with ID '%batchId;' was not found on Spark cluster. Open the Spark History UI and try to find it there. Contact HDInsight support for further assistance.

  • Penyebab: Batch telah dihapus di kluster HDInsight Spark.

  • Rekomendasi: Pecahkan masalah batch di kluster HDInsight Spark. Hubungi dukungan HDInsight untuk mendapatkan bantuan lebih lanjut.

    Untuk informasi selengkapnya tentang cara mengumpulkan log lengkap, lihat Mendapatkan log lengkap tugas batch, dan bagikan log lengkap dengan dukungan HDInsight untuk mendapatkan bantuan lebih lanjut.

Kode galat: 2328

  • Pesan: Failed to create the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

  • Penyebab: Pesan kesalahan akan menunjukkan detail tentang apa saja yang salah.

  • Rekomendasi: Pesan kesalahan akan membantu memecahkan masalah.

Kode galat: 2329

  • Pesan: Failed to delete the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

  • Penyebab: Pesan kesalahan akan menunjukkan detail tentang apa saja yang salah.

  • Rekomendasi: Pesan kesalahan akan membantu memecahkan masalah.

Kode galat: 2331

  • Pesan: The file path should not be null or empty.

  • Penyebab: Jalur file yang disediakan kosong.

  • Rekomendasi: Sediakan jalur untuk file yang ada.

Kode galat: 2340

  • Pesan: HDInsightOnDemand linked service does not support execution via SelfHosted IR. Your IR name is '%IRName;'. Please select an Azure IR instead.

  • Penyebab: Layanan tertaut HDInsightOnDemand tidak mendukung eksekusi melalui IR yang Dihost Sendiri.

  • Rekomendasi: Pilih Azure IR dan coba lagi.

Kode galat: 2341

  • Pesan: HDInsight cluster URL '%clusterUrl;' is incorrect, it must be in URI format and the scheme must be 'https'.

  • Penyebab: URL yang disediakan memiliki format yang salah.

  • Rekomendasi: Perbaiki URL kluster dan coba lagi.

Kode galat: 2342

  • Pesan: Failed to connect to HDInsight cluster: '%errorMessage;'.

  • Penyebab: Info masuk yang disediakan salah untuk kluster, atau terjadi masalah konfigurasi jaringan atau koneksi, atau IR mengalami masalah saat menghubungkan ke kluster.

  • Rekomendasi:

    1. Verifikasi bahwa info masuk sudah benar dengan membuka UI Ambari kluster HDInsight di browser.

    2. Jika kluster berada di Jaringan Virtual (VNet) dan IR yang dihosting sendiri sedang digunakan, URL HDI harus berupa URL privat di VNets, dan harus memiliki -int terdaftar setelah nama kluster.

      Misalnya, ubah https://mycluster.azurehdinsight.net/ menjadi https://mycluster-int.azurehdinsight.net/. Catat -int setelah mycluster, bukan sebelum .azurehdinsight.net

    3. Jika kluster berada di VNet, IR yang dihost sendiri sedang digunakan, dan URL privat digunakan, namun koneksi masih gagal, berarti VM tempat IR diinstal mengalami masalah saat terhubung ke HDI.

      Sambungkan ke VM tempat IR diinstal dan buka UI Ambari di browser. Gunakan URL privat untuk kluster. Koneksi ini akan berfungsi dari browser. Jika tidak, hubungi tim dukungan HDInsight untuk mendapatkan bantuan lebih lanjut.

    4. Jika IR yang dihost sendiri tidak digunakan, kluster HDI akan dapat diakses secara publik. Buka UI Ambari di browser dan periksa apakah UI terbuka. Jika terjadi masalah dengan kluster atau layanan di dalamnya, hubungi tim dukungan HDInsight untuk mendapatkan bantuan.

      URL kluster HDI yang digunakan dalam layanan tertaut harus dapat diakses untuk IR (dihosting sendiri atau Azure) agar koneksi uji dapat lulus, dan agar proses berjalan berfungsi. Status ini dapat diverifikasi dengan membuka URL dari browser baik dari VM, atau komputer publik apa pun.

Kode galat: 2343

  • Pesan: User name and password cannot be null or empty to connect to the HDInsight cluster.

  • Penyebab: Nama pengguna atau kata sandi kosong.

  • Rekomendasi: Masukkan info masuk yang benar untuk terhubung ke HDI dan coba lagi.

Kode galat: 2345

  • Pesan: Failed to read the content of the hive script. Error: '%message;'

  • Penyebab: File skrip tidak ada atau layanan tidak dapat tersambung ke lokasi skrip.

  • Rekomendasi: Verifikasi bahwa skrip ada, dan layanan tertaut yang terkait memiliki info masuk yang tepat untuk koneksi.

Kode galat: 2346

  • Pesan: Failed to create ODBC connection to the HDI cluster with error message '%message;'.

  • Penyebab: Layanan mencoba membuat koneksi Open Database Connectivity (ODBC) ke kluster HDI, dan gagal dengan kesalahan.

  • Rekomendasi:

    1. Pastikan bahwa Anda telah menyiapkan koneksi ODBC/Konektivitas Database Java (JDBC) dengan benar.
      1. Untuk JDBC, jika Anda menggunakan jaringan virtual yang sama, Anda bisa mendapatkan koneksi ini dari:
        Hive -> Summary -> HIVESERVER2 JDBC URL
      2. Untuk memastikan bahwa Anda memiliki pengaturan JDBC yang benar, lihat Mengajukan kueri Apache Hive melalui driver JDBC di HDInsight.
      3. Untuk Database Terbuka (ODB), lihat Tutorial: Mengajukan kueri Apache Hive dengan ODBC dan PowerShell untuk memastikan bahwa Anda memiliki pengaturan yang benar.
    2. Verifikasi bahwa Hiveserver2, Hive Metastore, dan Hiveserver2 Interactive aktif dan berfungsi.
    3. Periksa antarmuka pengguna Ambari (UI):
      1. Pastikan semua layanan tetap berjalan.
      2. Dari UI Ambari, periksa bagian pemberitahuan di dasbor Anda.
        1. Untuk informasi selengkapnya tentang pemberitahuan dan resolusi untuk pemberitahuan, lihat Mengelola dan Memantau Kluster.
    4. Jika langkah ini belum dapat mengatasi masalah, hubungi tim Azure HDInsight.

Kode galat: 2347

  • Pesan: Hive execution through ODBC failed with error message '%message;'.

  • Penyebab: Layanan mengirimkan skrip hive untuk dieksekusi ke kluster HDI melalui koneksi ODBC, dan skrip gagal pada HDI.

  • Rekomendasi:

    1. Pastikan bahwa Anda telah menyiapkan koneksi ODBC/Konektivitas Database Java (JDBC) dengan benar.
      1. Untuk JDBC, jika Anda menggunakan jaringan virtual yang sama, Anda bisa mendapatkan koneksi ini dari:
        Hive -> Summary -> HIVESERVER2 JDBC URL
      2. Untuk memastikan bahwa Anda memiliki pengaturan JDBC yang benar, lihat Mengajukan kueri Apache Hive melalui driver JDBC di HDInsight.
      3. Untuk Database Terbuka (ODB), lihat Tutorial: Mengajukan kueri Apache Hive dengan ODBC dan PowerShell untuk memastikan bahwa Anda memiliki pengaturan yang benar.
    2. Verifikasi bahwa Hiveserver2, Hive Metastore, dan Hiveserver2 Interactive aktif dan berfungsi.
    3. Periksa antarmuka pengguna Ambari (UI):
      1. Pastikan semua layanan tetap berjalan.
      2. Dari UI Ambari, periksa bagian pemberitahuan di dasbor Anda.
        1. Untuk informasi selengkapnya tentang pemberitahuan dan resolusi untuk pemberitahuan, lihat Mengelola dan Memantau Kluster.
    4. Jika langkah ini belum dapat mengatasi masalah, hubungi tim Azure HDInsight.

Kode galat: 2348

  • Pesan: The main storage has not been initialized. Please check the properties of the storage linked service in the HDI linked service.

  • Penyebab: Properti layanan tertaut penyimpanan tidak diatur dengan benar.

  • Rekomendasi: Hanya string koneksi penuh yang didukung dalam layanan tertaut penyimpanan utama untuk aktivitas HDI. Pastikan Bahwa Anda tidak menggunakan otorisasi atau aplikasi MSI.

Kode galat: 2350

  • Pesan: Failed to prepare the files for the run '%jobId;'. HDI cluster: '%cluster;', Error: '%errorMessage;'

  • Penyebab: Info masuk yang disediakan untuk terhubung ke penyimpanan tempat file berada salah, atau file tidak ada di sana.

  • Rekomendasi: Kesalahan ini terjadi saat layanan mempersiapkan aktivitas HDI, dan mencoba menyalin file ke penyimpanan utama sebelum mengirimkan pekerjaan ke HDI. Periksa apakah file ada di lokasi yang disediakan, dan koneksi penyimpanan sudah benar. Karena aktivitas HDI tidak mendukung autentikasi MSI pada akun penyimpanan yang terkait dengan aktivitas HDI, verifikasi bahwa layanan tertaut tersebut memiliki kunci lengkap atau menggunakan Azure Key Vault.

Kode galat: 2351

  • Pesan: Could not open the file '%filePath;' in container/fileSystem '%container;'.

  • Penyebab: File tidak ada pada jalur yang ditentukan.

  • Rekomendasi: Periksa apakah file benar-benar ada, dan layanan tertaut dengan info koneksi yang mengarah ke file ini memiliki info masuk yang benar.

Kode galat: 2352

  • Pesan: The file storage has not been initialized. Please check the properties of the file storage linked service in the HDI activity.

  • Penyebab: Properti layanan tertaut penyimpanan file tidak diatur dengan benar.

  • Rekomendasi: Verifikasi bahwa layanan tertaut penyimpanan file dikonfigurasi dengan benar.

Kode galat: 2353

  • Pesan: The script storage has not been initialized. Please check the properties of the script storage linked service in the HDI activity.

  • Penyebab: Properti layanan tertaut penyimpanan skrip tidak diatur dengan benar.

  • Rekomendasi: Verifikasi bahwa properti layanan tertaut penyimpanan skrip dikonfigurasi dengan benar.

Kode galat: 2354

  • Pesan: The storage linked service type '%linkedServiceType;' is not supported for '%executorType;' activities for property '%linkedServicePropertyName;'.

  • Penyebab: Jenis layanan tertaut penyimpanan tidak didukung oleh aktivitas.

  • Rekomendasi: Verifikasi bahwa layanan tertaut yang dipilih memiliki salah satu jenis yang didukung untuk aktivitas. Aktivitas HDI mendukung layanan tertaut AzureBlobStorage dan AzureBlobFSStorage.

    Untuk informasi selengkapnya, baca Membandingkan opsi penyimpanan untuk digunakan dengan kluster Azure HDInsight

Kode galat: 2355

  • Pesan: The '%value' provided for commandEnvironment is incorrect. The expected value should be an array of strings where each string has the format CmdEnvVarName=CmdEnvVarValue.

  • Penyebab: Nilai yang disediakan untuk commandEnvironment tidak benar.

  • Rekomendasi: Verifikasi bahwa nilai yang diberikan sama dengan:

    \"variableName=variableValue\"
]

    Verifikasi juga bahwa setiap variabel hanya muncul sekali dalam daftar.

Kode galat: 2356

  • Pesan: The commandEnvironment already contains a variable named '%variableName;'.

  • Penyebab: Nilai yang disediakan untuk commandEnvironment tidak benar.

  • Rekomendasi: Verifikasi bahwa nilai yang diberikan sama dengan:

    \"variableName=variableValue\"
]

    Verifikasi juga bahwa setiap variabel hanya muncul sekali dalam daftar.

Kode galat: 2357

  • Pesan: The certificate or password is wrong for ADLS Gen 1 storage.

  • Penyebab: Info masuk yang diberikan tidak benar.

  • Rekomendasi: Verifikasi bahwa informasi koneksi dalam ADLS Gen 1 ditautkan ke layanan, dan verifikasi bahwa koneksi pengujian berhasil.

Kode galat: 2358

  • Pesan: The value '%value;' for the required property 'TimeToLive' in the on demand HDInsight linked service '%linkedServiceName;' has invalid format. It should be a timespan between '00:05:00' and '24:00:00'.

  • Penyebab: Nilai yang disediakan untuk properti yang diperlukan TimeToLive memiliki format yang tidak valid.

  • Rekomendasi: Perbarui nilai ke rentang yang disarankan dan coba lagi.

Kode galat: 2359

  • Pesan: The value '%value;' for the property 'roles' is invalid. Expected types are 'zookeeper', 'headnode', and 'workernode'.

  • Penyebab: Nilai yang disediakan untuk properti roles tidak valid.

  • Rekomendasi: Perbarui nilai agar menjadi salah satu nilai yang disarankan dan coba lagi.

Kode galat: 2360

  • Pesan: The connection string in HCatalogLinkedService is invalid. Encountered an error while trying to parse: '%message;'.

  • Penyebab: String koneksi yang disediakan untuk HCatalogLinkedService tidak valid.

  • Rekomendasi: Perbarui nilai ke string koneksi Azure SQL yang benar dan coba lagi.

Kode galat: 2361

  • Pesan: Failed to create on demand HDI cluster. Cluster name is '%clusterName;'.

  • Penyebab: Pembuatan kluster gagal, dan layanan tidak mendapatkan kesalahan kembali dari layanan HDInsight.

  • Rekomendasi: Buka portal Microsoft Azure dan coba temukan sumber daya HDI dengan nama yang disediakan, lalu periksa status provisi. Hubungi tim dukungan HDInsight untuk mendapatkan bantuan lebih lanjut.

Kode galat: 2362

  • Pesan: Only Azure Blob storage accounts are supported as additional storages for HDInsight on demand linked service.

  • Penyebab: Penyimpanan tambahan yang disediakan bukan penyimpanan Azure Blob.

  • Rekomendasi: Masukkan akun penyimpanan Azure Blob sebagai penyimpanan tambahan untuk layanan tertaut sesuai permintaan HDInsight.

Kesalahan SSL saat layanan tertaut menggunakan kluster HDInsight ESP

  • Pesan: Failed to connect to HDInsight cluster: 'ERROR [HY000] [Microsoft][DriverSupport] (1100) SSL certificate verification failed because the certificate is missing or incorrect.'

  • Penyebab: Masalah ini kemungkinan besar terkait dengan Penyimpanan yang Dipercaya Sistem.

  • Resolusi: Anda dapat membuka jalur Microsoft Integration Runtime\4.0\Shared\ODBC Drivers\Microsoft Hive ODBC Driver\lib dan membuka DriverConfiguration64.exe untuk mengubah pengaturan.

    Uncheck Use System Trust Store

Aktivitas HDI macet saat mempersiapkan kluster

Jika aktivitas HDI macet saat mempersiapkan kluster, ikuti panduan di bawah ini:

  1. Pastikan batas waktu lebih besar dari apa yang dijelaskan di bawah ini dan tunggu eksekusi selesai atau sampai waktunya habis, dan tunggu waktu Time To Live (TTL) sebelum mengirimkan pekerjaan baru.

    Waktu default maksimum yang diperlukan untuk memutar kluster adalah 2 jam, dan jika Anda memiliki skrip init, ini akan lebih lama, hingga 2 jam lagi.

  2. Pastikan penyimpanan dan HDI diprovisikan di wilayah yang sama.

  3. Pastikan perwakilan layanan yang digunakan untuk mengakses kluster HDI valid.

  4. Jika masalah masih berlanjut, sebagai solusinya, hapus layanan tertaut HDI dan buat kembali dengan nama baru.

Aktivitas Web

Kode Galat: 2001

  • Pesan: The length of execution output is over limit (around 4MB currently).

  • Penyebab: Output eksekusi lebih besar dari ukuran 4 MB tetapi ukuran payload respons output maksimum yang didukung adalah 4 MB.

  • Rekomendasi: Pastikan ukuran output eksekusi tidak melebihi 4 MB. Untuk informasi selengkapnya, lihat Cara meluaskan skala ukuran pemindahan data menggunakan Azure Data Factory.

Kode Galat: 2002

  • Pesan: The payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.

  • Penyebab: Payload yang Anda coba kirim terlalu besar.

  • Rekomendasi: Lihat Payload terlalu besar.

Kode Galat: 2003

  • Pesan: There are substantial concurrent external activity executions which is causing failures due to throttling under subscription <subscription id>, region <region code> and limitation <current limit>. Please reduce the concurrent executions. For limits, refer https://aka.ms/adflimits.

  • Penyebab: Terlalu banyak aktivitas yang berjalan bersamaan. Ini dapat terjadi ketika terlalu banyak alur dipicu sekaligus.

  • Rekomendasi: Mengurangi konkurensi alur. Anda mungkin harus mendistribusikan waktu pemicu alur Anda.

Kode Galat: 2010

  • Pesan: The Self-hosted Integration Runtime ‘<SHIR name>’ is offline

  • Penyebab: Runtime integrasi yang dihost sendiri offline atau runtime integrasi Azure kedaluwarsa atau tidak terdaftar.

  • Rekomendasi: Pastikan runtime integrasi yang dihost sendiri aktif dan berjalan. Lihat Memecahkan masalah runtime integrasi yang dihost mandiri untuk informasi selengkapnya.

Kode Galat: 2105

  • Pesan: The value type '<provided data type>', in key '<key name>' is not expected type '<expected data type>'

  • Penyebab: Data yang dihasilkan dalam ekspresi konten dinamis tidak cocok dengan kunci dan menyebabkan kegagalan penguraian JSON.

  • Rekomendasi: Lihat bidang kunci dan perbaiki definisi konten dinamis.

Kode galat: 2108

  • Pesan: Error calling the endpoint '<URL>'. Response status code: 'NA - Unknown'. More details: Exception message: 'NA - Unknown [ClientSideException] Invalid Url: <URL>. Please verify Url or integration runtime is valid and retry. Localhost URLs are allowed only with SelfHosted Integration Runtime'

  • Penyebab: Tidak dapat menjangkau URL yang disediakan. Hal ini dapat terjadi karena ada masalah koneksi jaringan, URL tidak dapat diselesaikan, atau URL localhost sedang digunakan pada runtime integrasi Azure.

  • Rekomendasi: Verifikasi bahwa URL yang disediakan dapat diakses.


  • Pesan: Error calling the endpoint '%url;'. Response status code: '%code;'

  • Penyebab: Permintaan gagal karena masalah yang mendasarinya seperti konektivitas jaringan, kegagalan DNS, validasi sertifikat server, atau waktu habis.

  • Rekomendasi: Gunakan Fiddler/Postman/Netmon/Wireshark untuk memvalidasi permintaan.

    Menggunakan Fiddler

    Untuk menggunakan Fiddler untuk membuat sesi HTTP aplikasi web yang dipantau:

    1. Unduh, instal, dan buka Fiddler.

    2. Jika aplikasi web Anda menggunakan HTTPS, buka Alat>Opsi Fiddler>HTTPS.

      1. Di tab HTTPS, pilih Ambil HTTPS CONNECTs dan Dekripsi lalu lintas HTTPS.

        Fiddler options

    3. Jika aplikasi Anda menggunakan sertifikat TLS/SSL, tambahkan sertifikat Fiddler ke perangkat Anda.

      Buka: Alat>Opsi Fiddler>HTTPS>Tindakan>Ekspor Sertifikat Akar ke Desktop.

    4. Nonaktifkan pengambilan dengan membuka File>Ambil Lalu Lintas. Atau tekan F12.

    5. Hapus cache browser Anda agar semua cache item dihapus dan harus diunduh lagi.

    6. Buat permintaan:

    7. Pilih tah Komposer.

      1. Atur metode HTTP dan URL.

      2. Jika diperlukan, tambahkan header dan isi permintaan.

      3. Pilih Jalankan.

    8. Aktifkan pengambilan lalu lintas lagi, dan selesaikan transaksi bermasalah di halaman Anda.

    9. Buka: File>Simpan>Semua Sesi.

    Untuk informasi selengkapnya, lihat Mulai menggunakan Fiddler.

Kode Galat: 2113

  • Pesan: ExtractAuthorizationCertificate: Unable to generate a certificate from a Base64 string/password combination

  • Penyebab: Tidak dapat menghasilkan sertifikat dari kombinasi string/kata sandi Base64.

  • Rekomendasi: Verifikasi bahwa kombinasi sertifikat dan kata sandi PFX yang dikodekan Base64 yang Anda gunakan dimasukkan dengan benar.

Kode Galat: 2403

  • Pesan: Get access token from MSI failed for Datafactory <DF mname>, region <region code>. Please verify resource url is valid and retry.

  • Penyebab: Tidak dapat memperoleh token akses dari URL sumber daya yang disediakan.

  • Rekomendasi: Verifikasi bahwa Anda telah memberikan URL sumber daya yang benar untuk identitas terkelola Anda.

Umum

Kesalahan NULL token kelanjutan REST

Pesan kesalahan: {"token":null,"range":{"min":..}

Sebab: Saat mengkueri di beberapa partisi/halaman, layanan backend menampilkan token kelanjutan dalam format JObject dengan 3 properti: rentang kunci token, min dan maks, misalnya, {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}). Bergantung pada data sumber, kueri dapat menghasilkan 0 yang menunjukkan token yang tidak ada meskipun ada lebih banyak data untuk diambil.

Rekomendasi: Ketika continuationToken non-null, dengan string {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}, maka diwajibkan untuk memanggil queryActivityRuns API lagi dengan token kelanjutan dari respons sebelumnya. Anda harus meneruskan string penuh untuk API kueri lagi. Aktivitas ini akan ditampilkan di halaman berikutnya untuk hasil kueri. Anda harus mengabaikan bahwa ada larik kosong di halaman ini, selama nilai continuationToken penuh != null, Anda perlu terus mengkueri. Untuk detail selengkapnya, silakan lihat REST api untuk kueri eksekusi alur.

Masalah macetnya aktivitas

Ketika Anda mendapati bahwa aktivitas berjalan lebih lama daripada eksekusi normal dengan hampir tidak ada kemajuan, aktivitas kemungkinan macet. Anda dapat mencoba membatalkannya dan mencoba kembali untuk melihat apakah ini membantu. Jika berupa aktivitas penyalinan, Anda dapat mempelajari pemantauan dan pemecahan masalah performa dari Memecahkan masalah performa aktivitas penyalinan; jika berupa alur data, pelajari dari Performa aliran data pemetaan dan sesuaikan panduan.

Payload terlalu besar

Pesan kesalahanThe payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.:

Penyebab: Payload untuk setiap eksekusi aktivitas menyertakan konfigurasi aktivitas, himpunan data terkait, dan konfigurasi layanan tertaut jika ada, dan bagian kecil properti sistem yang dibuat per jenis aktivitas. Batas ukuran muatan tersebut adalah 896 KB sebagaimana disebutkan dalam dokumentasi batas Azure untuk Data Factory dan Azure Synapse Analytics.

Rekomendasi: Anda mencapai batas ini mungkin karena Anda melewati satu atau beberapa nilai parameter besar dari output aktivitas upstream atau eksternal, terutama jika Anda melewati data aktual di seluruh aktivitas dalam alur kontrol. Periksa apakah Anda dapat mengurangi nilai parameter besar, atau menyesuaikan logika alur Anda untuk menghindari melewati nilai tersebut di seluruh aktivitas dan menanganinya di dalam aktivitas.

Kompresi yang tidak didukung menyebabkan file rusak

Gejala: Anda mencoba untuk mengekstrak file yang disimpan dalam kontainer blob. Aktivitas salinan tunggal dalam alur memiliki sumber dengan jenis kompresi yang diatur ke "deflate64" (atau jenis yang tidak didukung). Aktivitas ini berjalan dengan sukses dan membuat file teks yang terdapat dalam file zip. Namun, ada masalah dengan teks dalam file, dan file ini tampak rusak. Saat file ini diekstrak secara lokal, tidak apa-apa.

Penyebab: File zip Anda dikompresi oleh algoritme "deflate64", sedangkan pustaka zip internal Azure Data Factory hanya mendukung "deflate". Jika file zip dikompresi oleh sistem Windows dan ukuran file keseluruhan melebihi jumlah tertentu, Windows akan menggunakan "deflate64" secara default, yang tidak didukung di Azure Data Factory. Di sisi lain, jika ukuran file lebih kecil atau Anda menggunakan beberapa alat zip pihak ketiga yang mendukung penentuan algoritme kompres, Windows akan menggunakan "deflate" secara default.

Tip

Sebenarnya, Format biner di Azure Data Factory dan Synapse Analytics serta Format teks terbatas di Azure Data Factory dan Azure Synapse Analytics dengan jelas menyatakan bahwa format "deflate64" tidak didukung di Azure Data Factory.

Jalankan Alur meneruskan parameter array sebagai string ke alur turunan

Pesan kesalahanOperation on target ForEach1 failed: The execution of template action 'MainForEach1' failed: the result of the evaluation of 'foreach' expression '@pipeline().parameters.<parameterName>' is of type 'String'. The result must be a valid array.:

Penyebab: Bahkan jika dalam Jalankan Alur Anda membuat parameter array jenis, seperti yang ditunjukkan pada gambar di bawah ini, alur akan gagal.

Screenshot showing the parameters of the Execute Pipeline activity.

Hal ini disebabkan oleh fakta bahwa payload diteruskan dari alur induk ke anak sebagai string. Kita dapat melihatnya ketika kita memeriksa input yang diteruskan ke alur anak.

Screenshot showing the input type string.

Rekomendasi: Untuk menyelesaikan masalah, kita dapat memanfaatkan fungsi buat array seperti yang ditunjukkan pada gambar di bawah ini.

Screenshot showing how to use the create array function.

Maka alur kita akan berhasil. Dan kita dapat melihat di kotak input bahwa parameter yang diteruskan adalah array.

Screenshot showing input type array.

Konten terkait

Untuk bantuan pemecahan masalah lainnya, coba sumber daya ini: