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.

"Microsoft.Synapse/workspaces/trustedServiceBypassEnabled" ayarına ayrılmış 'GET' API işlemi yok

Sorun Özeti: Azure Synapse Analytics'te "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled" kaynak kapsamındaki "trustedServiceBypassEnabled" ayarının durumunu almak için ayrılmış bir 'GET' API işlemi yoktur. Kullanıcılar bu yapılandırmayı ayarlayabilir, ancak bu özel kaynak kapsamı aracılığıyla durumunu doğrudan alamazlar.

Etki: "trustedServiceBypassEnabled" ayarı için belirli bir durumu zorunlu kılamadıkları için bu sınırlama Azure İlkesi tanımları etkiler. Müşteriler bu yapılandırmayı reddetmek veya yönetmek için Azure İlkesi kullanamıyor.

Geçici çözüm: bu özellik için istenen yapılandırma durumunu zorlamak için Azure İlkesi'da geçici bir çözüm yoktur. Ancak, kullanıcılar raporlama amacıyla yapılandırma durumunu denetlemek için 'GET' çalışma alanı işlemini kullanabilir.
Bu 'GET' çalışma alanı işlemi 'Microsoft.Synapse/workspaces/trustedServiceBypassEnabled' Azure İlkesi Diğer Ad ile eşler.

Azure İlkesi Diğer Adı, işlem Microsoft.Synapse/workspace kaynağına yönelik bir PUT isteğiyse, bu özelliği Reddetme Azure İlkesi Etkisi ile yönetmek için kullanılabilir, ancak yalnızca PUT isteği doğrudan Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration alt kaynağına gönderiliyorsa Denetim amacıyla çalışır. Üst kaynak, alt kaynaktan yapılandırmayı eşleyen [properties.trustedServiceBypassEnabled] özelliğine sahiptir ve bu nedenle üst kaynağın Azure İlkesi Diğer Adı üzerinden yine denetlenebilir.

Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration alt kaynağının kullanılabilir GET işlemi olmadığından, Azure İlkesi bu istekleri yönetemez ve Azure İlkesi bunun için bir Azure İlkesi Diğer Adı oluşturamaz.

Üst Kaynak: Microsoft.Synapse/workspaces

Alt Kaynak: Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration

Azure portalı, alt kaynak için PUT API'sine doğrudan PUT isteği gönderir ve bu nedenle Üst Microsoft.Synapse/workspaces API'leri dışında yapılan diğer API istekleriyle birlikte Azure portalı, reddetme veya başka eyleme dönüştürülebilir Azure İlkesi Etkisi aracılığıyla Azure İlkesi tarafından yönetilemez.

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:

1. Azure Cosmos DB analiz deposu bağlantısı özel uç nokta kullanıyor.
2. 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:

1. Başarısız olan sorguyu yeniden deneyin. Süresi dolan belirteci otomatik olarak yenileyecektir.
2. Ö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:

1. Sütunları yeniden adlandırarak görünümü yeniden oluşturun.
2. 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 depolama erişimi sorunları

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.

Görünümü sorgulamak beklenmeyen sonuçlar gösteriyor

Görünüm oluşturulduktan sonra temel şemanın değiştirildiği görünümü sorguladığınızda beklenmeyen sonuçlarla karşılaşabilirsiniz. Bu, görünümün değiştirilmiş veya artık mevcut olmayan sütunlara veya nesnelere başvurduğunu gösterir. Bunun üstesinden gelmek için, görünüm tanımını temel alınan şema değişiklikleriyle uyumlu olacak şekilde el ile ayarlamanız gerekir.

Geçici çözüm: Görünüm tanımını el ile ayarlayın.

Yakın zamanda kapatılan bilinen sorunlar

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ğlayıcısı kullanılı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ü

Spark 3.4 çalışma zamanında Synapse Ayrılmış SQL Havuzu Bağlayıcısı'nı kullanan LIKE yan tümcesiyle sorgu hatası

açık kaynak Apache Spark 3.4, özel karakterlerden kaçan bir sorun ortaya çıkarmıştır, ancak Synapse SQL kaçış anahtar sözcüğünü desteklemez. Müşteriler Apache Spark için Azure Synapse Ayrılmış SQL Havuzu Bağlayıcısı'nı kullandığında Synapse SQL için geçersiz bir SQL sorgusu oluşturabilir ve Synapse Spark not defteri veya toplu iş aşağıdakine benzer bir hata oluşturur:

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

Durum: Çözüldü

İlgili içerik

• Synapse Studio sorunlarını giderme
• Azure Synapse Analytics'de sunucusuz SQL havuzu sorunlarını giderme
• Azure Synapse Analytics'de sunucusuz SQL havuzu için en iyi yöntemler
• Ayrılmış SQL Havuzu'nda yavaş sorgu sorunlarını giderme