使用ADOMD.NET将UDF部署至SSAS的方法咨询（VS2022）

1. 迁移代码到类库项目 #

SSAS仅支持.NET Framework类库部署自定义函数，先把WinForms项目里的UDF代码移到类库：

• 在解决方案里新建一个**.NET Framework类库项目**（框架选4.7.2及以上，和你的SSAS实例兼容）
• 删除类库默认的Class1.cs，把WinForms项目中UDF相关代码（不含UI逻辑）复制过来
• 确保引用Microsoft.AnalysisServices.AdomdServer命名空间，给UDF方法加上[MdxFunction]特性，示例代码：

  using Microsoft.AnalysisServices.AdomdServer;
  
  public class CustomMdxTools
  {
      [MdxFunction(IsDeterministic = true, Description = "按表达式筛选集合的自定义函数")]
      public static Set FilterCollection(Set inputSet, Expression filterExpr)
      {
          // 你的筛选逻辑实现
          return inputSet.Filter(filterExpr);
      }
  }
  

2. 编译生成DLL #

• 右键类库项目，选择生成，在项目的bin\Debug或bin\Release目录找到编译好的DLL文件

3. 部署DLL到SSAS服务器 #

• 找到SSAS实例的自定义程序集目录，默认路径类似：C:\Program Files\Microsoft SQL Server\MSAS16.MSSQLSERVER\OLAP\bin\Custom（MSAS16对应SQL Server 2022，其他版本数字不同）
• 如果没有Custom文件夹就手动创建，把编译好的DLL复制进去

4. 在SSAS中注册UDF #

• 打开SQL Server Management Studio（SSMS），连接到你的SSAS实例
• 右键实例，选择新建查询，切换到MDX查询类型，执行以下XMLA脚本（替换为你的DLL名称和ID）：

  <Alter AllowCreate="true" ObjectExpansion="ExpandFull" xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">
    <ObjectDefinition>
      <Server>
        <Assemblies>
          <Assembly>
            <Name>CustomMdxTools</Name>
            <ID>CustomMdxTools</ID>
            <AssemblyType>ClrAssembly</AssemblyType>
            <Files>
              <File>
                <Name>CustomMdxTools.dll</Name>
                <Type>Main</Type>
              </File>
            </Files>
            <PermissionSet>ExternalAccess</PermissionSet>
          </Assembly>
        </Assemblies>
      </Server>
    </ObjectDefinition>
  </Alter>
  

  （如果DLL有依赖文件，也要复制到Custom目录，并在<Files>节点添加对应条目）

5. 在MDX查询中使用UDF #

注册完成后，就可以在多维数据集的MDX里直接调用自定义函数了，示例：

SELECT [Measures].[销售额] ON 0,
CustomMdxTools.FilterCollection([产品].[产品].成员, [Measures].[销售额] > 1000) ON 1
FROM [你的多维数据集名称]

可选：集成到SSAS项目实现一键部署 #

• 打开你的SSAS多维数据集项目，右键项目 -> 添加 -> 现有项，把类库的DLL添加进来
• 选中添加的DLL，在属性窗口设置生成操作为Content，复制到输出目录为较新则复制
• 编辑项目的部署脚本（Deployment Scripts文件夹下的XMLA文件），把注册UDF的XMLA代码整合进去，后续部署多维数据集时会自动部署UDF

内容的提问来源于stack exchange，提问作者Plaktil