Azure Service Fabric の Reliable Collections のガイドラインと推奨事項

このセクションでは、Reliable State Manager および Reliable Collection を使用するためのガイドラインを提供します。 目標は、ユーザーがよくある問題を回避できるようにすることです。

リライアブル コレクション ガイドライン

ガイドラインは、してください検討してください避けてください、およびしないでくださいの言葉を使った簡単な推奨事項として編成されています。

  • 読み取り操作 (TryPeekAsyncTryGetValueAsync など) によって返されるカスタム型のオブジェクトを変更しないでください。 Reliable Collection は、同時実行コレクションのように、コピーではなくオブジェクトへの参照を返すからです。
  • 返されたカスタム型のオブジェクトは、変更する前に詳細コピーしてください。 構造体と組み込み型は値渡しであるため、変更対象の参照型フィールドまたはプロパティが含まれない限り、詳細コピーを実行する必要はありません。
  • TimeSpan.MaxValue をタイムアウトに使用しないでください。 タイムアウトはデッドロックの検出に使用してください。
  • コミット、中止、または破棄された後に、トランザクションを使用しないでください。
  • 作成済みのトランザクション スコープの外部で、列挙型を使用しないでください。
  • デッドロックを引き起こす可能性があるため、別のトランザクションの using ステートメント内にトランザクションを作成しないでください。
  • IReliableStateManager.GetOrAddAsync を使用して信頼性の高い状態を作成し、それを同じトランザクション内で使用しないようにしてください。 そのようにすると、InvalidOperationException が発生します。
  • IComparable<TKey> の実装が正しいことを確認してください。 システムでは、チェックポイントと行を結合するため、IComparable<TKey> の依存関係を取得します。
  • ある種のデッドロックを防ぐために、更新目的で項目を読み取る場合は更新ロックを使用してください。
  • パーティションごとの Reliable Collection の数を 1000 未満に保つように考慮してください。 項目が少ない多数の Reliable Collection りも、項目が多い Reliable Collection を選んでください。
  • 項目 (Reliable Dictionary の TKey + TValue など) を 80 KB 未満に保つように考慮してください。小さいほど良いです。 これにより、大きなオブジェクト ヒープの使用量だけでなく、ディスクとネットワークの IO 要件が軽減されます。 多くの場合、値のごく一部だけが更新されるときの重複データのレプリケートが軽減されます。 Reliable Dictionary でこれを実現する一般的な方法は、行を複数行に分けることです。
  • 障害復旧を行うには、バックアップと復元の機能の使用を検討します。
  • 1 つのエンティティ操作と複数のエンティティ操作 (例: GetCountAsyncCreateEnumerableAsync) は分離レベルが異なるため、同じトランザクション内に混在させないでください。
  • InvalidOperationException を処理します。 ユーザー トランザクションは、さまざまな理由でシステムによって中止されることがあります。 たとえば、Reliable State Manager がプライマリからロールを変更する場合や、実行時間の長いトランザクションがトランザクション ログの切り詰めをブロックしている場合などです。 このような場合、ユーザーは、トランザクションが既に終了されたことを示す InvalidOperationException を受け取る可能性があります。 ユーザーが要求したトランザクション終了ではない場合、この例外を処理する最善の方法は、トランザクションを破棄し、キャンセル トークンが通知されたかどうか (または、レプリカのロールが変更されたかどうか) を確認して、そうではない場合は新しいトランザクションを作成して再試行することです。
  • トランザクション内で並列操作または同時実行操作を適用しないでください。 トランザクション内でサポートされるユーザー スレッド操作は 1 つだけです。 これらの操作を適用すると、メモリ リークとロックの問題が発生します。
  • コミットが完了したら、できるだけ早くトランザクションを破棄することを検討してください (特に ConcurrentQueue を使用している場合)。
  • トランザクション内でブロック コードを実行しないでください。
  • string がリライアブル ディクショナリのキーとして使用されている場合、並べ替え順序では、既定の文字列比較演算子 CurrentCulture が使用されます。 CurrentCulture の並べ替え順序は、序数文字列比較演算子とは異なることに注意してください。
  • コミット トランザクションの破棄または取り消しはしないでください。 これはサポートされておらず、ホスト プロセスがクラッシュする可能性があります。

次の点に注意してください。

  • すべての Reliable Collection API の既定のタイムアウトは 4 秒です。 ほとんどのユーザーは、既定のタイムアウトを使用する必要があります。
  • すべての Reliable Collection API で、既定のキャンセル トークンは CancellationToken.None です。
  • Reliable Dictionary のキー タイプ パラメーター (TKey) では、GetHashCode()Equals() が正しく実装されている必要があります。 キーは不変である必要があります。
  • Reliable Collection で高可用性を実現するには、各サービスに少なくとも 1 つのターゲットと、最低 3 台で構成されるレプリカ セットが必要です。
  • セカンダリの読み取り操作では、クォーラムのコミットをしていないバージョンを読み取ることがあります。 つまり、1 つのセカンダリから読み取られるデータのバージョンが、誤って進められる可能性があります。 プライマリからの読み取りは常に安定しており、誤って進められることはありません。
  • リライアブル コレクションでアプリケーションによって保持されるデータのセキュリティ/プライバシーは、お客様の決定であり、ストレージ管理によって提供される保護の対象です。つまり、オペレーティング システムのディスク暗号化を使用して、保存データを保護できます。
  • ReliableDictionary 列挙型では、キー順に並べ替えられたデータ構造が使用されます。 列挙型を効率的なものにするために、コミットは一時ハッシュテーブルに追加された後、並べ替えられたメインのデータ構造のポスト チェックポイントに移動します。 キーの存在について検証チェックが行われる場合、追加/更新/削除には、O(1) の最良の場合のランタイム、および O (log n) の最悪の場合のランタイムがあります。 取得は、最新のコミットから読み取るか、古いコミットから読み取るかに応じて、O (1) または O (log n) のいずれかになります。

揮発性のリライアブル コレクションの追加ガイドライン

揮発性の Reliable Collection を使用する場合は、次の点を考慮してください。

  • ReliableDictionary では揮発性がサポートされます
  • ReliableQueue では揮発性がサポートされます
  • ReliableConcurrentQueue では揮発性がサポートされません
  • 永続化されたサービスを揮発性にすることはできません。 HasPersistedState フラグを false に変更するには、サービス全体を最初から再作成する必要があります
  • 揮発性サービスを永続化することはできません。 HasPersistedState フラグを true に変更するには、サービス全体を最初から再作成する必要があります
  • HasPersistedState はサービス レベルの構成です。これはすべてのコレクションが永続化または揮発性となることを意味します。 揮発性コレクションと永続化されたコレクションを混在させることはできません
  • 揮発性パーティションのクォーラム損失により、データが完全に失われます
  • 揮発性サービスでは、バックアップと復元は利用できません

次のステップ