Pustaka klien Analysis Services
Berlaku untuk:
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
Pustaka klien diperlukan untuk aplikasi dan alat klien untuk terhubung ke Analysis Services. Aplikasi klien Microsoft seperti Power BI Desktop, Excel, SQL Server Management Studio (SSMS), dan ekstensi proyek Analysis Services untuk Visual Studio menginstal ketiga pustaka klien dan memperbaruinya bersama dengan pembaruan aplikasi reguler. Aplikasi klien kustom untuk Analysis Services mungkin juga memerlukan satu atau beberapa pustaka klien ini untuk diinstal. Versi baru pustaka klien diperbarui sekitar bulanan.
Penting: Sebelum mendapatkan versi terbaru, pastikan untuk melihat Pertimbangan dan batasan .
Unduh yang terbaru
Penginstal Windows
| Mengunduh | Versi |
|---|---|
| |
16.0.156.17 |
| |
16.0.156.17 |
| AMO |
19.84.1.0 |
| |
19.84.1.0 |
Catatan: Unduhan Penginstal Windows untuk Analysis Services Management Objects (AMO/TOM) dan ADOMD tidak lagi diperbarui dan tidak akan tersedia setelah 31 Desember 2024. Aplikasi yang mengandalkan unduhan Penginstal Windows ini harus dimigrasikan ke paket NuGet.
Paket NuGet
Pustaka klien Analysis Services Management Objects (AMO/TOM) dan ADOMD tersedia sebagai paket yang dapat diinstal dari NuGet.org. Sangat disarankan agar Anda bermigrasi ke referensi NuGet alih-alih menggunakan Penginstal Windows.
Rakitan paket NuGet AssemblyVersion mengikuti penerapan versi semantik: MAJOR. KECIL. PATCH. Referensi NuGet memuat versi yang diharapkan bahkan jika ada versi yang berbeda di GAC (dihasilkan dari penginstalan MSI). PATCH bertahap untuk setiap rilis. Versi AMO dan ADOMD tetap sinkron.
Mulai Juli 2024, paket AMO dan ADOMD berisi rilis multi-runtime untuk semua runtime target yang didukung, baik .NET FX maupun .NET Core; rilis sebelumnya dari paket yang hanya menargetkan satu runtime, baik .NET FX atau .NET Core, tersedia untuk kompatibilitas mundur, tetapi tidak lagi diperbarui.
Mulai September 2022, AMO (AMO/TOM) dan ADOMD .Net Core (versi 19.48.0.0), komunikasi berbasis HTTP dengan layanan cloud seperti Power BI dan Azure Analysis Services ditingkatkan secara signifikan. Disarankan agar Anda memperbarui ke versi terbaru untuk memanfaatkan peningkatan performa.
Mulai Feb. 2021, dukungan runtime .NET Core tersedia untuk paket klien AMO dan ADOMD. Namun, ada beberapa skenario yang tidak didukung oleh versi .NET Core. Untuk mempelajari selengkapnya, lihat pertimbangan dan batasan nanti di artikel ini.
AMO dan ADOMD
| Paket | Versi |
|---|---|
| AMO |
19.86.2.1 |
| |
19.86.2.1 |
Catatan:
Paket multi-runtime baru tidak lagi memiliki akhiran ".retail.amd64" dalam identitas paket dan sekarang hanya disebut Microsoft.AnalysisServices dan Microsoft.AnalysisServices.AdomdClient.
Paket .NET Framework dan .NET Core yang lebih lama masih tersedia di nuget.org untuk kompatibilitas mundur di bawah identitas lama dengan akhiran ".retail.amd64" untuk .NET Framework, dan ". Akhiran NetCore.retail.amd64" untuk .NET Core.
Versi minimum yang diperlukan
Protokol Keamanan Lapisan Transportasi (TLS) versi 1.0/1.1 tidak digunakan lagi di ID Microsoft Entra pada 30 Juni 2021. TLS 1.2 atau yang lebih tinggi sekarang diperlukan. TLS 1.2 tidak didukung di versi pustaka klien Analysis Services sebelumnya. Versi pustaka klien yang lebih baru mencakup dukungan untuk TLS 1.2 dan yang lebih tinggi selain peningkatan keamanan penting lainnya.
Untuk meminimalkan risiko dan potensi kerentanan keamanan, mulai 30 Juni 2021, keamanan yang ditingkatkan di Azure Analysis Services dan Power BI memerlukan versi berikut atau lebih tinggi:
| Lib klien | Versi file | Versi |
|---|---|---|
| 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 |
Pertimbangan dan batasan
AMO dan ADOMD
Dimulai dengan versi 19.84.6, dukungan untuk .NET FX 4.5 dan .NET Core 3.0 di rakitan terkelola tidak lagi tersedia. Rakitan sisi klien AS sekarang dirilis dengan dukungan untuk .NET FX 4.7.2, serta .NET 6.0 dan .NET 8.0 saja.
Dimulai dengan versi 19.82.0.0, AMO dan ADOMD mendukung Profil Perwakilan Layanan untuk autentikasi, seperti dalam contoh string koneksi berikut. Untuk mempelajari selengkapnya, lihat Menggunakan profil perwakilan layanan untuk mengelola data pelanggan di aplikasi multipenyewa.
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>
Dimulai dengan versi 19.67.0, objek konektivitas seperti Microsoft.AnalysisServices.AdomdClient.AdomdConnection dan Microsoft.AnalysisServices.Server, mendukung properti
Dimulai dengan versi 19.42.0.4, ADOMD.NET dan AMO/TOM menggunakan MSAL (Microsoft.Identity.Client) versi 4.43.0 atau yang lebih tinggi alih-alih ADAL untuk mengautentikasi pengguna dengan ID Microsoft Entra saat membuat koneksi ke layanan berbasis cloud seperti Power-BI dan Azure Analysis Services. Jika aplikasi Anda atau komponen lain yang bergantung pada aplikasi menggunakan MSAL, mungkin perlu untuk memperbarui pengaturan pengalihan pengikatan aplikasi jika ada konflik antara versi MSAL yang dimuat oleh komponen.
AMO dan ADOMD .Net Core
Skenario yang didukung termasuk koneksi ke Azure Analysis Services, Power BI Premium, dan SQL Server Analysis Services. Konektivitas berbasis TCP hanya didukung untuk komputer Windows.
Login interaktif dengan ID Microsoft Entra hanya didukung untuk komputer Windows. Runtime .NET Core Desktop diperlukan.
Dependensi dalam MSAL memerlukan versi 4.43.0 atau yang lebih tinggi.
Pustaka klien .Net Core versi 19.14.0 memperkenalkan dukungan pratinjau untuk penerbitan Self-Contained (baik dalam direktori yang diterbitkan, dan dalam mode file tunggal), selain dukungan untuk konsumsi oleh proyek .NET 5.0. Beberapa masalah yang terkait dengan konektivitas ke SQL Server Analysis Services yang diidentifikasi dalam rilis sebelumnya telah diperbaiki.
Versi 19.12.7.2 dari pustaka klien .Net Core memperkenalkan dukungan untuk SQL Server Analysis Services. Versi pratinjau yang lebih rendah hanya mendukung model semantik Azure Analysis Services dan Power BI.
AMO
Dimulai dengan versi 19.84.6, dukungan untuk TMDL di AMO\TOM dianggap sebagai dalam status General-Availability, dan tidak akan ada perubahan yang melanggar di permukaan API.
Pustaka klien AMO versi 19.12.3.0 memperkenalkan enumerasi baru, Microsoft.AnalysisServices.DataType. Namun, enumerasi sebelumnya, Microsoft.AnalysisServices.Tabular.DataType masih ada. Jika kode Anda mereferensikan enumerasi sebelumnya sebagai DataType dalam file kode dengan pernyataan ke kedua namespace layanan (Microsoft.AnalysisServices, Microsoft.AnalysisServices.Tabular), karena ambiguitas, Anda bisa mendapatkan kesalahan saat mengkompilasi. Untuk mengatasi kesalahan, sepenuhnya memenuhi syarat referensi ke enumerasi.
Pustaka klien AMO versi 19.61.1.4 memperkenalkan perubahan perilaku pembatalan transaksi Microsoft.AnalysisServices.Server. Dalam versi sebelumnya, panggilan ke Server.RollbackTransaction() mengirim permintaan ke mesin untuk mengembalikan transaksi dan kemudian mencoba mengembalikan perubahan lokal. Tidak seperti versi sebelumnya, di 19.61.1.4 dan yang lebih baru, jika perubahan lokal tidak dapat digulung balik dengan aman, database tabular yang disertakan dalam blok transaksi setiap perubahan tambahan hingga dapat sepenuhnya disinkronkan dan perubahan usang dari transaksi yang digulung balik dihapus.
Dimulai dengan versi 19.77.0, saat mengkloning atau menyalin MetadataObject ke instans lain metadataObject dengan menggunakan Model Objek Tabular (TOM), TOM mengembalikan null untuk properti yang merujuk silang objek di luar pohon langsung objek anak MetadataObject. Anda harus menambahkan instans MetadataObject kloning ke model semantik sehingga referensi silang ke objek di luar pohon MetadataObject dapat diselesaikan.
Misalnya, saat mengkloning tabel dengan partisi yang mereferensikan ekspresi bernama dalam EntityPartitionSource, properti ExpressionSource dari EntityPartitionSource mengembalikan null hingga tabel kloning ditambahkan ke model semantik seperti dalam cuplikan kode di bawah ini sehingga referensi ExpressionSource kloning dapat diselesaikan. Klon harus ditambahkan ke model karena ekspresi bernama yang direferensikan silang adalah anggota koleksi Ekspresi model dan bukan bagian dari pohon tabel objek anak.
Table tableClone = model.Tables[0].Clone();
anotherModel.Tables.Add(tableClone);
ADOMD
Dimulai dengan ADOMD (baik .NET Framework, dan .NET Core) versi 19.61.1.4, kompresi sepenuhnya tersedia di lapisan transportasi XMLA. Rilis sebelumnya setelah versi 19.55.3.1 menerapkan beberapa dukungan parsial untuk kompresi. Laporan tentang masalah dengan rilis tersebut diterima. Masalah tersebut diperbaiki sebagai bagian dari rilis 16.61.1.4. Pastikan untuk meningkatkan ke 19.61.1.4 atau yang lebih baru jika Anda mengalami masalah yang terkait dengan pemadatan.
MSOLAP
Dimulai dengan versi 16.0.139.27, MSOLAP mendukung Profil Perwakilan Layanan untuk autentikasi, seperti dalam contoh string koneksi berikut. Untuk mempelajari selengkapnya, lihat Menggunakan profil perwakilan layanan untuk mengelola data pelanggan di aplikasi multipenyewa.
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>
Dimulai dengan versi 16.0.134.22, MSOLAP mendukung single Sign-On senyap (SSO) menggunakan Web Account Manager (WAM), tersedia pada Windows 10 dan yang lebih tinggi serta Window Server 2019 dan yang lebih tinggi. Ketika koneksi HTTP baru dibuka, MSOLAP mendapatkan token akses sebagai berikut:
- Jika penembolokan token diaktifkan dan token yang sesuai tersedia di cache, MSOLAP menggunakan token cache.
- Jika token cache yang sesuai tidak tersedia, MSOLAP mencoba mendapatkan token akses secara diam-diam melalui WAM.
- Jika SSO menggunakan WAM gagal, MSOLAP kembali ke autentikasi interaktif dan pop-up jendela masuk.
Pengguna dapat melewati alur SSO senyap dan segera meluncurkan pengalaman autentikasi interaktif dengan memberikan id pengguna 'kosong' dalam string koneksi (ID Pengguna='').
Dimulai dengan versi 16.0.43.20, MSOLAP menggunakan MSAL (Microsoft.Identity.Client) versi 4.43.0 atau yang lebih tinggi alih-alih ADAL untuk mengautentikasi pengguna dengan ID Microsoft Entra saat membuat koneksi ke layanan berbasis cloud seperti Power-BI dan Azure Analysis Services. Jika aplikasi Anda atau komponen lain yang bergantung pada aplikasi menggunakan MSAL, mungkin perlu untuk memperbarui pengaturan pengalihan pengikatan aplikasi jika ada konflik antara versi MSAL yang dimuat oleh komponen
Regresi yang terkait dengan koneksi ke sistem berbasis cloud menggunakan ID Microsoft Entra ditemukan dalam OLEDB (MSOLAP) versi 16.0.4.17. Ini diperbaiki dalam versi 16.0.20.201. Karena sifat masalah, versi 16.0.4.17 yang diinstal, serta versi lain sebelum 16.0.20.201, tidak dapat diperbaiki dengan menurunkan penyedia, bahkan jika pengaturan dijalankan dalam mode perbaikan. Disarankan untuk menghapus instalasi 16.0.4.17 [atau versi bermasalah lainnya] dan kemudian menginstal versi 16.0.20.201 atau yang lebih baru.
Dalam rilis sebelumnya, MSOLAP diperbarui untuk terhubung ke Analysis Services berbasis cloud menggunakan Microsoft Authentication Library (MSAL) terkelola. Dimulai dengan versi 16.0.87.16, penyiapan MSOLAP tidak lagi menginstal komponen Asli Azure Active Directory Authentication Library (ADAL).
Memahami pustaka klien
Analysis Services menggunakan tiga pustaka klien. ADOMD.NET dan Analysis Services Management Objects (AMO) adalah pustaka klien terkelola. Dan Analysis Services OLE DB Provider (MSOLAP DLL) adalah pustaka klien asli. Biasanya, ketiganya diinstal secara bersamaan.
Aplikasi klien Microsoft seperti Power BI Desktop dan Excel menginstal ketiga pustaka klien dan memperbaruinya saat versi baru tersedia. Bergantung pada versi atau frekuensi pembaruan, beberapa pustaka klien mungkin bukan versi terbaru yang diperlukan oleh Azure Analysis Services dan Power BI. Hal yang sama berlaku untuk aplikasi kustom atau antarmuka lain seperti AsCmd, TOM, ADOMD.NET. Aplikasi ini memerlukan penginstalan pustaka secara manual atau terprogram. Pustaka klien untuk penginstalan manual disertakan dalam paket fitur SQL Server sebagai paket yang dapat didistribusikan. Namun, pustaka klien ini terkait dengan versi SQL Server dan mungkin bukan yang terbaru. Pastikan Anda selalu menginstal yang terbaru, dapat diunduh dari artikel ini.
Jenis pustaka klien
Penyedia OLE DB Analysis Services (MSOLAP)
Penyedia Analysis Services OLE DB (MSOLAP) adalah pustaka klien asli untuk koneksi database Analysis Services. Ini digunakan secara tidak langsung oleh ADOMD.NET dan AMO, mendelegasikan permintaan koneksi ke penyedia data. Anda juga dapat memanggil Penyedia OLE DB langsung dari kode aplikasi.
Penyedia Analysis Services OLE DB diinstal secara otomatis oleh sebagian besar alat dan aplikasi klien yang digunakan untuk mengakses database Analysis Services. Ini harus diinstal pada komputer yang digunakan untuk mengakses data Analysis Services.
Penyedia OLE DB sering ditentukan dalam string koneksi. String koneksi Analysis Services menggunakan nomenklatur yang berbeda untuk merujuk ke Penyedia OLE DB: MSOLAP.<versi>.dll.
AMO
AMO adalah pustaka klien terkelola yang digunakan untuk administrasi server dan definisi data. Ini diinstal dan digunakan oleh alat dan aplikasi klien. Misalnya, SQL Server Management Studio (SSMS) menggunakan AMO untuk menyambungkan ke Analysis Services. Koneksi menggunakan AMO biasanya minimal, terdiri dari "data source=\<servername>". Setelah koneksi dibuat, Anda menggunakan API untuk bekerja dengan koleksi database dan objek utama. Visual Studio dan SSMS menggunakan AMO untuk menyambungkan ke instans Analysis Services.
ADOMD
ADOMD.NET adalah pustaka klien data terkelola yang digunakan untuk mengkueri data Analysis Services. Ini diinstal dan digunakan oleh alat dan aplikasi klien.
Saat menyambungkan ke database, properti string koneksi untuk ketiga pustaka serupa. Hampir semua string koneksi yang Anda tentukan untuk ADOMD.NET dengan menggunakan Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString juga berfungsi untuk AMO dan Penyedia OLE DB Analysis Services (MSOLAP). Untuk mempelajari selengkapnya, lihat properti string Koneksi .
Periksa versi yang terinstal
OLEDDB (MSOLAP)
Buka
C:\Program Files\Microsoft Analysis Services\AS OLEDB\. Jika Anda memiliki lebih dari satu folder, pilih angka yang lebih tinggi.Klik kanan msolap.dll>Properti>Detail. Periksa properti Versi produk
. Catatan: Jika nama file msolap140.dll, nama file lebih lama dari versi terbaru dan harus ditingkatkan. 
AMO
Buka
C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\. Jika Anda memiliki lebih dari satu folder, pilih angka yang lebih tinggi.Klik kanan Properti>Microsoft.AnalysisServices>Detail.
ADOMD
Buka
C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\. Jika Anda memiliki lebih dari satu folder, pilih angka yang lebih tinggi.Klik kanan
Properti Microsoft.AnalysisServices.AdomdClient Detail .
Memperbarui secara manual
Pustaka klien biasanya diinstal dan diperbarui secara otomatis bersama dengan alat dan aplikasi klien yang menggunakannya. Namun, dalam beberapa kasus pustaka klien mungkin tidak diperbarui secara otomatis dan masing-masing harus diperbarui secara manual. Untuk memperbarui secara manual, unduh dan jalankan paket Windows Installer (.msi) untuk setiap pustaka klien.
Untuk mengunduh dan memperbarui
Klik:
Di Unduhan, klik Paket Penginstal Windows untuk menjalankan Penyetelan.
Di Penyetelan, klik Berikutnya.
Baca perjanjian lisensi. Jika Anda setuju, pilih Saya menerima persyaratan dalam perjanjian lisensi, lalu klik Berikutnya.
Klik, Instal.
Setelah selesai, klik Selesai.