Alterar modos de feed no Azure Cosmos DB

O modo de versão mais recente fornece uma maneira fácil de processar alterações históricas e em tempo real para itens em um contêiner com a capacidade de voltar às alterações desde o início do contêiner.

Seguem-se cenários adequados a este modo:

• Migrações de um contêiner inteiro para um local secundário.

• Capacidade de reprocessar alterações desde o início do recipiente.

• Processamento em tempo real de alterações em itens em um contêiner resultantes de operações de criação e atualização.

• Cargas de trabalho que não precisam capturar exclusões ou alterações intermediárias entre leituras.

O modo de alimentação de alteração de todas as versões e exclusões permite novos cenários para o feed de alterações e simplifica outros. Você pode ler todas as alterações que ocorreram nos itens (mesmo nos casos em que várias alterações ocorreram entre as leituras do feed de alterações), identificar o tipo de operação das alterações que estão sendo processadas e obter as alterações resultantes de exclusões.

Alguns cenários comuns que este modo permite e melhora são:

• Transferência de dados em tempo real entre dois locais sem implementar uma exclusão suave.

• Lógica de acionamento com base em alterações incrementais se várias operações de alteração para um determinado item forem esperadas entre as pesquisas de alimentação de alterações.

• Disparar alertas em operações de exclusão, como em cenários de auditoria.

• A capacidade de processar itens cria, atualiza e exclui de forma diferente com base no tipo de operação.

• O feed de alterações inclui operações de inserção e atualização feitas em itens no contêiner.

• Este modo de alimentação de alterações não regista eliminações. Você pode capturar exclusões definindo um sinalizador de "exclusão suave" dentro de seus itens em vez de excluí-los diretamente. Por exemplo, você pode adicionar um atributo no item chamado deleted com o valor truee, em seguida, definir um tempo de vida (TTL) no item. O feed de alterações o captura como uma atualização e o item é excluído automaticamente quando o TTL expira. Como alternativa, você pode definir um período de expiração finito para seus itens usando o recurso TTL. Com esta solução, você tem que processar as alterações dentro de um intervalo de tempo mais curto do que o período de expiração TTL.

• Apenas a alteração mais recente para um item específico é incluída no feed de alterações. Alterações intermediárias podem não estar disponíveis.

• Quando um item é excluído, ele não está mais disponível no feed de alterações.

• As alterações podem ser sincronizadas a partir de qualquer ponto no tempo, e não há um período fixo de retenção de dados para o qual as alterações estejam disponíveis.

• Não é possível filtrar o feed de alterações para um tipo específico de operação. Uma alternativa possível é adicionar um "marcador suave" no item para atualizações e filtrar com base no marcador quando você processa itens no feed de alterações.

• O ponto de partida para ler o feed de alterações pode ser desde o início do contêiner, de um ponto no tempo, de "agora" ou de um ponto de verificação específico. A precisão do tempo de início é de aproximadamente cinco segundos.

• O feed de alterações inclui operações de inserção, atualização e exclusão feitas em itens dentro do contêiner. Exclusões de expirações TTL também são capturadas.

• Os metadados são fornecidos para determinar o tipo de alteração, incluindo se uma exclusão foi devida a uma expiração de TTL.

• Os itens de feed de alteração vêm na ordem de seu tempo de modificação. Não é garantido que as exclusões das expirações do TTL apareçam no feed imediatamente após a expiração do item. Eles aparecem quando o item é removido do contêiner.

• Todas as alterações que ocorreram na janela de retenção definida para backups contínuos na conta podem ser lidas. A tentativa de ler as alterações que ocorreram fora da janela de retenção resulta em um erro. Por exemplo, se o contêiner foi criado há oito dias e o período de retenção do período de backup contínuo é de sete dias, você só poderá ler as alterações dos últimos sete dias.

• O ponto de partida do feed de alterações pode ser a partir de "agora" ou de um ponto de verificação específico dentro do seu período de retenção. Não é possível ler as alterações desde o início do contêiner ou de um ponto específico no tempo usando esse modo.

Você pode usar as seguintes maneiras de consumir as alterações do feed de alterações no modo de versão mais recente:

Analisar o objeto de resposta

No modo de versão mais recente, o objeto de resposta padrão é uma matriz de itens que foram alterados. Cada item contém os metadados padrão para qualquer item do Azure Cosmos DB, incluindo _etag e _ts, com a adição de uma nova propriedade, _lsn.

O _etag formato é interno e você não deve depender dele, porque ele pode mudar a qualquer momento. _ts é uma modificação ou um carimbo de data e hora de criação. Você pode usar _ts para comparação cronológica. _lsn é um ID de lote que é adicionado apenas para o feed de alterações que representa o ID da transação. Muitos itens podem ter o mesmo _lsn.

ETag on FeedResponse é diferente do que _etag você vê no item. _etag é um identificador interno e é usado para controle de simultaneidade. A _etag propriedade representa a versão do item, enquanto a ETag propriedade é usada para sequenciar o feed.

Durante a visualização, os seguintes métodos para ler o feed de alterações estão disponíveis para cada SDK do cliente:

Começar agora

Para começar a usar todas as versões e excluir o modo de feed de alterações, inscreva-se na visualização por meio da página Recursos de visualização na página de visão geral da Assinatura do Azure. Procure o recurso AllVersionsAndDeletesChangeFeed e selecione Registrar.

Antes de enviar sua solicitação, verifique se você tem pelo menos uma conta do Azure Cosmos DB na assinatura. Essa conta pode ser uma conta existente ou uma nova conta que você criou para experimentar o recurso de visualização. Se você não tiver contas na assinatura quando a equipe do Azure Cosmos DB receber sua solicitação, a solicitação será recusada porque não há contas às quais aplicar o recurso.

A equipa do Azure Cosmos DB analisa o seu pedido e contacta-o por correio eletrónico para confirmar quais as contas do Azure Cosmos DB na subscrição que pretende inscrever na pré-visualização. Para usar a visualização, você deve ter backups contínuos configurados para sua conta do Azure Cosmos DB. Os backups contínuos podem ser habilitados antes ou depois de serem admitidos na visualização, mas os backups contínuos devem ser habilitados antes que você tente ler o feed de alterações em todas as versões e exclusões.

Analisar o objeto de resposta

O objeto de resposta é uma matriz de itens que representam cada alteração. A matriz se parece com o exemplo a seguir:

[
    {  
        "current": { 
            <The current version of the item that changed. All the properties of your item will appear here. This will be empty for delete operations.>
         },  
        "previous" : { 
            <The previous version of the item that changed. If the change was a delete operation, the item that was deleted will appear here. This will be empty for create and replace operations.>
         },  
        "metadata": {
            "lsn": <A number that represents the batch ID. Many items can have the same lsn.>, 
            "operationType": <The type of change, either 'create', 'replace', or 'delete'.>, 
            "previousImageLSN" : <A number that represents the batch ID of the change prior to this one.>, 
            "timeToLiveExpired" : <For delete changes, it will be 'true' if it was deleted due to a TTL expiration and 'false' if it wasn't.>, 
            "crts": <A number that represents the Conflict Resolved Timestamp. It has the same format as _ts.> 
        } 
    }
]

Limitações

• Com suporte para contas do Azure Cosmos DB para NoSQL. Não há suporte para outros tipos de conta do Azure Cosmos DB.

• Backups contínuos são necessários para usar esse modo de alimentação de alterações. As limitações do uso de backup contínuo podem ser encontradas na documentação.

• Não há suporte para a leitura de alterações em um contêiner que existiam antes de backups contínuos habilitados na conta.

• A capacidade de começar a ler o feed de alterações desde o início ou selecionar uma hora de início com base em um carimbo de data/hora passado não é suportada no momento. Você pode começar a partir de "agora" ou de uma concessão anterior ou token de continuação.

• Receber a versão anterior de itens que foram atualizados não está disponível no momento.

• Não há suporte para contas que habilitaram a mesclagem de partições.