Implementazione dei flussi di Amazon Cognito Sync - Amazon Cognito

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Implementazione dei flussi di Amazon Cognito Sync

Se non hai mai usato Amazon Cognito Sync, utilizza AWS AppSync. Come Amazon Cognito Sync, AWS AppSync è un servizio per la sincronizzazione dei dati delle applicazioni tra dispositivi.

Consente di sincronizzare i dati dell'utente come le preferenze dell'app o lo stato del gioco. Inoltre estende queste funzionalità consentendo a più utenti di sincronizzare e collaborare in tempo reale su dati condivisi.

Amazon Cognito Streams offre agli sviluppatori il controllo e l'analisi dei loro dati archiviati in Amazon Cognito. Gli sviluppatori possono ora configurare un flusso Kinesis per ricevere eventi non appena i dati sono aggiornati e sincronizzati. Amazon Cognito può eseguire il push di ogni modifica del set di dati in un flusso Kinesis in tempo reale.

Utilizzando Amazon Cognito Streams, puoi spostare tutti i tuoi dati di Sync in Kinesis, che possono quindi essere distribuiti in uno strumento data warehouse come Amazon Redshift per un'ulteriore analisi. Per ulteriori informazioni su Kinesis, consulta Nozioni di base per l'uso di Amazon Kinesis.

Configurazione dei flussi

Puoi configurare Amazon Cognito Streams nella console Amazon Cognito. Per abilitare Amazon Cognito Streams nella console Amazon Cognito, devi selezionare lo stream Kinesis su cui pubblicare e un ruolo che IAM conceda ad Amazon Cognito l'autorizzazione a inserire eventi nello stream selezionato.

Dalla home page della console:

  1. Fai clic sul nome del pool di identità per cui desideri configurare Amazon Cognito Streams. Viene visualizzata la pagina Dashboard (Pannello di controllo) per il tuo pool di identità.

  2. Nell'angolo in alto a destra della pagina Dashboard (Pannello di controllo), fai clic su Manage Identity Pools (Gestisci pool di identità). Viene visualizzata la pagina di gestione delle identità federate.

  3. Scorri verso il basso e fai clic su Cognito Streams (Flussi di Cognito) per espandere l'operazione.

  4. Nel menu a discesa Stream name (Nome del flusso), seleziona il nome di un flusso Kinesis esistente. In alternativa, fai clic su Create stream (Crea flusso) per crearne uno, immettendo un nome di flusso e il numero di shard. Per ulteriori informazioni sugli shard e per valutare il numero di shard di cui hai bisogno per il tuo flusso, consulta la Guida per gli sviluppatori di Kinesis.

  5. Nel menu a discesa Ruolo di pubblicazione, seleziona il IAM ruolo che concede ad Amazon Cognito l'autorizzazione a pubblicare il tuo stream. Fai clic su Crea ruolo per creare o modificare i ruoli associati al tuo pool di identità nella Console.AWS IAM

  6. Nel menu a discesa Stream status (Stato del flusso) seleziona Enabled (Abilitato) per abilitare gli aggiornamenti del flusso. Fai clic su Save Changes (Salva modifiche).

Dopo che hai configurato correttamente i flussi di Amazon Cognito, tutti i successivi aggiornamenti ai set di dati in questo pool di identità saranno inviati al flusso.

Contenuti del flusso

Ogni record inviato al flusso rappresenta una singola sincronizzazione. Ecco l'esempio di un record inviato al flusso:

{
    "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
}

Per gli aggiornamenti che superano la dimensione massima del payload Kinesis di 1 MB, Amazon Cognito include un Amazon S3 URL predefinito che contiene il contenuto completo dell'aggiornamento.

Dopo aver configurato i flussi di Amazon Cognito, se elimini il flusso Kinesis o modifichi l'autorizzazione di attendibilità del ruolo in modo che non possa più essere assunto da Amazon Cognito Sync, disabiliterai i flussi di Amazon Cognito. Devi creare nuovamente il flusso Kinesis o correggere il ruolo e quindi riattivare il flusso.

Pubblicazione in blocco

Una volta che hai configurato i flussi di Amazon Cognito potrai eseguire un'operazione di pubblicazione in blocco per i dati esistenti nel tuo pool di identità. Dopo aver avviato un'operazione di pubblicazione in blocco, tramite la console o direttamente tramiteAPI, Amazon Cognito inizierà a pubblicare questi dati nello stesso flusso che riceve gli aggiornamenti.

Amazon Cognito non garantisce l'univocità dei dati inviati al flusso quando si utilizza l'operazione di pubblicazione in blocco. Potresti ricevere lo stesso aggiornamento sia come un aggiornamento, sia come parte di una pubblicazione in blocco. Tieni presente questa possibilità durante l'elaborazione del record proveniente dal tuo flusso.

Per pubblicare in blocco tutti i tuoi flussi, segui i passaggi 1-6 della sezione di configurazione dei flussi e quindi fai clic su Start bulk publish (Inizia la pubblicazione in blocco). Hai un limite per un'operazione di pubblicazione in blocco in corso in qualsiasi momento e per una richiesta di pubblicazione in blocco riuscita ogni 24 ore.