KV ストアの使用

KV ストアは、エッジでの高パフォーマンスの読み取りと書き込みで使用するために、キーと値のペアの形式でデータを保存できるコンテナの一種です。単一の KV ストアを、アカウント内の複数の Compute サービスに関連付けることができます。KV ストアはバージョンレスであるため、保存されるデータに有効期限はなく、KV ストアの作成後にいつでも更新することができ、サービスのバージョンを増分する必要もありません。また、KV ストアはエッジに保存されるため、オリジンからデータをオフロードし、エンドユーザーに近い場所に保管することができます。

また、API 経由で KV ストアを作成および使用することもできます。

前提条件

KV ストアは、Fastly の Compute サービスでのみご利用いただけます。CDN (VCL ベース) サービスではご利用いただけません。

制約と考慮事項

KV ストアを使用する前に、以下の点に留意してください。

• KV ストアは Compute サービスでのみご利用いただけます。CDN (VCL ベース) サービスではご利用いただけません。
• 作成できる KV ストアの数は、お客様のアカウントで使用可能なリソース数によって制限されます。

キーファイルをフォーマットする際には、以下の点に留意してください。

• キーファイルには、すべてのファイルタイプを使用できます。最大サイズは 25 MB です。 この最大値は、リクエストすることで 100 MB にまで引き上げることができます。詳細については、アカウントマネージャーまたは japan@fastly.com にお問い合わせください。
• キーを .well-known/acme-challenge/ または .. で始めることはできません。
• キー名には、UTF-8 でエンコードされている場合、長さ 1-1024 バイトの有効なユニコード文字を任意のシーケンスで含めることができます。 キー名には次の文字を使用できますが、プリフィックスクエリ文字列では検索できません: !、"、$、%、&、(、)、*、+、,、/、\、:、<、=、>、@、[、]、`、{、}。
• キー名に .. を含めることはできません。
• 単一文字のキー名として、キーに Unicode 文字、0‐32、65534、65535を使用することはできません。

以下の文字は無効となるため、キー名に使用することはできません。

• #、;、?、^、および |
• 改行文字
• キャリッジリターン

KV ストアの作成

KV ストアを作成するには、サービスに関連付ける前に、少なくとも1つのキーと値のペアを作成する必要があります。新しい KV ストアと、そのキーと値のペアを作成するには以下の手順に従ってください。

1. Fastly コントロールパネルにログインします。
2. Resources > KV stores に移動します。
3. Create a KV store をクリックします。
4. Name of KV store フィールドに KV ストアの名前を入力し、Add をクリックします。
   ヒント

   KV ストア名の最大長は255文字で、文字、数字、ダッシュ (-)、アンダースコア (_)、ピリオド (.) を含めることができます。

5. Key-value pairs をクリックします。
6. Name of key フィールドに、KV ストアに関連付けられたキー/値ペアの最初のセットの名前を入力します。
7. Browse for file をクリックし、ファイル選択画面を使用してシステム上にあるファイルまで移動し、キーの値をアップロードします。また、これらの設定機能の下にあるドラッグ & ドロップエリアに、キーのファイルを直接ドラッグ & ドロップすることもできます。
8. キーコントロールの右側にある Add をクリックします。
9. Add item ボタンをクリックし、必要に応じて別のキーと値ペアを追加します。

KV ストアをサービスにリンクする

少なくとも1つのキーと値のペアを KV ストアに追加すると、Resources コントロールまたはサービスのサービス設定から、サービスに KV ストアをリンクすることができます。ストアに対して行われる後続の更新はすべて、リンクされたサービスに自動的に反映されます。

Resources コントロールを使用して KV ストアをサービスにリンクする

Resources コントロールから KV ストアをサービスにリンクする手順は次のとおりです。

1. Fastly コントロールパネルにログインします。

2. Resources > KV stores に移動します。

3. リンクするストアの右側にある Link to services をクリックします。

4. KV ストアをリンクするサービスの横にあるチェックボックスを選択し、Next をクリックします。

5. リンクするサービスのバージョンを決定します。デフォルトでは、最も最近に有効化されたサービスバージョンをクローンするとシステムは想定します。サービスの既存のドラフトバージョンを選択する場合は、Version メニューからそのバージョンを選択します。

6. ストアをサービスにリンクするには、以下のオプションのいずれかを選択します。

   • Link only: 選択したサービスバージョンにストアがリンクされますが、クローンまたはドラフトバージョンは後で有効化できるように、有効化されていない状態で維持されます。
   • Link and activate: 選択したサービスバージョンにストアがリンクされ、同時にバージョンも有効化されます。

   KV ストアがサービスにリンクされると、正常にリンクされたことを示すメッセージが表示されます。

7. 最後に、以下のいずれかの操作を行います。

   • Activate versions をクリックし、KV ストアにリンクされているサービスのクローンまたはドラフトバージョンを有効化します。
   • Finish をクリックし、サービスのクローンまたはドラフトバージョンを有効化せずに、後で追加の設定変更を行ってから有効化できるようにします。

   エッジロジックで KV ストアを直ちに参照し始めることができます。

サービス設定を使用して KV ストアをサービスにリンクする

サービス設定から KV ストアをサービスにリンクする手順は次のとおりです。

1. Fastly コントロールパネルにログインします。
2. Home ページから、適切なサービスを選択します。検索ボックスで ID、名称、ドメインによる検索が行えます。
3. Service configuration をクリックします。
4. ページ上のナビゲーションにある Resources オプションで、KV stores をクリックします。
5. Link KV Store to service メニューから、サービスにリンクする KV ストアを選択します。ストアがサービスにリンクされたことを示すメッセージが表示されます。

リンクが完了すると、エッジロジックで KV ストアの参照を直ちに開始できるようになり、準備ができ次第サービスを有効化することができます。

KV ストアのリンク解除

サービス設定で、サービスから KV ストアのリンクを解除することができます。

KV ストアのリンクを解除するには、以下の手順に従ってください。

1. Fastly コントロールパネルにログインします。
2. Home ページから、適切なサービスを選択します。検索ボックスで ID、名称、ドメインによる検索が行えます。
3. Service configuration をクリックします。
4. ページ上のナビゲーションにある Resources オプションで、KV stores をクリックします。
5. サービスへのリンクを解除する KV ストアの横にある Unlink from service をクリックします。
6. Confirm and unlink をクリックします。 サービスの新しいドラフトバージョンが作成されます。
7. サービスを有効化し、KV ストアのリンク解除を完了します。

KV ストアの編集

KV ストアの名前と、ストア内のキーと値のペアは、Resources > KV stores 内で編集できます。 このページには、サービス設定から KV ストアにアクセスし、Edit in Resources をクリックしてアクセスすることもできます。

KV ストアの名前を変更するには、以下の手順に従ってください。

1. 名前を変更するストアの右側にある鉛筆アイコン をクリックします。
2. KV ストアの新しい名前を入力します。
3. Save、Confirm and rename の順にクリックして続行します。

以下の手順に従って、新しいキーと値のペアを KV ストアに追加できます。

1. Key-value pairs セクションを展開します。
2. Key-value pairs の下にある Add item をクリックします。
3. キー名を入力し、値が含まれるキーファイルをアップロードして、Add をクリックします。
4. 他のキーと値のペアがある場合はこの操作を繰り返します。

KV ストア内のキーと値のペアを編集するには、以下の手順に従ってください。

1. Key-value pairs セクションを展開します。
2. 編集するエントリーにカーソルを合わせ、Edit をクリックします。
3. 値が含まれるキーファイルをドラッグ & ドロップエリアにドロップし、キーのリストをアップロードします。または、Browse for file をクリックし、ファイル選択画面を使用してシステム上にあるファイルを選択することもできます。
4. Save をクリックします。

変更は直ちに設定に適用され、KV ストアに関連付けられたデプロイ済みのサービスバージョンにも適用されます。

KV ストアの削除

KV ストアはいつでも削除することができます。

KV ストアを削除する前に以下を実行してください。

• サービスから KV ストアのリンクを解除します。KV ストアがサービスにリンクされている場合、ストアを削除しようとするとエラーが表示されます。
• KV ストア内のキーと値ペアを参照するカスタムロジックがあれば更新します。KV ストアを削除すると、ストア内のすべてのキーと値のペアも削除されます。

KV ストアを削除するには、以下の手順に従ってください。

1. Fastly コントロールパネルにログインします。
2. Resources > KV stores に移動します。
3. 削除したいストアの右側にあるゴミ箱アイコン をクリックします。
4. Confirm and Delete をクリックします。