pmrep 命令引用 > MassUpdate
  

MassUpdate

更新一组满足指定条件的会话的会话属性。 可以更新文件夹或会话列表中的所有会话。 要更新会话列表,请创建一个持久性输入文件。 此列表可以包含特定会话列表,也可以包含诸如名称模式或属性值等条件。 使用 ExecuteQuery 生成一个持久性输入文件。
运行 MassUpdate 时,您可以查看文件夹名称、已成功更新或失败的会话数以及已更新的会话名称等信息。 可以在命令行窗口或此命令生成的日志文件中查看更新的状态。 运行此命令时,应指定日志文件的名称和路径。 默认情况下,此日志文件存储在运行此命令的目录中。
当 PowerCenter 版本更改了某个默认值时,可使用 MassUpdate 在多个会话中更新会话属性。
在更新会话之前,还可以在测试模式下运行 MassUpdate 来查看这些更改。 要查看日志文件示例,请参阅日志文件示例
MassUpdate 命令使用以下语法:
pmrep massupdate

-t <session_property_type (session_property, session_config_property, transformation_instance_attribute, session_instance_runtime_option)>

-n <session_property_name>

-v <session_property_value>

[-w <transformation_type>]

{-i <persistent_input_file> | -f <folder_name> }

[-o <condition_operator (equal, unequal, less, greater)>]

[-l <condition_value>]

[-g <update_session_instance_flag>]

[-m <test_mode>]

[-u <output_log_file_name>]
下表介绍了 pmrep MassUpdate 选项和参数:
选项
参数
说明
-t
session_property_type
必需。 要更新的会话属性类型。 会话属性为以下类型:
  • - session_property
  • - session_config_property
  • - transformation_instance_attribute
  • - session_instance_runtime_option
-n
session_property_name
必需。 要更新的特征或属性的名称。
-v
session_property_value
必需。 要分配给属性的值,后跟分号。
例如,要为属性分配值,请使用以下语法:-v "IgnoreNULLInExpressionComparison=Yes;"
注: 将会话属性值两侧加上双引号。
-w
transformation_type
如果要更新转换实例属性,则为必需选项。 要更新的转换类型。 可以更新以下转换类型:aggregator、joiner、lookup procedure、rank、sorter、source definition 和 target definition。
-i
persistent_input_file
未使用 -f 选项时,为必需选项。 包含要更新的选定会话列表的文件的名称。 可以使用 pmrep ExecuteQuery 命令来运行查询并生成此文件。 如果指定的对象不是会话,MassUpdate 将返回错误。 必须使用 -i 选项或 -f 选项,但不能同时使用二者。
-f
folder_name
未使用 -i 选项时,为必需选项。 文件夹的名称。 用于更新文件夹中的所有会话。 必须使用 -i 选项或 -f 选项,但不能同时使用二者。
-o
condition_operator
如果使用 condition_value,则为必需选项。 定义会话集的条件的组成部分。
满足条件时,将更新会话或会话实例的属性。
可以使用以下条件运算符来更新字符串:等号或不等号。
可以使用以下条件运算符来更新整数:等号、不等号、小于号或大于号。
-l
condition_value
如果使用条件运算符,则为必需选项。 条件的组成部分。 条件按以下形式显示:
<session_property_value> <condition operator> <condition_value>
-g
update_session_instance_flag
如果更新会话实例运行时选项,则为必需选项。
对于以下会话属性类型为可选选项:会话属性、会话配置属性和转换实例属性。
更新会话实例。
如果一个会话实例替代了某个属性,可以更新此会话实例中的该属性。
-m
test_mode
可选。 以测试模式运行 MassUpdate。 在提交更改之前查看将受此命令影响的会话。 可以在命令行窗口中查看以下详细信息:
  • - 会话名称
  • - 会话类型:可重用或不可重用
  • - 该会话属性的当前值
  • - 具有相同的属性值且不受此命令影响的会话。
-u
output_log_file_name
可选。 存储更新状态和会话或会话实例基本信息的日志文件的名称。 以前的属性值也将写入此文件中。 如果不使用此选项,详细信息将显示在命令行窗口中。
MassUpdate 命令返回“massupdate 已成功完成 (massupdate successfully completed)”或“无法执行 massupdate (failed to execute massupdate)”消息。 由于下列原因,更新可能失败:

会话属性类型

运行 MassUpdate 时,指定会话属性类型和名称。 请指定以下会话属性类型:
下表列出了可更新的会话属性和会话属性类型:
会话属性
会话属性类型
源连接值($S)
session_property
目标连接值($T)
session_property
用于查找缓存创建的其他并发管道
session_config_property
汇总器数据缓存大小
transformation_instance_attribute
transformation_type 参数必须为汇总器。
汇总器索引缓存大小
transformation_instance_attribute
transformation_type 参数必须为汇总器。
允许临时序列下推
session_property
允许临时视图下推
session_property
缓存目录
transformation_instance_attribute
transformation_type 参数必须为汇总器、联接器或等级。
缓存 LOOKUP() 函数
session_config_property
收集性能数据
session_property
提交间隔
session_property
提交类型
session_property
基于约束的加载顺序
session_config_property
自定义属性
session_config_property
日期时间格式字符串
session_config_property
默认缓冲区块大小
session_config_property
禁用此任务
session_instance_runtime_option
DTM 缓冲区大小
session_property
启用高精度
session_property
启用测试负载
session_property
如果任务不运行,则父项会失败
session_instance_runtime_option
如果此任务失败,父项也会失败
session_instance_runtime_option
增量汇总
session_property
是否启用
session_config_property
Java 类路径
session_property
联接器数据缓存大小
transformation_instance_attribute
transformation_type 参数必须为联接器。
联接器索引缓存大小
transformation_instance_attribute
transformation_type 参数必须为联接器。
换行缓冲区长度
session_config_property
查找缓存目录名称
transformation_instance_attribute
transformation_type 参数必须为查找过程。
查找数据缓存大小
transformation_instance_attribute
transformation_type 参数必须为查找过程。
查找索引缓存大小
transformation_instance_attribute
transformation_type 参数必须为查找过程。
自动内存属性允许使用的内存上限
session_config_property
自动内存属性允许使用的总内存百分比上限
session_config_property
关于 SQL 错误前后处理
session_config_property
关于会话前命令任务错误
session_config_property
关于存储过程错误
session_config_property
输出文件目录
transformation_instance_attribute
transformation_type 参数必须为目标定义。
替代跟踪
session_config_property
参数文件名
session_property
Pre-85 时间戳兼容性
session_config_property
预构建查找缓存
session_config_property
下推优化
session_property
等级数据缓存大小
transformation_instance_attribute
transformation_type 参数必须为等级。
等级索引缓存大小
transformation_instance_attribute
transformation_type 参数必须为等级。
恢复策略
session_property
拒绝文件目录
transformation_instance_attribute
transformation_type 参数必须为目标定义。
出错时回滚事务
session_property
保存会话日志依据
session_config_property
会话日志文件目录
session_property
死锁时重试会话
session_property
会话排序顺序
session_property
集成服务在 Unicode 模式下运行时,可以选择会话中字符数据的排序顺序。 可为排序顺序配置以下值:
  • - 0. BINARY
  • - 2. SPANISH
  • - 3. TRADITIONAL_SPANISH
  • - 4. DANISH
  • - 5. SWEDISH
  • - 6. FINNISH
排序器缓存大小
transformation_instance_attribute
transformation_type 参数必须为排序器。
源文件目录
transformation_instance_attribute
transformation_type 参数必须为源定义。
出错时停止
session_config_property
将源行视为
session_property
将输入链接视为 AND
session_instance_runtime_option
写入向后兼容的会话日志文件
session_property

MassUpdate 的规则和标准

运行 MassUpdate 时,请遵守以下规则和标准:

日志文件示例

以下文本显示一个由 pmrep MassUpdate 生成的示例日志文件:
cases_auto,s_test_ff,reusable,0
s_test_ff was successfully checked out.

------------------------------------------------------------------------------
11/10/2008 11:12:55 ** Saving... Repository test_ver_MU, Folder cases_auto
------------------------------------------------------------------------------
Session s_test_ff updated.
Checking-in saved objects...done
------------------------------------------------------------------------------

cases_auto,wf_non_reusable_test_ff.s_test_ff_non_reusable,non-reusable,0
wf_non_reusable_test_ff was successfully checked out.

------------------------------------------------------------------------------
11/10/2008 11:12:57 ** Saving... Repository test_ver_MU, Folder cases_auto
------------------------------------------------------------------------------
Validating the flow semantics of Workflow wf_non_reusable_test_ff...
...flow semantics validation completed with no errors.

Validating tasks of Workflow wf_non_reusable_test_ff...
...Workflow wf_non_reusable_test_ff tasks validation completed with no errors.

Workflow wf_non_reusable_test_ff updated.
Checking-in saved objects...done
------------------------------------------------------------------------------

Massupdate Summary:
Number of reusable sessions that are successfully updated: 1.
Number of non-reusable sessions that are successfully updated: 1.
Number of session instances that are successfully updated: 0.
Number of reusable sessions that fail to be updated: 0.
Number of non-reusable sessions that fail to be updated: 0.
Number of session instances that fail to be updated: 0.
------------------------------------------------------------------------------