キャッシュ

キャッシュ

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

キャッシュモジュールでは、Functions、Server Scripts、その他の対応コンポーネントからすばやくアクセスできるキーと値のデータを一時的に保存できます。
​
各キャッシュエントリーは、設定された有効期間（TTL）の間のみ利用でき、TTLが切れると自動的に削除されます。
キャッシュは、認証トークン、APIレスポンス、ワークフローの中間データ、アプリケーションで共有する値などの一時的な値の保存によく使用されます。

キャッシュの概要  

キャッシュでは、一時データをセグメントとキャッシュエントリーで整理します。

  • セグメント  

    • セグメントは、関連するキャッシュエントリーをまとめて管理します。

    • 例：

      • HR -- EmployeeToken, ManagerID

      • Marketing -- CampaignToken, Region

      • Finance -- ApprovalToken

  • キャッシュエントリー  

    • キャッシュエントリーには、セグメント内の1つのキーと値のペアが保存されます。

    • 各キャッシュエントリーには、キー、値、有効期限（TTL）が含まれます。

    • TTLが切れると、キャッシュエントリーは自動的に削除されます。

 

最初のキャッシュ とセグメントの作成

初めてキャッシュモジュールを開いた時点では、セグメントはありません。最初のキャッシュエントリーを作成すると、最初のセグメントも自動的に作成されます。
  1. Qntrlにログインします。
  2. ［設定］→［詳細設定］→［キャッシュ］に移動します。
  3. ［キャッシュを作成］をクリックします。
  4. 次の詳細を入力します。
    1. ［セグメント名］：キャッシュエントリーを作成するセグメントの名前です。セグメントがまだ存在しないため、新しいセグメントが自動的に作成されます。
    2. ［キー名］：キャッシュエントリーを識別するための一意の名前です。
    3. ［値］：保存する値です。
    4. ［有効期限（TTL）］：あらかじめ定義された有効期限を選択するか、カスタム期間を指定します。TTLが切れると、キャッシュエントリーは自動的に削除されます。
  5. ［作成］をクリックします。


  • 最初のセグメントと最初のキャッシュエントリーが同時に作成されます。   

  • セグメントの一意のリンクが自動的に生成され、ページ上部に表示されます。

  • 最初のセグメントを作成すると、キャッシュページの右上に［新しいセグメント］ボタンが表示されます。


追加のセグメントの作成

セグメントを作成するには：

  1. ［新しいセグメント］をクリックします。

  2. 次の詳細を入力します。

    1. ［名前］：セグメントの名前です。

    2. ［説明］：セグメントの説明です。

  1. ［作成］をクリックします。


セグメントが作成され、左側のペインに表示されます。  

1つ以上のセグメントを作成すると、任意のセグメント配下に追加のキャッシュエントリーを作成できます。

追加のキャッシュエントリーの作成

セグメント配下に追加のキャッシュエントリーを作成するには：

  1. 左側のペインからセグメントを選択します。

  2. ［新しいキャッシュ］をクリックします。

  3. 選択したセグメントが自動的に入力されます。

  4. キャッシュの詳細を入力します。

  5. ［作成］をクリックします。

キャッシュエントリーが選択したセグメント配下に作成されます。

キャッシュの制限

項目

上限

組織あたりの最大セグメント数

50

セグメントあたりの最大ストレージ容量

5MB

キャッシュストレージの合計上限

250MB

キーの最大長

50文字

値の最大サイズ

16KB

TTLの最小値

1分

TTLの最大値

48時間


キャッシュの管理

セグメントの管理

既存のセグメントを更新または削除できます。
  1. 対象のセグメントの横にある［編集］アイコンを、セグメント一覧からクリックします。
  2. 更新：セグメントの詳細を変更し、［保存］をクリックします。
  3. 削除：右上の［削除］アイコンをクリックし、削除を確認します。

キャッシュエントリーの管理

セグメント内のキャッシュエントリーを更新または削除できます。

  • 必要なセグメントをセグメントリストから選択します。

  • 対象のキャッシュエントリーをクリックします。

  • 更新：［値］または［有効期限（TTL）］を変更し、［保存］をクリックします。

  • 削除：右上の［削除］アイコンをクリックし、削除を確定します。


サーバースクリプトでのキャッシュの使用   

キャッシュは、主にサーバー側スクリプト内で使用することを想定しています。

関数、サーバースクリプト、その他の対応SDKベースのコンポーネントでは、プログラムによってキャッシュエントリーを作成、取得、更新、削除できます。

キャッシュSDK  

キャッシュSDKを使用すると、サーバー側スクリプトからキャッシュエントリーを作成、取得、更新、削除できます。

例：

関数が外部アプリケーションからOAuthトークンを取得します。実行のたびに新しいトークンを要求する代わりに、TTLを1時間に設定してトークンをキャッシュに保存できます。以降の実行では、トークンが自動的に期限切れになるまで、キャッシュされたトークンを再利用します。

操作

SDK

説明

作成

QntrlCache.create(seg_id, key, value, duration)

指定したセグメントに新しいキャッシュエントリーを作成します。

取得

QntrlCache.of(seg_id, key)

既存のキャッシュエントリーの値を取得します。

更新

QntrlCache.update(seg_id, key, value, duration)

既存のキャッシュエントリーの値と有効期限を更新します。

削除

QntrlCache.delete(seg_id, key)

指定したキャッシュエントリーをセグメントから削除します。

 

例：

QntrlCache.create(segmentId, key, value, duration);

実行すると：

  • キーが存在しない場合、新しいキャッシュエントリーが作成されます。

  • 選択したセグメント内にキーがすでに存在する場合、既存の値が更新されます。

  • キャッシュエントリーは、設定されたTTLが期限切れになるまで、キャッシュモジュールですぐに使用できるようになります。