Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Applies to:
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. Microsoft istemci uygulamaları olan Power BI Desktop, Excel, SQL Server Management Studio (SSMS) ve Visual Studio için Analysis Services projeleri uzantısı, üç istemci kitaplığını yükler ve bunları normal uygulama güncelleştirmeleriyle birlikte otomatik olarak günceller. 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.
En son sürümü indirin
Windows Yükleyicisi
| İndirmek | Sürüm |
|---|---|
| MSOLAP (amd64) | 17.0.69.18 |
| MSOLAP (x86) | 17.0.69.18 |
| AMO | 19.84.1.0 |
| ADOMD | 19.84.1.0 |
Note: Analysis Services Yönetim Nesneleri (AMO/TOM) ve ADOMD için Windows Yükleyicisi indirmeleri artık güncelleştirilmiyor ve 31 Aralık 2024'den sonra kullanılamayacak. Bu Windows Yükleyicisi indirmelerini kullanan uygulamalar NuGet paketlerine geçirilmelidir.
NuGet paketleri
Analysis Services Yönetim Nesneleri (AMO/TOM) ve ADOMD istemci kitaplıkları NuGet.org'dan yüklenebilir paketler olarak kullanılabilir. Windows Yükleyicisi'ni kullanmak yerine NuGet başvuruları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 FX hem de .NET Core .NET 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'tan itibaren .NET Core çalışma zamanı desteği AMO ve ADOMD istemci paketleri için kullanılabilir. Ancak, .NET Core sürümleri tarafından desteklenmeyen birkaç senaryo vardır. Daha fazla bilgi edinmek için bu makalenin devamında
AMO ve ADOMD
| Paket | Sürüm |
|---|---|
| AMO | 19.113.7.0 |
| ADOMD | 19.113.7.0 |
Note:
Yeni çoklu çalışma zamanı paketleri artık paket kimliğinde ".retail.amd64" son ekine sahip değildir; şimdi yalnızca Microsoft.AnalysisServices ve Microsoft.AnalysisServices.AdomdClient olarak adlandırılmaktadır.
Eski .NET Framework ve .NET Core paketleri, eski kimlik altında geriye dönük uyumluluk sağlamak amacıyla, .NET Framework için ".retail.amd64" soneki ve .NET Core için ".NetCore.retail.amd64" soneki ile nuget.org'da hâlâ mevcuttur.
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ımdan kaldırı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.
Riskleri ve olası güvenlik açıklarını en aza indirmek amacıyla, 30 Haziran 2021 tarihinden itibaren Azure Analysis Services ve Power BI için gelişmiş güvenlik önlemleri, aşağıda belirtilen 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 örnekte 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 itibaren, Microsoft.AnalysisServices.AdomdClient.AdomdConnection ve Microsoft.AnalysisServices.Server gibi bağlantı nesneleri, XMLA bağlantı katmanı tarafından kullanılacak dış OAuth belirteçlerinin geçirilmesi için geliştirilen yeni bir AccessToken özelliğini desteklemektedir. 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, kullanıcıları Microsoft Entra ID ile kimlik doğrulaması yaparken ADAL yerine MSAL (Microsoft.Identity.Client) sürüm 4.43.0 veya üzeri kullanır. Bu, Power-BI ve Azure Analysis Services gibi bulut tabanlı hizmetlere bağlantı kurulması sırasında gerçekleşir. 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 arasında Azure Analysis Services, Power BI Premium ve SQL Server Analysis Services bağlantıları bulunur. 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ı gereklidir.
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 için (hem yayımlanmış dizinde hem de tek dosya modunda) önizleme desteği ekledi. Ö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 sürüm 19.12.7.2, SQL Server Analysis Services desteği ekledi. Düşük önizleme sürümleri yalnızca Azure Analysis Services ve Power BI semantik modelleri destekler.
AMO
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.DataType adlı yeni bir numaralandırma tanıtır. Ancak, önceki numaralandırma olan Microsoft. AnalysisServices.Tabular.DataType hala var. Kodunuz önceki numaralandırmaya DataType olarak başvuruyorsa, her iki ad alanına da deyimleri olan bir kod dosyasında (Microsoft. AnalysisServices, Microsoft. AnalysisServices.Tabular), 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.Server'ın işlem geri alma davranışında bir değişiklik getiriyor. Ö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
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) 19.61.1.4 sürümünden 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, aşağıdaki bağlantı dizesi örnekte olduğu gibi 16.0.139.27 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.
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 başlayarak MSOLAP, Windows 10 ve üzeri sürümlerde ve Windows Server 2019 ve üzeri sürümlerde kullanılabilen Web Hesabı Yöneticisi(WAM) kullanan 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:
- Belirteç önbellekleme etkinse ve önbellekte uygun bir belirteç varsa, MSOLAP önbellekteki belirteci kullanır.
- Uygun bir önbelleğe alınmış belirteç kullanılamıyorsa, MSOLAP WAM aracılığıyla gizlice bir erişim belirteci elde etmeye çalışır.
- 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='').
MSOLAP, 16.0.43.20 sürümünden başlayarak Microsoft.Identity.Client sürüm 4.43.0 veya üzerini ADAL yerine kullanarak Power-BI ve Azure Analysis Services gibi bulut tabanlı hizmetlere bağlantı kurarken kullanıcıların kimliğini Microsoft Entra ID ile doğrular. 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
Microsoft Entra ID kullanan bulut tabanlı sistemlere bağlantılarla ilgili bir regresyon OLEDB'nin (MSOLAP) 16.0.4.17 sürümünde 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 Authentication Library (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.
Microsoft istemci uygulamaları olan Power BI Desktop ve Excel, her üç istemci kitaplığını da yükler ve yeni sürümler mevcut olduğunda günceller. 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.<version>.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 hemen hemen her bağlantı dizesi, 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)
C:\Program Files\Microsoft Analysis Services\AS OLEDB\şuraya git. Birden fazla klasörünüz varsa, yüksek sayıyı seçin.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
C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\gidin. Birden fazla klasörünüz varsa, yüksek sayıyı seçin.Microsoft.AnalysisServices>Özellikler>Ayrıntılar öğesine sağ tıklayın.
ADOMD
C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\gidin. Birden fazla klasörünüz varsa, yüksek sayıyı seçin.Microsoft.AnalysisServices.AdomdClient>Properties>Details öğesine sağ tıklayın.
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 Yükleyicisi (.msi) paketini indirin ve çalıştırın.
İndirmek ve güncelleştirmek için
Tıklayın:
Downloads içinde, Kurulumu çalıştırmak için bir Windows Yükleyici Paketi'ne tıklayın.
Kurulum'da Sonrakiöğesine tıklayın.
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.
Yükle'ye tıklayın.
Tamamlandığında Sonbutonuna tıklayın.