萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MS SQL 資料庫

使用 AMO (Analysis Management Objects) 存取 SQL Server SSAS 物件模型

什麼是 AMO?

Analysis Management Objects (AMO) 是 SQL Server Analysis Services (SSAS) 的伺服器端物件模型組件,位於 Microsoft.AnalysisServices.dll。可用於:

  • 建立/修改/刪除 Cube、Dimension、Measure、Partition、Role、DataSource 等。
  • 處理 (Process) 物件、管理權限、讀取中繼資料。
  • 自動化部署、監控、備份還原 SSAS 資料庫。

環境準備

  1. 安裝 SQL Server Shared Management Objects (SMO) 或完整 SQL Server Client Tools。
  2. 專案加入參考:Microsoft.AnalysisServices.dll(通常在 C:\Program Files\Microsoft SQL Server\xxx\SDK\Assemblies\)。
  3. 引入命名空間:using Microsoft.AnalysisServices;

核心 C# 範例:列舉伺服器、資料庫、Cube、角色

using System;
using System.Collections.Generic;
using Microsoft.AnalysisServices;

namespace AMOTest
{
    class Program
    {
        static void Main(string[] args)
        {
            string connStr = "Data Source=ServerName; Provider=MSOLAP;";
            var server = new Server();
            server.Connect(connStr);

            // 1. 列出所有資料庫
            Console.WriteLine("----- Databases -----");
            foreach (Database db in server.Databases)
                Console.WriteLine(db.Name);

            // 2. 取第一個資料庫的 Cubes
            if (server.Databases.Count > 0)
            {
                var db = server.Databases[0];
                Console.WriteLine($"\n----- Cubes in {db.Name} -----");
                foreach (Cube cube in db.Cubes)
                    Console.WriteLine(cube.Name);

                // 3. 資料庫層級角色
                Console.WriteLine($"\n----- Database Roles in {db.Name} -----");
                foreach (Role role in db.Roles)
                    Console.WriteLine($"Role: {role.Name}, Members: {role.Members.Count}");

                // 4. Cube 層級權限 (CubePermission)
                if (db.Cubes.Count > 0)
                {
                    var cube = db.Cubes[0];
                    Console.WriteLine($"\n----- Cube Permissions in {cube.Name} -----");
                    foreach (CubePermission cp in cube.CubePermissions)
                        Console.WriteLine($"Role: {cp.Role.Name}, Members: {cp.Role.Members.Count}, Read: {cp.Read}, Write: {cp.Write}");
                }
            }

            server.Disconnect();
            Console.ReadKey();
        }
    }
}

執行結果範例

AMO 執行輸出

進階應用方向

  • 自動化部署:讀取 JSON/BIML 定義,動態建立/更新 Cube 結構。
  • 處理排程:database.Process(ProcessType.ProcessFull)、partition.Process(ProcessType.ProcessData)。
  • 權限同步:從 AD 群組同步角色成員,role.Members.Add(new RoleMember("DOMAIN\Group"))。
  • 備份/還原:db.Backup("path.abf")、server.Restore("path.abf", "NewDB")。
  • 監控:輪詢 server.Traces、dimension.ProcessingState 等。

注意事項

  • AMO 僅支援多維模式;表格模式請使用 TOM (Tabular Object Model) (Microsoft.AnalysisServices.Tabular)。
  • 連線字串 Provider:多維用 MSOLAP,表格用 MSOLAP.8 (視版本)。
  • 執行身分需具備 SSAS 伺服器管理員或資料庫管理員權限。
copyright © 萬盛學電腦網 all rights reserved