“执行查询”活动
在运行时期间,执行查询活动运行 select SQL 语句。
执行查询活动支持参数化查询 - 包含输入或者输入和输出参数的查询。在查询中指定了输入参数时,在运行时会提供参数值。以下示例 select 语句中的 ? 字符指定存在一个输入参数:
select * from myUserSchema.mySourceTable where myUserSchema.mySourceTable.myColumn=?
在以上 select 语句中,* 字符指定查询将返回在 mySourceTable 表中找到的一个或多个列作为一个或多个输出参数。例如,如果 mySource 表包含两列(一列类型为 CHAR,另一列类型为 VARCHAR),那么执行查询活动返回两个输出参数(一个类型为 CHAR,另一个类型为 VARCHAR)。
注: 执行查询活动中仅支持 select SQL 语句。
insert SQL 语句在执行查询活动中不受支持。
下列过程中描述了向编排中添加和配置执行查询活动的步骤:
在编排中添加“执行查询”
- 创建或打开编排。这样会显示编排的图形表示。
- 选择活动选项卡并展开数据库文件夹。
- 将执行查询活动拖至编排上。
- 选择执行查询活动
创建、选择或编辑数据库端点
- 单击核对表中的选取端点任务,然后选择下列操作之一:
- 选择现有端点:
- 选择浏览。这样会打开 Project Explorer。
- 选择现有端点并单击确定。跳至指定查询 SQL 语句过程。
- 选择现有端点并编辑该端点:
- 选择浏览。这样会打开 Project Explorer。
- 选择现有端点并单击确定
- 单击编辑。这样会打开“编辑端点”窗格。
- 创建端点:选择新建。这样会打开“创建端点”窗格。
- 选择现有端点:
- 创建或编辑数据库端点
指定查询 SQL 语句
- 从核对表中选择输入查询任务。 这样会打开“输入查询”窗格。
- 在窗格中显示的空白区域内输入查询。请勿在查询结尾放置分号。
- 单击查看列以复审所选表的列详细信息,以通过输入有效的表名称和列来协助构建 SQL 语句。
- 如果所需编码不同于数据库的缺省编码,请使用下列选项之一为输入和输出参数选择备用字符编码设置:
- 从编码列表中选择其中一种缺省编码类型。
- 通过在编码字段中单击,然后输入编码类型,直接输入编码类型。
注: 一些双字节字符未使用 SHIFT-JIS 编码进行转换。有关更多信息,请参阅使用 Shift-JIS 编码。 - 单击验证查询。此操作检查查询是否有效,并且在映射输入和映射输出任务中填充输入和输出参数。
- 在 MaxRows 字段中输入值。MaxRows 字段指定在运行时期间要从查询中返回的最大行数。
注: 如果对相同数据多次启动了同一查询,那么会返回同一行集。例如,如果 MaxRows 等于 1,那么每次启动查询时总是会返回同一行(第一行)- 没有通过行集进行迭代。
配置查询的输入参数
- 从核对表中选择设置输入参数任务。“设置输入参数”窗格显示查询的一个或多个输入参数。
- 单击查看列以复审所选表的列详细信息,以通过输入有效的表名称和列来协助构建 SQL 语句。
- 在列标题中单击以按列值对行进行排序。例如,要按行的列名称对行进行排序,请单击列的列名称标题。在列标题名称右侧会显示一个箭头。向上箭头指示列按字母顺序(从 a 到 z)排序。 向下箭头指示列按反向字母顺序(从 z 到 a)排序。 单击箭头可逆转字母顺序。
- 如有必要,请为各查询输入参数更改数据类型、编码或可空值的设置。
单击字段以进行新选择:
- 参数名称 - 您可以将缺省名称更改为更有意义的名称。参数按其在查询中的指定顺序列出。
- 数据类型 - 选择此参数的数据类型。注: (针对 MONEY 和 XMLTYPE 数据类型)对于 Oracle 数据库中的 XMLTYPE 数据类型和 SQL Server 数据库中的 MONEY 数据类型,Studio 不会自动关联正确的数据类型,因此必须手动选择相应的数据类型。
- 编码 - 如果所需编码不同于数据库的缺省编码,请为参数选择备用字符编码设置。
- 大小 - 表中定义的列大小。此大小是从数据库表中检索到的并且不可配置。
- 单击重置值以查询数据库并从数据库中获取数据类型和大小。这可覆盖窗格中手动设置的数据类型和大小。
配置输出参数
- 从核对表中选择设置结果集任务。 这样会打开“设置结果集”窗格并且列出查询的一个或多个输出参数的缺省值。
- 单击查看列以复审所选表的列详细信息,以通过输入有效的表名称和列来协助构建 SQL 语句。
- 如有必要,请为各查询输出参数更改数据类型、编码或可空值的设置:
- 参数名称 - 您可以将缺省名称更改为更有意义的名称。参数按其在查询中的指定顺序列出。
- 数据类型 - 选择此参数的数据类型。
- 编码 - 如果所需编码不同于数据库的缺省编码,请为参数选择备用字符编码设置。
- 大小 - 表中定义的列大小。此大小是从数据库表中检索到的并且不可配置。
- 单击重置值以查询数据库并从数据库中获取数据类型和大小。这可覆盖窗格中手动设置的数据类型和大小。
指定查询的重试选项
要指定查询的重试选项:- 配置重试选项。注: 对于数据库执行查询活动,如果将重试选项设置为零,那么 Integration Appliance 将无限次地重试连接。
映射活动的输入
- 在核对表中选择映射输入任务。 为查询指定的输入参数是活动的输入参数。活动的输入参数显示在“至活动”窗格中的 parameters 元素下。
- 必须映射活动的所有输入参数。请参阅创建映射,以获取与映射有关的常规指示信息。
映射活动的输出
- 在核对表中选择映射输出任务。 select 语句返回的列是显示在“自活动”窗格中 rows/row 元素下的元素。
- 您无需映射活动的输出参数。 请参阅创建映射,以获取与映射有关的常规指示信息。