retain

リモート キーをキャッシュからローカルに保存するか、ローカルに保存されたキーを返す

ページ内をすべて折りたたむ

構文

retain(c,remoteKeys)
localKeys = retain(c)

説明

retain(c,remoteKeys) は、キーをキャッシュからローカルに保存します。

例

localKeys = retain(c) は、ローカルに保存されたキーの cell 配列を返します。

例

例

すべて折りたたむ

永続性プロバイダーとして Redis™ を使用する永続性サービスを開始します。このサービスには、接続名と開いたポートが必要です。サービスが実行中になったら、接続名を使用してサービスに接続し、キャッシュを作成できます。

ctrl = mps.cache.control('myRedisConnection','Redis','Port',4519);
start(ctrl)
c = mps.cache.connect('myCache', 'Connection', 'myRedisConnection');

キーと値をキャッシュに追加します。

put(c,'keyOne',10,'keyTwo',20,'keyThree',30,'keyFour',[400 500],'keyFive',magic(5))

いくつかのキーをローカルに保持してローカル キーを確認します。

retain(c,{'keyThree','keyFour'})
localKeys = retain(c)
localKeys =

  1×2 cell array

    {'keyThree'}    {'keyFour'}

入力引数

すべて折りたたむ

永続性プロバイダー固有のデータ キャッシュ オブジェクトによって表されるデータ キャッシュ。

現在、サポートされている永続性プロバイダーは Redis と MATLAB® のみです。このため、キャッシュ オブジェクトのタイプは mps.cache.RedisCache または mps.cache.MATFileCache です。

例: c

ローカルに保存するリモート キー。文字ベクトルの cell 配列として指定します。

例: {'keyThree','keyFour'}

出力引数

すべて折りたたむ

ローカルに保存されたキー。文字ベクトルの cell 配列として返されます。

ヒント

  • パフォーマンスの最適化として、キーのセットとそれらの値を永続性サービスではなく MATLAB セッションまたはワーカーに一時的に保存できます。このように "保持" されるキーは、MATLAB の終了時、または最初の関数呼び出しが返ったときに永続性サービスに自動的に書き込まれます (flush を参照)。

  • flush メソッドと purge メソッドで、保持されるキーの有効期間を手動で制御します。

バージョン履歴

R2018b で導入

参考

| | |

トピック