对 Oracle 数据库中具有大型对象数据类型的表运行操作

适用于 Oracle 数据库的 Microsoft BizTalk 适配器支持 Oracle 大型对象 (LOB) 数据类型：

• 二进制大型对象 (BLOB)

• CLOB) (字符大型对象

• 国家字符大型对象 (NCLOB)

• BFILE) (二进制文件。 有关详细信息，请参阅使用 BizTalk Server 对 Oracle 数据库中具有 BFILE 数据类型的表执行操作。

  Microsoft BizTalk Adapter for Oracle Database 通过为包含 LOB 列的表显示 ReadLOB 和 UpdateLOB 操作来执行此操作。 有关这些操作的详细信息，请参阅 对 Oracle 数据库中包含 LOB 数据的表和视图的操作。 有关用于调用这些操作的 SOAP 消息的结构的详细信息，请参阅 特殊 LOB 操作的消息架构。

注意

将 Oracle 数据库适配器与 BizTalk Server 配合使用时，ReadLOB 操作不支持从 Oracle 数据库流式传输 LOB 类型数据。 若要使用 BizTalk Server 流式传输 Oracle 数据库中的 LOB 数据，应改用 Select 操作。 有关流式处理的详细信息，请参阅 Oracle 数据库中 LOB 数据类型的流式处理支持。 此外，Oracle 数据库对 ReadLOB 操作的响应将无法通过 WSDL 验证。 有关如何解决故障的说明，请参阅 排查操作问题。

如何对 LOB 数据执行操作？

使用具有 BizTalk Server 的 Oracle 数据库适配器对 Oracle 数据库执行操作涉及构建基块以使用 Oracle 数据库开发 BizTalk 应用程序中所述的过程性任务。 若要对 Oracle 数据库中的表调用 ReadLOB 和 UpdateLOB 操作，这些任务包括：

1. 创建 BizTalk 项目并为 ReadLOB 和 UpdateLOB 操作生成架构。

2. 在 BizTalk 项目中创建消息，以便从 Oracle 数据库发送和接收消息。 必须为发送请求和接收这两个操作的响应创建消息。

3. 创建业务流程以调用 ReadLOB 和 UpdateLOB 操作。

4. 生成和部署 BizTalk 项目。

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

6. 启动 BizTalk 应用程序。

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

基于本主题的示例

BizTalk 适配器包还提供了基于本主题Operate_LOB的示例。 有关详细信息，请参阅 适配器示例。

生成架构

在本主题中，为了演示如何执行 ReadLOB 和 UpdateLOB 操作，我们将为 Oracle 数据库中 SCOTT 架构下的 CUSTOMER 表显示这些操作生成元数据。 此表是通过运行随示例提供的 SQL 脚本在 SCOTT 架构下创建的。 若要详细了解示例，请参阅 架构示例。

定义消息和消息类型

前面生成的架构描述了业务流程中的消息所需的“类型”。 消息通常是一个变量，其类型由相应的架构定义。 必须在第一步中生成的架构链接到 BizTalk 项目的“业务流程视图”窗口中的消息。

对于本主题，必须创建两个请求-响应消息集：一个请求-响应集用于 ReadLOB 操作，另一个请求-响应集用于 UpdateLOB 操作。

执行以下步骤来创建消息并将其链接到架构。

创建消息并链接到架构

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

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

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

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

   使用此选项	要执行此操作
   标识符	键入 “请求”。
   消息类型	从下拉列表中，展开“ 架构”，然后选择“ Operate_LOB”。OracleDBBindingSchema.ReadLOB， 其中 Operate_LOB 是 BizTalk 项目的名称。 OracleDBBindingSchema 是为 CUSTOMER 表上的 ReadLOB 和 UpdateLOB 操作生成的架构。

5. 重复上一步，再创建三条消息。 在新消息的“ 属性 ”窗格中，执行以下操作：

   将“标识符”设置为	将“消息类型”设置为
   响应	Operate_LOB。OracleDBBindingSchema.ReadLOBResponse
   Request2	Operate_LOB。OracleDBBindingSchema.UpdateLOB
   Response2	Operate_LOB。OracleDBBindingSchema.UpdateLOBResponse

设置业务流程

必须创建 BizTalk 业务流程才能使用 BizTalk Server 调用表上的 ReadLOB 和 UpdateLOB 操作。 在此业务流程中，删除两条请求消息，一条用于 ReadLOB 操作，另一条用于 UpdateLOB 操作。 这些消息将丢弃在接收位置。 Oracle 数据库适配器使用消息，并通过 ODP 将它们传递到 Oracle 数据库。 Oracle 数据库的响应将保存到另一个位置。

由于业务流程同时选取两个请求，因此需要在业务流程中包含并行操作形状。 对于每个并行操作，必须包含“发送和接收”形状，以便将消息发送到 Oracle 数据库并接收响应。 但是，可以使用相同的端口来发送和接收这两个操作的消息。 同时执行 ReadLOB 和 UpdateLOB 操作的典型业务流程将包含：

• 发送和接收形状，用于将消息发送到 Oracle 数据库并接收响应。

• 单向接收端口，用于接收要发送到 Oracle 数据库的请求消息。

• 双向发送端口，用于将请求消息发送到 Oracle 数据库并接收响应。

• 用于将响应从 Oracle 数据库发送到文件夹的单向发送端口。

  示例业务流程类似于以下内容：

  

添加消息形状

请确保为每个消息形状指定以下属性。 “形状”列中列出的名称是刚才提到的业务流程中显示的消息形状的名称。 下表列出了必须为其中一个并行操作包括的形状。

形状	形状类型	属性
ReceiveMessage	接收	- 将 Name 设置为 ReceiveMessage - 将 “激活” 设置为 “True”
SendMessage	发送	- 将 Name 设置为 SendMessage
ReceiveResponse	接收	- 将 Name 设置为 ReceiveResponse - 将 “激活” 设置为 “False”
SendResponse	发送	- 将 “名称” 设置为 SendResponse

下表列出了必须包含用于其他并行操作的形状。

形状	形状类型	属性
ReceiveMessage2	接收	- 将 Name 设置为 ReceiveMessage2 - 将 “激活” 设置为 “True”
SendMessage2	发送	- 将 “名称” 设置为 SendMessage2
ReceiveResponse2	接收	- 将 Name 设置为 ReceiveResponse2 - 将 “激活” 设置为 “False”
SendResponse2	发送	- 将 Name 设置为 SendResponse2

添加端口

请确保为每个逻辑端口指定以下属性。 “端口”列中列出的名称是业务流程中显示的端口名称。

端口	属性
FileIn	- 将 标识符 设置为 FileIn - 将 Type 设置为 FileInType - 将 通信模式 设置为 单向 - 将 通信方向 设置为 接收
LOBPort	- 将 标识符 设置为 LOBPort - 将 Type 设置为 LOBPortType - 将 通信模式 设置为 请求-响应 - 将 通信方向 设置为 “发送-接收”
SaveResponse	- 将 标识符 设置为 SaveResponse - 将 Type 设置为 SaveResponseType - 将 通信模式 设置为 单向 - 将 “通信方向 ”设置为 “发送”

由于你将使用这些端口处理两个请求和响应消息，因此必须为每个端口创建两个操作，其中每个操作对应于一个消息类型。 若要创建操作，请右键单击端口形状，然后选择“ 新建操作”。 将每个端口的第一个操作命名为 ReadLOB ，将每个端口的第二个操作命名为 UpdateLOB。

使用相关性

相关是将传入消息与业务流程的相应实例相匹配的过程。 在业务流程中，将删除两个请求消息，每个重载一个。 使用关联，可将请求消息与正确的业务流程相关联。 有关相关性的详细信息，请参阅 在业务流程中使用相关性。

使用相关性

1. 从为每个操作生成的架构提升属性。 例如，从 ReadLOB 操作架构提升 LOB_COLUMN 属性;从 UpdateLOB 操作架构提升 FILTER 属性。 若要提升某个属性，请在架构视图中右键单击该属性，指向“ 升级”，然后选择“ 快速升级”。 这会将 PropertySchema.xsd 文件添加到 BizTalk 项目。

   有关提升属性的信息，请参阅 提升属性。

2. 在“业务流程视图”中，右键单击“ 相关类型”，然后选择“ 新建相关类型”。

3. “ 关联属性 ”对话框列出了在步骤 1 中升级的属性。 选择一个属性，然后单击“ 添加”。

4. 单击 “确定” 。

5. 若要为其他提升的属性创建相关类型，请重复这些步骤。

6. 根据关联类型关联的操作重命名相关类型。 可以将 ReadLOB 操作 ) 的相关类型重命名为CorrelationType_ReadLOB (，CorrelationType_UpdateLOB UpdateLOB 操作) (。

7. 在“业务流程视图”中，右键单击“ 相关集”，然后选择“ 新建相关集”。

8. 右键单击新添加的关联集，然后单击“ 属性”。 在 “属性 ”窗格中，执行以下操作：

   使用此选项	要执行此操作
   相关类型	Operate_LOB。CorrelationType_ReadLOB
   标识符	Correlation_ReadLOB

9. 添加另一个关联集，并从“属性”窗格中指定以下属性。

   使用此选项	要执行此操作
   相关类型	Operate_LOB。CorrelationType_UpdateLOB
   标识符	Correlation_UpdateLOB

指定操作形状的消息，并将其连接到端口

下表指定了应设置的属性及其值，以便为操作形状指定消息并将其链接到端口。 “形状”列中列出的名称是前面提到的业务流程中显示的消息形状的名称。

形状	属性
ReceiveMessage	- 将 初始化相关集 设置为 Correlation_ReadLOB - 将 “消息 ”设置为 “请求” - 将 操作 设置为 FileIn.ReadLOB.Request
SendMessage	- 将 “消息 ”设置为 “请求” - 将 操作 设置为 LOBPort.ReadLOB.Request
ReceiveResponse	- 将 消息 设置为 响应 - 将 操作 设置为 LOBPort.ReadLOB.Response
SendResponse	- 将 消息 设置为 响应 - 将 操作 设置为 SaveResponse.ReadLOB.Request
ReceiveMessage2	- 将 初始化相关集 设置为 Correlation_UpdateLOB - 将 消息 设置为 Request2 - 将 操作 设置为 FileIn.UpdateLOB.Request
SendMessage2	- 将 消息 设置为 Request2 - 将 操作 设置为 LOBPort.UpdateLOB.Request
ReceiveResponse2	- 将 Message 设置为 Response2 - 将 操作 设置为 LOBPort.UpdateLOB.Response
SendResponse2	- 将 消息 设置为 响应 - 将 操作 设置为 SaveResponse.UpdateLOB.Request

指定这些属性后，将连接消息形状和端口，并且业务流程已完成。

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

配置 BizTalk 应用程序

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

配置应用程序涉及：

• 为应用程序选择主机。

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

  • 在硬盘上定义一个位置和相应的文件端口，以便删除请求消息，每个消息用于 ReadLOB 和 UpdateLOB 操作。 BizTalk 业务流程将使用请求消息并将其发送到 Oracle 数据库。

  • 在硬盘上定义一个位置和相应的文件端口，BizTalk 业务流程将在其中删除响应消息，每个操作一个，其中包含来自 Oracle 数据库的响应。

  • 定义物理 WCF-Custom 或 WCF-OracleDB 发送端口以将消息发送到 Oracle 数据库。 还必须在发送端口中指定操作。 有关如何创建 WCF-Custom 或 WCF-OracleDB 端口的信息，请参阅 手动配置到 Oracle 数据库适配器的物理端口绑定。 由于 WCF-Custom 或 WCF-OracleDB 发送端口发送和接收符合多个架构的消息并执行两个操作，因此必须为这两个操作设置动态操作。 有关操作的详细信息，请参阅 为 Oracle 数据库配置 SOAP 操作。 对于此业务流程，应按如下所示设置操作：

    <BtsActionMapping xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
      <Operation Name="ReadLOB" Action="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/CUSTOMER/ReadLOB" />  
      <Operation Name="UpdateLOB" Action="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/CUSTOMER/UpdateLOB" />  
    </BtsActionMapping>  
    

    注意

    使用使用适配器服务 BizTalk 项目外接程序生成架构还会创建一个绑定文件，其中包含有关要为这些端口设置的端口和操作的信息。 可以从 BizTalk Server 管理控制台导入此绑定文件，为出站呼叫创建发送端口 () 或接收) 入站呼叫 (端口。 有关详细信息，请参阅 使用到 Oracle 数据库的端口绑定文件配置物理端口绑定。

启动应用程序

必须启动 BizTalk 应用程序才能对 Oracle 数据库执行操作。 有关启动 BizTalk 应用程序的说明，请参阅 如何启动业务流程。

在此阶段，请确保：

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

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

• WCF-Custom 发送端口或用于将消息发送到 Oracle 数据库的 WCF-OracleDB 正在运行。

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

执行操作

运行应用程序后，必须将请求消息删除到 FILE 接收位置。 请求消息的架构必须符合前面生成的操作的架构。 有关使用 Oracle 数据库适配器调用 LOB 数据类型操作的请求消息架构的详细信息，请参阅 特殊 LOB 操作 的消息架构。

业务流程使用请求消息并将其发送到 Oracle 数据库。 来自 Oracle 数据库的响应保存在定义为业务流程一部分的其他 FILE 位置。

对于此业务流程，我们首先删除 UpdateLOB 操作的请求消息，以更新 CUSTOMER 表的 BLOB 数据类型的 PHOTO 列 () 。 调用特定客户的更新 PHOTO 列的请求消息为：

<UpdateLOB xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/CUSTOMER">  
  <LOB_COLUMN>PHOTO</LOB_COLUMN>  
  <FILTER>Name='Mindy Martin'</FILTER>  
  <Stream>YWJjZA==</Stream>  
</UpdateLOB>  

注意

筛选器字符串必须始终提取一个匹配行，否则 Oracle 数据库适配器将引发 XmlReaderParsingException。 此外，Stream> 元素的值<必须是 base64Binary 类型。

UpdateLOB 操作的响应为：

<?xml version="1.0" encoding="utf-8"?>  
<UpdateLOBResponse xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/CUSTOMER"></UpdateLOBResponse>  

现在，我们删除 ReadLOB 操作的请求消息，以读取由 UpdateLOB 操作更新的数据。 针对特定客户的 PHOTO 列调用 ReadLOB 操作的请求消息为：

<ReadLOB xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/CUSTOMER">  
  <LOB_COLUMN>PHOTO</LOB_COLUMN>  
  <FILTER>NAME='Mindy Martin'</FILTER>  
</ReadLOB>  

注意

筛选器字符串必须始终提取一个匹配行。 如果有多个匹配行，则 Oracle 数据库适配器仅返回匹配) 行的第一个 (LOB 列。

ReadLOB 操作的响应为：

<?xml version="1.0" encoding="utf-8"?>  
<ReadLOBResponse mlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/CUSTOMER">  
  <ReadLOBResult>YWJjZA==</ReadLOBResult>  
</ReadLOBResponse>  

注意

ReadLOB 操作的响应可能无法针对 WSDL 进行验证。 必须执行某些任务才能针对 WSDL 验证 ReadLOB。 有关详细信息，请参阅 排查操作问题。

可能的异常

有关使用 BizTalk Server 对包含 LOB 数据的表执行操作时可能遇到的异常的信息，请参阅异常和错误处理。

最佳实践

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

另请参阅

使用 Oracle 数据库开发 BizTalk 应用程序的构建基块