Implementação de streams do Amazon Cognito Sync - Amazon Cognito

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Implementação de streams do Amazon Cognito Sync

Se você for novo com o Amazon Cognito Sync, use o AWS AppSync. Assim como o Amazon Cognito Sync, AWS AppSync é um serviço para sincronizar dados de aplicativos entre dispositivos.

Ele permite que dados do usuário, como preferências de aplicações ou estado de jogos, sejam sincronizados. Ele também amplia essas capacidades ao permitir que vários usuários sincronizem e colaborem em tempo real com dados compartilhados.

O Amazon Cognito Streams oferece aos desenvolvedores controle e insight sobre os dados armazenados no Amazon Cognito. Agora, os desenvolvedores podem configurar um fluxo do Kinesis para receber eventos à medida que os dados forem atualizados e sincronizados. O Amazon Cognito pode enviar cada alteração de conjunto de dados a um fluxo do Kinesis de sua propriedade em tempo real.

Usando o Amazon Cognito Streams, você pode mover todos os dados de sincronização para o Kinesis, que poderão, em seguida, ser transmitidos para uma ferramenta de data warehouse, como o Amazon Redshift, para análise posterior. Para saber mais sobre o Kinesis, consulte Conceitos básicos do uso do Amazon Kinesis.

Como configurar transmissões

Você pode configurar o Amazon Cognito Streams no console do Amazon Cognito. Para habilitar o Amazon Cognito Streams no console do Amazon Cognito, você precisa selecionar o stream do Kinesis para publicar e uma função que IAM conceda ao Amazon Cognito permissão para colocar eventos no stream selecionado.

Na página inicial do console:

  1. Clique no nome do grupo de identidades para o qual você deseja configurar o Amazon Cognito Streams. A página Dashboard (Painel) do grupo de identidades será exibida.

  2. No canto superior direito da página Dashboard (Painel), clique em Manage Identity Pools (Gerenciar grupos de identidades). A página Manage Federated Identities (Gerenciar identidades federadas) é exibida.

  3. Role para baixo e clique em Cognito Streams para expandi-lo.

  4. No menu suspenso Stream name, selecione o nome de um fluxo existente do Kinesis. Se desejar, clique em Create stream para criar um fluxo, informando um nome de fluxo e o número de estilhaços. Para saber mais sobre fragmentos e para obter ajuda sobre como estimar o número de fragmentos necessários para seu fluxo, consulte o Guia do desenvolvedor do Kinesis.

  5. No menu suspenso Publish role, selecione a IAM função que concede permissão ao Amazon Cognito para publicar seu stream. Clique em Criar função para criar ou modificar as funções associadas ao seu grupo de identidades no AWS IAMconsole.

  6. No menu suspenso Stream status, selecione Enabled para habilitar as atualizações de fluxo. Clique em Salvar alterações

Depois que você tiver configurado com êxito os fluxos do Amazon Cognito, todas as atualizações subsequentes dos conjuntos de dados nesse grupo de identidades serão enviadas ao fluxo.

Conteúdo de transmissão

Cada registro enviado ao fluxo representa uma única sincronização. Este é um exemplo de um registro enviado ao fluxo:

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

Para atualizações maiores do que o tamanho máximo de carga útil do Kinesis de 1 MB, o Amazon Cognito inclui um Amazon S3 pré-assinado que contém o conteúdo completo URL da atualização.

Depois de configurar fluxos do Amazon Cognito, se você excluir o fluxo do Kinesis ou alterar a permissão de confiança de função para que não possa mais ser presumida pelo Amazon Cognito Sync, os fluxos do Amazon Cognito serão desabilitados. Você deve recriar o fluxo do Kinesis ou corrigir a função e, depois, ativar o fluxo novamente.

Publicação em massa

Após ter configurado os fluxos do Amazon Cognito, você poderá executar uma operação de publicação em massa dos dados existentes no grupo de identidades. Depois de iniciar uma operação de publicação em massa, pelo console ou diretamente peloAPI, o Amazon Cognito começará a publicar esses dados no mesmo stream que está recebendo suas atualizações.

O Amazon Cognito não garante a exclusividade dos dados enviados ao fluxo durante o uso da operação de publicação em massa. Você pode receber a mesma atualização como uma atualização e como parte de uma publicação em massa. Mantenha isso em mente ao processar os registros do seu fluxo.

Para realizar uma publicação em massa de todos os fluxos, siga as etapas de 1 a 6 em Configuração de fluxos e clique em Start bulk publish. Você está limitado a uma operação de publicação em massa contínua a qualquer momento e a uma solicitação de publicação em massa bem-sucedida a cada 24 horas.