Amazon-Cognito-Streams - Amazon Cognito

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon-Cognito-Streams

Wenn Amazon Cognito Sync für Sie neu ist, verwenden Sie zuerst AWS AppSync. Wie Amazon Cognito Sync ist AWS AppSync ein Service zum Synchronisieren von Anwendungsdaten zwischen verschiedenen Geräten.

Es ermöglicht Benutzerdaten wie App-Einstellungen oder Spielstatus synchronisiert werden. Darüber hinaus erweitert es diese Möglichkeiten, indem mehrere Benutzer gemeinsam genutzte Daten synchronisieren und diese in Echtzeit zusammen nutzen können.

Amazon-Cognito-Streams bietet Entwicklern Kontrolle und einen detaillierten Überblick über ihre in Amazon Cognito gespeicherten Daten. Entwickler können einen Kinesis-Stream für den Empfang von Ereignissen konfigurieren, sobald Daten aktualisiert und synchronisiert werden. Amazon Cognito kann jede Datensatzänderung per Push in Echtzeit an einen Kinesis-Stream in Ihrem Besitz übertragen.

Mit Amazon-Cognito-Streams können Sie alle Ihre Synchronisierungsdaten auf Kinesis verschieben, wo sie anschließend auf ein Data-Warehouse-Tool wie Amazon Redshift zur weiteren Analyse gestreamt werden können. Weitere Informationen zu Kinesis finden Sie unter Erste Schritte mit Amazon Kinesis.

Konfigurieren von Streams

Sie können Amazon-Cognito-Streams in der Amazon-Cognito-Konsole einrichten. Zum Aktivieren von Amazon-Cognito-Streams müssen Sie in der Amazon-Cognito-Konsole den Kinesis-Stream für die Veröffentlichung sowie eine IAM-Rolle auswählen, der Amazon Cognito die Berechtigung erteilt, Ereignisse in den ausgewählten Stream zu schreiben.

Auf der Startseite der Konsole:

  1. Klicken Sie auf den Namen des Identitätspools, für den Sie Amazon-Cognito-Streams einrichten möchten. Die Seite Dashboard für Ihren Identitäten-Pool wird angezeigt.

  2. Klicken Sie in der rechten oberen Ecke der Seite Dashboard auf Edit identity pool (Identitäten-Pool bearbeiten). Die Seite Manage Federated Identities wird angezeigt.

  3. Scrollen Sie nach unten und wählen Sie Cognito Streams, um diesen zu erweitern.

  4. Wählen Sie im Dropdown-Menü Stream name (Stream-Name) den Namen eines vorhandenen Kinesis-Streams aus. Alternativ klicken Sie auf Create stream (Stream erstellen), um ihn zu erstellen. Geben Sie dazu einen Stream-Namen und die Anzahl der Shards ein. Weitere Informationen zu Shards und Hilfe zum Schätzen der Anzahl der Shards, die für Ihren Stream erforderlich sind, finden Sie im Kinesis-Entwicklerhandbuch.

  5. Wählen Sie im Dropdown-Menü Rolle veröffentlichen die IAM-Rolle aus, die Ihnen die Amazon-Cognito-Berechtigung gewährt, Streams zu veröffentlichen. Klicken Sie auf Rolle erstellen, um Rollen zu erstellen oder zu ändern, die Ihrem Identitäten-Pool in der AWS-IAM-Konsole zugeordnet sind.

  6. Wählen Sie im Dropdown-Menü Stream status (Stream-Status) die Option Enabled (Aktiviert), um Stream-Aktualisierungen zu ermöglichen. Klicken Sie auf Save Changes (Änderungen speichern).

Nachdem Sie erfolgreich Amazon-Cognito-Streams konfiguriert haben, werden alle nachfolgenden Aktualisierungen an den Datensätzen in diesem Identitätspool an den Stream gesendet.

Stream-Inhalte

Jeder Datensatz, der an den Stream gesendet wird, stellt eine einzelne Synchronisierung dar. Hier finden Sie ein Beispiel für einen Datensatz, der an den Stream gesendet wurde:

{
    "identityPoolId": "Pool Id",
    "identityId": "Identity Id",
    "dataSetName": "Dataset Name",
    "operation": "(replace|remove)",
    "kinesisSyncRecords": [
        {
            "key": "Key",
            "value": "Value",
            "syncCount": 1,
            "lastModifiedDate": 1424801824343,
            "deviceLastModifiedDate": 1424801824343,
            "op": "(replace|remove)"
        },
        ...
    ],
    "lastModifiedDate": 1424801824343,
    "kinesisSyncRecordsURL": "S3Url",
    "payloadType": "(S3Url|Inline)",
    "syncCount": 1
}

Für Updates, die größer als die maximale Kinesis-Nutzlastgröße von 1 MB sind, schließt Amazon Cognito eine vorsignierte Amazon-S3-URL ein, die den vollständigen Inhalt der Aktualisierung enthält.

Nachdem Sie Amazon-Cognito-Streams konfiguriert haben, deaktivieren Sie Amazon-Cognito-Streams, wenn Sie den Kinesis-Stream löschen oder die Rollenvertrauensberechtigung ändern, sodass die Rolle nicht mehr von Amazon Cognito Sync übernommen werden kann. Sie müssen den Kinesis-Stream entweder neu erstellen oder die Rolle reparieren und anschließend den Stream erneut aktivieren.

Massen-Veröffentlichung

Sobald Sie Amazon-Cognito-Streams konfiguriert haben, können Sie eine Massen-Veröffentlichung der vorhandenen Daten in Ihrem Identitätspool ausführen. Nachdem Sie eine Massen-Veröffentlichungsoperation entweder über die Konsole oder direkt über die API initiiert haben, beginnt Amazon Cognito mit der Veröffentlichung dieser Daten auf demselben Stream, auf dem Sie Ihre Updates erhalten.

Amazon Cognito garantiert nicht die Eindeutigkeit der Daten, die bei Verwendung der Massen-Veröffentlichungsoperation an den Stream gesendet werden. Sie können die gleiche Aktualisierung sowohl als Update als auch als Teil einer Massen-Veröffentlichung erhalten. Beachten Sie dies beim Verarbeiten der Datensätze aus Ihrem Stream.

Um alle Ihre Streams als Teil einer Massen-Veröffentlichung zu veröffentlichen, führen Sie die Schritte 1 bis 6 unter "Configuring Streams" aus, und klicken Sie dann auf "Massen-Veröffentlichung starten". Sie sind auf eine laufende Massen-Veröffentlichungsoperation zu einem bestimmten Zeitpunkt und eine erfolgreiche Massen-Veröffentlichungsanfrage alle 24 Stunden beschränkt.