使用此系统过程添加或删除 MobiLink 属性。此系统过程会更改 ml_property 系统表中的行。
ml_add_property ( 'comp_name', 'prop_set_name', 'prop_name', 'prop_value' )
语法 | 说明 |
---|---|
comp_name |
VARCHAR(128)。组件名。要按脚本版本保存属性,请将此参数设置为 ScriptVersion。对于 MobiLink 服务器属性,请将此参数设置为 MLS。对于服务器启动的同步属性,请将此参数设置为 SIS。 |
prop_set_name |
VARCHAR(128)。属性集名称。 如果组件名是 ScriptVersion,则此参数是脚本版本的名称。 如果组件名是 MLS,则此参数可以是 ml_user_log_verbosity(用于为 MobiLink 用户指定详细程度)、ml_remote_id_log_verbosity(用于为远程 ID 指定详细程度)或 locking_and_blocking_detection(用于向 MobiLink 分析器或 MobiLink 服务器日志文件报告锁定和阻塞信息)。 如果组件名是 SIS,则此参数是您设置的属性所属的通告程序、网关或运营公司的名称。 |
prop_name |
VARCHAR(128)。属性名称。 如果组件名是 ScriptVersion,则此参数是您定义的属性。可以使用 DBConnectionContext 来引用以下属性:getVersion 和 getProperties,或使用 ServerContext 引用以下属性:getPropertiesByVersion、getProperties 和 getPropertySetNames。 如果组件名是 MLS,则此属性可以是 MobiLink 用户名或定义的远程 ID,或者是用于向 MobiLink 分析器或 MobiLink 服务器日志文件报告锁定和阻塞信息的 blocking_threshold_in_seconds。 |
prop_value |
TEXT。属性值。 如果 prop_set_name 是 ml_user_log_verbosity 或 ml_remote_id_log_verbosity,则其必须是有效的 mlsrv -v 选项。 如果要向 MobiLink 分析器或 MobiLink 服务器日志文件报告锁定和阻塞信息,此值为 time_in_seconds。 如果是 Adaptive Server Enterprise,此参数为 VARCHAR(16384)。如果是 IBM DB2 LUW,此参数为 VARCHAR(4000)。如果是 Oracle,此参数为 CLOB。要删除属性,请设置为空。 |
MobiLink 服务器会检测运行时间大于某一特定时间(缺省值为 60 秒)的任何用户定义脚本,然后向 MobiLink 分析器报告锁定/阻塞信息,如果连接到 MobiLink 服务器,还会将该信息记录到 MobiLink 服务器日志文件中。
锁定/阻塞信息包括以下内容:
同步 ID
当前被阻塞的 MobiLink 服务器连接 ID
当前阻塞 MobiLink 服务器连接的连接 ID
总阻塞时间(以秒为单位)
服务器连接受阻塞所在对象或操作的名称
在统一数据库中执行以下 SQL 语句可更改缺省时间:
call ml_add_property( 'MLS', 'locking_and_blocking_detection', 'blocking_threshold_in_seconds', 'time_in_seconds' ); |
其中 time_in_seconds 是整数,用于指定阻塞阈值(以秒为单位)。当 time_in_seconds 为零时将禁用此功能。
这是一个静态属性。必须重新启动 MobiLink 服务器才能使新值生效。
可将 MobiLink 服务器设置为对目标 MobiLink 用户或远程 ID 使用不同的日志详细程度。MobiLink 服务器每五分钟检查一次 ml_property 表,为 MobiLink 用户或远程 ID 查找详细程度设置。如果存在详细程度设置,则 MobiLink 服务器将使用新设置为给定 MobiLink 用户或远程 ID 记录输出消息。这样您就可以查看特定用户或远程 ID 的详细信息而无需高详细程度设置(会对服务器群产生负面影响),且无需重新启动群中的每一台服务器。
要为目标 MobiLink 用户(如 ml_user1)设置最高详细程度,请登录统一数据库并执行以下 SQL 语句:
call ml_add_property( 'MLS', 'ml_user_log_verbosity', 'ml_user1', '-v+' ) |
要为目标远程 ID(如 rid_1)设置最高详细程度,请登录统一数据库并执行以下 SQL 语句:
call ml_add_property( 'MLS', 'ml_remote_id_log_versity', 'rid_1', '-v+' ) |
verbose_setting 必须为有效的 MobiLink 服务器 -v 选项。例如,用于记录行数据和未定义的表脚本时,verbose_setting 可以是 -vru 或 vru。5 分钟后,MobiLink 服务器将为 ml_user1 或 rid_1 使用此详细程度设置。 请参见-v mlsrv16 选项。
要禁用 MobiLink 用户的日志详细程度,请登录统一数据库并执行以下 SQL 语句:
call ml_add_property( 'MLS', 'ml_user_log_verbosity', 'ml_user1', NULL ) |
要禁用 MobiLink 远程 ID 的日志详细程度,请登录统一数据库并执行以下 SQL 语句:
call ml_add_property( 'MLS', 'ml_remote_id_log_verbosity', 'rid_1', NULL ) |
五分钟后,MobiLink 服务器将为 ml_user1 或 rid_1 停止使用先前的详细程度设置。
如果同时为给定 MobiLink 用户和远程 ID 设置了 ml_user_log_verbosity 和 ml_remote_id_log_verbosity,且如果同步过程中的 MobiLink 用户名和远程 ID 与给定的目标 MobiLink 用户和远程 ID 相同,则 MobiLink 服务器将使用 ml_remote_id_log_verbosity 设置记录输出消息。
如果是服务器启动的同步,使用 ml_add_property 系统过程可以为通告程序、网关和运营公司设置属性。
例如,为称作 x 的 SMTP 网关添加属性 server=mailserver1
,执行以下 SQL 语句:
ml_add_property( 'SIS','SMTP(x)','server','mailserver1' ); |
verbosity 属性适用于所有通告程序和网关,因此无法指定特定的属性集名称。要更改 verbosity 设置,请将属性集名称留空。例如:
ml_add_property( 'SIS','','verbosity',2 ); |
如果是常规 MobiLink 同步,可以使用此系统过程将属性与脚本版本关联起来。这种情况下,请将 component_name 设置为 ScriptVersion。可以指定任何属性,并可使用 Java 和 .NET 类来访问它们。
例如,要将 LDAP 服务器与名为 MyVersion 的脚本版本进行关联,请执行以下 SQL 语句:
ml_add_property( 'ScriptVersion','MyVersion','ldap-server','MyServer' ); |
![]() |
使用DocCommentXchange讨论此页。
|
版权 © 2013, SAP 股份公司或其关联公司. - SAP Sybase SQL Anywhere 16.0 |