安裝、散發及參考表格式物件模型

發行項
07/05/2024

適用於： SQL Server 2016 和更新版本的 Analysis Services Azure Analysis Services Fabric/Power BI Premium

本文說明如何下載、參考及轉散發表格式物件模型（TOM），這是 C# 連結庫，用於在 Managed 程式代碼中建立和管理表格式模型和資料庫。

TOM 是 AMO 用戶端連結庫的延伸模組（Microsoft.AnalysisServices.dll）。若要使用 TOM，模型和資料庫必須位於相容性層級 1200 或更高版本。

AMO-TOM 元件

AMO 包含新的核心、表格式和 JSON 元件。它也包含自第一個版本以來一直屬於 Analysis Services 的原始 AMO 元件 Microsoft.AnalysisServices.dll。重組的 AMO 會將一般類別卸除至一個元件，並透過其他元件提供表格式和多維度 API 之間的邏輯分割。

下表描述每個元件：

集會	功能性	重要類別
核心 Microsoft.AnalysisServices.Core.dll	表格式和多維度資料庫通用。提供例外狀況處理、伺服器實例和資料庫的泛型連接，以及存取 Server 和 Database 物件的通用屬性和方法。	Core Server 核心資料庫 AmoException
湯姆 Microsoft.AnalysisServices.Tabular.dll版本 13.0.1601.5 或更新版本。	建立和管理表格式元數據物件。	TOM 伺服器 TOM 資料庫型桌子列關係
AMO Microsoft.AnalysisServices.dll	建立和管理多維度元數據物件，包括表格式 1050-1103 資料庫。	AMO 伺服器 AMO 資料庫立方體尺寸 MeasureGroup
Json Microsoft.AnalysisServices.Tabular.Json.dll	包裝 NewtonSoftJson.dll （JSON.NET）以控制更新的協助程式 DLL，可消除在伺服器工作負載中引入 JSON 串行化功能變更的風險。此 DLL 存在於 TOM 中作為相依性，並不適合直接在程式碼中使用。	沒有。

瞭解元件相依性

若要針對 AMO 進行程式設計，您的解決方案必須包含相依 DLL 的參考。 AMO 和 TOM 都相依於 Core，因為它提供基類。

AMO 相依於 TOM，因為 AMO 參考類別中的某些類別來自 TOM。例如，AMO Database 物件具有 Model 類型的屬性 Model，在 TOM dll 中實作。

AMO TOM 相依性

您無法在沒有 Microsoft.AnalysisServices.Tabular.dll的情況下散發 Microsoft.AnalysisServices.dll，但您可以參考其個別的命名空間，而不需要其他命名空間。

選擇要在程式代碼中使用的命名空間

在物件階層中，Database 下方的任何物件都是透過Model物件建構表格式元數據，或透過Cube、Dimension 或 MeasureGroup 物件建構多維度元數據建構。針對伺服器、資料庫、角色或追蹤層級的高階作業，要參考的命名空間選擇將取決於您程式代碼需要支援的工作負載。

如果您的解決方案是相容性層級 1200 或更新版本，請使用 Tabular.Server 或 Tabular.Database，而您所使用的 Database 對象必須提供模型、數據表、數據行和其他以表格式元數據建構表示的物件存取權。
如果下游程式代碼參考 Cube、DataSources、DataSourceViews 和 Dimensions 等多維度物件，請使用 AnalysisServices.Server 或 AnalysisServices.Database。

針對支援混合資料庫和模型類型的工具和應用程式，您需要這兩個命名空間。

在程式代碼中參考 Core 命名空間是不必要的;Core 中的類別是針對主要物件提供通用屬性，例如 Name 和 Description 等通用屬性而建立的基類。

下載並安裝 AMO

移至客戶端連結庫。
使用 Windows Installer 或 NuGet 套件選取並下載 AMO。

新增參考

在 [方案總管] 中，>新增參考>流覽。
移至 C：\Program Files\Microsoft SQL Server\140\SDK\Assemblies，然後選取：
- Microsoft.AnalysisServices.Core
- Microsoft.AnalysisServices.表格式
- Microsoft.AnalysisSerivces.Tabular.Json
按下 [確定] 。在 [方案總管]中，確認元件存在於 [參考] 資料夾中。
在您的代碼頁中，如果資料庫和模型是表格式 1200 或更高的相容性層級，請新增 Microsoft.AnalysisServces.Tabular 命名空間。
```
using Microsoft.AnalysisServices; 
using Microsoft.AnalysisServices.Tabular;
```
在包含具有 Server、Database、Role 和 Trace 物件通用類別的命名空間時，請藉由限定您想要使用的命名空間來避免模棱兩可的參考（例如，Microsoft.AnalysisServices.Tabular.Server 使用表格式命名空間具現化 Server 物件）。

使用您的應用程式轉散發 AMO 和 TOM

AMO 和 TOM 的轉散發是透過 sql_as_amo.msi 安裝套件或 NuGet 套件。如果您要為呼叫 AMO 或 TOM 的用戶端應用程式建置安裝程式，請將 sql_as_amo.msi 新增至可執行檔。

套件是獨立的，並提供在程式碼中呼叫 AMO 和 TOM 所需的所有元件。 TOM 程式設計案例不需要其他套件，例如 SQL_AS_OLEDB.msi 或 SQL_AS_ADOMD.msi。

共用方式為