翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Quick でアプリのデータを操作する
Quick アプリでは、アプリ内のデータを複数の方法で保持および管理できます。
組み込みアプリケーションストレージ
データを保持する最も簡単な方法は、組み込みのアプリケーションストレージを使用することです。これは、多数のレコードをサポートするために外部セットアップやスケーリングを必要としないキーバリューシステムです。
ストレージスコープ
-
プライベートストレージ — 現在のユーザーのみに表示されるデータ。個人用の設定、設定、保存済みフィルター、ブックマーク、ユーザーごとの状態に使用します。
-
共有ストレージ — アプリケーションにアクセスできるすべてのユーザーに表示されるデータ。共同リスト、コメント、投票、共有設定、チームデータに を使用します。
ストレージオペレーション
| 運用 | プライベート | 共有済み | 説明 |
|---|---|---|---|
| Put Item | はい | はい | キーと値の項目を保存または更新します。 |
| Get Item | はい | はい | キーで項目を取得します。 |
| 項目を一覧表示する | はい | はい | オプションのキープレフィックスフィルターを使用して項目を一覧表示します。 |
| Delete Item | はい | はい | キーで項目を削除します。 |
| タグで一覧表示する | いいえ | はい | タグ (セカンダリインデックス) で共有項目をクエリします。 |
主要なコンセプト
-
テーブル — データの論理グループ。テーブル名を定義します。セットアップは必要ありません。
-
キー — 各項目には、テーブル内に一意のキーがあります。キーは最大 255 文字です。
-
値 — 最大 350 KB の文字列値。構造化データには JSON シリアル化を使用します。
-
タグ (共有のみ) — 共有項目のオプションの分類文字列。タグを使用すると、カテゴリ別に効率的なクエリを実行できます。
-
書き込みモード — UPSERT (デフォルト) は既存の項目を上書きします。キーが既に存在する場合、INSERT は失敗します。これは重複を防ぐのに役立ちます。
注記
各アプリには完全に個別のストレージがあります。データはユーザーセッションとアプリの再ロード全体で保持されます。
データのエクスポート
エージェントにエクスポート機能の追加を求めることができます。Quick のアプリは、Bridge API を使用した CSV、JSON、PDF、および Excel ファイルとしてのデータのエクスポートをサポートしています。アプリに接続スペースにデータスナップショットを書き込むこともできます。これはバックアップとして機能し、データを他の Quick 機能で利用できるようにします。
AI 推論がアクティブな場合の書き込み承認の処理
アプリが AI 推論を使用して (共有ストレージまたはアクションコネクタを介して) データを書き込む場合、各書き込みペイロードを確認して承認する必要があります。このセキュリティ対策により、アプリが AI 生成コンテンツを保持する前に AI 生成コンテンツを確認できます。
3 つの戦略により、承認プロンプトの頻度を減らすことができます。
-
バッチ書き込み — すべての項目を収集し、1 回のオペレーションで 1 つのストレージキーに保存します。
-
AI と書き込みの分離 — AI 処理とデータ永続性が個別のユーザーアクションで発生するようにアプリケーションを設計します。
-
不要な AI 推論を削除する — アプリが AI 生成コンテンツを使用しない場合は、AI 推論統合が登録されていないことを確認してください。AI 推論を使用しない場合、書き込みオペレーションに「このアプリで許可」を選択できます。アクセス許可はセッション間で保持されます。
ユーザー情報へのアクセス
Quick のアプリでは、実行時に現在のユーザーの ID にアクセスできます。これにより、アプリエクスペリエンスをパーソナライズしたり、ユーザー名を表示したり、ユーザーごとのロジックを実装したりできます。
使用可能なユーザー情報には、E メール、名、姓、および ID 名が含まれます。
ヒント
ユーザー ID とプライベートストレージを組み合わせて、ユーザーごとの挨拶、保存された設定、ブックマーク、カスタムダッシュボードなどのパーソナライズされたエクスペリエンスを構築します。
