Freigeben über


Synchronisierung von Offlinedaten in Azure Mobile Apps

Was ist die Synchronisierung von Offlinedaten?

Die Synchronisierung von Offlinedaten ist ein Client- und SDK-Feature von Azure Mobile Apps, die Entwicklern das Erstellen von Apps erleichtert, die ohne Netzwerkverbindung funktionsfähig sind.

Wenn sich Ihre App im Offlinemodus befindet, können Benutzer weiterhin Daten erstellen und ändern. Diese Daten werden in einem lokalen Speicher gespeichert. Wenn die App wieder online ist, können sie lokale Änderungen mit dem Azure Mobile App-Back-End synchronisieren. Das Feature unterstützt auch das Erkennen von Konflikten, wenn auf dem Client und dem Back-End der gleiche Datensatz geändert wird. Konflikte können dann entweder auf dem Server oder vom Client verarbeitet werden.

Die Offlinesynchronisierung hat mehrere Vorteile:

  • Verbesserte Reaktionsfähigkeit der App durch das lokale Caching von Serverdaten auf dem Gerät
  • Erstellen stabiler Apps, die auch bei Netzwerkproblemen funktionstüchtig bleiben
  • Endbenutzer können Daten auch ohne Netzwerkzugriff erstellen und ändern – also in Szenarien mit schlechter oder fehlender Konnektivität.
  • Daten auf mehreren Geräten synchronisieren und Konflikte erkennen, wenn derselbe Datensatz von zwei Geräte aus geändert wird
  • Das Beschränken der Netzwerknutzung bei Netzwerken mit hoher Latenz oder getakteten Netzwerken

Die folgenden Lernprogramme zeigen, wie Sie die Offlinesynchronisierung zu Ihren mobilen Clients mithilfe von Azure Mobile Apps hinzufügen können:

Was ist eine Synchronisierungstabelle?

Um auf den "/tables"-Endpunkt zuzugreifen, stellen Azure Mobile-Client-SDKs Schnittstellen bereit, z. B. IMobileServiceTable (.NET-Client-SDK) oder MSTable (iOS-Client). Diese APIs stellen eine direkte Verbindung mit dem Azure Mobile App-Back-End her, und es tritt ein Fehler auf, wenn das Clientgerät über keine Netzwerkverbindung verfügt.

Zur Unterstützung der Offlinenutzung sollte Ihre App stattdessen die Synchronisierungstabellen-APIs verwenden, z. B. IMobileServiceSyncTable (.NET-Client-SDK) oder MSSyncTable (iOS-Client). Die gleichen CRUD-Vorgänge (Create, Read, Update, Delete; Erstellen, Lesen, Aktualisieren, Löschen) können für Synchronisierungstabellen-APIs verwendet werden – mit dem Unterschied, dass sie jetzt einen lokalen Speicher lesen oder in diesen schreiben. Bevor Synchronisierungtabellenvorgänge durchgeführt werden können, muss der lokale Speicher initialisiert werden.

Was ist ein lokaler Speicher?

Ein lokaler Speicher ist die Datenpersistenzebene auf dem Clientgerät. Die Client-SDKs von Azure Mobile Apps bieten eine Standardimplementierung für den lokalen Speicher. Unter Windows, Xamarin und Android basiert sie auf SQLite. Unter iOS basiert sie auf Core Data.

Um die SQLite-basierte Implementierung für Windows Phone oder den Microsoft Store verwenden zu können, müssen Sie eine SQLite-Erweiterung installieren. Weitere Informationen finden Sie unter Universelle Windows-Plattform: Aktivieren der Offlinesynchronisierung. Im Lieferumfang von Android und iOS ist im Betriebssystem selbst eine Version von SQLite enthalten, weshalb es nicht notwendig ist, auf eine eigene Version von SQLite zu verweisen.

Entwickler können auch ihren eigenen lokalen Speicher implementieren. Wenn Sie Daten in einem verschlüsselten Format auf dem mobilen Client speichern möchten, können Sie z. B. einen lokalen Speicher definieren, der SQLCipher für die Verschlüsselung verwendet.

Was ist ein Synchronisierungskontext?

Ein Synchronisierungskontext ist einem mobilen Clientobjekt zugeordnet (z. B. IMobileServiceClient oder MSClient) und verfolgt die Änderungen, die mithilfe von Synchronisierungstabellen vorgenommen werden. Der Synchronisierungskontext verwaltet eine Vorgangswarteschlange mit einer sortierten Liste mit CUD-Vorgängen (Create, Update, Delete; Erstellen, Aktualisieren und Löschen), die später an den Server gesendet wird.

Ein lokaler Speicher wird mithilfe einer Initialisierungsmethode wie IMobileServicesSyncContext.InitializeAsync(localstore) im .NET Client SDKdem Synchronisierungskontext zugeordnet.

So funktioniert die Offlinesynchronisierung

Beim Synchronisieren von Tabellen steuert der Clientcode, wann lokale Änderungen mit einem Azure Mobile App-Back-End synchronisiert werden sollen. Nichts wird an das Back-End gesendet, bis ein Aufruf für einen Pushvorgang für lokale Änderungen erfolgt. Auf ähnliche Weise wird der lokale Speicher nur dann mit neuen Daten aufgefüllt, wenn ein Aufruf für einen Pullvorgang von Daten erfolgt.

  • Push: Ein Pushvorgang ist ein Vorgang im Synchronisierungskontext, bei dem alle CUD-Änderungen seit dem letzten Pushvorgang gesendet werden. Beachten Sie, dass es nicht möglich ist, nur die Änderungen einer einzelnen Tabelle zu senden, da andernfalls Vorgänge außerhalb der Reihenfolge gesendet werden könnten. Ein Pushvorgang führt eine Reihe von REST-Aufrufen an Ihr Azure Mobile App-Back-End durch, das wiederum die Serverdatenbank ändert.

  • Pull: Ein Pullvorgang wird pro Tabelle ausgeführt und kann mit einer Abfrage so angepasst werden, dass nur eine Teilmenge der Serverdaten abgerufen wird. Die Azure Mobile-Client-SDKs legen dann die resultierenden Daten im lokalen Speicher ab.

  • Implizite Pushvorgänge: Wenn ein Pullvorgang für eine Tabelle mit ausstehenden lokalen Updates ausgeführt wird, führt der Pullvorgang zunächst einen Vorgang vom Typ push() für den Synchronisierungskontext aus. Dieser Pushvorgang minimiert Konflikte zwischen Änderungen, die sich bereits in der Warteschlange befinden, und den neuen Daten vom Server.

  • Inkrementelle Synchronisierung: der erste Parameter für den Pullvorgang ist ein Abfragename , der nur auf dem Client verwendet wird. Wenn Sie einen nicht leeren Abfragenamen verwenden, führt das Azure Mobile SDK eine inkrementelle Synchronisierung durch. Jedes Mal, wenn ein Pullvorgang einen Satz von Ergebnissen zurückgibt, wird der neueste updatedAt-Zeitstempel aus der Ergebnismenge in den lokalen SDK-Systemtabellen gespeichert. Nachfolgende Pullvorgänge rufen nur Datensätze nach dem jeweiligen Zeitstempel ab.

    Um die inkrementelle Synchronisierung verwenden zu können, muss Ihr Server sinnvolle updatedAt-Werte zurückgeben und das Sortieren nach diesem Feld unterstützen. Da das SDK jedoch eine eigene Sortierung auf das Feld "UpdatedAt" hinzufügt, können Sie keine Pullabfrage nutzen, die über eine eigene orderBy -Klausel verfügt.

    Der Name der Abfrage kann eine beliebige Zeichenfolge sein, muss aber für jede logische Abfrage in Ihrer App eindeutig sein. Andernfalls könnten unterschiedliche Pullvorgänge den gleichen Zeitstempel für die inkrementelle Synchronisierung überschreiben, sodass Ihre Abfragen falsche Ergebnisse zurückgeben.

    Wenn die Abfrage einen Parameter aufweist, ist das Integrieren des Parameterwerts eine Möglichkeit zum Erstellen eindeutiger Abfragenamen. Wenn Sie beispielsweise nach der Benutzer-ID filtern, könnte Ihr eindeutiger Abfragename so aussehen (in C#):

      await todoTable.PullAsync("todoItems" + userid,
          syncTable.Where(u => u.UserId == userid));
    

    Wenn Sie die inkrementelle Synchronisierung deaktivieren möchten, übergeben Sie null als Abfrage-ID. In diesem Fall werden bei jedem Aufruf von PullAsync alle Datensätze abgerufen, was möglicherweise ineffizient ist.

  • Löschen: Sie können den Inhalt des lokalen Speichers mit IMobileServiceSyncTable.PurgeAsync löschen. Das Löschen kann erforderlich sein, wenn die Clientdatenbank veraltete Daten enthält oder Sie alle ausstehenden Änderungen verwerfen möchten.

    Beim Löschen wird eine Tabelle aus dem lokalen Speicher entfernt. Sollten Vorgänge vorhanden sein, für die eine Synchronisierung mit der Datenbank aussteht, löst das Löschen eine Ausnahme aus, sofern nicht der Parameter force purge festgelegt ist.

    Als Beispiel für veraltete Daten auf dem Client nehmen wir an, dass im Beispiel "todo list" Gerät 1 nur Elemente abruft, die nicht abgeschlossen sind. Das todo-Element „Milch kaufen“ wurde auf dem Server von einem anderen Gerät als abgeschlossen markiert. Allerdings verfügt Gerät 1 im lokalen Speicher weiterhin über das todo-Element „Milch kaufen“, da es nur Elemente abruft, die nicht als abgeschlossen markiert sind. Dieses veraltete Element wird durch eine Löschung entfernt.

Nächste Schritte