Amazon Cognito Streams - 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á.

Amazon Cognito Streams

Se você for novo com o Amazon Cognito Sync, use o AWS AppSync. Como o Amazon Cognito Sync, o AWS AppSync é um serviço para sincronizar dados de aplicações 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 fluxo do Kinesis no qual será realizada a publicação e uma função do IAM que concede ao Amazon Cognito permissão para colocar eventos no fluxo 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 (Publicar função), selecione a função do IAM que concede ao Amazon Cognito permissão para publicar seu fluxo. Clique em Create role (Criar função) para criar ou modificar as funções associadas ao grupo de identidades no console do AWS IAM.

  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 que o tamanho máximo de carga útil de 1 MB do Kinesis, o Amazon Cognito incluirá um URL pré-assinado do Amazon S3 com o conteúdo completo 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, por meio do console ou diretamente por meio da API, o Amazon Cognito começará a publicar esses dados no mesmo fluxo que está recebendo as 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.