Analysis Services müşteri kitaplıkları

Şunlar için geçerlidir: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

İstemci kitaplıkları, istemci uygulamalarının ve araçlarının Analysis Services'a bağlanması için gereklidir. Visual Studio için Power BI Desktop, Excel, SQL Server Management Studio (SSMS) ve Analysis Services projeleri uzantısı gibi Microsoft istemci uygulamaları üç istemci kitaplığını da yükler ve bunları normal uygulama güncelleştirmeleriyle birlikte güncelleştirir. Analysis Services için özel istemci uygulamaları, bu istemci kitaplıklarından birinin veya daha fazlasının yüklenmesini de gerektirebilir. İstemci kitaplıklarının yeni sürümleri yaklaşık aylık olarak güncelleştirilir.

Önemli: En son sürümleri almadan önce,Dikkat Edilmesi Gerekenler ve sınırlamalar'ı gördüğünüzden emin olun.

En son sürümü indirin

Windows Yükleyici

İndirmek	Sürüm
MSOLAP (amd64)	17.0.30.23
MSOLAP (x86)	17.0.30.23
AMO	19.84.1.0
ADOMD	19.84.1.0

Not: Analysis Services Yönetim Nesneleri (AMO/TOM) ve ADOMD için Windows Installer indirmeleri artık güncelleştirilmiyor ve 31 Aralık 2024'den sonra kullanılamayacak. Bu Windows Installer indirmelerini kullanan uygulamalar NuGet paketlerine geçirilmelidir.

NuGet paketleri

Analysis Services Yönetim Nesneleri (AMO/TOM) ve ADOMD istemci kitaplıkları, NuGet.org'den yüklenebilir paketler olarak sunulmaktadır. Windows Installer'ı kullanmak yerine NuGet bağımlılıklarına geçmeniz kesinlikle önerilir.

NuGet paket derlemeleri AssemblyVersion, semantik sürümlemeyi izler: ANA.ARA.DÜZELTME. GAC'de farklı bir sürüm bulunsa bile (MSI yüklemesinden gelen), NuGet başvuruları beklenen sürümü yükler. PATCH her bir sürüm için artırılır. AMO ve ADOMD sürümleri eşgüdümlü olarak tutulur.

Temmuz 2024'den itibaren, AMO ve ADOMD paketleri hem .NET FX hem de .NET Core olmak üzere desteklenen tüm hedef çalışma zamanları için çoklu çalışma zamanı sürümleri içerir; .NET FX veya .NET Core olmak üzere yalnızca tek bir çalışma zamanını hedefleyen paketlerin önceki sürümleri geriye dönük uyumluluk için kullanılabilir, ancak artık güncelleştirilmez.

Eylül 2022'den itibaren AMO (AMO/TOM) ve ADOMD .Net Core (sürüm 19.48.0.0), Power BI ve Azure Analysis Services gibi bulut hizmetleriyle HTTP tabanlı iletişim önemli ölçüde geliştirilmiştir. Performans geliştirmelerinden yararlanmak için en son sürüme güncelleştirmeniz önerilir.

2021 Şubat ayından itibaren, .NET Core çalışma zamanı desteği , AMO ve ADOMD istemci paketleri için mevcuttur. Bununla birlikte, .NET Core sürümleri tarafından desteklenmeyen birkaç senaryo vardır. Daha fazla bilgi edinmek için bu makalenin devamında önemli noktalara ve sınırlamalara bakın.

AMO ve ADOMD

Paket	Sürüm
AMO	19.101.1.0
ADOMD	19.101.1.0

Not:

Yeni çoklu çalışma zamanı paketlerinin artık paket kimliğinde ".retail.amd64" soneki yoktur ve artık yalnızca Microsoft.AnalysisServices ve Microsoft.AnalysisServices.AdomdClient olarak adlandırılır.

Eski .NET Framework ve .NET Core paketleri, geriye dönük uyumluluk amacıyla eski kimlik altında hâlâ nuget.org'da mevcuttur. Bu paketler, .NET Framework için ".retail.amd64" soneki ve .NET Core için ".NetCore.retail.amd64" soneki taşır.

En düşük gerekli sürümler

Aktarım Katmanı Güvenliği (TLS) protokolü sürüm 1.0/1.1, 30 Haziran 2021'de Microsoft Entra Id'de kullanım dışı bırakılmıştır. TLS 1.2 veya üzeri artık gereklidir. TLS 1.2, Analysis Services istemci kitaplıklarının önceki sürümlerinde desteklenmez. Daha yeni istemci kitaplığı sürümleri, diğer önemli güvenlik geliştirmelerine ek olarak TLS 1.2 ve üzeri için destek içerir.

Riski ve olası güvenlik açıklarını en aza indirmek için, 30 Haziran 2021'dan itibaren Azure Analysis Services ve Power BI'da gelişmiş güvenlik aşağıdaki veya daha yüksek sürümleri gerektirir:

İstemci kütüphane	Dosya sürümü	Sürüm
MSOLAP	2018.151.61.21	15.1.61.21
AMO	15.1.61.21	19.12.3.0
ADOMD	15.1.61.21	19.12.3.0

Dikkat edilmesi gerekenler ve sınırlamalar

AMO ve ADOMD

19.98.0.3 sürümünden itibaren:

• HTTP bağlantıları üzerinden Entra-Id tabanlı kimlik doğrulama deneyimini denetlemek için ek bir bağlantı dizesi özellikleri kümesi kullanılabilir. Daha fazla bilgi için ürün belgelerindeki Analysis-Services bağlantı dizesi özellikleri makalesine bakın.
• HTTP tabanlı iletişim, özellikle .NET Core kitaplıkları kullanılırken aktarım katmanında açık HTTP kanallarının daha iyi yönetilmesiyle geliştirilmiştir.

19.94.1.1 sürümünün AdomdClient ve AMO Paketleri, 19.94.0.0 sürümünün yerini alır. Lütfen en son sürüme yükseltin.

Sürüm 19.94.1.1 ile:

• AMO paketindeki TMDL serileştirme seçenekleri sınıfları, kullanımlarını basitleştirmek için bir dizi uzantı yöntemi içerir. Diğer ayrıntılar için API başvurusu belgelerine bakın.
• Bazı anlamsal model yazma senaryolarındaki hata bilgileri, uyumluluk ihlalleri ve çapraz başvuru sorunları için ek ayrıntılar içerir:
  • Uyumluluk ihlalleri: CompatibilityViolationException sınıfı, sorun gidermeye yardımcı olmak için ileti metninde ayrıntılı bilgiler sunar. SupportedCompatibilityLevel ve CompatibilityLevelRequest gibi ek özellikler de daha ayrıntılı bilgiler sunar.
  • Çapraz başvuru hataları: TmdlDeserializationWithReferenceErrorsException ve JsonDeserializationWithReferenceErrorsException sınıfları, çözümlenmemiş özellikleri listeleyen ve çapraz başvuru hataları hakkında ek ayrıntılar sunan ayrıntılı hata iletileri sağlar. Bu yeni özel durum sınıfları TMDL ve TMSL seri durumdan çıkarma sorunlarını işlemeye yardımcı olabilir.

Sürüm 19.84.6'dan başlayarak, yönetilen derlemelerde .NET FX 4.5 ve .NET Core 3.0 desteği artık sağlanmamaktadır. AS istemci tarafı derlemeleri artık .NET FX 4.7.2 ve yalnızca .NET 6.0 ve .NET 8.0 desteğiyle kullanıma sunuldu.

AMO ve ADOMD, aşağıdaki bağlantı dizesi örneğinde olduğu gibi 19.82.0.0 sürümünden başlayarak kimlik doğrulaması için Hizmet Sorumlusu Profillerini destekler. Daha fazla bilgi edinmek için bkz. Hizmet sorumlusu profillerini kullanarakçok kiracılı uygulamalarda müşteri verilerini yönetme. Kullanıcılar, XMLA uç noktası üzerinden Hizmet Sorumlusu Profillerini kullanarak Premium Per-User lisansıyla ilişkili çalışma alanlarına bağlanamaz.

Data Source=powerbi://api.powerbi.com/v1.0/myorg/<WorkspaceName>;User ID=app:<service principal id>@<tenant id>;SPN Profile=<service-principal profile id>;Password=<service-principal's secret>

19.67.0 sürümünden başlayarak, Microsoft.AnalysisServices.AdomdClient.AdomdConnection ve Microsoft.AnalysisServices.Server gibi bağlantı nesneleri, XMLA bağlantı katmanı tarafından kullanılacak dış OAuth belirteçlerini geçirmenin geliştirilmiş bir yolunu sağlayan yeni bir AccessToken özelliğini destekler. Daha fazla bilgi edinmek için bkz. Bağlantı dizesi özellikleri - Kullanıcı Kimliği=...; Password=.

19.42.0.4 sürümünden başlayarak, ADOMD.NET ve AMO/TOM, Power-BI ve Azure Analysis Services gibi bulut tabanlı hizmetlere bağlantı kurarken kullanıcıların kimliğini Microsoft Entra Id ile doğrulamak için ADAL yerine MSAL (Microsoft.Identity.Client) sürüm 4.43.0 veya üzerini kullanır. Uygulamanız veya uygulamanın bağımlı olduğu başka bir bileşen MSAL kullanıyorsa, bileşenler tarafından yüklenen MSAL sürümleri arasında çakışmalar varsa uygulamanın bağlama yeniden yönlendirme ayarlarını güncelleştirmeniz gerekebilir.

AMO ve ADOMD .Net Core

Desteklenen senaryolar Azure Analysis Services, Power BI Premium ve SQL Server Analysis Services bağlantılarıdır. TCP tabanlı bağlantı yalnızca Windows bilgisayarları için desteklenir.

Microsoft Entra Id ile etkileşimli oturum açma yalnızca Windows bilgisayarları için desteklenir. .NET Core Desktop çalışma zamanına ihtiyacınız vardır.

MSAL'de bağımlılık için sürüm 4.43.0 veya üzeri gerekir.

.Net Core istemci kitaplıklarının 19.14.0 sürümü, .NET 5.0 projelerinin kullanımına yönelik desteğin yanı sıra Self-Contained yayımlama (hem yayımlanmış dizinde hem de tek dosya modunda) için önizleme desteği sundu. Önceki sürümde tanımlanan SQL Server Analysis Services bağlantısıyla ilgili çeşitli sorunlar düzeltildi.

.Net Core istemci kitaplıklarının 19.12.7.2 sürümü SQL Server Analysis Services desteği sunmş. Alt önizleme sürümleri yalnızca Azure Analysis Services ve Power BI anlam modellerini destekler.

ÇYN

19.98.0.3 sürümünden itibaren tablosal model veritabanları için varsayılan uyumluluk düzeyi 1700'dür. Açıkça uyumluluk düzeyi belirtilmeden oluşturulan veritabanları varsayılan olarak düzey 1700 kullanır.

Sürüm 19.84.6'dan başlayarak, AMO\TOM'da TMDL desteği General-Availability durumunda kabul edilir ve API yüzeyinde herhangi bir önemli değişiklik yapılmayacaktır.

AMO istemci kitaplığının 19.12.3.0 sürümü, Microsoft.AnalysisServices.DataTypeyeni bir numaralandırma tanıtır. Ancak, Microsoft.AnalysisServices.Tabular.DataType önceki numaralandırma hala mevcut. Kodunuz, her iki ad alanının (Microsoft.AnalysisServices, Microsoft.AnalysisServices.Tabular) deyimlerini içeren bir kod dosyasında DataType şeklinde önceki numaralandırmaya referans veriyorsa, belirsizlik nedeniyle derleme sırasında bir hata alabilirsiniz. Hatayı gidermek için, numaralandırmaya olan referansı tam olarak belirleyin.

AMO istemci kitaplığının 19.61.1.4 sürümü, Microsoft.AnalysisServices.Serverişlem geri alma davranışında bir değişiklik sağlar. Önceki sürümlerde, Server.RollbackTransaction() çağrısı işlemi geri almak için altyapıya bir istek gönderir ve ardından yerel değişiklikleri geri almayı dener. Önceki sürümlerden farklı olarak, 19.61.1.4 ve sonraki sürümlerde yerel değişiklikler güvenli bir şekilde geri alınamazsa, işlemdeki tablosal veritabanları, tamamen eşitlenebilene ve geri alınan işlemdeki eski değişiklikler kaldırılana kadar ek değişiklikleri engeller. İlgili tablo veritabanında bir değişiklik yapıldığında InvalidOperationException oluşturulur. Kodunuz Server.RollbackTransaction()çağırıyorsa, işlemin bir parçası olarak değiştirilen tablosal veritabanları için, bu çağrıdan sonra [Database.Refresh(true)] ile tam bir senkronizasyon yapmanız önerilir.

19.77.0 sürümünden başlayarak, Tablosal Nesne Modeli'ni (TOM) kullanarak bir MetadataObject'i başka bir MetadataObject örneğine kopyalarken veya çoğaltırken, MetadataObject'in doğrudan alt nesne ağacının dışındaki nesnelere çapraz başvuruda bulunan özellikler için TOM null döndürür. MetadataObject ağacı dışındaki nesnelere çapraz başvuruların çözümlenebilmesi için kopyalanan MetadataObject örneğini anlam modeline eklemeniz gerekir.

Örneğin, EntityPartitionSource'ta adlandırılmış bir ifadeye başvuran bir bölüme sahip bir tabloyu klonlarken, kopyalanan tablo aşağıdaki kod parçacığında olduğu gibi anlam modeline eklenene kadar EntityPartitionSource'un ExpressionSource özelliği null döndürür, böylece kopyalanan ExpressionSource başvurusu çözümlenebilir. Adı başka bir yerde referans alınan ifade, tablonun alt nesne ağacının bir parçası olmadığı için ve modelin İfadeler koleksiyonunun bir üyesi olduğu için klon, modele eklenmelidir.

Table tableClone = model.Tables[0].Clone();
anotherModel.Tables.Add(tableClone);

ADOMD

ADOMD (hem .NET Framework hem de .NET Core) sürüm 19.61.1.4 ile başlayarak, sıkıştırma XMLA aktarım katmanında tamamen kullanılabilir. 19.55.3.1 sürümünden sonraki önceki sürümlerde sıkıştırma için bazı kısmi destek uygulanmıştı. Bu sürümlerle ilgili sorunlar hakkında raporlar alındı. Bu sorunlar 16.61.1.4 sürümünün bir parçası olarak düzeltildi. Sıkıştırmayla ilgili sorunlarla karşılaşıyorsanız 19.61.1.4 veya sonraki bir sürüme yükseltmeyi unutmayın.

MSOLAP

Sürüm 17.0.25.23'den başlayarak, HTTP bağlantıları üzerinden Entra-Id tabanlı kimlik doğrulama deneyimini denetlemek için ek bir bağlantı dizesi özellikleri kümesi kullanılabilir. Daha fazla bilgi için ürün belgelerindeki Analysis-Services bağlantı dizesi özellikleri makalesine bakın.

MSOLAP, 16.0.139.27 sürümünden başlayarak, aşağıdaki bağlantı dizesi örneğinde olduğu gibi kimlik doğrulaması için Hizmet Sorumlusu Profillerini destekler. Daha fazla bilgi edinmek için bkz. Hizmet sorumlusu profillerini kullanarakçok kiracılı uygulamalarda müşteri verilerini yönetme.

Data Source=powerbi://api.powerbi.com/v1.0/myorg/<WorkspaceName>;User ID=app:<service principal id>@<tenant id>;SPN Profile=<service-principal profile id>;Password=<service-principal's secret>

16.0.134.22 sürümünden itibaren MSOLAP, Windows 10 ve üzeri sürümlerde ve Windows Server 2019 ve üzeri sürümlerde kullanılabilen Web Hesabı Yöneticisi'nin (WAM) kullanıldığı sessiz Tek Sign-On (SSO) destekler. Yeni bir HTTP bağlantısı açıldığında, MSOLAP aşağıdaki gibi bir erişim belirteci elde eder:

1. Belirteç önbellekleme etkinse ve önbellekte uygun bir belirteç varsa, MSOLAP önbellekteki belirteci kullanır.
2. Uygun bir önbelleğe alınmış belirteç kullanılamıyorsa, MSOLAP WAM aracılığıyla gizlice bir erişim belirteci elde etmeye çalışır.
3. WAM kullanan SSO başarısız olursa, MSOLAP etkileşimli kimlik doğrulamasına geri döner ve oturum açma penceresi açılır.

Kullanıcılar sessiz SSO akışını atlayabilir ve bağlantı dizesinde 'boş' bir kullanıcı kimliği sağlayarak etkileşimli kimlik doğrulama deneyimini hemen başlatabilir (Kullanıcı Kimliği='').

16.0.43.20 sürümünden başlayarak MSOLAP, Power-BI ve Azure Analysis Services gibi bulut tabanlı hizmetlerle bağlantı kurarken Kullanıcıların kimliğini Microsoft Entra Id ile doğrulamak için ADAL yerine MSAL (Microsoft.Identity.Client) sürüm 4.43.0 veya üzerini kullanır. Uygulamanız veya uygulamanın bağımlı olduğu başka bir bileşen MSAL kullanıyorsa, bileşenler tarafından yüklenen MSAL sürümleri arasında çakışmalar varsa uygulamanın bağlama yeniden yönlendirme ayarlarını güncelleştirmeniz gerekebilir

OleDB'nin (MSOLAP) 16.0.4.17 sürümünde Microsoft Entra Id kullanılarak bulut tabanlı sistemlere yapılan bağlantılarla ilgili bir regresyon bulundu. 16.0.20.201 sürümünde düzeltildi. Sorunun doğası gereği, yüklü bir 16.0.4.17 sürümünün yanı sıra 16.0.20.201 öncesi diğer sürümler, kurulum onarım modunda çalıştırılsa bile sağlayıcı yükseltilerek düzeltilemez. 16.0.4.17 [veya diğer sorunlu] sürümü tamamen kaldırmanız ve ardından 16.0.20.201 veya sonraki bir sürümü yüklemeniz önerilir.

Önceki bir sürümde MSOLAP, yönetilen Microsoft Kimlik Doğrulama Kitaplığı (MSAL) kullanılarak bulut tabanlı Analysis Services'e bağlanacak şekilde güncelleştirildi. Sürüm 16.0.87.16'dan başlayarak, MSOLAP kurulumu artık özgün yerel Azure Active Directory Kimlik Doğrulama Kitaplığı (ADAL) bileşenini yüklemez.

İstemci kitaplıklarını anlama

Analysis Services üç istemci kitaplığı kullanır. ADOMD.NET ve Analysis Services Yönetim Nesneleri (AMO) yönetilen istemci kitaplıklarıdır. Analysis Services OLE DB Sağlayıcısı (MSOLAP DLL), yerel bir istemci kitaplığıdır. Genellikle üçü de aynı anda yüklenir.

Power BI Desktop ve Excel gibi Microsoft istemci uygulamaları üç istemci kitaplığını da yükler ve yeni sürümler kullanılabilir olduğunda bunları güncelleştirir. Güncelleştirmelerin sürümüne veya sıklığına bağlı olarak, bazı istemci kitaplıkları Azure Analysis Services ve Power BI için gereken en son sürümler olmayabilir. Aynı durum özel uygulamalar veya AsCmd, TOM ADOMD.NET gibi diğer arabirimler için de geçerlidir. Bu uygulamalar, kitaplıkların el ile veya program aracılığıyla yüklenmesini gerektirir. El ile yükleme için istemci kitaplıkları SQL Server özellik paketlerine dağıtılabilir paketler olarak eklenir. Ancak, bu istemci kitaplıkları SQL Server sürümüne bağlıdır ve en son sürüm olmayabilir. Bu makaleden her zaman en son indirilebilir sürümü yüklediğinizden emin olun.

İstemci kitaplığı türleri

Analysis Services OLE DB Sağlayıcısı (MSOLAP)

Analysis Services OLE DB Sağlayıcısı (MSOLAP), Analysis Services veritabanı bağlantıları için yerel istemci kitaplığıdır. Hem ADOMD.NET hem de AMO tarafından dolaylı olarak kullanılır ve veri sağlayıcısına bağlantı istekleri atanır. Ole DB Sağlayıcısını doğrudan uygulama kodundan da çağırabilirsiniz.

Analysis Services OLE DB Sağlayıcısı, Analysis Services veritabanlarına erişmek için kullanılan çoğu araç ve istemci uygulaması tarafından otomatik olarak yüklenir. Analysis Services verilerine erişmek için kullanılan bilgisayarlara yüklenmelidir.

OLE DB sağlayıcıları genellikle bağlantı dizelerinde belirtilir. Analysis Services bağlantı dizesi, OLE DB Sağlayıcısına atıfta bulunmak için farklı bir adlandırma kullanır: MSOLAP.<sürümü>.dll.

AMO

AMO, sunucu yönetimi ve veri tanımı için kullanılan yönetilen bir istemci kitaplığıdır. Araçlar ve istemci uygulamaları tarafından yüklenip kullanılır. Örneğin, SQL Server Management Studio (SSMS), Analysis Services'e bağlanmak için AMO kullanır. AMO kullanan bir bağlantı genellikle minimum düzeydedir ve "data source=\<servername>"oluşur. Bağlantı kurulduktan sonra, veritabanı koleksiyonları ve ana nesnelerle çalışmak için API'yi kullanırsınız. Hem Visual Studio hem de SSMS bir Analysis Services örneğine bağlanmak için AMO kullanır.

ADOMD

ADOMD.NET, Analysis Services verilerini sorgulamak için kullanılan bir yönetilen veri istemci kitaplığıdır. Araçlar ve istemci uygulamaları tarafından yüklenip kullanılır.

Veritabanına bağlanırken, üç kitaplığın da bağlantı dizesi özellikleri benzerdir. Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString kullanarak ADOMD.NET için tanımladığınız neredeyse tüm bağlantı dizeleri AMO ve Analysis Services OLE DB Sağlayıcısı (MSOLAP) için de çalışır. Daha fazla bilgi edinmek için bkz. Bağlantı dizesi özellikleri.

Yüklü sürümleri denetleme

OLEDDB (MSOLAP)

1. C:\Program Files\Microsoft Analysis Services\AS OLEDB\'a gidin. Birden fazla klasörünüz varsa, yüksek sayıyı seçin.

2. Sağ tıklayın msolap.dll>Özellikleri>Ayrıntıları. Ürün sürümü özelliğini denetleyin. Not: Dosya adı msolap140.dllise en son sürümden daha eskidir ve yükseltilmelidir.

   

AMO

1. C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\'a gidin. Birden fazla klasörünüz varsa, yüksek sayıyı seçin.

2. Microsoft.AnalysisServices>Özellikleri>Ayrıntılarıüzerinde sağ tıklayın.

   

ADOMD

1. C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\'a gidin. Birden fazla klasörünüz varsa, yüksek sayıyı seçin.

2. Sağ tıklayın Microsoft.AnalysisServices.AdomdClient>Özellikleri>Ayrıntıları.

   

El ile güncelleştirme

İstemci kitaplıkları genellikle bunları kullanan araçlar ve istemci uygulamalarıyla birlikte otomatik olarak yüklenir ve güncelleştirilir. Ancak bazı durumlarda istemci kitaplıkları otomatik olarak güncelleştirilmeyebilir ve her birinin el ile güncelleştirilmesi gerekir. El ile güncelleştirmek için, her istemci kitaplığı için Windows Installer (.msi) paketini indirin ve çalıştırın.

İndirmek ve güncelleştirmek için

1. Tıklayın:

   • MSOLAP (amd64) İndirin veya MSOLAP (x86) İndirin
   • AMO'yu İndir
   • ADOMD'yi İndir

2. İndirilenlerklasöründe, kurulumu başlatmak için bir Windows Installer Paketine tıklayın.

3. Kurulum'da Sonrakiöğesine tıklayın.

4. Lisans sözleşmesini okuyun. Kabul ediyorsanız, lisans sözleşmesindeki koşulları kabul ediyorumseçin ve ardından İleri'e tıklayın.

5. Yükle'ye tıklayın.

6. Tamamlandığında Sonbutonuna tıklayın.