Redisプロバイダー設定リファレンス

アクセスキー

accessKey属性をRedisキャッシュのプライマリまたはセカンダリーアクセスキーで設定します。

accessKey="STKNJnBR9/DGaNoOATadRu/RY3PFFEZ7Xshk8B5NjNc="

applicationName

applicationName属性をprivateに設定し、同じRedisプロバイダーでホストする場合、プライベートセッションストアと共有セッションステートストアのデータを別々にshared設定します。デフォルト値は空なので、異なるシステムパラメータに基づいて値を生成Sitecoreします。

applicationName="private"

圧縮

compression属性をtrueに設定してセッションステートデータの圧縮を有効にします。セッションステートデータを圧縮することで、SitecoreインスタンスとRedisデータベース間で転送するデータ量が減りますが、追加のCPUオーバーヘッドが発生する可能性があります。デフォルト値はfalseです。

compression="false"

connectionPoolSize

Redisとの通信のために作成されるIConnectionMultiplexersの数を定義するように、connectionPoolSizeを設定します。デフォルト値は1です。

connectionString

connectionString属性をRedisデータベースを指すように設定します。connectionStrings.configファイルの接続文字列名(redisと呼ぶ必要があります)を使うか、有効なStackExchange.Redisクライアントの接続文字列を使うことができます。

connectionString="session" connectionString="127.0.0.1

!ヒントconnectionString属性を設定する代わりに、以下のいずれかを行えます:

• 接続文字列の代わりにaccessKey、connectionTimeoutInMilliseconds、host、operationTimeoutInMilliseconds、port、ssl属性を設定します。

• settingsClassName属性と属性settingsMethodName設定して接続文字列を提供します。

接続時間アウトミリ秒

RedisクライアントのconnectionTimeoutInMilliseconds属性を設定し、connectTimeout設定を上書きします。デフォルトのconnectTimeout値は5000ミリ秒です。詳細はStackExchange.Redisクライアント設定モデルのドキュメント をご覧ください。

connectionTimeoutInMilliseconds="5000"

データベースID

databaseId属性を、デフォルトのRedis構成がサポートする16のデータベースのいずれか(番号は0から15)に設定します。デフォルト値は0であり、これはデータベース0が使われていることを意味します。

databaseId="0"

司会者

host属性を設定してRedisキャッシュを指すようにします。

host="127.0.0.1"

lastExceptionEnabled

lastExceptionEnabledを設定して、最後の例外がHttpContextに保存されているかどうかを示し、リクエスト中にプロバイダーへの後続の呼び出しを抑制します。デフォルト値はfalseです。

ロックゲージミリ秒

lockAgeMilliseconds設定して、アイテムがセッション状態にロックされ続ける最大時間をミリ秒単位で定義します。デフォルト値はsystem.web/httpRuntime/executionTimeoutです。

maxConcurrencyLevel

maxConcurrencyLevel設定して、同時に動作するスレッド数を決定し、期限切れのセッションをインメモリキューに追加します。属性がない場合はデフォルト値が使われます。デフォルト値はSessionExpirationThreadCountSessionExpirationBatchSizeを掛け、さらに2を掛けます。

操作時間

RedisクライアントのoperationTimeoutInMilliseconds属性を設定してsyncTimeout設定を上書きします。デフォルトのsyncTimeout値は5000ミリ秒です。詳細はStackExhcange.Redisクライアント設定モデルのドキュメント をご覧ください。

operationTimeoutInMilliseconds = "1000"

!注retryTimeoutInMilliseconds値がoperationTimeoutInMilliseconds値より高くなっていることを確認してください。そうでなければ、リトライは起こりません。

pollingBatchSize

pollingBatchSize属性は、Redisキャッシュへの呼び出しごとに反復されるキーの数に設定します。デフォルト値は200キーです。詳細はRedis SCANのドキュメントをご覧ください。

pollingBatchSize="200"

pollingEnabled

pollingEnabled属性を設定して、期限切れのセッションのRedisクライアント処理を有効または無効にします。デフォルト値はtrueです。

pollingEnabled="true"

投票期限タイムアウト

pollingExpirationTimeout属性を設定し、Redisクライアントが期限切れのセッションを無視してセッション終了処理に含めるまでの時間を示します。デフォルト値は120秒です。

pollingExpirationTimeout="120"

ポーリングインターバル

pollingInterval属性を設定して、Redisクライアントがどれくらいの頻度でセッションが切れているかを確認します。デフォルト値は2秒です。

pollingInterval="2"

pollingMaxExpiredSessionsPerSecond

pollingMaxExpiredSessionsPerSecond属性を、Redisクライアントが1秒あたり処理する期限切れセッション数に設定します。デフォルト値は0秒で、この設定は無効になります。

pollingMaxExpiredSessionsPerSecond="0"

ポーリングオンスレイブ

pollingOnSlaves属性をtrueに設定すると、Redisがスレーブサーバーの期限切れセッションをスキャンします。これは、複数のRedisサーバーをマスター/スレーブ関係でレプリケーション用に設定している場合にのみ関係します。デフォルト値はfalseです。

pollingOnSlaves="false"

!重要レプリケーションが設定されたスタンドアロンのRedisサーバーに接続した場合、pollingOnSlavesを有効にする際にallowAdmin="true"属性を追加する必要があります。

港湾

port属性を、保護されていないポートかSSL保護ポートのいずれかに設定します。

port="6380"

retryTimeoutInMilliseconds

retryTimeoutInMilliseconds属性を結合された操作の再試行のタイムアウトに設定します。

Redisプロバイダーは最初の操作再試行の20ミリ秒を待ちます。その再試行が失敗した場合、次の試行まで100ミリ秒待ち、その後タイムアウトを200ミリ秒に倍増させて再度試みます。この手順はタイムアウトを倍にして繰り返され、合計時間がretryTimeoutInMillisecondに達するまで繰り返します。それでも操作が成功していない場合、例外が呼び出し元に制御権を戻します( throwOnError設定によります)。

デフォルト値は5000ミリ秒です。

retryTimeoutInMilliseconds="5000"

!注retryTimeoutInMilliseconds値がoperationTimeoutInMilliseconds値より高くなっていることを確認してください。そうでなければ、リトライは起こりません。

settingsClassName

アセンブリのsettingsClassName属性と、settingsメソッドを含むクラス名を設定します( settingsMethodNameを参照)。

settingsClassName="Sitecore.SessionProvider.Redis.Settings, Sitecore.SessionProvider.Redis"

settingsMethodName

メソッドのsettingsMethodName属性は設定クラス(settingsClassName参照)で設定します。メソッドはパラメータを必要としず、公開的で静的で、connectionStringを持つStringを返す必要があります。

settingsMethodName="GetRedisConnectionString"

SSL(SSL)

ssl属性を設定して、RedisクライアントとRedisキャッシュ間のSSL保護通信を有効または無効にします。デフォルト値はtrueです。

!重要 正しいSSLポートを指定してください。

ssl="true"

throwOnError

throwOnError設定を、Redisクライアントが失敗時に例外をスローするかどうかを設定します。デフォルト値はtrueです。

throwOnError="true"