Bagikan melalui

Menginstal, mendistribusikan, dan mereferensikan Model Objek Tabular

  • Artikel

Berlaku untuk: SQL Server 2016 dan yang lebih baru Analysis Services Azure Analysis Services Fabric/Power BI Premium

Artikel ini menjelaskan cara mengunduh, mereferensikan, dan mendistribusikan ulang Model Objek Tabular (TOM), pustaka C# untuk membuat dan mengelola model tabular dan database dalam kode terkelola.

TOM adalah ekstensi dari pustaka klien AMO (Microsoft.AnalysisServices.dll). Untuk menggunakan TOM, model dan database harus berada pada tingkat kompatibilitas 1200 atau lebih tinggi.

Rakitan AMO-TOM

AMO mencakup rakitan Core, Tabular, dan JSON baru. Ini juga termasuk assembly AMO asli, Microsoft.AnalysisServices.dll, yang telah menjadi bagian dari Analysis Services sejak rilis pertamanya. AMO yang direstrukturisasi membongkar kelas umum ke satu perakitan, dan menyediakan pembagian logis antara API tabular dan multidimensi melalui rakitan tambahan.

Tabel berikut ini menjelaskan setiap rakitan:

Rakitan Fungsionalitas Kelas penting
Core
Microsoft.AnalysisServices.Core.dll		 Umum untuk database tabular dan multidmensional.

Menyediakan penanganan pengecualian, koneksi generik ke instans server dan database, dan akses ke properti dan metode umum untuk objek Server dan Database.		 Server Inti
Database Inti
AmoException
TOM
Microsoft.AnalysisServices.Tabular.dll, versi 13.0.1601.5 atau yang lebih baru.		 Membuat dan mengelola objek metadata tabular. TOM Server
TOM Database
Model
Tabel
Kolom
Hubungan
AMO
Microsoft.AnalysisServices.dll		 Membuat dan mengelola objek metadata multidmensional, termasuk database tabular 1050-1103. AMO Server
AMO Database
Kubus
Dimensi
MeasureGroup
Json
Microsoft.AnalysisServices.Tabular.Json.dll		 DLL pembantu yang membungkus NewtonSoftJson.dll (JSON.NET) untuk mengontrol pembaruan, menghapus risiko memperkenalkan perubahan fungsional pada serialisasi JSON dalam beban kerja server.

DLL ini ada sebagai dependensi dalam TOM dan tidak dimaksudkan untuk digunakan langsung dalam kode Anda.		 Tidak ada.

Memahami dependensi perakitan

Untuk memprogram terhadap AMO, solusi Anda harus menyertakan referensi ke DLL dependen. Baik AMO maupun TOM bergantung pada Core karena menyediakan kelas dasar.

AMO bergantung pada TOM karena beberapa kelas di kelas referensi AMO dari TOM. Misalnya, objek Database AMO memiliki Model properti jenis Model, yang diimplementasikan di dll TOM.

Dependensi AMO TOM

Anda tidak dapat mendistribusikan Microsoft.AnalysisServices.dll tanpa Microsoft.AnalysisServices.Tabular.dll, tetapi Anda dapat mereferensikan namespace masing-masing tanpa yang lain.

Memilih namespace layanan mana yang akan digunakan dalam kode

Dalam hierarki objek, objek apa pun di bawah Database adalah konstruksi metadata tabular melalui objek Model, atau konstruksi metadata multidaya melalui objek Kubus, Dimensi, atau MeasureGroup. Untuk operasi tingkat tinggi di tingkat Server, Database, Peran, atau Pelacakan, pilihan namespace layanan mana yang akan dirujuk akan bergantung pada beban kerja yang perlu didukung kode Anda.

  • Gunakan Tabular.Server atau Tabular.Database jika solusi Anda adalah tingkat kompatibilitas 1200 atau lebih tinggi, dan objek Database yang Anda kerjakan harus menyediakan akses ke Model, Tabel, Kolom, dan objek lain yang dinyatakan sebagai konstruksi metadata Tabular.
  • Gunakan AnalysisServices.Server atau AnalysisServices.Database jika kode hilir mereferensikan objek Multidmensional seperti Kubus, DataSources, DataSourceViews, dan Dimensions.

Anda akan memerlukan namespace layanan untuk alat dan aplikasi yang mendukung campuran database dan jenis model.

Mereferensikan namespace layanan Inti dalam kode Anda tidak perlu; kelas di Core adalah kelas dasar yang dibuat untuk tujuan menyediakan properti umum, seperti Nama dan Deskripsi, untuk objek utama.

Mengunduh dan menginstal AMO

  1. Buka Pustaka klien.

  2. Pilih dan unduh AMO dengan menggunakan paket Windows Installer atau NuGet.

Menambahkan referensi

  1. Di Penjelajah Solusi>Tambahkan Penelusuran Referensi>.

  2. Buka C:\Program Files\Microsoft SQL Server\140\SDK\Assembly dan pilih:

    • Microsoft.AnalysisServices.Core
    • Microsoft.AnalysisServices.Tabular
    • Microsoft.AnalysisSerivces.Tabular.Json

  3. Klik OK. Di Penjelajah Solusi, konfirmasikan rakitan ada di folder Referensi.

  4. Di halaman kode Anda, tambahkan namespace Microsoft.AnalysisServces.Tabular jika database dan model adalah Tingkat kompatibilitas Tabular 1200 atau lebih tinggi.

    using Microsoft.AnalysisServices; 
using Microsoft.AnalysisServices.Tabular;

    Saat menyertakan namespace yang memiliki kelas yang sama untuk objek Server, Database, Peran, dan Pelacakan, hindari referensi ambigu dengan memenuhi syarat namespace layanan mana yang ingin Anda gunakan (misalnya, Microsoft.AnalysisServices.Tabular.Server membuat instans objek Server menggunakan namespace tabular).

Mendistribusikan ulang AMO dan TOM dengan aplikasi Anda

Redistribusi AMO dan TOM adalah melalui paket penginstalan sql_as_amo.msi atau paket NuGet. Jika Anda membangun program penyiapan untuk aplikasi klien yang memanggil AMO atau TOM, tambahkan sql_as_amo.msi ke executable Anda.

Paket ini mandiri dan menyediakan semua rakitan yang diperlukan untuk memanggil AMO dan TOM dalam kode Anda. Paket lain, seperti SQL_AS_OLEDB.msi atau SQL_AS_ADOMD.msi, tidak secara khusus diperlukan untuk skenario pemrograman TOM.