Azure Synapse Analytics bilinen sorunları
Bu sayfada Azure Synapse Analytics'teki bilinen sorunlar ve bunların çözüm tarihi veya olası geçici çözümü listelenir. Azure desteği isteği göndermeden önce, karşılaştığınız sorunun zaten bilinip bilinmediğini ve giderilip giderilmediğini görmek için bu listeyi gözden geçirin.
Azure Synapse Analytics hakkında daha fazla bilgi edinmek için bkz . Azure Synapse Analytics'e Genel Bakış ve Azure Synapse Analytics'teki yenilikler?
Bilinen etkin sorunlar
Azure Synapse Analytics ayrılmış SQL havuzu etkin bilinen sorunlar özeti
Müşteriler, ölçümleri kullanarak ayrılmış SQL havuzu kullanımlarını izleyemiyor
Telemetri verilerimizin performansını ve güvenilirliğini artırmayı amaçlayan telemetri emisyon mantığımızın iç yükseltmesi, bazı müşterilerin ayrılmış SQL havuzlarını, tempdbve Veri Ambarı Veri GÇ ölçümlerini izleme becerisini etkileyen beklenmeyen bir soruna neden oldu.
Geçici çözüm: Sorunu belirledikten sonra ekibimiz kök nedeni belirlemek ve sistemimizdeki yapılandırmayı güncelleştirmek için harekete geçti. Müşteriler, örneğin normal durumunu ve telemetri veri akışını geri yükleyecek şekilde örneklerini duraklatarak ve devam ettirerek sorunu çözebilir.
AUTO_CREATE_TABLE='ON' içeren bir tabloya parquet dosyası alınırken sorgu hatası
Ile AUTO_CREATE_TABLE='ON' karma dağıtılmış tabloya bir parquet dosyası almaya çalışan müşteriler aşağıdaki hatayı alabilir:
COPY statement using Parquet and auto create table enabled currently cannot load into hash-distributed tables
AUTO_CREATE_TABLE kullanılarak otomatik olarak oluşturulan karma dağıtılmış bir tabloya veri alımı desteklenmez. Daha önce bu desteklenmeyen senaryoyu kullanarak yüklemiş olan müşteriler, verilerini yeni bir tabloya eklemeli ve eski tablonun yerine kullanmalıdır.
Veri Sızdırma Hatası ile başarısız olan sorgular
Synapse Analytics'te Veri Sızdırma Koruması kapatılırken genel hata iletisiyle veri sızdırma korumasıyla ilgili mevcut bir ayrılmış SQL Havuzu rapor sorgusu hatasından oluşturulan Synapse çalışma alanları:
Data exfiltration to '{****}' is blocked. Add destination to allowed list for data exfiltration and try again.
Geçici çözüm: Benzer bir hatayla karşılaştıysanız yardım için Microsoft Desteği Ekibi ile iletişime geçin.
UPDATE STATISTICS hatası
Bazı ayrılmış SQL Havuzları bir deyimi yürütürken bir UPDATE STATISTICS özel durumla karşılaşabilir. Komut "Sağlanan istatistik akışı bozuk" iletisiyle sonuçlanır ve istatistiklerinizi güncelleştiremiyor.
Tabloya yeni bir kısıtlama eklendiğinde, dağıtımlarda ilgili bir istatistik oluşturulur. Tabloda kümelenmiş dizin de oluşturulduysa kısıtlamayla aynı sütunları (aynı sırada) içermesi gerekir, aksi takdirde UPDATE STATISTICS bu sütunlardaki komutlar başarısız olabilir.
Geçici çözüm: Tabloda kısıtlama ve kümelenmiş dizin olup olmadığını belirleyin. Öyleyse, hem kısıtlamayı hem de kümelenmiş dizini DROP tuşuna bırakın. Bundan sonra kümelenmiş dizini ve ardından kısıtlamayı yeniden oluşturarak her ikisinin de aynı sütunları aynı sırada içermesini sağlayın. Tabloda kısıtlama ve kümelenmiş dizin yoksa veya yukarıdaki adım aynı hatayla sonuçlanırsa yardım için Microsoft Desteği Ekibine başvurun.
Etiket güncelleştirmeleri başarısız görünüyor
Azure portalı veya diğer yöntemler aracılığıyla ayrılmış bir SQL havuzunun etiketlerinde değişiklik yaparken, değişiklik başarıyla yapılmış olsa bile bir hata iletisi görüntülenebilir.
Geçici çözüm: Etiketlerde yapılan değişikliğin başarılı olduğunu onaylayabilir ve hata iletisini gerektiği gibi yoksayabilir/gizleyebilirsiniz.
Azure Synapse çalışma alanı etkin bilinen sorunlar özeti
Synapse çalışma alanıyla ilgili bilinen sorunlar aşağıdadır.
Kullanıcı Tarafından Atanan Yönetilen Kimlik (UAMI) ile blob depolama bağlı hizmeti listelenmiyor
Blob depolama bağlı hizmetini Azure Synapse Analytics'te "Kullanıcı Tarafından Atanan Yönetilen Kimlik" kimlik doğrulamasını kullanacak şekilde yapılandırdıktan sonra bağlı hizmet Data Hub ->Linked ->Azure Blob Depolama altında görünmeyebilir.
Geçici çözüm: Mühendislik ekibi şu anda bu davranışın farkındadır ve bir düzeltme üzerinde çalışmaktadır. Alternatif olarak, "Kullanıcı Tarafından Atanan Yönetilen Kimlik" yerine "Sistem Tarafından Atanan Yönetilen Kimlik" kimlik doğrulama yöntemini kullanın.
Synapse çalışma alanı silinemedi & Sanal ağ silinemedi
Synapse çalışma alanını silme işlemi şu hata iletisiyle başarısız oluyor:
Failed to delete Synapse workspace '[Workspace Name]'. Unable to delete virtual network. The correlationId is ********-****-****-****-************;
Geçici çözüm: Silme işlemi yeniden denenerek sorun giderilebilir. Mühendislik ekibi bu davranışın farkındadır ve bir düzeltme üzerinde çalışmaktadır.
Ağ ayarlarını güncelleştirmek için REST API PUT işlemleri veya ARM/Bicep şablonları başarısız
Synapse çalışma alanının genel ağ erişim ayarlarını ve/veya güvenlik duvarı kurallarını değiştirmek için ARM şablonu, Bicep şablonu veya doğrudan REST API PUT işlemi kullanılırken işlem başarısız olabilir.
Geçici çözüm: İstenen yapılandırma değişikliklerini tersine çevirmek ve yeniden denemek için REST API PATCH işlemi veya Azure portalı kullanıcı arabirimi kullanılarak sorun giderilebilir. Mühendislik ekibi bu davranışın farkındadır ve bir düzeltme üzerinde çalışmaktadır.
Etiketler değerine köşeli ayraç [] eklemeyle ilgili bilinen sorun
Azure Synapse çalışma alanı içindeki etiket değerlerini güncelleştirme bağlamında köşeli ayraçların ([]) eklenmesi başarısız bir güncelleştirme işlemine neden olur.
Geçici çözüm: Geçerli geçici çözüm, Azure Synapse çalışma alanı etiket değerlerinde köşeli ayraçları ([]) kullanmaktan kaçınmanızdır.
ARM şablonlarıyla GitHub eylemlerinde Synapse-workspace-deployment v1.8.0 kullanılarak Synapse Çalışma Alanında dağıtım hataları
Hata, üretime dağıtım sırasında oluşur ve çift ters eğik çizgi içeren bir konak adı içeren bir tetikleyiciyle ilgilidir.
Görüntülenen hata iletisi: Action failed - Error: Orchestrate failed - SyntaxError: Unexpected token in JSON at position 2057.
Geçici çözüm: Hızlı azaltma olarak aşağıdaki eylemler yapılabilir:
- Kaçış karakterlerini kaldırma: Dağıtımdan önce parametre dosyasından tüm kaçış karakterlerini (
\) el ile kaldırın. Bu, dağıtımın ayrıştırma veya işleme aşamasında sorunlara neden olabilecek bu karakterleri ortadan kaldırmak için dosyanın düzenlenmesi anlamına gelir. - Kaçış karakterlerini eğik çizgilerle değiştirin: Kaçış karakterlerini (
\) eğik çizgilerle (/) değiştirin. Bu, birçok sistemin geçerli yol ayırıcıları olarak eğik çizgi kabul ettiği dosya yollarında özellikle yararlı olabilir. Bu değiştirme, kaçış karakterleriyle ilgili sorunun atlanmasına yardımcı olabilir ve dağıtım işleminin başarılı olmasını sağlayabilir.
Bu geçici çözümlerden birini uyguladıktan ve başarıyla dağıttıktan sonra, her şeyin doğru ayarlandığından emin olmak için çalışma alanındaki gerekli yapılandırmaları el ile güncelleştirin. Bu, yapılandırma dosyalarını düzenlemeyi, ayarları ayarlamayı veya dağıtılmakta olan belirli bir ortam veya uygulamayla ilgili diğer görevleri gerçekleştirmeyi içerebilir.
Azure Synapse Analytics sunucusuz SQL havuzu etkin bilinen sorunlar özeti
Sunucusuz SQL havuzundan Azure Cosmos DB analiz deposuna sorgu hataları
Sunucusuz SQL havuzundan Azure Cosmos DB analiz deposuna yönelik sorgular aşağıdaki hata iletilerinden biriyle başarısız olabilir:
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'
Bu sorunla karşılaşıldığını onaylamak için aşağıdaki koşulların doğru olması gerekir:
- Azure Cosmos DB analiz deposu bağlantısı özel uç nokta kullanıyor.
- Sorgu yeniden denendiğinde başarılı oluyor.
Geçici çözüm: Mühendislik ekibi bu davranışın farkındadır ve aşağıdaki eylemler hızlı bir şekilde azaltılabilir:
- Başarısız olan sorguyu yeniden deneyin. Süresi dolan belirteci otomatik olarak yenileyecektir.
- Özel uç noktayı devre dışı bırakın. Bu değişikliği uygulamadan önce güvenlik ekibinizden bunun şirketinizin güvenlik ilkelerine uyduğunu onaylamasını isteyin.
Azure Cosmos DB analiz deposu görünümü, sütunda yanlış öznitelikleri yayıyor
Cosmos DB analiz deposu üzerinden Azure Synapse sunucusuz havuzundaki görünümleri kullanırken, Cosmos DB analiz deposundaki dosyalarda bir değişiklik varsa, değişiklik SELECT deyimlerine doğru yayılmaz, müşteri görünümde kullanıyordur. Sonuç olarak, öznitelikler sonuçlardaki farklı bir sütuna yanlış eşlenir.
Geçici çözüm: Mühendislik ekibi bu davranışın farkındadır ve aşağıdaki eylemler hızlı bir şekilde azaltılabilir:
- Sütunları yeniden adlandırarak görünümü yeniden oluşturun.
- Mümkünse görünümleri kullanmaktan kaçının.
Kimlik bilgisi kullanıldıysa veritabanı kapsamlı kimlik bilgilerini değiştirme işlemi başarısız olur
Bazen sorguyu ALTER DATABASE SCOPED CREDENTIAL yürütemeyebilirsiniz. Bu sorunun kök nedeni, kimlik bilgilerinin ilk kullanımından sonra önbelleğe alınıp değişiklik için erişilemez hale getirilmesidir. Döndürülen hata:
Failed to modify the identity field of the credential '{credential_name}' because the credential is used by an active database file.
Geçici çözüm: Mühendislik ekibi şu anda bu davranışın farkında ve bir düzeltme üzerinde çalışıyor. Geçici bir çözüm olarak DROP ve CREATE kimlik bilgilerini oluşturabilirsiniz. Bu, kimlik bilgilerini kullanarak dış tabloları yeniden oluşturmak anlamına da gelir. Alternatif olarak, yardım için Microsoft Desteği Ekibi ile iletişime geçebilirsiniz.
Sunucusuz SQL havuzlarında sorgu hataları
Depolama alanı üzerinde kullanıcı için gerekli izinlere sahip olmasına rağmen, belirteç süre sonu sorgu yürütmesi sırasında hatalara neden olabilir. Bu hata iletileri, rol tabanlı erişim denetimi (RBAC) rollerinin depolama hesabına atanmaması gibi yaygın kullanıcı hatalarından da kaynaklanabilir.
Örnek hata iletileri:
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.
Geçici çözüm:
Çözüm, kimlik doğrulamasına, Microsoft Entra'ya (eski adıYla Azure Active Directory) veya yönetilen hizmet kimliğine (MSI) bağlı olarak farklıdır:
Microsoft Entra belirteci süre sonu için:
Uzun süre çalışan sorgular için kullanıcı kimliği kullanmak yerine hizmet sorumlusuna, yönetilen kimliğe veya paylaşılan erişim imzasına (SAS) geçin. Daha fazla bilgi için bkz . Azure Synapse Analytics'te sunucusuz SQL havuzu için depolama hesabı erişimini denetleme.
Bağlantıyı kurmak için yeni bir belirteç almak için istemciyi (SSMS/ADS) yeniden başlatın.
MSI belirteci süre sonu için:
- Devre dışı bırakın ve ardından belirteç önbelleğini temizlemek için havuzu etkinleştirin. Yardım için Microsoft Desteği Ekibi ile iletişime geçin.
Yetkilendirme üst bilgisinin çok uzun olması nedeniyle erişim sorunlarını Depolama
Sunucusuz SQL havuzlarında örnek hata iletileri:
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}
Sorgu çalıştırılırken bu genel depolama erişim hataları görüntülenir. Sorun, bir çalışma alanında bulunan bir kullanıcı için oluşabilir ancak diğer çalışma alanlarında düzgün çalışabilir. Belirteç boyutu nedeniyle bu davranış beklenir.
PowerShell'de aşağıdaki komutu çalıştırarak Microsoft Entra belirteci uzunluğunu denetleyin. -ResourceUrl Parametre değeri, abonelik dışı bulutlar için farklı olacaktır. Belirteç uzunluğu 11000 veya daha uzunsa Azaltma bölümüne bakın.
(Get-AzAccessToken -ResourceUrl https://database.windows.net).Token.Length
Geçici çözüm:
Önerilen geçici çözümler şunlardır:
- Depolama erişim denetiminde açıklandığı gibi Yönetilen Kimlik depolama yetkilendirmesine geçin.
- Güvenlik grubu sayısını azaltın (uyumlu uzunlukta bir belirteçle 90 veya daha az güvenlik grubu elde edilir).
- Güvenlik grubu sayısını 200'den fazla artırın (belirtecin oluşturma şeklini değiştirdiğinden, grupların tam listesi yerine ms Graph API URI'si içerir). Bu, yeni oluşturulan gruplara kullanıcı eklemeniz gerekdikten sonra yönetilen grupları takip ederek sahte/yapay gruplar eklenerek elde edilebilir.
Yakın zamanda kapatılan bilinen sorunlar
| Synapse Bileşeni | Sorun | Durum | Çözümlenme Tarihi |
|---|---|---|---|
| Azure Synapse sunucusuz SQL havuzu | Microsoft Entra kimlik doğrulaması kullanan sorgular 1 saat sonra başarısız oluyor | Çözümlendi | Ağustos 2023 |
| Azure Synapse sunucusuz SQL havuzu | OPENROWSET kullanarak Cosmos DB verileri okunurken sorgu hataları | Çözümlendi | Mart 2023 |
| Azure Synapse Apache Spark havuzu | İşlem hatlarında not defterleri kullanılırken Azure Synapse ayrılmış SQL havuzu Bağlan veya Apache Spark kullanılarak Synapse Spark'tan SQL Ayrılmış Havuzuna yazılamadı | Çözümlendi | Haziran 2023 |
| Azure Synapse Apache Spark havuzu | Depolama hesabı azaltma nedeniyle bazı Spark işi veya görevi Hata Kodu 503 ile çok erken başarısız oluyor | Çözümlendi | Kasım 2023 |
Azure Synapse Analytics sunucusuz SQL havuzu yakın zamanda kapatılan bilinen sorunlar özeti
Microsoft Entra kimlik doğrulaması kullanan sorgular 1 saat sonra başarısız oluyor
1 saatten uzun süre etkin kalan Microsoft Entra kimlik doğrulaması kullanan SQL bağlantıları başarısız olmaya başlar. Bu, Microsoft Entra doğrudan kimlik doğrulamasını kullanarak depolamayı sorgulamayı ve CREATE EXTERNAL PROVIDER gibi Microsoft Entra ID ile etkileşim kuran deyimleri içerir. Bu, SSMS ve ADS'deki sorgu düzenleyicisi gibi bağlantıları etkin tutan her aracı etkiler. Sorguları yürütmek için yeni bağlantı açan araçlar Synapse Studio gibi etkilenmez.
Durum: Çözüldü
OPENROWSET kullanarak Azure Cosmos DB verilerini okurken sorgu hataları
SUNUCUSUZ SQL havuzundan OPENROWSET kullanan Cosmos DB Analiz Deposu'na yapılan sorgular aşağıdaki hata iletisiyle başarısız oluyor:
Resolving CosmosDB path has failed with error 'bad allocation'.
Durum: Çözüldü
Azure Synapse Analytics Apache Spark havuzu yakın zamanda kapatılan bilinen sorunlar özeti
İşlem hatlarında not defterleri kullanılırken Apache Spark için Azure Synapse ayrılmış SQL havuzu bağlayıcısı kullanılarak Synapse Spark'tan SQL Ayrılmış Havuzuna yazılamadı
İşlem hatlarında Not Defterlerini kullanarak Azure Synapse Ayrılmış havuzu yazmak üzere Apache Spark için Azure Synapse ayrılmış SQL havuzu Bağlan kullanırken bir hata iletisiyle karşılaşırız:
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.
Durum: Çözüldü
Depolama hesabı azaltma nedeniyle bazı Spark işi veya görevi Hata Kodu 503 ile çok erken başarısız oluyor
3 Ekim 2023 ile 16 Kasım 2023 arasında, depolama API'si sınırı eşiğinin aşılması nedeniyle birkaç Azure Synapse Analytics Apache Spark havuzu Spark işi/görev hatalarıyla karşılaşabilir.
Durum: Çözüldü