Synchronisationseinrichtung für Ihre UltraLite-Anwendung

Jede entfernte UltraLite-Datenbank synchronisiert mit einem MobiLink-Server über ein Netzwerkprotokoll. Das Netzwerkprotokoll wird mit dem Parameter für den Synchronisationsdatenstrom eingestellt. Als Netzwerkprotokolle werden TCP/IP, HTTP, HTTPS und TLS unterstützt. Für das gewählte Protokoll müssen Sie auch Datenstromparameter übergeben, die andere erforderliche Verbindungsinformationen wie z.B. Host und Port des MobiLink-Servers definieren. Sie müssen auch MobiLink- Benutzerdaten und die Synchronisationsskriptversion angeben.

Sie können das Synchronisationsverhalten steuern, indem Sie diverse Synchronisationsparameter einstellen. Wie die Parameter gesetzt werden, hängt von der jeweils verwendeten UltraLite-Schnittstelle ab.

Beachten Sie folgende wichtige Elemente des Synchronisationsverhaltens:

Synchronisationsrichtung Standardmäßig wird eine Zwei-Wege-Synchronisation ausgeführt. Wenn Sie nur Einweg-Synchronisationen benötigen, müssen Sie die entsprechenden Parameter upload_only oder download_only verwenden. Mithilfe von Einweg-Synchronisationen können Sie die Zeit für Synchronisationen reduzieren. Außerdem müssen Sie bei reinen Download-Synchronisationen vor der Synchronisation nicht alle Änderungen der UltraLite-Datenbank festschreiben. Nicht festgeschriebene Änderungen von Tabellen, die nicht synchronisiert werden, verursachen durch die unvollständigen Transaktionen keine Probleme, da für sie kein Upload erfolgt.
Bei der reinen Download-Synchronisation müssen Sie sicher stellen, dass die Zeilen, die mit dem Download überlappen, nicht lokal geändert werden. Wenn Daten lokal geändert werden, schlägt die Synchronisation in der UltraLite-Anwendung fehl, und es kommt zu einem SQLE_DOWNLOAD_CONFLICT-Fehler.
Parallele Änderungen während der Synchronisation Während der Upload-Phase haben UltraLite-Anwendungen nur Lesezugriff auf UltraLite-Datenbanken. Während der Download-Phase ist der Lese- und Schreibzugriff erlaubt. Wenn eine Anwendung eine Zeile ändert, die anschließend auch vom Download geändert werden soll, schlägt der Download jedoch fehl und wird zurückgesetzt. Diesen parallelen Datenzugriff während der Synchronisation können Sie deaktivieren, indem Sie den Synchronisationsparameter Disable_Concurrency verwenden.

Die folgende Vorgehensweise wird üblicherweise verwendet, um Ihrer Anwendung Synchronisationsfunktionen hinzuzufügen:

Übergeben Sie die für die Sitzung notwendigen Synchronisationsparameter und Protokolloptionen als Felder einer Synchronisationsinformationsstruktur.

Beispiel: Mit der UltraLite C/C++-API können Sie einer Ihrer Anwendungen Synchronisationsfunktionen hinzufügen, indem Sie die geeigneten Werte in der ul_sync_info-Struktur einstellen:

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

Initialisieren Sie die Synchronisation.

Für eine direkte Synchronisation rufen Sie eine API-spezifische Synchronisationsmethode auf. Diese Methoden geben einen booleschen Wert zurück, der Erfolg oder Fehlschlag des Synchronisationsvorgangs bekanntgibt. Wenn die Synchronisation fehlschlägt, können Sie detaillierte Fehlerstatusfelder in einer anderen Struktur prüfen, um zusätzliche Informationen zur Fehlerbedingung zu erhalten.

Bei der ActiveSync-Synchronisation müssen Sie die Synchronisationsnachricht vom ActiveSync-Provider abfangen und die DoSync-Methode benutzen, um die ULSynchronize-Methode aufzurufen.
Benutzen Sie eine Beobachter-Callbackfunktion, um den Fortschritt der Synchronisation an den Benutzer zu melden.

Tipp

Wenn Sie eine Umgebung verwenden, in der DLLs fehlschlagen, weil die DLL sehr groß oder die Netzwerkverbindung nicht zuverlässig ist, können Sie wiederaufnehmbare Downloads einrichten. Siehe Fehlgeschlagene Downloads und Wiederaufnahme fehlgeschlagener Downloads.

ActiveSync mit UltraLite unter Windows Mobile
Reine Upload- und reine Download-Synchronisation
Upload und Download
UltraLite-Synchronisationsparameter
UltraLite-Netzwerkprotokolloptionen für dbmlsync
UltraLite.NET: MobiLink-Datensynchronisation
UltraLite C/C++: MobiLink-Datensynchronisation
UltraLite C/C++: ActiveSync-Synchronisation einrichten
UltraLite für Embedded SQL: Synchronisation für eine Embedded SQL-Anwendung einrichten
UltraLiteJ-API: MobiLink-Datensynchronisation

Synchronisationseinrichtung für Ihre UltraLite-Anwendung

Verbindung definieren

Synchronisationsverhalten definieren

Tipp

Siehe auch