连接字符串属性(分析服务)

本主题文档记录了您可以在设计器或管理工具中设置的连接字符串属性,或者在连接并查询 Analysis Services 数据的客户端应用程序生成的连接字符串中看到的属性。 因此,它只涵盖可用属性的子集。 完整列表包括许多服务器和数据库属性,使你可以自定义特定应用程序的连接,而与在服务器上配置实例或数据库的方式无关。

在应用程序代码中生成自定义连接字符串的开发人员应查看 ADOMD.NET 客户端的 API 文档,以查看更详细的列表: ConnectionString

本主题中所述的属性由 Analysis Services 客户端库、ADOMD.NET、AMO 和用于 Analysis Services 的 OLE DB 提供程序使用。 大多数连接字符串属性都可用于所有三个客户端库。 在说明中将会提到异常。

本主题包含下列部分:

常用连接参数

身份验证和安全性

特殊用途参数

预留供以后使用

示例连接字符串

Analysis Services 中使用的连接字符串格式

加密连接字符串

注释

设置属性时,如果无意中设置同一属性两次,则使用连接字符串中的最后一个属性。

有关如何在现有Microsoft应用程序中指定 Analysis Services 连接的详细信息,请参阅 从客户端应用程序(Analysis Services)进行连接

常用连接参数

下表描述了生成连接字符串时最常使用的属性。

资产 DESCRIPTION 示例:
Data SourceDataSource 指定服务器实例。 所有连接都需要此属性。 有效值包括服务器的网络名称或 IP 地址、localhost 或本地连接、如果服务器为 HTTP 或 HTTPS 访问配置的 URL 或本地多维数据集 (.cub) 文件的名称。 Data source=AW-SRV01 用于默认实例和端口(TCP 2383)。

Data source=AW-SRV01$Finance:8081 用于命名实例($Finance)和固定端口。

Data source=AW-SRV01.corp.Adventure-Works.com (假设默认实例和端口)的完全限定域名。

Data source=172.16.254.1 用于服务器 IP 地址,跳过 DNS 服务器解析,有助于排查连接问题。
Initial CatalogCatalog 指定要连接到的 Analysis Services 数据库的名称。 数据库必须部署在 Analysis Services 上,并且必须具有连接到该数据库的权限。 此属性对于 AMO 连接是可选的,但 ADOMD.NET 是必需的。 Initial catalog=AdventureWorks2012
Provider 有效值包括 MSOLAP 或 MSOLAP。<版本>,其中 <版本> 为 3、4 或 5。 在文件系统上,数据提供程序名称为 SQL Server 2012 版本的 msolap110.dll,SQL Server 2008 和 2008 R2 版本的 msolap100.dll,以及 SQL Server 2005 版本的 msolap90.dll。

当前版本为 MSOLAP.5。 此属性是可选的。 默认情况下,客户端库从注册表读取 OLE DB 提供程序的当前版本。 仅当需要特定版本的数据提供程序(例如连接到 SQL Server 2008 实例)时,才需要设置此属性。

数据提供程序对应于 SQL Server 的版本。 如果你的组织使用当前和以前的 Analysis Services 版本,则很可能需要指定在手动创建的连接字符串上使用哪个提供程序。 你可能还需要在没有所需版本的计算机上下载并安装特定版本的数据提供程序。 可以从下载中心的 SQL Server 功能包页下载 OLE DB 提供程序。 转到 Microsoft SQL Server 2012 功能包 ,下载适用于 SQL Server 2012 的 Analysis Services OLE DB 提供程序。

MSOLAP.4 已在 SQL Server 2008 和 SQL Server 2008 R2 中发布。 2008 R2 版本支持 PowerPivot 工作簿,有时需要在 SharePoint 服务器上手动安装。 若要区分这些版本,需要在提供程序的文件属性中检查内部版本号:请转到 程序文件\Microsoft Analysis Services\AS OLEDB\10。 右键单击 msolap110.dll 并选择“ 属性”。 单击“详细信息”。 查看文件版本信息。 版本应包括 10.50。<SQL Server 2008 R2 的 buildnumber> 。 有关详细信息,请参阅在 SharePoint Server 上安装 Analysis Services OLE DB 提供程序,以及用于 Analysis Services 连接的数据提供程序

MSOLAP.3 已在 SQL Server 2005 中发布。

MSOLAP.4 已在 SQL Server 2008 和 SQL Server 2008 R2 中再次发布

MSOLAP.5 已在 SQL Server 2012 中发布
Provider=MSOLAP.3 用于需要 SQL Server 2005 版本的 OLE DB 提供程序的 Analysis Services 连接。
Cube 多维数据集名称或透视名称。 数据库可以包含多个多维数据集和视图。 当存在多个可能的目标时,请在连接字符串中包含多维数据集或视图名称。 Cube=SalesPerspective 表明您可以使用多维数据集连接字符串属性指定多维数据集的名称或视图的名称。

身份验证和安全

本部分包括与身份验证和加密相关的连接字符串属性。 Analysis Services 仅使用 Windows 身份验证,但你可以在连接字符串上设置属性以传入特定的用户名和密码。

属性按字母顺序列出。

资产 DESCRIPTION
EffectiveUserName 在服务器上必须模拟最终用户标识时使用。 以域\用户格式指定帐户。 若要使用此属性,调用方必须在 Analysis Services 中具有管理权限。 有关在 SharePoint 的 Excel 工作簿中使用此属性的详细信息,请参阅 SharePoint Server 2013 中的 Use Analysis Services EffectiveUserName。 欲了解此属性如何在 Reporting Services 中使用的示例,请参阅 在 SSAS 中使用 EffectiveUserName 进行模拟

EffectiveUserName 在 PowerPivot for SharePoint 安装中用于捕获使用情况信息。 用户标识提供给服务器,以便可以在日志文件中记录包含用户标识的事件或错误。 对于 PowerPivot,它不用于授权目的。
加密密码 指定是否使用本地密码来加密本地多维数据集。 有效值为 True 或 False。 默认值为 False。
Encryption Password 用于解密加密本地多维数据集的密码。 默认值为空。 此值必须由用户显式设置。
Impersonation Level 指示服务器在模拟客户端时允许使用的模拟级别。 有效值包括:

匿名:客户端对服务器是匿名的。 服务器进程无法获取有关客户端的信息,也不能模拟客户端。

标识:服务器进程可以获取客户端标识。 服务器可以根据授权目的模拟客户端标识,但不能以客户端身份访问系统对象。

模拟:这是默认值。 客户端标识可以被模拟,但只有在建立连接时才能进行,而不是在每次调用时。

委托:服务器进程可以模拟客户端的安全上下文,并代表客户端执行操作。 服务器进程可以在代表客户端的情况下,向其他服务器发起外部调用。
Integrated Security 调用者的 Windows 标识用于连接到 Analysis Services。 有效值为空、SSPI 和 BASIC。

Integrated Security = SSPI 是 TCP 连接的默认值,允许 NTLM、Kerberos 或匿名身份验证。 空白是 HTTP 连接的默认值。

使用SSPI时,ProtectionLevel必须设置为以下项之一:ConnectPktIntegrityPktPrivacy
Persist Encrypted 当客户端应用程序要求数据源对象以加密形式保存敏感的身份验证信息(如密码)时设置此属性。 默认情况下,不会保留身份验证信息。
Persist Security Info 有效值为 True 和 False。 设置为 True 时,可以在建立连接后从连接获取安全信息(例如之前在连接字符串上指定的用户标识或密码)。 默认值为 False。
ProtectionLevel 确定在连接上使用的安全级别。 有效值为:

None。 未经身份验证或匿名连接。 对发送到服务器的数据不执行身份验证。

Connect。 经过身份验证的连接。 仅在客户端与服务器建立关系时进行身份验证。

PktIntegrity。 加密连接。 验证是否从客户端接收所有数据,并且传输过程中尚未更改数据。

PktPrivacy。 签名加密,仅支持 XMLA。 验证是否从客户端接收所有数据、传输中未更改数据,并通过加密来保护数据的隐私。



有关详细信息,请参阅 在 ADOMD.NET 中建立安全连接
Roles 指定预定义角色的逗号分隔列表,以使用该角色传达的权限连接到服务器或数据库。 如果省略此属性,则使用所有角色,并且有效权限是所有角色的组合。 将属性设置为空值(例如 Roles=' ') 客户端连接没有角色成员身份。

使用此属性的管理员使用角色传达的权限进行连接。 如果角色未提供足够的权限,某些命令可能会失败。
SSPI 显式指定在Integrated Security设置为SSPI时用于客户端身份验证的安全包。 SSPI 支持多个包,但可以使用此属性指定特定包。 有效值为 Negotiate、Kerberos、NTLM 和 Anonymous User。 如果未设置此属性,则所有包都可用于连接。
Use Encryption for Data 加密数据传输。 值为 True 和 False。
User ID=...; Password= User IDPassword 一起使用。 Analysis Services 模拟通过这些凭据指定的用户身份。 在 Analysis Services 连接中,只有当服务器配置为 HTTP 访问时,并且在 IIS 虚拟目录中指定了基本身份验证而非集成安全性,才能在命令行中输入凭据。

用户名和密码必须是 Windows 标识(本地或域用户帐户)的凭据。 请注意, User ID 有嵌入的空间。 此属性的其他别名包括 UserName (无空格)和 UIDPassword 的别名是 PWD.

特殊用途参数

本部分介绍连接字符串参数的其余部分。 它们用于确保应用程序所需的特定连接行为。

属性按字母顺序列出。

资产 DESCRIPTION
Application Name 设置与连接关联的应用程序的名称。 监视跟踪事件时,此值非常有用,尤其是在有多个应用程序访问同一数据库时。 例如,将应用程序名称=“test”添加到连接字符串会导致“test”出现在 SQL Server Profiler 跟踪中,如以下屏幕截图所示:

SSAS_AppNameExcample

此属性的别名包括 sspropinitAppNameAppName。 有关详细信息,请参阅 连接到 SQL Server 时使用应用程序名称参数
AutoSyncPeriod 设置客户端和服务器缓存同步的频率(以毫秒为单位)。 ADOMD.NET 为具有最小内存开销的常用对象提供客户端缓存。 这有助于减少到服务器的往返次数。 默认值为 10000 毫秒(或 10 秒)。 设置为 null 或 0 时,会自动关闭同步。
Character Encoding 定义如何在请求中对字符进行编码。 有效值为 Default 或 UTF-8(这些值等效),以及 UTF-16
CompareCaseSensitiveStringFlags 调整指定区域设置的区分大小写的字符串比较。 有关设置此属性的详细信息,请参阅 CompareCaseSensitiveStringFlags 属性
Compression Level 如果 TransportCompression 为 XPRESS,则可以设置压缩级别来控制使用的压缩量。 有效值为 0 到 9,0 具有最小压缩,9 个具有最大压缩。 提高压缩速度会降低性能。 默认值为 0。
Connect Timeout 确定客户端在超时前尝试连接的最大时间(以秒为单位)。如果连接在此时间段内未成功,客户端会退出尝试连接并生成错误。
MDX Compatibility 此属性的目的是确保针对发出 MDX 查询的应用程序使用一组一致的 MDX 行为。 Excel 使用 MDX 查询填充和计算连接到 Analysis Services 的数据透视表,将此属性设置为 1,以确保不规则层次结构中的占位符成员在数据透视表中可见。 有效值包括 0、1、2。

0 和 1 显示占位符成员,而 2 不显示。 如果这是空的,则假定为 0。
MDX Missing Member Mode=Error 指示 MDX 语句中是否忽略缺少的成员。 有效值为 Default、Error 和 Ignore。 默认值使用服务器定义的值。 当某个成员不存在时,会引发一个错误。 忽略指定应忽略缺失值。
Optimize Response 一个位掩码,指示启用了以下哪些查询响应优化。

0x01:默认值。 使用 NormalTupleSet
0x02:当切片器为空时使用
Packet Size 512 到 32,767 之间的网络数据包大小(以字节为单位)。 默认网络数据包大小为 4096。
Protocol Format 设置发送到服务器的 XML 的格式。 有效值为 Default、XML 或 Binary。 协议为 XMLA。 可以指定以压缩格式(这是默认值)、原始 XML 或二进制格式发送 XML。 二进制格式对 XML 元素和属性进行编码,使其更小。 压缩是一种专有格式,可进一步减小请求和响应的大小。 压缩和二进制格式用于加快数据传输请求和响应的速度。

如果使用二进制格式或压缩格式,则必须在连接上使用客户端库。 OLE DB 提供程序可以采用二进制格式或压缩格式格式化请求和响应。 AMO 和 ADOMD.NET 将请求的格式设置为“文本”,但接受采用二进制或压缩格式的响应。

此连接字符串属性等效于EnableBinaryXMLEnableCompression服务器配置设置。
Real Time Olap 设置此属性以绕过缓存,导致所有分区主动侦听查询通知。 默认情况下,未设置此属性。
Safety Options 设置用户定义的函数和操作的安全级别。 有效值为 0、1、2。 在 Excel 连接中,此属性为 Safety Options=2。 有关此选项的详细信息,请参阅 ConnectionString
SQLQueryMode 指定 SQL 查询是否包括计算。 有效值为 Data、Calculated、IncludeEmpty。 数据意味着不允许进行计算。 “Calculated”工具允许进行计算。 IncludeEmpty 允许在查询结果中返回计算和空行。
Timeout 指定客户端库在生成错误之前等待命令完成的时间(以毫秒为单位)。
Transport Compression 定义通过 Protocol Format 属性指定压缩时如何压缩客户端和服务器通信。 有效值为 Default、None、Compressed 和 gzip. TCP 默认无压缩,HTTP 默认为 gzip。 无表示未使用压缩。 压缩使用 XPRESS 压缩(SQL Server 2008 及更高版本)。 gzip 仅适用于 HTTP 连接,其中 HTTP 请求包括 Accept-Encoding=gzip。
UseExistingFile 连接到本地多维数据集时使用。 此属性指定是否覆盖本地数据立方体。 有效值为 True 或 False。 如果设置为 True,则多维数据集文件必须存在。 现有文件将是连接的目标。 如果设置为 False,则会覆盖立方体文件。
VisualMode 设置此属性可控制在应用维度安全性时如何聚合成员。

对于允许每个人查看的多维数据集数据,聚合所有成员是有意义的,因为所有参与总数的值都是可见的。 但是,如果基于用户标识筛选或限制维度,则根据所有成员(将受限值和允许的值合并为单个总计)显示总计可能会令人困惑或显示比应显示的信息更多。

若要指定在应用维度安全性时如何聚合成员,可以将此属性设置为 True 以仅使用聚合中允许的值,或 False 从总计中排除受限值。

在连接字符串上设置时,此值适用于多维数据集或透视级别。 在模型中,可以在更精细的级别控制视觉对象总计。

有效值为 0、1 和 2。

0 是默认值。 当前,默认行为相当于 2,其中聚合包括用户无法看到的值。

1 排除总计中的隐藏值。 这是 Excel 的默认值。

2 包括总计中的隐藏值。 这是服务器上的默认值。



此属性的别名包括 Visual TotalDefault MDX Visual Mode

保留以供将来使用

在连接字符串上允许以下属性,但在 Analysis Services 的当前版本中不可运行。

  • 经过身份验证的用户

  • 缓存身份验证

  • 缓存模式(在早期版本中已调查此属性的使用)。虽然你可能会发现博客文章推荐其用法,但除非Microsoft支持指示,否则应避免设置此属性。

  • 缓存策略

  • 缓存比率

  • 缓存比率 2

  • 动态调试限制

  • 调试模式

  • 模式

  • SQL兼容性

  • 使用公式缓存

连接字符串示例

本部分介绍在常用应用程序中设置 Analysis Services 连接时最有可能使用的连接字符串。

泛型连接字符串

如果要从 Reporting Services 配置连接,则可以使用如下所示的连接字符串。

Data source=<servername>; initial catalog=<databasename>

Excel 中的连接字符串

Excel 中的默认 ADOMD.NET 连接字符串指定数据提供程序、服务器、数据库名称、Windows 集成安全性。 MDX 兼容性级别始终设置为 1。 尽管可以更改当前会话的值,但下次打开文件时,Excel 会将 MDX 兼容性重置为 1。

Provider=MSOLAP.5;Integrated Security=SSPI;Persist Security Info=True;Initial Catalog=Adventure Works DW 2008R2;Data Source=AW-SRV01;MDX Compatibility=1;Safety Options=2;MDX Missing Member Mode=Error

有关详细信息,请参阅 Reporting Services 中的数据连接、数据源和连接字符串 ,以及 SharePoint Server 2013 中 Excel Services 的数据身份验证

Analysis Services 中使用的连接字符串格式

本部分列出了 Analysis Services 支持的所有连接字符串格式。 除了连接到 PowerPivot 数据库之外,可以在连接到 Analysis Services 的应用程序中指定这些连接字符串。

与服务器的直接连接(或本地连接)

Data Source=server[:port][\instance] 其中“port”和“\instance”是可选的。 例如,指定“Data Source=server1”会在名为“server1”的服务器上打开与默认实例(和默认端口 2383)的连接。

“Data Source=server1:port1”将打开与“server1”上的端口“port1”上运行的 Analysis Services 实例的连接。

“Data Source=server1\instance1”将打开与 SQL Browser 的连接(在其默认端口 2382 上),解析命名实例“instance1”的端口,然后打开与该 Analysis Services 端口的连接。

“Data Source=server1:port1\instance1”将在“port1”上打开与 SQL Browser 的连接,解析“instance1”命名实例的端口,然后打开与该 Analysis Services 端口的连接。

本地多维数据集连接(.cub 文件)

Data Source=<path>,例如“Data Source=c:\temp\a.cub”

与 msmdpump.dll的 Http(s) 连接

Data Source=<URL>,其中 URL 是包含 msmdpump.dll的虚拟 IIS 文件夹的 HTTP 或 HTTPS 地址。 有关详细信息,请参阅 配置对 Internet Information Services (IIS) 8.0 上的 Analysis Services 的 HTTP 访问

Http(s) 连接到 PowerPivot 工作簿(.xlsx、.xlsb 或 .xlsm 文件)

Data Source=<URL>,其中 URL 是发布到 SharePoint 库的 PowerPivot 工作簿的 SharePoint 路径。 例如,“Data Source=https://localhost/Shared Documents/Sales.xlsx”。

与BI语义模型的HTTP(s)连接文件

Data Source=<URL> 其中 URL 是 .bism 文件的 SharePoint 路径。 例如,“Data Source=https://localhost/Shared Documents/Sales.bism”。

嵌入式 PowerPivot 连接

Data Source=$Embedded$ 其中,$embedded$ 是一个名字对象,它引用工作簿中的嵌入式 PowerPivot 数据模型。 此连接字符串在内部创建和管理。 请勿修改它。 嵌入式连接字符串由客户端工作站上的 PowerPivot for Excel 加载项或 SharePoint 场中的 PowerPivot for SharePoint 实例解析。

Analysis Services 存储过程中的本地服务器上下文

Data Source=*,其中 * 解析为本地实例。

加密连接字符串

Analysis Services 加密并存储用于连接到其每个数据源的连接字符串。 如果与数据源的连接需要用户名和密码,则可以让 Analysis Services 使用连接字符串存储名称和密码,或者在每次需要与数据源建立连接时提示你输入名称和密码。 让 Analysis Services 提示用户提供信息意味着无需存储和加密此信息。 但是,如果将此信息存储在连接字符串中,则需要加密和保护此信息。

为了加密和保护连接字符串信息,Analysis Services 使用数据保护 API。 Analysis Services 使用单独的加密密钥来加密每个 Analysis Services 数据库的连接字符串信息。 Analysis Services 在创建数据库时创建此密钥,并根据 Analysis Services 启动帐户加密连接字符串信息。 Analysis Services 启动时,将读取、解密和存储每个数据库的加密密钥。 然后,Analysis Services 使用适当的解密密钥在 Analysis Services 需要连接到数据源时解密数据源连接字符串信息。

另请参阅

在 Internet Information Services (IIS) 8.0 上配置 Analysis Services 的 HTTP 访问
Kerberos 约束委派配置 Analysis Services
用于 Analysis Services 连接的数据提供程序
连接至分析服务