C#通过AMO对象模型浏览SQL SERVER 2005 SSAS角色一例

时间:2022-04-15 03:17:43

用过SSAS的朋友都使用Visual Studio Business Intelligence Development Studio(BIDS)去创建以及管理所创建的Cube。但是如果只是想查看Cube下的某个角色包含的用户以及权限,我们只能一遍遍的打开BIDS,忍受它的慢动作。更有甚者,如果要比较两个Cube下所有角色及用户是否一致,手工操作更是会让人头大。现在,利用Microsoft提供的AMO对象模型,我们可以很轻松的对Cube进行编程访问,根据自身工作的需求,实在一些有用的工具,以提高工作效率,避免无聊的手工重复劳动。 

Analysis Management Objects (AMO) SQL Server SSAS的对象模型库,通过它可以方便的对SSAS里的对象进行访问及控制,包括Cube, DataSource, DataSourceView, Partition, Measure, Dimension, Assembly, Role以及Data Mining对象等。要使用它,必须在机器上找到SSAS的安装路径..\Microsoft SQL Server\90\SDK\Assemblies,把目录中的Microsoft.AnalysisServices.Dll文件加载到项目的Reference列表中,AMO对象就是通过这个Dll文件进行访问的。

  需要说明的一点是,
AMO对象不能用来获取Cube中的数据,如果想要进行数据查询,则需要使用ADOMD.Net (Microsoft.AnalysisServices.AdomdClient).

下面,我们就简要介绍一下如何利用AMO对象来访问Cube。在把Microsoft.AnalysisServices.Dll加载到项目的引用以后,在代码中我们需要引入命名空间:

using Microsoft.AnalysisServices


在此命名空间下,我们首先引入
SSASServer对象,并建立连接: 

String connectstring = “Data Source = ServerName;Provider=msolap”;
Server ssasServer 
= New Server();
ssasServere.Connect(connectstring);

与SSAS的服务器实例建立连接以后,我们要取得它的所有Database对象名称:

C#通过AMO对象模型浏览SQL SERVER 2005 SSAS角色一例static public List<string> GetDatabaseCollection()
    {
        List
<string> collect = new List<string>();
        
foreach (Database db in server.Databases)
        {
            collect.Add(db.Name);
        }
        
return collect;         
}
C#通过AMO对象模型浏览SQL SERVER 2005 SSAS角色一例

 

请注意,AMO中的Database对象并不是一般意义上的数据库,而是一个容器,可以简单的理解为我们的一个Business Intelligence项目就是一个Database容器,在Database对象内容,包括了BI项目中的所有内容 (Cube, dimension, data mining structure, data source, account, role) 。

接下来,根据所选择的Database来获得它的Cube对象,因为在一个Database(一个BI项目中),我们可以建立多个Cube,所以在此先取得所有Cube的列表:

C#通过AMO对象模型浏览SQL SERVER 2005 SSAS角色一例    static public List<string> GetCubeCollection(string databasename)
    {
        List
<string> collect = new List<string>();
        database 
= server.Databases[databasename];
        
foreach (Cube cube in database.Cubes)
        {
            collect.Add(cube.Name);
        }
        
return collect;
}
C#通过AMO对象模型浏览SQL SERVER 2005 SSAS角色一例

Cube对象中,我们可以取得CubePermission对象,角色Role就在CubePermission中,从这里就可以获得指定Cube下所有的角色名称列表:

C#通过AMO对象模型浏览SQL SERVER 2005 SSAS角色一例static public List<string> GetCubePermission(string cubename)
    {
        List
<string> collect = new List<string>();
        cube 
= database.Cubes[cubename];
        
foreach (CubePermission cp in cube.CubePermissions)
        {
            collect.Add(cp.Role.Name);
        }
        
return collect;
    }
C#通过AMO对象模型浏览SQL SERVER 2005 SSAS角色一例

 到这里,我们其实就满足了基本需求,可以很轻松地得到Cube下的角色列表,但是不同角色针对DimensionAttribute其实是拥有不同的访问权限。

C#通过AMO对象模型浏览SQL SERVER 2005 SSAS角色一例foreach (CubeDimensionPermission dp in cp.DimensionPermissions)
{
  
foreach (AttributePermission ap in dp.AttributePermissions)
   {
    Label1.Text 
= ap.AllowedSet;
    Label2.Text 
= ap.DeniedSet;
    }
}
C#通过AMO对象模型浏览SQL SERVER 2005 SSAS角色一例

利用CubeDimensionPermission下的AttributePermission对象,我们可以得到当前角色的允许和拒绝的维度属性值,得到了这个值,我们可以直接编程来检查两个Cube中的角色是否一致。

上面只是简单介绍了利用AMO对象进行SSAS服务器对象管理的一个例子,其实大家可以尽情发挥,利用AMO对象实现一些实用的工具来帮忙日常工作中对于SSAS的便捷管理。

附:AMO对象树
C#通过AMO对象模型浏览SQL SERVER 2005 SSAS角色一例