翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Quick でアプリのデータを操作する
<a name="working-with-data-apps"></a>

Quick アプリでは、アプリ内のデータを複数の方法で保持および管理できます。

## 組み込みアプリケーションストレージ
<a name="apps-builtin-storage"></a>

データを保持する最も簡単な方法は、組み込みのアプリケーションストレージを使用することです。これは、多数のレコードをサポートするために外部セットアップやスケーリングを必要としないキーバリューシステムです。

### ストレージスコープ
<a name="apps-storage-scopes"></a>
+ **プライベートストレージ** — 現在のユーザーのみに表示されるデータ。個人用の設定、設定、保存済みフィルター、ブックマーク、ユーザーごとの状態に使用します。
+ **共有ストレージ** — アプリケーションにアクセスできるすべてのユーザーに表示されるデータ。共同リスト、コメント、投票、共有設定、チームデータに を使用します。

### ストレージオペレーション
<a name="apps-storage-operations"></a>


| 運用 | プライベート | 共有済み | 説明 | 
| --- | --- | --- | --- | 
| Put Item | はい  | はい | キーと値の項目を保存または更新します。 | 
| Get Item | はい  | はい | キーで項目を取得します。 | 
| 項目を一覧表示する | はい  | はい | オプションのキープレフィックスフィルターを使用して項目を一覧表示します。 | 
| Delete Item | はい  | はい | キーで項目を削除します。 | 
| タグで一覧表示する | いいえ | はい | タグ (セカンダリインデックス) で共有項目をクエリします。 | 

### 主要なコンセプト
<a name="apps-storage-concepts"></a>
+ **テーブル** — データの論理グループ。テーブル名を定義します。セットアップは必要ありません。
+ **キー** — 各項目には、テーブル内に一意のキーがあります。キーは最大 255 文字です。
+ **値** — 最大 350 KB の文字列値。構造化データには JSON シリアル化を使用します。
+ **タグ (共有のみ)** — 共有項目のオプションの分類文字列。タグを使用すると、カテゴリ別に効率的なクエリを実行できます。
+ **書き込みモード** — UPSERT (デフォルト) は既存の項目を上書きします。キーが既に存在する場合、INSERT は失敗します。これは重複を防ぐのに役立ちます。

**注記**  
各アプリには完全に個別のストレージがあります。データはユーザーセッションとアプリの再ロード全体で保持されます。

## データのエクスポート
<a name="apps-exporting-data"></a>

エージェントにエクスポート機能の追加を求めることができます。Quick のアプリは、Bridge API を使用した CSV、JSON、PDF、および Excel ファイルとしてのデータのエクスポートをサポートしています。アプリに接続スペースにデータスナップショットを書き込むこともできます。これはバックアップとして機能し、データを他の Quick 機能で利用できるようにします。

## AI 推論がアクティブな場合の書き込み承認の処理
<a name="apps-write-approvals"></a>

アプリが AI 推論を使用して (共有ストレージまたはアクションコネクタを介して) データを書き込む場合、各書き込みペイロードを確認して承認する必要があります。このセキュリティ対策により、アプリが AI 生成コンテンツを保持する前に AI 生成コンテンツを確認できます。

3 つの戦略により、承認プロンプトの頻度を減らすことができます。

1. **バッチ書き込み** — すべての項目を収集し、1 回のオペレーションで 1 つのストレージキーに保存します。

1. **AI と書き込みの分離** — AI 処理とデータ永続性が個別のユーザーアクションで発生するようにアプリケーションを設計します。

1. **不要な AI 推論を削除する** — アプリが AI 生成コンテンツを使用しない場合は、AI 推論統合が登録されていないことを確認してください。AI 推論を使用しない場合、書き込みオペレーションに「このアプリで許可」を選択できます。アクセス許可はセッション間で保持されます。

## ユーザー情報へのアクセス
<a name="apps-user-identity"></a>

Quick のアプリでは、実行時に現在のユーザーの ID にアクセスできます。これにより、アプリエクスペリエンスをパーソナライズしたり、ユーザー名を表示したり、ユーザーごとのロジックを実装したりできます。

使用可能なユーザー情報には、E メール、名、姓、および ID 名が含まれます。

**ヒント**  
ユーザー ID とプライベートストレージを組み合わせて、ユーザーごとの挨拶、保存された設定、ブックマーク、カスタムダッシュボードなどのパーソナライズされたエクスペリエンスを構築します。