同期エラー

このエラーは、クライアント クエリが無効または不正であることを示します。 このエラーには、クエリが無効な理由に関する詳細を示す メッセージが含まれます。

このエラーから回復するには、クエリ構文が正しいこと、およびサーバーでサポートされているクエリ演算子を使用していることを確認する必要がある場合があります。 さらに、Flexible Sync 構成内のクエリ可能なフィールドをクエリしていることを確認してください。 クエリでインデックス付きのクエリ可能なフィールドを使用する場合は、インデックス付きのクエリ可能なフィールドに対する有効なクライアント側クエリの要件を満たしていることを確認してください。

このエラーは、使用されているクエリが256 kB のサイズ制限を超えたことを示しています。

このエラーから回復するには、クエリを再構成して、クエリ内のデータが許容サイズ内に収まるようにします。

このエラーは、ファイル識別子に対するサーバー権限が最後に使用された以降に変更されたことを示しています。

このエラーはクライアントのリセットをトリガーします。 このエラーから回復するには、クライアント リセットを実行します。

このエラーは、最初の同期が完了する前にクライアントがセッションを開始しようとしたことを示しています。 これは、アプリが同期を有効にしたばかりで、まだ同期履歴を作成しているプロセスにある場合に発生することがあります。

このプロセスが完了するまで、クライアントは再接続を試みます。 その後、このエラーは解決され、同期は正常に動作するようになります。

この致命的でないエラーは、クライアントが「不正」な書込みを試みた場合に発生します。 以下は、不正な書込みと見なされます。

• サブスクリプションを開く前に オブジェクトを作成します。

• クライアントのクエリ ビューの外部にあるオブジェクトを作成します。 「クエリ ビュー」には、クライアントのサブスクライブとクライアントの読み取り権限の両方が含まれます。

• クライアントのクエリ ビューの外部にあるオブジェクトを変更している。

• クライアントが書込み (write) 権限を持たないオブジェクトまたはフィールドを作成、削除、または変更します。

• 書き込み後にクライアントがそのオブジェクトまたはフィールドに対する書込み権限を持たなくなるようにオブジェクトを変更すると、

• 既存のオブジェクトのインデックス付きクエリ可能なフィールド値を更新

ローカル Realm には「不正」書込みの概念が存在しないため、書込みは常にローカルで成功します。 同期時に、サーバーは不正な書き込みに注意します。 その後、サーバーは変更を元に戻します。 "Composing Write"と呼ばれる元に戻す操作は、クライアントに同期することで、クライアントの Realm で不正な書込み (write) が行われなくなります。 サーバーはこのエラーを送信して、クライアントに何が発生したかを通知します。

特定のオブジェクトへの不正な書込み (write) と、それに対応する書込み (write) の間にある特定のオブジェクトへのローカル書込み (write) は、いずれもなくなります。

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

不正な書込みは、アプリログに致命的でないエラーとして表示されます。 不正な書き込みは、アプリケーション コードが意図しないことを実行していることを示している場合があります。

次の場合、「ErrorWriteNotAllowed ErrorCompensatingWritenull」書込み後に ではなく が表示されます。

• Realm Core 12.1.0 より前の Realm Core バージョンにリンクされている古い SDK バージョンを使用している場合。 この場合、サーバーは不正な書き込みを元に戻し ない ため、クライアントを手動でリセットする必要があります。

• Data Ingestが有効になっているコレクション内のオブジェクトを変更する場合。 この場合、エラーは致命的なものではなく、クライアントのリセットはtriggerされません。 サーバーは不正な変更をスキップし、同期された MongoDB クラスターには適用しません。