Ultra Light では、設定されている通信ストリーム (ネットワークプロトコル) で Mobile Link サーバーとの特定の接続を開始することで同期が開始されます。ネットワークに直接接続している場合の同期のサポートに加えて、Windows Mobile デバイスでは ActiveSync 同期もサポートされています。
接続の定義 同期動作の定義同期動作は、さまざまな同期パラメーターを設定することで制御できます。パラメーターの設定方法は、使用している Ultra Light インターフェイスによって異なります。
検討する必要がある重要な動作は、次のとおりです。
同期の方向 デフォルトでは、同期は双方向です。一方向だけの同期を行うには、upload_only パラメーターまたは download_only パラメーターを使用します。一方向の同期を実行することによって、同期に必要な時間を最小限に抑えることができます。また、ダウンロード専用同期では、Ultra Light データベースに対してあらかじめすべての変更をコミットする必要はありません。コミットしなかった変更は同期に含まれず、アップロードされません。したがって、不完全なトランザクションでも問題は起こりません。
ダウンロード専用同期を使用する場合は、ダウンロードと重なっているローがローカルレベルで変更されていないことを確認してください。ローカルレベルでデータが変更されていると、SQLE_DOWNLOAD_CONFLICT エラーによって、Ultra Light アプリケーションの同期は失敗します。
同期中の変更 アップロードフェーズでは、Ultra Light アプリケーションは、読み込み専用として Ultra Light データベースにアクセスできます。ダウンロードフェーズでは、読み込み／書き込みアクセスが許可されますが、アプリケーションがローを変更してからダウンロードによってこのローが変更されようとすると、ダウンロードが失敗し、ロールバックが行われます。DisableConcurrency 同期パラメーターを設定することで、同期中のデータへの同時アクセスを無効にすることができます。
♦ Ultra Light アプリケーションへの同期コードの追加同期情報の構造体のフィールドとして、セッションに必要な同期パラメーターとプロトコルオプションを指定します。
たとえば、C/C++ API を使用する場合は、ul_sync_info 構造体に適切な値を設定して、Ultra Light アプリケーションに同期を追加します。
ul_sync_info info;
// define a sync structure named "info"
ULEnableTcpipSynchronization( &sqlca );
// use a TCP/IP stream
conn->InitSynchInfo( &info );
// initialize the structure
info.stream = ULSocketStream();
// specify the Socket Stream
info.stream_parms= UL_TEXT( "host=myMLserver;port=2439" );
// set the MobiLink host information
info.version = UL_TEXT( "custdb 11.0" );
// set the MobiLink version information
info.user_name = UL_TEXT( "50" );
// set the MobiLink user name
info.download_only =ul_true;
// make the synchronization download-only |
同期を初期化します。
直接同期する場合は、API 固有の同期関数を呼び出します。これらの関数は、同期操作の成功または失敗を示すブール値を返します。同期が失敗した場合は、別の構造体で詳細なエラーステータスのフィールドを検証して、追加のエラー情報を取得できます。
ActiveSync 同期の場合は、ActiveSync プロバイダーからの同期メッセージを取得し、DoSync 関数を使用して ULSynchronize を呼び出す必要があります。
同期の進行状況をユーザーにレポートする場合は、observer コールバック関数を使用します。
DLL が非常に大きいか、ネットワーク接続の信頼性が低いため、DLL を正常に実行できない場合は、再開可能なダウンロードを実装できます。ダウンロードの失敗とダウンロードの失敗の再開を参照してください。
参照 |
DocCommentXchange で意見交換できます
|
Copyright © 2012, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.1 |