第 4 课：添加同步脚本

本课假定您已完成前面的所有课程。请参见第 1 课：建立文本文件数据源。

在本课中，您将在统一数据库中添加脚本，以实现 SQL 行处理和直接行处理。

SQL 行处理可用于将远程数据与 MobiLink 统一数据库中的表同步。基于 SQL 的脚本可定义：

如何将从 MobiLink 客户端上载的数据应用到统一数据库。
应从统一数据库下载哪些数据。

将创建以下基于 SQL 的上载和下载事件：

upload_insert 此事件对插入客户端数据库的新订单如何应用到统一数据库进行定义。
download_cursor 此事件对应下载到远程客户端的订单进行定义。
download_delete_cursor 在使用非仅上载的同步脚本时，需要使用此事件。对于本教程，需将 MobiLink 服务器设置为忽略此事件。

可以使用存储过程通过直接行处理将同步脚本信息添加到 MobiLink 统一数据库中。在本课中，您将注册与 handle_UploadData、handle_DownloadData、end_download、download_cursor 和 download_delete_cursor 事件对应的方法名。在下一课中，您将创建自己的 Java 或 .NET 类。

♦ 将脚本添加至统一数据库以进行 SQL 行处理和直接行处理

如果尚未连接统一数据库，则运行以下命令通过 Interactive SQL 与之连接：
dbisql -c "DSN=mldirect_db"

使用 ml_add_table_script 存储过程为 upload_insert、download_cursor 和 download_delete_cursor 事件添加基于 SQL 的表脚本。

在 Interactive SQL 中执行以下 SQL 语句。upload_insert 脚本将上载的 order_id、product_id、quantity 和 order_status 插入到 MobiLink 统一数据库。download_cursor 脚本使用基于时间戳的过滤将更新的行下载到远程客户端。

CALL ml_add_table_script( 'default', 'RemoteOrders', 
    'upload_insert',
    'INSERT INTO RemoteOrders( order_id, product_id, quantity, order_status)
     VALUES( {ml r.order_id}, {ml r.product_id}, {ml r.quantity}, {ml r.order_status} )' );
   
CALL ml_add_table_script( 'default', 'RemoteOrders',
    'download_cursor',
    'SELECT order_id, product_id, quantity, order_status
     FROM RemoteOrders WHERE last_modified >= {ml s.last_table_download}');

CALL ml_add_table_script( 'default', 'RemoteOrders',
    'download_delete_cursor', '--{ml_ignore}');

COMMIT;

注册用于 end_download 事件的 Java 或 .NET 方法。

当 MobiLink 服务器运行 end_download 连接事件时，使用此方法释放内存资源。

对于 Java，在 Interactive SQL 中执行以下语句：

CALL ml_add_java_connection_script( 'default',
    'end_download',
    'MobiLinkOrders.EndDownload' );

对于 .NET，在 Interactive SQL 中执行以下语句：

CALL ml_add_dnet_connection_script( 'default',
    'end_download',
    'MobiLinkOrders.EndDownload' );

Interactive SQL 注册用于 end_download 事件的用户定义的 EndDownload 方法。

注册用于 handle_UploadData 和 handle_DownloadData 事件的 Java 或 .NET 方法。

对于 Java，在 Interactive SQL 中执行以下语句：

CALL ml_add_java_connection_script( 'default', 
    'handle_UploadData',
    'MobiLinkOrders.GetUpload' );
   
CALL ml_add_java_connection_script( 'default',
    'handle_DownloadData',
    'MobiLinkOrders.SetDownload' );

对于 .NET，在 Interactive SQL 中执行以下语句：

CALL ml_add_dnet_connection_script( 'default', 
    'handle_UploadData',
    'MobiLinkOrders.GetUpload' );
   
CALL ml_add_dnet_connection_script( 'default',
    'handle_DownloadData',
    'MobiLinkOrders.SetDownload' );

Interactive SQL 分别注册用于 handle_UploadData 和 handle_DownloadData 事件的用户定义的 GetUpload 和 SetDownload 方法。在后续课程中，将创建这些方法。

在 Interactive SQL 中执行以下语句：

CALL ml_add_table_script( 'default', 'OrderComments',
    'download_cursor', '--{ml_ignore}');

CALL ml_add_table_script( 'default', 'OrderComments',
    'download_delete_cursor', '--{ml_ignore}');

使用脚本时，download_cursor 和 download_delete_cursor 事件必须进行注册才能用于 OrderComments 表，因为同步是双向同步，而不是仅上载同步。请参见必需的脚本。

提交所做的更改。

在 Interactive SQL 中执行以下语句：
COMMIT;
关闭 Interactive SQL。
前进至第 5 课：创建 Java 或 .NET 类以实现 MobiLink 直接行处理。

另请参见

使用DocCommentXchange讨论此页。