Masalah umum Azure Synapse Analytics

Halaman ini mencantumkan masalah yang diketahui di Azure Synapse Analytics, dan tanggal resolusi atau kemungkinan solusinya. Sebelum mengirimkan permintaan dukungan Azure, tinjau daftar ini untuk melihat apakah masalah yang Anda alami sudah diketahui dan sedang ditangani.

Untuk mempelajari selengkapnya tentang Azure Synapse Analytics, lihat Gambaran Umum Azure Synapse Analytics, dan Apa yang baru di Azure Synapse Analytics?

Masalah aktif yang diketahui

Ringkasan masalah aktif kumpulan SQL khusus Azure Synapse Analytics yang diketahui

Perintah salin Data Factory gagal dengan kesalahan "Permintaan tidak dapat dilakukan karena kesalahan perangkat I/O"

Alur Azure Data Factory menggunakan COPY INTO pernyataan Transact-SQL untuk menyerap data dalam skala besar ke dalam tabel kumpulan SQL khusus. Dalam beberapa kasus yang jarang terjadi, COPY INTO pernyataan dapat gagal saat memuat file CSV ke dalam tabel kumpulan SQL khusus ketika pemisahan file digunakan dalam alur Azure Data Factory. Pemisahan file adalah mekanisme yang meningkatkan performa beban ketika sejumlah kecil file yang lebih besar (1 GB+) dimuat dalam satu tugas penyalinan. Saat pemisahan file diaktifkan, satu file dapat dimuat oleh beberapa utas paralel, di mana setiap utas diberi bagian dari file.

Solusi sementara: Pelanggan yang terkena dampak harus menonaktifkan pemisahan file di Azure Data Factory.

Pernyataan COPY INTO gagal dengan kesalahan "Terjadi kesalahan DMS internal yang menyebabkan operasi ini gagal." ketika identitas terkelola digunakan

Saat menggunakan COPY INTO perintah dengan identitas terkelola, pernyataan dapat gagal setelah kueri yang berjalan lama dengan pesan kesalahan "Terjadi kesalahan DMS internal yang menyebabkan operasi ini gagal".

Solusi sementara: Pelanggan yang terkena dampak dapat menggunakan metode autentikasi alternatif untuk akun penyimpanan, seperti Kunci Akses Bersama.

Pelanggan tidak dapat memantau penggunaan kumpulan SQL khusus mereka dengan menggunakan metrik

Peningkatan internal logika emisi telemetri kami, yang dimaksudkan untuk meningkatkan performa dan keandalan data telemetri kami, menyebabkan masalah tak terduga yang memengaruhi kemampuan beberapa pelanggan untuk memantau metrik IO data kumpulan SQL khusus, tempdb, dan Gudang Data mereka.

Solusi sementara: Setelah mengidentifikasi masalah, tim kami mengambil tindakan untuk mengidentifikasi akar penyebab dan memperbarui konfigurasi di sistem kami. Pelanggan dapat memperbaiki masalah dengan menjeda dan membalas instans mereka, yang akan memulihkan status normal instans dan aliran data telemetri.

Kegagalan kueri saat menyerap file parquet ke dalam tabel dengan AUTO_CREATE_TABLE='ON'

Pelanggan yang mencoba menyerap file parquet ke dalam tabel terdistribusi hash dengan AUTO_CREATE_TABLE='ON' dapat menerima kesalahan berikut:

COPY statement using Parquet and auto create table enabled currently cannot load into hash-distributed tables

Penyerapan ke dalam tabel terdistribusi hash yang dibuat secara otomatis menggunakan AUTO_CREATE_TABLE tidak didukung. Pelanggan yang sebelumnya telah dimuat menggunakan skenario yang tidak didukung ini harus CTAS data mereka ke dalam tabel baru dan menggunakannya sebagai pengganti tabel lama.

Kueri gagal dengan Kesalahan Penyelundupan Data

Ruang kerja Synapse yang dibuat dari kegagalan kueri laporan Kumpulan SQL khusus yang ada terkait dengan Perlindungan Eksfiltrasi Data dengan pesan kesalahan umum saat Perlindungan Penyelundupan Data dinonaktifkan di Synapse Analytics:

Data exfiltration to '{****}' is blocked. Add destination to allowed list for data exfiltration and try again.

Solusi sementara: Jika Anda mengalami kesalahan serupa, libatkan Tim Dukungan Microsoft untuk mendapatkan bantuan.

KEGAGALAN STATISTIK PEMBARUAN

Beberapa Kumpulan SQL khusus dapat mengalami pengecualian saat menjalankan UPDATE STATISTICS pernyataan. Perintah menghasilkan pesan "Aliran statistik yang disediakan rusak" dan gagal memperbarui statistik Anda.

Saat batasan baru ditambahkan ke tabel, statistik terkait dibuat dalam distribusi. Jika indeks berkluster juga dibuat pada tabel, indeks harus menyertakan kolom yang sama (dalam urutan yang sama) dengan batasan, jika tidak UPDATE STATISTICS , perintah pada kolom tersebut mungkin gagal.

Solusi sementara: Identifikasi apakah ada batasan dan indeks terkluster pada tabel. Jika demikian, HILANGKAN batasan dan indeks berkluster. Setelah itu, buat ulang indeks berkluster lalu batasan yang memastikan bahwa keduanya menyertakan kolom yang sama dalam urutan yang sama. Jika tabel tidak memiliki batasan dan indeks terkluster, atau jika langkah di atas menghasilkan kesalahan yang sama, hubungi Tim Dukungan Microsoft untuk mendapatkan bantuan.

Pembaruan tag tampaknya gagal

Saat membuat perubahan pada tag kumpulan SQL khusus melalui portal Azure atau metode lain, pesan kesalahan dapat muncul meskipun perubahan berhasil dilakukan.

Solusi sementara: Anda dapat mengonfirmasi bahwa perubahan pada tag berhasil dan mengabaikan/menyembunyikan pesan kesalahan sesuai kebutuhan.

Ringkasan masalah aktif ruang kerja Azure Synapse yang diketahui

Berikut ini adalah masalah yang diketahui dengan ruang kerja Synapse.

Layanan tertaut penyimpanan blob dengan User Assigned Managed Identity (UAMI) tidak terdaftar

Layanan tertaut mungkin tidak terlihat di bawah Data Hub ->Linked ->Azure Blob Storage setelah mengonfigurasi layanan tertaut penyimpanan blob untuk menggunakan autentikasi "Identitas Terkelola yang Ditetapkan Pengguna" di Azure Synapse Analytics.

Solusi sementara: Tim teknik saat ini mengetahui perilaku ini dan sedang berupaya memperbaikinya. Sebagai alternatif, gunakan metode autentikasi "Identitas Terkelola yang Ditetapkan Sistem" alih-alih "Identitas Terkelola yang Ditetapkan Pengguna".

Gagal menghapus ruang kerja Synapse & Tidak dapat menghapus jaringan virtual

Menghapus ruang kerja Synapse gagal dengan pesan kesalahan:

Failed to delete Synapse workspace '[Workspace Name]'. Unable to delete virtual network. The correlationId is ********-****-****-****-************;

Solusi sementara: Masalah dapat dimitigasi dengan mencoba kembali operasi penghapusan. Tim teknik mengetahui perilaku ini dan sedang berupaya memperbaikinya.

Operasi REST API PUT atau templat ARM/Bicep untuk memperbarui pengaturan jaringan gagal

Saat menggunakan templat ARM, templat Bicep, atau operasi REST API PUT langsung untuk mengubah pengaturan akses jaringan publik dan/atau aturan firewall untuk ruang kerja Synapse, operasi dapat gagal.

Solusi sementara: Masalah dapat dimitigasi dengan menggunakan operasi PATCH REST API atau antarmuka pengguna portal Azure untuk membalikkan dan mencoba kembali perubahan konfigurasi yang diinginkan. Tim teknik mengetahui perilaku ini dan sedang berupaya memperbaikinya.

Masalah yang diketahui menggabungkan kurung siku [] dalam nilai Tag

Dalam konteks memperbarui nilai tag dalam ruang kerja Azure Synapse, penyertaan kurung siku ([]) akan mengakibatkan operasi pembaruan yang gagal.

Solusi sementara: Solusi saat ini adalah untuk tidak menggunakan kurung siku ([]) di nilai tag ruang kerja Azure Synapse.

Kegagalan penyebaran di Ruang Kerja Synapse menggunakan Synapse-workspace-deployment v1.8.0 dalam tindakan GitHub dengan templat ARM

Kegagalan terjadi selama penyebaran ke produksi dan terkait dengan pemicu yang berisi nama host dengan garis miring terbelakang ganda.

Pesan kesalahan yang ditampilkan adalah Action failed - Error: Orchestrate failed - SyntaxError: Unexpected token in JSON at position 2057.

Solusi sementara: Tindakan berikut dapat diambil sebagai mitigasi cepat:

• Hapus karakter escape: Hapus karakter\ escape () secara manual dari file parameter sebelum penyebaran. Ini berarti mengedit file untuk menghilangkan karakter ini yang dapat menyebabkan masalah selama tahap penguraian atau pemrosesan penyebaran.
• Ganti karakter escape dengan Garis Miring : Ganti karakter escape (\) dengan garis miring ke depan (/). Ini dapat sangat berguna dalam jalur file, di mana banyak sistem menerima garis miring maju sebagai pemisah jalur yang valid. Penggantian ini mungkin membantu melewati masalah dengan karakter escape, memungkinkan proses penyebaran berhasil.

Setelah menerapkan salah satu solusi ini dan berhasil disebarkan, perbarui konfigurasi yang diperlukan secara manual dalam ruang kerja untuk memastikan semuanya disiapkan dengan benar. Ini mungkin melibatkan pengeditan file konfigurasi, menyesuaikan pengaturan, atau melakukan tugas lain yang relevan dengan lingkungan atau aplikasi tertentu yang sedang disebarkan.

Tidak ada operasi API 'GET' yang didedikasikan untuk pengaturan "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled"

Ringkasan Masalah: Di Azure Synapse Analytics, tidak ada operasi API 'GET' khusus untuk mengambil status pengaturan "trustedServiceBypassEnabled" di cakupan sumber daya "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled". Meskipun pengguna dapat mengatur konfigurasi ini, mereka tidak dapat langsung mengambil statusnya melalui cakupan sumber daya khusus ini.

Dampak: Batasan ini berdampak pada definisi Azure Policy, karena tidak dapat memberlakukan status tertentu untuk pengaturan "trustedServiceBypassEnabled". Pelanggan tidak dapat menggunakan Azure Policy untuk menolak atau mengelola konfigurasi ini.

Solusi sementara: Tidak ada solusi yang tersedia di Azure Policy untuk memberlakukan status konfigurasi yang diinginkan untuk properti ini. Namun, pengguna dapat menggunakan operasi ruang kerja 'GET' untuk mengaudit status konfigurasi untuk tujuan pelaporan.
Operasi ruang kerja 'GET' ini memetakan ke Alias Azure Policy 'Microsoft.Synapse/workspaces/trustedServiceBypassEnabled'.

Alias Azure Policy dapat digunakan untuk mengelola properti ini dengan Efek Kebijakan Azure Tolak jika operasi adalah permintaan PUT terhadap sumber daya Microsoft.Synapse/ruang kerja, tetapi hanya akan berfungsi untuk tujuan Audit jika permintaan PUT dikirim langsung ke sumber daya anak Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration. Sumber daya induk memiliki properti [properties.trustedServiceBypassEnabled] yang memetakan konfigurasi dari sumber daya anak dan inilah sebabnya mengapa masih dapat diaudit melalui Azure Policy Alias sumber daya induk.

Karena sumber daya anak Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration tidak memiliki operasi GET yang tersedia, Azure Policy tidak dapat mengelola permintaan ini, dan Azure Policy tidak dapat menghasilkan Alias Azure Policy untuk itu.

Sumber Daya Induk: Microsoft.Synapse/workspaces

Sumber Daya Anak: Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration

portal Azure membuat permintaan PUT langsung ke PUT API untuk sumber daya anak dan oleh karena itu portal Azure, bersama dengan permintaan API lain yang dibuat di luar API Microsoft.Synapse/workspaces induk, tidak dapat dikelola oleh Azure Policy melalui Tolak atau Efek Kebijakan Azure lainnya yang dapat ditindaklanjuti.

Ringkasan masalah aktif kumpulan SQL tanpa server Azure Synapse Analytics

Kegagalan kueri dari kumpulan SQL tanpa server ke penyimpanan analitik Azure Cosmos DB

Kueri dari kumpulan SQL tanpa server ke penyimpanan analitis Azure Cosmos DB mungkin gagal dengan salah satu pesan kesalahan berikut:

• Resolving CosmosDB path has failed with error 'This request is not authorized to perform this operation'
• Resolving CosmosDB path has failed with error 'Key not found'

Kondisi berikut harus benar untuk memastikan masalah ini:

1. Sambungan ke penyimpanan analitis Azure Cosmos DB menggunakan titik akhir privat.
2. Berhasil mencoba kembali kueri.

Solusi sementara: Tim teknik mengetahui perilaku ini dan tindakan berikut dapat diambil sebagai mitigasi cepat:

1. Coba lagi kueri yang gagal. Token yang kedaluwarsa akan di-refresh otomatis.
2. Nonaktifkan titik akhir privat. Sebelum menerapkan perubahan ini, pastikan dengan tim keamanan Anda bahwa perubahan tersebut memenuhi kebijakan keamanan perusahaan Anda.

Tampilan penyimpanan analitik Azure Cosmos DB menyebarluaskan atribut yang salah di kolom

Saat menggunakan tampilan di kumpulan tanpa server Azure Synapse melalui penyimpanan analitik Cosmos DB, jika ada perubahan pada file di penyimpanan analitik Cosmos DB, perubahan tidak disebarluaskan dengan benar ke pernyataan SELECT, pelanggan menggunakan pada tampilan. Akibatnya, atribut salah dipetakan ke kolom yang berbeda dalam hasil.

Solusi sementara: Tim teknik mengetahui perilaku ini dan tindakan berikut dapat diambil sebagai mitigasi cepat:

1. Buat ulang tampilan dengan mengganti nama kolom.
2. Hindari menggunakan tampilan jika memungkinkan.

Mengubah kredensial cakupan database gagal jika kredensial telah digunakan

Terkadang Anda mungkin tidak dapat menjalankan ALTER DATABASE SCOPED CREDENTIAL kueri. Akar penyebab masalah ini adalah kredensial di-cache setelah penggunaan pertamanya membuatnya tidak dapat diakses untuk perubahan. Kesalahan yang dikembalikan adalah:

• Failed to modify the identity field of the credential '{credential_name}' because the credential is used by an active database file.

Solusi sementara: Tim teknik saat ini mengetahui perilaku ini dan sedang berupaya memperbaikinya. Sebagai solusinya, Anda dapat MENGHILANGKAN dan MEMBUAT kredensial, yang juga berarti membuat ulang tabel eksternal menggunakan kredensial. Atau, Anda dapat melibatkan Tim Dukungan Microsoft untuk mendapatkan bantuan.

Kegagalan kueri di kumpulan SQL tanpa server

Kedaluwarsa token dapat menyebabkan kesalahan selama eksekusi kueri mereka, meskipun memiliki izin yang diperlukan untuk pengguna melalui penyimpanan. Pesan kesalahan ini juga dapat terjadi karena kesalahan pengguna umum, seperti ketika peran kontrol akses berbasis peran (RBAC) tidak ditetapkan ke akun penyimpanan.

Contoh pesan kesalahan:

• WaitIOCompletion call failed. HRESULT = 0x80070005'. File/External table name: {path}
• Unable to resolve path '%' Error number 13807, Level 16, State 1, Message "Content of directory on path '%' cannot be listed.
• Error 16561: External table '<table_name>' is not accessible because content of directory cannot be listed.
• Error 13822: File {path} cannot be opened because it does not exist or it is used by another process.
• Error 16536: Cannot bulk load because the file "%ls" could not be opened.

Solusi:

Resolusinya berbeda tergantung pada autentikasi, Microsoft Entra (sebelumnya Azure Active Directory) atau identitas layanan terkelola (MSI):

Untuk kedaluwarsa token Microsoft Entra:

• Untuk kueri yang berjalan lama, beralihlah ke perwakilan layanan, identitas terkelola, atau tanda tangan akses bersama (SAS) alih-alih menggunakan identitas pengguna. Untuk informasi selengkapnya, lihat Mengontrol akses akun penyimpanan untuk kumpulan SQL tanpa server di Azure Synapse Analytics.

• Mulai ulang klien (SSMS/ADS) untuk memperoleh token baru untuk membuat koneksi.

Untuk kedaluwarsa token MSI:

• Nonaktifkan lalu aktifkan kumpulan untuk menghapus cache token. Libatkan Tim Dukungan Microsoft untuk mendapatkan bantuan.

Masalah akses penyimpanan karena header otorisasi terlalu panjang

Contoh pesan kesalahan di kumpulan SQL tanpa server:

• File {path} cannot be opened because it does not exist or it is used by another process.
• Content of directory on path {path} cannot be listed.
• WaitIOCompletion call failed. HRESULT = {code}'. File/External table name: {path}

Kesalahan akses penyimpanan generik ini muncul saat menjalankan kueri. Masalah ini mungkin terjadi untuk pengguna di satu ruang kerja tetapi akan berfungsi dengan baik di ruang kerja lain. Perilaku ini diharapkan karena ukuran token.

Periksa panjang token Microsoft Entra dengan menjalankan perintah berikut di PowerShell. Nilai -ResourceUrl parameter akan berbeda untuk cloud nonpublik. Jika panjang token mendekati 11000 atau lebih lama, lihat bagian Mitigasi .

(Get-AzAccessToken -ResourceUrl https://database.windows.net).Token.Length

Solusi:

Solusi yang disarankan adalah:

• Beralih ke otorisasi penyimpanan Identitas Terkelola seperti yang dijelaskan dalam kontrol akses penyimpanan.
• Kurangi jumlah grup keamanan (memiliki 90 atau lebih sedikit hasil grup keamanan dengan token dengan panjang yang kompatibel).
• Tingkatkan jumlah grup keamanan lebih dari 200 (karena itu mengubah bagaimana token dibangun, itu akan berisi MS Graph API URI alih-alih daftar lengkap grup). Ini dapat dicapai dengan menambahkan grup dummy/buatan dengan mengikuti grup terkelola, setelah Anda perlu menambahkan pengguna ke grup yang baru dibuat.

Mengkueri tampilan memperlihatkan hasil yang tidak terduga

Saat Anda mengkueri tampilan yang skema dasarnya telah berubah setelah tampilan dibuat, Anda mungkin mengalami hasil yang tidak terduga. Ini berarti bahwa tampilan mereferensikan kolom atau objek yang dimodifikasi atau tidak ada lagi. Untuk mengatasi hal ini, Anda perlu menyesuaikan definisi tampilan secara manual agar selaras dengan perubahan skema yang mendasar.

Solusi sementara: Sesuaikan definisi tampilan secara manual.

Masalah yang diketahui baru-baru ini ditutup

Kumpulan SQL tanpa server Azure Synapse Analytics baru-baru ini menutup ringkasan masalah yang diketahui

Kueri yang menggunakan autentikasi Microsoft Entra gagal setelah 1 jam

Koneksi SQL menggunakan autentikasi Microsoft Entra yang tetap aktif selama lebih dari 1 jam mulai gagal. Ini termasuk mengkueri penyimpanan menggunakan autentikasi pass-through Microsoft Entra dan pernyataan yang berinteraksi dengan ID Microsoft Entra, seperti CREATE EXTERNAL PROVIDER. Ini memengaruhi setiap alat yang membuat koneksi tetap aktif, seperti editor kueri di SSMS dan ADS. Alat yang membuka koneksi baru untuk menjalankan kueri tidak terpengaruh, seperti Synapse Studio.

Status: Diselesaikan

Kegagalan kueri saat membaca data Azure Cosmos DB menggunakan OPENROWSET

Kueri dari kumpulan SQL tanpa server ke Cosmos DB Analytical Store menggunakan OPENROWSET gagal dengan pesan kesalahan berikut:

Resolving CosmosDB path has failed with error 'bad allocation'.

Status: Diselesaikan

Ringkasan masalah umum kumpulan Apache Spark Azure Synapse Analytics baru-baru ini ditutup

Gagal menulis ke Kumpulan Khusus SQL dari Synapse Spark menggunakan konektor kumpulan SQL khusus Azure Synapse untuk Apache Spark saat menggunakan notebook di alur

Saat menggunakan Konektor kumpulan SQL khusus Azure Synapse untuk Apache Spark untuk menulis kumpulan Khusus Azure Synapse menggunakan Notebook dalam alur, kita akan melihat pesan kesalahan:

com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: COPY statement input file schema discovery failed: Cannot bulk load. The file does not exist or you don't have file access rights.

Status: Diselesaikan

Pekerjaan atau tugas spark tertentu gagal terlalu awal dengan Kode Kesalahan 503 karena pembatasan akun penyimpanan

Antara 3 Oktober 2023 dan 16 November 2023, beberapa kumpulan Apache Spark Azure Synapse Analytics dapat mengalami kegagalan pekerjaan/tugas spark karena ambang batas API penyimpanan terlampaui.

Status: Diselesaikan

Kegagalan kueri dengan klausul LIKE menggunakan Konektor Kumpulan SQL Khusus Synapse di runtime Spark 3.4

Sumber terbuka Apache Spark 3.4 telah memperkenalkan masalah, yang lolos dari karakter khusus, tetapi Synapse SQL tidak mendukung kata kunci escape. Ketika pelanggan menggunakan Konektor Kumpulan SQL Khusus Azure Synapse untuk Apache Spark, itu dapat menghasilkan kueri SQL yang tidak valid untuk Synapse SQL dan notebook Synapse Spark atau pekerjaan batch akan melemparkan kesalahan yang mirip dengan:

com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: com.microsoft.sqlserver.jdbc.SQLServerException: Parse error at line: 1, column: XXX: Incorrect syntax near ''%test%''

Status: Diselesaikan

Konten terkait

• Pemecahan Masalah Synapse Studio
• Memecahkan masalah kumpulan SQL tanpa server di Azure Synapse Analytics
• Praktik terbaik untuk kumpulan SQL nirserver di Azure Synapse Analytics
• Memecahkan masalah kueri lambat pada Kumpulan SQL khusus