アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> updateResourceCacheConfig
 
updateResourceCacheConfig
リソースのキャッシュ構成を更新します。
ロケーション
/services/webservices/system/admin/resource/operations/
リクエストエレメント
updateResourceCacheConfigリクエストには、5つのレベルのエレメントがあります。 4番目と5番目のレベルのエレメントの前には、角括弧内のレベル番号([4]と[5])が付いています。
path:キャッシュ可能なリソースのパス。
type:キャッシュされたリソースのタイプは、TABLEまたはPROCEDUREです。
detail:応答に含めるリソースに関する詳細レベル。有効な値は、NONE、SIMPLE、およびFULLです。
cacheConfig:指定されたリソースのキャッシュ構成。
allOrNothing(オプション):このフラグは、キャッシュグループにのみ適用されます。キャッシュグループの更新ポリシーをすべてまたはゼロにする必要がある場合はTRUE。キャッシュグループの更新ポリシーがベストエフォートである場合はFALSE。個々のキャッシュグループの場合、このフラグは常にTRUEを返し、このフラグを設定しても効果はありません。
configured(オプション):指定されたリソースに対してキャッシュを構成する必要がある場合はTRUE。それ以外の場合はFALSE。指定しない場合、構成された設定は変更されません。構成がFALSEの場合、他のすべてのエレメントは無視されます。
enabled(オプション):キャッシュが有効な場合はTRUE。それ以外の場合はFALSE。指定しない場合、有効な設定は変更されません。
incremental(オプション):キャッシュがインクリメンタルに維持される場合はTRUE。それ以外の場合はFALSE。指定しない場合、増分的に維持される設定は変更されません。
storage(オプション):キャッシュされたストレージの方法。指定しない場合、ストレージ設定は変更されません。
useDefaultCacheStorage(オプション):TRUEの場合、TDVはデフォルトのキャッシュデータソースを使用してキャッシュテーブルを保存します。この値がTRUEに設定されている場合、numBucketsとdropCreateIdxの値のみが考慮されます。残りは無視されます。
mode(オプション):キャッシュに使用されるストレージのタイプ。 useDefaultCacheStorageが設定されていない場合、またはFALSEに設定されている場合に必要です。 AUTOMATIC、DATA_SOURCE、またはDATA_SOURCE_OTPSの場合があります。
bucketMode(オプション):ストレージモードがDATA_SOURCE_OTPSの場合に存在し、それ以外の場合は無視されます。 AUTO_GENまたはMANUALの場合があります。
bucketProperties(オプション):bucketModeがAUTO_GENの場合に存在し、それ以外の場合は無視されます。
[4] bucketCatalog(オプション):バケットを作成するデータベースカタログ。
[4] bucketSchema(オプション):バケットを作成するデータベーススキーマ。
[4] bucketPrefix(オプション):各バケットの名前を開始する短い文字列。
[4] numBuckets:キャッシュに使用するバケットの数。
dropCreateIdx(オプション):TRUEの場合、TDVはキャッシュデータをロードする前にインデックスを自動的に削除し、ロード後にインデックスを作成します。
storageDataSourcePath(オプション):モードがDATA_SOURCEまたはDATA_SOURCE_OTPSの場合、これはキャッシュデータの保存に使用されているデータソースへのパスを識別します。
storageTargets(オプション):キャッシュデータの保存に使用されるターゲットのリスト。モードがDATA_SOURCEまたはDATA_SOURCE_OTPSの場合、これはテーブルのリストです。モードがDATA_SOURCE_OTPSの場合、bucketModeがMANUALのときにstorageTargetsが必要です。それ以外の場合、storageTargetsは無視されます。
[4]entry(オプション):
[5] targetName:TABLEリソースとストレージモードのDATA_SOURCEの場合、これは常に結果です。TABLEリソースとストレージモードのDATA_SOURCE_OTPSの場合、これはresult、result1、result2、など。PROCEDUREリソースの場合、これはカーソルパラメーターの名前、またはスカラー出力パラメーターの場合は空の文字列です。
[5] path:このデータの保存に使用されるテーブルへのパス。
[5]type:常にTABLE。
refresh(オプション):キャッシュを更新する方法。指定しない場合、更新設定は変更されません。 エレメントの更新を参照してください。
mode:キャッシュを更新する方法。手動またはスケジュールされている場合があります。
schedule(オプション):モードがSCHEDULEDの場合、このエレメントには次の子エレメントがあります。
[4]mode(オプション):常に間隔。
[4] startTime(オプション):最初の更新が発生するタイミング。
[4] fromTomeInADay(オプション):
[4] endTimeInADay(オプション):
[4] recurringDay(オプション):
[4] interval(オプション):更新間の秒数。
[4] period(オプション):
[4] count(オプション):
[4] isCluster(オプション):
ExpirationPeriod(オプション):キャッシュが更新された後、キャッシュがクリアされるまでの時間(ミリ秒単位)。ゼロ未満の場合、期間はゼロに設定されます(つまり、キャッシュが期限切れになることはありません)。指定しない場合、有効化設定は変更されません。
firstRefreshCallback(オプション):キャッシュの更新前に呼び出す必要のある入力エレメントがゼロのプロシージャへのパス。
secondRefreshCallback(オプション):キャッシュの更新が成功または失敗した後に呼び出す必要のある入力エレメントがゼロのプロシージャへのパス。
clearRule(オプション):NONE、ON_LOAD、またはON_FAILURE。
通常の動作では、有効期限が切れたとき、またはキャッシュの更新が正常に完了し、古いキャッシュデータが新しいキャッシュデータに置き換えられたときに、古いキャッシュデータがクリアされます。 clearRuleが指定されていない場合、有効化設定は変更されません。
NONEの場合、通常の動作のみが発生します。
ON_LOADの場合、通常の動作が発生しますが、更新が開始されると、古いキャッシュデータはすぐにクリアされます。
ON_FAILUREの場合、通常の動作が発生し、更新が失敗すると古いキャッシュデータがクリアされます。
応答エレメント
cacheConfig(オプション):指定されたリソースのキャッシュ構成。このエレメントは、詳細レベルがNONEでない場合にのみ応答に存在します。応答サブエレメントは要求エレメントと同じですが、値が更新されています。
エラー解析
IllegalArgument:パスの形式が正しくないか、不正なタイプが指定された場合。
IllegalState:リソースタイプがキャッシュをサポートしていない場合。
NotFound:リソースまたはリソースへのパスの一部が存在しない場合。
セキュリティ:ユーザーは、パス内のすべてのアイテムに対する読み取りアクセス権を持っている必要があります。
セキュリティ:ユーザーがパスの最後のアイテムに対する書き込みアクセス権を持っていない場合。
セキュリティ:ユーザーがACCESS_TOOLS権限を持っていない場合。