内容:

使用存储过程

  • 版本 :2022.1 及更高版本

适用于: Tableau Desktop, Tableau Online, Tableau Server

存储过程是可供访问关系数据库系统的应用程序使用的例程。使用 Tableau 连接到 SAP Sybase ASE、Microsoft SQL Server 或 Teradata 数据库时,可以使用存储过程来定义连接。

对于 Oracle,您可以使用表函数来定义连接。Oracle 表函数的功能类似于存储过程,列在“数据源”页面上的“存储过程”下。

当您使用其中一种数据类型创建数据源时,存储过程下列出了可用的过程,如 Microsoft SQL Server 示例中所示:

从左侧窗格中,将该过程拖动到画布或双击列出的一个过程。如果该过程中有可用参数,将自动显示“参数”对话框。

您可以使用现有 Tableau 参数而无需输入值,或者为值创建新 Tableau 参数:

如果您随后在视图中公开 Tableau 参数,用户将能够以交互方式更改过程中的参数值。

存储过程不支持联合、关联或联接。它们在逻辑层中的单个逻辑表中表示,并且不允许打开“联接/并集”画布(物理层)。

存储过程注意事项

如果您使用存储过程为 Tableau 定义数据源,请注意以下几点:

  • 如果存储过程返回多个结果集,Tableau 将读取第一个结果集并忽略其余结果集。

  • 如果存储过程具有输出参数,Tableau 会筛选该存储过程。

  • 不包括具有非标量类型的参数的存储过程。

  • 记录了 Tableau 中没有匹配类型的结果集列(例如 varbinary、geometry 和 hierarchyid)。如果所有结果集列都对应于未知数据类型,则 Tableau 会显示消息:

    “结果集...没有可用列。”

  • 没有返回结果集的存储过程将在数据源页中列出,但如果选择这些存储过程,则会失败。

  • 如果没有为存储过程所需的参数提供任何值,则会出现错误。Tableau 无法提前确定是否需要参数。

  • Tableau 不对存储过程执行任何事务管理。即,存储过程编写器不必依赖 Tableau 即可在调用存储过程之前启动事务,或者在调用存储过程之后提交事务。

  • 列名称必须唯一才可以使用存储过程。如果两个列的名称相同,或者未提供任何名称,则存储过程可能会导致错误。

  • 如果存储过程中有多个查询(例如,用于从另一表读取值或保存临时组合),则其中每个查询必须以相同顺序(相同名称和数据类型)返回同一组列。为确保列顺序和名称在查询结果中匹配,您可能需要执行显式 CAST 以确保数据类型正确(例如 CAST(Username as VARCHAR(20))),并显式命名这些列。如果存储过程不遵循这些指南,则可能出现错误消息:

    “InsertData: 未绑定的列错误”

  • 如果存储过程中有多个查询(例如,用于从另一表读取值或保存临时组合)并且该过程将产生错误,请尝试在该过程顶部添加 SET NOCOUNT ON。这可防止显示受 Transact-SQL 语句影响的行计数的消息作为查询结果集的一部分返回。

此外,以下约束适用于特定数据库。

Teradata 数据库的存储过程约束

以下约束适用于 Teradata 数据库中的存储过程。

  • 必须为每个参数提供值。如果用户没有为一个或多个参数提供值,则 Tableau 会显示一条 Teradata 数据库错误,指出为存储过程提供的值太少。

SQL Server 数据库的存储过程约束

以下约束适用于 SQL Server 数据库中的存储过程。

  • 如果存储过程的结果集包含 IMAGE 或 TEXT 类型的列,则存储过程会失败,并出现“语法不正确”错误消息。

  • 如果结果集的总宽度(每行中的字节数)超过 8060,则存储过程将失败。非常宽的表(几百列)或具有大型文本列的表(旨在容纳数千个文本字符)可能会出现这种情况。

  • Tableau 不会显示架构“sys”中的存储过程。

  • 如果用户没有为此过程需要的一个或多个参数提供值,则 Tableau 会以“此过程需要参数 @x 的值,但是没有提供”的形式显示一条 SQL Server 数据库错误。

  • 包含多个查询的存储过程应遵循“存储过程注意事项”(上文)中列出的指南。

  • Tableau Desktop 不支持 Microsoft SQL Server TIME 数据类型。当在 Microsoft SQL Server 数据库上的存储过程中包含此类型的字段时,Tableau Desktop 不会导入这些字段。

SAP Sybase ASE 数据库的存储过程约束

以下约束适用于 SAP Sybase ASE 数据库中的存储过程(仅限于 Windows)。

  • 数据库必须具有一个正确配置的远程服务器。

  • 如果用户没有为此过程需要的一个或多个参数提供值,则 Tableau 会以“此过程需要参数 @x 的值,但是没有提供”的形式显示一条 Sybase ASE 数据库错误。