Erros do Sync

Este erro indica que a query do cliente é inválida ou está malformada. Esse erro inclui uma mensagem que fornece detalhes sobre o motivo pelo qual a query é inválida.

Para se recuperar desse erro, talvez seja necessário verificar se a sintaxe da query está correta e se você está usando operadores de query compatíveis com o servidor. Além disso, confirme que você está executando query em um campo consultável em sua configuração de Flexible Sync. Se sua query usa um campo consultável indexado, certifique-se de que ele atenda aos requisitos de queries válidas do lado do cliente para campos consultáveis indexados.

Este erro indica que a query que está sendo usada excedeu o limite de tamanho de 256 kB.

Para recuperar deste erro, reestruture sua query para garantir que os dados na sua query estejam dentro do limite de tamanho aceitável.

Esse erro indica que as permissões do servidor para a identificação do arquivo foram alteradas desde a última vez em que ele foi usado.

Esse erro desencadeia a redefinição de um cliente. Para recuperar deste erro, execute uma redefinição de cliente.

Esse erro indica que o cliente tentou abrir uma sessão antes de a sincronização inicial ser concluída. Isso pode ocorrer quando o aplicativo acabou de habilitar a sincronização e ainda está em processo de criação do histórico de sincronização.

O cliente tenta se reconectar até que este processo seja concluído. Depois, o erro é resolvido e a sincronização começa a funcionar normalmente.

Esse erro não fatal ocorre quando um cliente tenta escrever "ilegal". Os itens a seguir são considerados gravações ilegais:

• Criando um objeto antes de abrir uma assinatura.

• Criando um objeto que estaria fora da visualização de query do cliente. "Visualização de query" inclui as assinaturas do cliente e as permissões de leitura do cliente.

• Modificar um objeto que está fora da visualização de query do cliente.

• Criar, excluir ou modificar um objeto ou campo para o qual o cliente não tem permissões de gravação.

• Modificar um objeto de forma que o cliente não tenha mais permissões de escrita nesse objeto ou campo após a escrita.

• Atualizando o valor do campo de query indexado de um objeto existente.

Como o realm local não tem nenhum conceito de escrita "ilegal", a escrita sempre terá sucesso em nível local. Após a sincronização, o servidor notará a escrita ilegal. Depois, o servidor desfaz a alteração. A operação de desfazer, chamada de "escrita compensatória", é sincronizada novamente com o cliente para que o realm do cliente não tenha mais a escrita ilegal. O servidor também envia esse erro para que o cliente saiba o que aconteceu.

Qualquer escrita local em um determinado objeto entre uma escrita ilegal nesse objeto e a escrita compensatória correspondente será perdida.

obj1.fieldA = 10 // illegal due to field-level permissions
obj1.fieldB = 5 // legal
DELETE obj1 // legal
DELETE obj2 // legal

A gravação ilegal aparece no applog como um erro não fatal. Escreve ilegalmente pode indicar que o código da sua aplicação está a fazer algo que não pretendia.

Nos seguintes casos, você verá ErrorWriteNotAllowed em vez de ErrorCompensatingWrite após uma escrita "ilegal":

• Ao usar versões antigas do SDK vinculadas a uma versão realm-core anterior ao realm-core 12.1.0. Nesse caso, o servidor não irá desfazer a gravação ilegal, e será necessário executar um reinício do cliente manual.

• Ao modificar um objeto em uma collection com a ingestão de dados habilitada. Nesse caso, o erro não é fatal e não aciona o reinício do cliente. O servidor ignora a alteração ilegal e não a aplica ao cluster MongoDB sincronizado.