SAP HANA 数据库

总结

项	说明
发布状态	正式版
产品	Power BI（数据集） Power BI（数据流） Power Apps（数据流） Excel Analysis Services
支持的身份验证类型	基本 数据库 Windows
函数参考文档	SapHana.Database

注意

由于部署计划和特定于主机的功能，某些功能可能存在于一个产品中，但其他产品中不存在。

先决条件

需要一个 SAP 帐户才能登录到网站并下载驱动程序。 如果不确定，请联系组织中的 SAP 管理员。

若要在 Power BI Desktop 或 Excel 中使用 SAP HANA，必须在本地客户端计算机上安装 SAP HANA ODBC 驱动程序，SAP HANA 数据连接才能正常工作。 可以从 SAP 开发工具下载 SAP HANA 客户端工具，其中包含所需的 ODBC 驱动程序。 也可以从 SAP 软件下载中心获取。 在“软件”门户中，搜索 Windows 计算机的 SAP HANA 客户端 。 由于 SAP 软件下载中心的结构经常发生变化，因此没有有关站点导航的更多具体指导。 有关安装 SAP HANA ODBC 驱动程序的说明，请转到 在 Windows 64 位上安装 SAP HANA ODBC 驱动程序。

若要在 Excel 中使用 SAP HANA，必须具有 32 位或 64 位 SAP HANA ODBC 驱动程序 (，具体取决于在本地客户端计算机上安装的 32 位还是 64 位版本的 Excel) 。

此功能仅在具有 Office 2019 或 Microsoft 365 订阅的情况下在 Excel for Windows 中可用。 如果你是 Microsoft 365 订阅者， 请确保拥有最新版本的 Office。

支持 HANA 1.0 SPS 12rev122.09、2.0 SPS 3rev30 和 BW/4HANA 2.0。

支持的功能

• 导入
• 直接查询
• 高级
  • SQL 语句

从 Power Query Desktop 连接到 SAP HANA 数据库

若要从 Power Query Desktop 连接到 SAP HANA 数据库，请执行以下操作：

1. 在 Excel 的“数据”>功能区中选择“在 Power BI Desktop 中获取数据 SAP HANA 数据库”或“从 > SAP HANA 数据库获取数据库”。

2. 输入要连接到的 SAP HANA 服务器的名称和端口。 下图中的示例在 SAPHANATestServer 端口 30015上使用 。

   

   默认情况下，端口号设置为支持单个容器数据库。 如果 SAP HANA 数据库可以包含多个多租户数据库容器，请选择“ 多容器系统数据库” (30013) 。 如果要连接到租户数据库或具有非默认实例编号的数据库，请从“端口”下拉菜单中选择“自定义”。

   如果要从 Power BI Desktop 连接到 SAP HANA 数据库，还可以选择“导入”或“DirectQuery”。 本文中的示例使用 导入，这是 Excel) 的默认 (和唯一模式。 有关在 Power BI Desktop 中使用 DirectQuery 连接到数据库的详细信息，请转到使用 Power BI 中的 DirectQuery 连接到 SAP HANA 数据源。

   还可以输入 SQL 语句或从 “高级”选项启用列绑定。 有关详细信息， 请使用高级选项进行连接

   输入所有选项后，选择“ 确定”。

3. 如果是首次访问数据库，系统会要求你输入凭据进行身份验证。 在此示例中，SAP HANA 服务器需要数据库用户凭据，因此请选择“ 数据库 ”并输入用户名和密码。 如有必要，请输入服务器证书信息。

   

   此外，可能需要验证服务器证书。 有关使用验证服务器证书选择的详细信息，请参阅 使用 SAP HANA 加密。 在 Power BI Desktop 和 Excel 中，默认启用验证服务器证书选择。 如果已在 ODBC 数据源管理员中设置这些选择，请清除“验证服务器证书检查框。 若要详细了解如何使用 ODBC 数据源管理员设置这些选择，请转到 为 ODBC 客户端配置对 SAP HANA 的访问的 SSL。

   有关身份验证的详细信息，请转到 使用数据源进行身份验证。

   填写所有必需信息后，选择“ 连接”。

4. 在“导航器”对话框中，可以通过选择“转换数据”在Power Query编辑器中转换数据，也可以通过选择“加载”来加载数据。

从 Power Query Online 连接到 SAP HANA 数据库

若要从 Power Query Online 连接到 SAP HANA 数据，

1. 在 “数据源 ”页中，选择“ SAP HANA 数据库”。

2. 输入要连接到的 SAP HANA 服务器的名称和端口。 下图中的示例在 SAPHANATestServer 端口 30015上使用 。

3. （可选）在 “高级”选项中输入 SQL 语句。 有关详细信息， 请使用高级选项进行连接

4. 选择要用于访问数据库的本地数据网关的名称。

   注意

   无论数据是本地数据还是联机数据，都必须使用此连接器的本地数据网关。

5. 选择要用于访问数据的身份验证类型。 还需要输入用户名和密码。

   注意

   目前，Power Query Online 仅支持基本身份验证。

6. 如果使用的是任何 加密连接 ，请选择“使用加密连接”，然后选择 SSL 加密提供程序。 如果未使用加密连接，请清除 “使用加密连接”。 详细信息： 为 SAP HANA 启用加密

   

7. 选择“下一步”继续。

8. 在“导航器”对话框中，可以通过选择“转换数据”在Power Query编辑器中转换数据，也可以通过选择“加载”来加载数据。

使用高级选项进行连接

Power Query提供了一组高级选项，可根据需要将这些选项添加到查询。

下表介绍了可在 Power Query 中设置的所有高级选项。

高级选项	说明
SQL 语句	详细信息， 使用本机数据库查询从数据库导入数据
启用列绑定	提取数据时，将变量绑定到 SAP HANA 结果集的列。 可能会提高性能，但代价是内存利用率略高。 此选项仅在 Power Query Desktop 中可用。 详细信息： 启用列绑定
ConnectionTimeout	一个持续时间，用于控制在放弃尝试建立与服务器的连接之前等待的时间。 默认值为 15 秒。
CommandTimeout	一个持续时间，用于控制在取消前允许服务器端查询运行多长时间。 默认值为十分钟。

SAP HANA 支持的功能

以下列表显示了 SAP HANA 支持的功能。 并非所有 SAP HANA 数据库连接器实现都支持此处列出的所有功能。

• SAP HANA 数据库的 Power BI Desktop 和 Excel 连接器都使用 SAP ODBC 驱动程序提供最佳用户体验。

• 在 Power BI Desktop 中，SAP HANA 支持 DirectQuery 和导入选项。

• Power BI Desktop支持 HANA 信息模型（例如分析和计算视图），并优化了导航。

• 借助 SAP HANA，还可以使用本机数据库查询 SQL 语句中的 SQL 命令连接到 HANA 目录表中的行表和列表，这些表不包括在导航器体验提供的分析/计算视图中。 还可以使用 ODBC 连接器 来查询这些表。

• Power BI Desktop包括 HANA 模型的优化导航。

• Power BI Desktop 支持 SAP HANA 变量和输入参数。

• Power BI Desktop支持基于 HDI 容器的计算视图。

• SapHana.Database 函数现在支持连接和命令超时。 详细信息： 使用高级选项进行连接

  • 要在 Power BI 中访问基于 HDI 容器的计算视图，请确保用于 Power BI 的 HANA 数据库用户有权访问其中存储着你要访问的视图的 HDI 运行时容器。 若要授予此访问权限，请创建允许访问 HDI 容器的角色。 然后，将角色分配给将与 Power BI 一起使用的 HANA 数据库用户。 （和往常一样，此用户还必须具有从 SYSBI 架构中的系统表中读取内容的权限。）要详细了解如何创建和分配数据库角色，请参阅 SAP 官方文档。 此 SAP 博客文章 可能是一个很好的起点。

  • 附加到基于 HDI 的计算视图的 HANA 变量当前存在一些限制。 这些限制是因为 HANA 方面出错。 首先，无法将 HANA 变量应用到基于 HDI 容器的计算视图的共享列中。 若要修复这一限制，请升级到 HANA 2 版本 37.02 及更高版本或 HANA 2 版本 42 及更高版本。 其次，变量和参数的多项默认值当前不在 Power BI UI 中显示。 SAP HANA 中的错误会导致此限制，但是 SAP 尚未发布修复程序。

启用列绑定

从数据源提取的数据在应用程序为此分配的变量中返回给应用程序。 在完成此操作之前，应用程序必须将这些变量关联或 绑定到结果集的列;从概念上讲，此过程与将应用程序变量绑定到语句参数相同。 当应用程序将变量绑定到结果集列时，它将该变量（地址、数据类型等）描述给驱动程序。 驱动程序将此信息存储在它为该语句维护的结构中，并在提取行时使用该信息从列中返回值。

目前，使用 Power Query Desktop 连接到 SAP HANA 数据库时，可以选择“启用列绑定高级”选项来启用列绑定。

还可以通过在Power Query编辑栏或高级编辑器中手动将 选项添加到EnableColumnBinding连接，在现有查询或 Power Query Online 中使用的查询中启用列绑定。 例如：

SapHana.Database("myserver:30015", [Implementation = "2.0", EnableColumnBinding = true]),

手动添加 EnableColumnBinding 选项存在一些限制：

• 启用列绑定在导入和 DirectQuery 模式下均有效。 但是，无法将现有 DirectQuery 查询改造为使用此高级选项。 相反，必须创建新查询才能使此功能正常工作。
• 在 SAP HANA Server 2.0 或更高版本中，列绑定是全部或全无。 如果某些列无法绑定，则不会绑定任何列，并且用户将收到异常， DataSource.Error: Column MEASURE_UNIQUE_NAME of type VARCHAR cannot be bound (20002 > 16384)例如 。
• SAP HANA 1.0 版服务器并不总是报告正确的列长度。 在此上下文中， EnableColumnBinding 允许部分列绑定。 对于某些查询，这可能意味着未绑定任何列。 如果未绑定列，则不会获得性能优势。

SAP HANA 数据库连接器中的本机查询支持

Power Query SAP HANA 数据库连接器支持本机查询。 有关如何在 Power Query 中使用本机查询的信息，请转到使用本机数据库查询从数据库导入数据。

本机查询上的查询折叠

Power Query SAP HANA 数据库连接器现在支持对本机查询进行查询折叠。 详细信息： 本机查询上的查询折叠

注意

在 Power Query SAP HANA 数据库连接器中，当 设置为 true 时EnableFolding，本机查询不支持重复的列名。

本机查询中的参数

Power Query SAP HANA 数据库连接器现在支持本机查询中的参数。 可以使用 Value.NativeQuery 语法在本机查询中指定参数。

与其他连接器不同，SAP HANA 数据库连接器同时支持 EnableFolding = True 和指定参数。

若要在查询中使用参数，请在代码中将问号 (？) 作为占位符。 若要指定 参数，请在 SqlType 中使用Value文本值和 SqlType 的值。 Value 可以是任何 M 值，但必须分配给指定 SqlType的值。

可通过多种方式指定参数：

• 仅提供值作为列表：

  { “Seattle”, 1, #datetime(2022, 5, 27, 17, 43, 7) }
  

• 以列表的形式提供值和类型：

  { [ SqlType = "CHAR", Value = "M" ], 
     [ SqlType = "BINARY", Value = Binary.FromText("AKvN", BinaryEncoding.Base64) ], 
     [ SqlType = "DATE", Value = #date(2022, 5, 27) ] }
  

• 混合并匹配两者：

  { “Seattle”, 1, [ SqlType = "SECONDDATE", Value = #datetime(2022, 5, 27, 17, 43, 7) ] }
  

SqlType 遵循 SAP HANA 定义的标准类型名称。 例如，以下列表包含最常用的使用类型：

• BIGINT
• BINARY
• BOOLEAN
• CHAR
• DATE
• DECIMAL
• DOUBLE
• INTEGER
• NVARCHAR
• SECONDDATE
• SHORTTEXT
• SMALLDECIMAL
• SMALLINT
• TIME
• TIMESTAMP
• VARBINARY
• VARCHAR

以下示例演示如何提供参数值的列表。

let
    Source = Value.NativeQuery(
        SapHana.Database(
            "myhanaserver:30015", 
            [Implementation = "2.0"]
        ), 
        "select ""VARCHAR_VAL"" as ""VARCHAR_VAL""
    from ""_SYS_BIC"".""DEMO/CV_ALL_TYPES""
    where ""VARCHAR_VAL"" = ? and ""DATE_VAL"" = ?
    group by ""VARCHAR_VAL""
    ", 
        {"Seattle", #date(1957, 6, 13)}, 
        [EnableFolding = true]
    )
in
    Source

以下示例演示如何提供记录列表 (或将值和记录混合) ：

let
    Source = Value.NativeQuery(
        SapHana.Database(Server, [Implementation="2.0"]), 
    "select
        ""COL_VARCHAR"" as ""COL_VARCHAR"",
        ""ID"" as ""ID"",
        sum(""DECIMAL_MEASURE"") as ""DECIMAL_MEASURE""
    from ""_SYS_BIC"".""DEMO/CV_ALLTYPES""
    where
        ""COL_ALPHANUM"" = ? or
        ""COL_BIGINT"" = ? or
        ""COL_BINARY"" = ? or
        ""COL_BOOLEAN"" = ? or
        ""COL_DATE"" = ?
    group by 
        ""COL_ALPHANUM"",
        ""COL_BIGINT"",
        ""COL_BINARY"",
        ""COL_BOOLEAN"",
        ""COL_DATE"",
       {
            [ SqlType = "CHAR", Value = "M" ],                                                // COL_ALPHANUM - CHAR
            [ SqlType = "BIGINT", Value = 4 ],                                                // COL_BIGINT - BIGINT
            [ SqlType = "BINARY", Value = Binary.FromText("AKvN", BinaryEncoding.Base64) ],   // COL_BINARY - BINARY
            [ SqlType = "BOOLEAN", Value = true ],                                            // COL_BOOLEAN - BOOLEAN
            [ SqlType = "DATE", Value = #date(2022, 5, 27) ],                                 // COL_DATE - TYPE_DATE
        } ,
        [EnableFolding=false]
    )
in
    Source

支持动态属性

SAP HANA 数据库连接器处理计算列的方式已得到改进。 SAP HANA 数据库连接器是一个“多维数据集”连接器， (“多维数据集”空间中发生的) 添加项、折叠列等操作集。 此多维数据集空间显示在Power Query桌面和Power Query Online 用户界面中，“多维数据集”图标替换了更常见的“表”图标。

以前，添加表列 (或另一个在内部添加列) 的转换时，查询将“删除多维数据集空间”，所有操作将在表级别完成。 在某些时候，这种退出可能会导致查询停止折叠。 无法再在添加列后执行多维数据集操作。

进行此更改后，添加的列将被视为多维数据集中的 动态属性 。 让查询保留在此操作的多维数据集空间中的好处是，即使在添加列后，也能继续使用多维数据集操作。

注意

此新功能仅在连接到 SAP HANA Server 2.0 或更高版本中的计算视图时可用。

以下示例查询利用了这一新功能。 过去，应用 Cube.CollapseAndRemoveColumns 时，会出现“值不是多维数据集”异常。

let
    Source = SapHana.Database(“someserver:someport”, [Implementation="2.0"]),
    Contents = Source{[Name="Contents"]}[Data],
    SHINE_CORE_SCHEMA.sap.hana.democontent.epm.models = Contents{[Name="SHINE_CORE_SCHEMA.sap.hana.democontent.epm.models"]}[Data],
    PURCHASE_ORDERS1 = SHINE_CORE_SCHEMA.sap.hana.democontent.epm.models{[Name="PURCHASE_ORDERS"]}[Data],
    #"Added Items" = Cube.Transform(PURCHASE_ORDERS1,
        {
            {Cube.AddAndExpandDimensionColumn, "[PURCHASE_ORDERS]", {"[HISTORY_CREATEDAT].[HISTORY_CREATEDAT].Attribute", "[Product_TypeCode].[Product_TypeCode].Attribute", "[Supplier_Country].[Supplier_Country].Attribute"}, {"HISTORY_CREATEDAT", "Product_TypeCode", "Supplier_Country"}},
            {Cube.AddMeasureColumn, "Product_Price", "[Measures].[Product_Price]"}
        }),
    #"Inserted Year" = Table.AddColumn(#"Added Items", "Year", each Date.Year([HISTORY_CREATEDAT]), Int64.Type),
    #"Filtered Rows" = Table.SelectRows(#"Inserted Year", each ([Product_TypeCode] = "PR")),
    #"Added Conditional Column" = Table.AddColumn(#"Filtered Rows", "Region", each if [Supplier_Country] = "US" then "North America" else if [Supplier_Country] = "CA" then "North America" else if [Supplier_Country] = "MX" then "North America" else "Rest of world"),
    #"Filtered Rows1" = Table.SelectRows(#"Added Conditional Column", each ([Region] = "North America")),
    #"Collapsed and Removed Columns" = Cube.CollapseAndRemoveColumns(#"Filtered Rows1", {"HISTORY_CREATEDAT", "Product_TypeCode"})
in
    #"Collapsed and Removed Columns"

后续步骤

• 启用 SAP HANA 加密

以下文章包含连接到 SAP HANA 数据库时可能有用的详细信息。

• 管理数据源 - SAP HANA
• 使用 Kerberos 进行单一登录 (SSO) 到 SAP HANA