MobiLink 同步配置文件

同步配置文件允许您将某些 dbmlsync 选项放置在数据库中。您创建的同步配置文件可以包含各种同步选项。

可使用以下语句创建、更改和删除同步配置文件：

可以通过以下方式访问同步配置文件：dbmlsync -sp 选项、Dbmlsync API 中的 Sync 方法、SQL SYNCHRONIZE 语句，以及通过远程数据库的管理中心创建的远程任务。任何情况下都能够指定与同步配置文件中的选项合并的附加选项。如果指定的任何额外选项与同步配置文件中指定的选项冲突，则会使用由额外选项指定的值。

使用 dbmlsync -sp 选项时，命令行上的所有其它选项均会被视为额外选项。其它接口提供了用于指定额外选项的特定参数或子句。

有关在 UltraLite 中使用同步配置文件的信息，请参见同步配置文件选项。

可在同步配置文件中指定以下选项：

长选项名	简称	允许值	说明
AuthParms	ap	字符串	将参数提供给 authenticate_parameters 脚本和验证参数。请参见AuthParms 同步配置文件选项。
ApplyDnldFile	ba	字符串	应用一个下载文件。请参见ApplyDnldFile 同步配置文件选项。
Background	bk	字符串	设置为 TRUE 时启用后台同步。请参见Background 同步配置文件选项。
BackgroundRetry	bkr	整数	控制后台同步被中断后 dbmlsync 的行为方式。请参见BackgroundRetry 同步配置文件选项。
ContinueDownload	dc	布尔值	重新启动以前执行失败的下载。请参见ContinueDownload 同步配置文件选项。
CreateDnldFile	bc	字符串	创建一个下载文件。请参见CreateDnldFile 同步配置文件选项。
DnldFileExtra	be	字符串	创建下载文件时，此选项用于指定要包含在文件中的额外字符串。请参见DnldFileExtra 同步配置文件选项。
DownloadOnly	ds	布尔值	执行仅下载同步。请参见DownloadOnly 同步配置文件选项。
DownloadReadSize	drs	整数	对于可重新启动的下载，指定发生通信故障后需要重新发送的最大数据量。请参见DownloadReadSize 同步配置文件选项。
ExtOpt	e	字符串	指定扩展选项。请参见ExtOpt 同步配置文件选项。
IgnoreHookErrors	eh	布尔值	忽略挂接函数中出现的错误。请参见IgnoreHookErrors 同步配置文件选项。
IgnoreScheduling	is	布尔值	忽略调度指令，以便立即进行同步。请参见IgnoreScheduling 同步配置文件选项。
KillConnections	d	布尔值	删除对远程数据库的冲突锁定。请参见KillConnections 同步配置文件选项。
LogRenameSize	x	后跟 K 或 M 的一个整数。	在扫描事务日志获取上载数据后，重命名并重新启动该事务日志。请参见LogRenameSize 同步配置文件选项。
MobiLinkPwd	mp	字符串	提供 MobiLink 用户的口令。请参见MobiLinkPwd 同步配置文件选项。
MLUser	u	字符串	指定 MobiLink 用户名。请参见MLUser 同步配置文件选项（不建议使用）。
NewMobiLinkPwd	mn	字符串	为 MobiLink 用户提供新口令。在想要更改现有口令时，可使用此选项。请参见NewMobiLinkPwd 同步配置文件选项。
Ping	pi	布尔值	强制 MobiLink 服务器回应，以确认客户端与 MobiLink 之间的通信。请参见Ping 同步配置文件选项。
Publication	n	字符串	不建议使用此选项。指定要同步的发布。在同步配置文件中，发布只能指定一次，但可以多次指定命令行选项。请参见发布同步配置文件选项（不建议使用）。
RemoteProgressGreater	ra	布尔值	指定远程偏移大于统一偏移时，使用远程偏移。此选项等同于 -ra 选项。请参见RemoteProgressGreater 同步配置文件选项。
RemoteProgressLess	rb	布尔值	指定远程偏移小于统一偏移时（例如，通过备份恢复远程数据库时），使用远程偏移。此选项等同于 -rb 选项。请参见RemoteProgressLess 同步配置文件选项。
Subscription	s	字符串	指定要同步的预订。在一个同步配置文件中只能指定一次预订。请参见Subscription 同步配置文件选项。
TransactionalUpload	tu	布尔值	指定远程数据库上的每个事务都应在一次同步中作为一个单独的事务上载。请参见TransactionalUpload 同步配置文件选项。
UpdateGenNum	bg	布尔值	创建下载文件时，此选项可创建能用于尚未同步的远程数据库的文件。请参见UpdateGenNum 同步配置文件选项。
UploadOnly	uo	布尔值	指定同步仅包含上载，不进行任何下载。请参见UploadOnly 同步配置文件选项。
UploadRowCnt	urc	整数	指定同步过程中估计要上载的行数。请参见UploadRowCnt 同步配置文件选项。
Verbosity		字符串（用逗号分隔的选项列表）	控制 dbmlsync 详细程度。与Verbosity 同步配置文件选项类似。其值必须为下列其中一个或多个选项的用逗号分隔的列表，每个选项对应于一个现有 -v 选项，如下所述： BASIC - 等同于 -v HIGH - 等同于 -v+ CONNECT_STR - 等同于 -vc ROW_CNT - 等同于 -vn OPTIONS - 等同于 -vo ML_PASSWORD - 等同于 -vp ROW_DATA - 等同于 -vr

使用DocCommentXchange讨论此页。