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 guna 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 juga mengharuskan pustaka klien diinstal. Pustaka klien diperbarui setiap bulan.
Penting: Sebelum mendapatkan versi terbaru, pastikan untuk melihat Pertimbangan dan batasan.
Unduh yang terbaru
Pemasang Windows
| Unduh | Versi |
|---|---|
| MSOLAP (amd64) | 16.0.130.20 |
| MSOLAP (x86) | 16.0.130.20 |
| AMO | 19.79.0.0 |
| ADOMD | 19.79.0.0 |
Paket NuGet
Pustaka klien Analysis Services Management Objects (AMO/TOM) dan ADOMD tersedia sebagai paket yang dapat diinstal dari NuGet.org. Disarankan agar Anda bermigrasi ke referensi NuGet alih-alih menggunakan Pemasang Windows.
Mulai Feb. 2021, versi paket .NET Core yang setara dengan paket klien AMO dan ADOMD juga tersedia. Namun, ada beberapa skenario yang tidak didukung oleh versi .NET Core. Untuk mempelajari lebih lanjut, lihat pertimbangan dan batasan nanti di artikel ini.
Rakitan paket NuGet AssemblyVersion mengikuti penerapan versi semantik: MAJOR. KECIL. PATCH. Referensi NuGet memuat versi yang diharapkan meskipun ada versi yang berbeda di GAC (dihasilkan dari penginstalan MSI). PATCH bertahap untuk setiap rilis. Versi AMO dan ADOMD tetap sinkron.
AMO dan ADOMD
| Paket | Versi |
|---|---|
| AMO | 19.79.1 |
| ADOMD | 19.79.1 |
AMO dan ADOMD .Net Core
| Paket | Versi |
|---|---|
| AMO .Net Core | 19.79.1 |
| ADOMD .Net Core | 19.79.1 |
Dimulai dengan 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 ini.
Pratinjau TMDL
Dimulai dengan rilis AMO 19.72.0, fungsionalitas TMDL sekarang disertakan dalam Microsoft.AnalysisServices.Tabular.dll. Jika Anda telah menggunakan paket NuGet Microsoft.AnalysisServices.Tabular.Tmdl , pastikan untuk menghapusnya dari proyek dan kompilasi ulang.
Perubahan berikut dilakukan pada TMDL API yang dapat memengaruhi kode Anda:
- Perubahan nama properti TmdlFormatException. Misalnya, Jalur berubah menjadi Dokumen.
Untuk mempelajari selengkapnya tentang TMDL, lihat Gambaran umum Bahasa Definisi Model Tabular.
Versi minimum yang diperlukan
Protokol Transport Layer Security (TLS) versi 1.0/1.1 tidak digunakan lagi di Microsoft Entra ID 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:
| Pustaka 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.67.0, objek konektivitas seperti Microsoft.AnalysisServices.AdomdClient.AdomdConnection dan Microsoft.AnalysisServices.Server, mendukung properti AccessToken baru yang memungkinkan cara yang ditingkatkan untuk meneruskan token OAuth eksternal untuk digunakan oleh lapisan konektivitas XMLA. Untuk mempelajari selengkapnya, lihat Properti string koneksi - ID Pengguna=...; Kata sandi=.
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 Microsoft Entra ID 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.
Masuk interaktif dengan Microsoft Entra ID 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, maupun 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 didukung Azure Analysis Services dan model semantik Power BI.
AMO
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 (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 putar kembali transaksi Microsoft.AnalysisServices.Server. Dalam versi sebelumnya, panggilan ke Server.RollbackTransaction() mengirimkan 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 sampai dapat sepenuhnya disinkronkan dan perubahan usang dari transaksi yang digulung balik dihapus. InvalidOperationException dimunculkan ketika perubahan dilakukan pada database tabular yang relevan. Jika kode Anda memanggil Server.RollbackTransaction(), disarankan untuk mengikuti panggilan tersebut dengan sinkronisasi penuh [Database.Refresh(true)] untuk database tabular apa pun yang dimodifikasi sebagai bagian dari transaksi.
Dimulai dengan versi 19.77.0, saat mengkloning atau menyalin MetadataObject ke instans lain dari 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 yang dikloning 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 yang dikloning 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.43.20, MSOLAP menggunakan MSAL (Microsoft.Identity.Client) versi 4.43.0 atau yang lebih tinggi alih-alih ADAL untuk mengautentikasi pengguna dengan Microsoft Entra ID 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 Microsoft Entra ID 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 menekan penyedia, bahkan jika pengaturan dijalankan dalam mode perbaikan. Disarankan untuk menghapus instalasi 16.0.4.17 [atau versi bermasalah lainnya] sepenuhnya dan kemudian menginstal versi 16.0.20.201 atau yang lebih baru.
Dalam rilis sebelumnya, MSOLAP diperbarui untuk menyambungkan 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) asli.
Memahami pustaka klien
Analysis Services menggunakan tiga pustaka klien. ADOMD.NET dan Analysis Services Management Objects (AMO) adalah pustaka klien terkelola. Dan Analysis Services Penyedia OLE DB (MSOLAP DLL) adalah pustaka klien asli. Biasanya, ketiganya dipasang pada saat yang sama.
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 OLE DB Analysis Services (MSOLAP) adalah pustaka klien asli untuk Penghubungan 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 OLE DB Analysis Services 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 anda tentukan untuk ADOMD.NET dengan menggunakan Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString juga berfungsi untuk AMO dan Analysis Services OLE DB Provider (MSOLAP). Untuk mempelajari selengkapnya, lihat Properti string koneksi.
Memeriksa 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>DetailProperti>. 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 kananDetailProperti>Microsoft.AnalysisServices>.
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 kananDetailProperti>Microsoft.AnalysisServices.AdomdClient>.
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 Pemasang Windows (.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 menyetujui persyaratan dalam perjanjian lisensi, lalu klik Berikutnya.
Klik, Instal.
Setelah selesai, klik Selesai.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk