通过

使用 BizTalk Server 调用 SQL Server 中的 Table-Valued 函数

可以将 SQL 适配器与 BizTalk Server 配合使用来调用 SQL Server 中的表值函数。 适配器将表值函数公开为可以直接在 SQL Server 上调用的操作。 有关适配器如何支持表值函数的详细信息，请参阅 使用 SQL 适配器在 SQL Server 中执行 Table-Valued 函数。 有关用于调用表值函数的 SOAP 消息的结构的信息，请参阅 过程和函数的消息架构。

先决条件

在 SQL Server 数据库上调用表值函数

结合 BizTalk Server 和 SQL 适配器对 SQL Server 数据库执行操作，涉及 在使用 SQL 适配器开发 BizTalk 应用程序时构建基块中所述的过程任务。 若要在 SQL Server 中调用表值函数，这些任务包括：

  1. 创建 BizTalk 项目，并为要在 SQL Server 中调用的表值函数生成架构。

  2. 在 BizTalk 项目中创建消息，以便从 SQL Server 发送和接收消息。

  3. 创建一个编排以调用 SQL Server 上的操作。

  4. 生成和部署 BizTalk 项目。

  5. 通过创建物理发送和接收端口来配置 BizTalk 应用程序。

  6. 启动 BizTalk 应用程序。

    本主题提供执行这些任务的说明。

生成架构

本主题演示如何在 SQL Server 中使用 SQL 适配器和 BizTalk Server 调用表值函数。 为了演示此操作，在本主题中将执行TVF_EMPLOYEE函数。 此函数采用员工的指定作为参数，并将具有该指定的所有员工记录作为表类型返回。 Employee 表和函数是通过运行随示例提供的脚本创建的。 有关脚本的详细信息，请参阅 SQL 适配器的示例。

为了演示如何调用表值函数，将为TVF_EMPLOYEE表值函数生成架构。 必须创建一个 BizTalk 项目，并使用“消费适配器服务插件”来生成架构。 有关如何生成架构的详细信息，请参阅 使用 SQL 适配器在 Visual Studio 中检索 SQL Server 操作的元数据。

定义消息和消息类型

前面生成的架构描述了业务流程中消息所需的“类型”。 消息通常是一个变量，即由相应架构定义的类型。 现在，为业务流程创建消息并将其链接到在上一步中生成的架构。

  1. 将一项编排添加到 BizTalk 项目中。 在解决方案资源管理器中，右键单击 BizTalk 项目名称，指向 “添加”，然后单击“ 新建项”。 键入 BizTalk 业务流程的名称，然后单击“ 添加”。

  2. 打开 BizTalk 项目的“业务流程视图”窗口（如果尚未打开）。 为此，请单击“ 视图”，指向 “其他窗口”，然后单击“ 业务流程视图”。

  3. 在业务流程视图中，右键单击 “消息”，然后单击“ 新建消息”。

  4. 右键单击新创建的消息，然后选择“ 属性窗口”。

  5. 在Message_1的“属性”窗格中，执行以下作：

    用这个 要执行的操作
    标识符 类型 Request
    消息类型 在下拉列表中，展开 “架构”，然后选择 TableFunctions.TableValuedFunction_dbo。TVF_EMPLOYEE，其中 TableFunctions 是 BizTalk 项目的名称。 TableValuedFunction_dbo是为TVF_EMPLOYEE函数生成的架构。

  6. 重复步骤 2 以创建新消息。 在新消息的 “属性 ”窗格中，执行以下作：

    用这个 要执行的操作
    标识符 类型 Response
    消息类型 在下拉列表中，展开 模式，然后选择 TableFunctions.TableValuedFunction_dbo.TVF_EMPLOYEEResponse。

设置业务流程

创建一个 BizTalk 业务流程，以使用 BizTalk Server 在 SQL Server 上执行操作。 在此业务流程中，会在定义的接收位置投递请求消息。 SQL 适配器使用此消息并将其传递到 SQL Server。 SQL Server 的响应将保存到另一个位置。 必须包含“发送和接收”形状，才能将消息分别发送到 SQL Server 和接收响应。 用于调用表值函数的示例编排如下所示：

用于调用表值函数的编排

添加消息形状

为每个邮件形状输入以下属性。 “形状”列中列出的名称是消息形状的名称，如上述编排中所显示。

形状 形状类型 性能
接收消息 接收 - 将 名称 设置为 ReceiveMessage
- 将 “激活 ”设置为 True
发送消息 发送 - 将 名称 设置为 SendMessage
接收响应 接收 - 将 名称 设置为 ReceiveResponse
- 将 “激活 ”设置为 False
SendResponse 发送 - 将 名称 设置为 SendResponse

添加端口

为每个逻辑端口输入以下属性。 端口列中列出的名称是在编排中显示的端口的名称。

港口 性能
MessageIn - 将 标识符 设置为 MessageIn
- 将 类型 设置为 MessageInType
- 将 通信模式 设置为 单向
- 将通信方向设置为接收
LOBPort - 将 标识符 设置为 LOBPort
- 将 类型 设置为 LOBPortType
- 将 通信模式 设置为 请求-响应
- 将 通信方向 设置为 发送接收
ResponseOut - 将 标识符 设置为 ResponseOut
- 将 类型 设置为 ResponseOutType
- 将 通信模式 设置为 单向
- 将通信方向设置为发送

输入消息到动作形状，并将其连接到端口

下表列出了为操作形状指定消息及将消息链接到端口时需要设置的属性及其值。 Shape 列中列出的名称是前文提到的业务编排中显示的消息形状的名称。

形状 性能
接收消息 - 将 消息 设置为 请求
- 将 Operation 设置为 MessageIn.TVF.Request
发送消息 - 将 消息 设置为 请求
- 将 操作 设置为 LOBPort.TVF.Request
接收响应 - 将 消息 设置为 响应
- 将 操作 设置为 LOBPort.TVF.Response
SendResponse - 将 消息 设置为 响应
- 将操作设置为ResponseOut.TVF.Request

在指定这些属性之后，消息类型和端口被连接，您的编排就完成了。

现在，生成 BizTalk 解决方案并将其部署到 BizTalk Server。 有关详细信息，请参阅 生成和运行业务流程。

配置 BizTalk 应用程序

部署 BizTalk 项目后，前面创建的业务流程将列在 BizTalk Server 管理控制台中的“业务流程”窗格下。 必须使用 BizTalk Server 管理控制台来配置应用程序。 有关演练，请参阅 演练：部署基本 BizTalk 应用程序。

配置应用程序涉及：

  • 为应用程序选择主机。

  • 将业务流程中创建的端口映射到 BizTalk Server 管理控制台中的物理端口。 对于此编排，必须：

    • 请在硬盘上指定一个位置及其对应的文件端口，以便放置请求消息。 BizTalk 业务流程将使用请求消息并将其发送到 SQL Server 数据库。

    • 定义硬盘上的位置和相应的文件端口，BizTalk 业务流程将删除包含来自 SQL Server 数据库的响应的响应消息。

    • 定义物理 WCF-Custom 或 WCF-SQL 发送端口以将消息发送到 SQL Server 数据库。 还必须在发送端口中指定操作。 有关如何创建端口的信息，请参阅 手动配置到 SQL 适配器的物理端口绑定。

      注释

      使用“消耗适配器服务”BizTalk 项目外接程序生成架构时，还会创建一个绑定文件，其中包含有关这些端口及其对应操作信息。 可以从 BizTalk Server 管理控制台导入此绑定文件，以创建发送端口（用于出站呼叫）或接收端口（对于入站呼叫）。 有关详细信息，请参阅 使用端口绑定文件配置物理端口绑定以使用 SQL 适配器。

启动应用程序

启动 BizTalk 应用程序，以便在 SQL Server 数据库中调用表值函数。 有关启动 BizTalk 应用程序的说明，请参阅 如何启动业务流程。

在此阶段，请确保：

  • 用于接收业务流程请求消息的 FILE 接收端口正在运行。

  • 用于从业务流程接收响应消息的 FILE 发送端口正在运行。

  • WCF-Custom 或 WCF-SQL 发送端口用于将消息发送到 SQL Server 数据库，并且当前正在运行。

  • 正在运行该操作的 BizTalk 业务流程。

执行操作

运行应用程序后，必须将请求消息投递到 FILE 接收位置。 请求消息的架构必须符合前面生成的TVF_EMPLOYEE表值函数的架构。 例如，调用TVF_EMPLOYEE函数的请求消息为：

<TVF_EMPLOYEE xmlns="http://schemas.microsoft.com/Sql/2008/05/TableValuedFunctions/dbo">  
  <emp_desig>Tester</emp_desig>  
</TVF_EMPLOYEE>

此请求消息调用TVF_EMPLOYEE函数，以检索指定为“Tester”的员工记录。 有关使用 SQL 适配器在 SQL Server 中调用表值函数的请求消息架构的详细信息，请参阅 过程和函数的消息 架构。

注释

如果未为参数指定值，适配器在内部使用 DEFAULT 关键字执行函数，这意味着适配器通过传递参数的默认值（如果作为函数定义的一部分可用）来执行函数。

协调流程使用消息并将其发送到 SQL Server 数据库。 SQL Server 数据库的响应保存在编排过程中定义的其他 FILE 位置。 例如，来自 SQL Server 数据库的上述请求消息的响应为：

<?xml version="1.0" encoding="utf-8" ?>   
<TVF_EMPLOYEEResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/TableValuedFunctions/dbo">  
  <TVF_EMPLOYEEResult>  
    <TVF_EMPLOYEE xmlns="http://schemas.microsoft.com/Sql/2008/05/Types/TableFunctionReturnTables/dbo">  
      <Employee_ID>10499</Employee_ID>   
      <Name>John</Name>   
      <Designation>Tester</Designation>   
      <Salary>999999.00</Salary>   
      <Last_Modified>AAAAAAAAJBM=</Last_Modified>   
    </TVF_EMPLOYEE>  
    <TVF_EMPLOYEE xmlns="http://schemas.microsoft.com/Sql/2008/05/Types/TableFunctionReturnTables/dbo">  
      ......  
      ......  
    </TVF_EMPLOYEE>  
    ......  
    ......  
  </TVF_EMPLOYEEResult>  
</TVF_EMPLOYEEResponse>

最佳做法

部署并配置 BizTalk 项目后，可以将配置设置导出到名为绑定文件的 XML 文件。 生成绑定文件后，可以从该文件导入配置设置，以便无需为同一业务流程创建发送端口和接收端口等项。 有关绑定文件的详细信息，请参阅 重复使用适配器绑定。

另请参阅

使用 SQL 适配器开发 BizTalk 应用程序