# create-data-sample

このタスクは、特定のデータセットに関連するデータサンプルを作成し、接続されたデバイスや外部データソースからデータを抽出して処理します。

## パラメーター

- **データセット (dataset)**
  - データサンプルが追加されるデータセットの一意の識別子(ID)です。このデータセットはシステム内に既に存在している必要があります。
- **ソース (source)**
  - データが収集されるデバイスまたはデータソースの識別子です。これは、デバイス ID または記述的な名前である可能性があります。
  - [アクセッサー](../../integration/concept/data-accessor.md)
- **生データ (rawData)**
  - コンテキストまたは受信データペイロードから生データを取得するためのアクセスパスです。このパスは、提供されたデータ構造内で生データを見つける場所を指定します。
  - [アクセッサー](../../integration/concept/data-accessor.md)
- **データ (data)**
  - コンテキストまたは受信データペイロードから処理されたまたは抽出されたデータを取得するためのアクセスパスです。rawData と同様に、これは提供されたデータ構造内で関連データを見つける場所を指定します。
  - [アクセッサー](../../integration/concept/data-accessor.md)
- **タイムスタンプ (timestamp)**
  - データサンプルの作成に関連するタイムスタンプです。提供されない場合は、現在の時刻が使用されます。このタイムスタンプは、データが収集または生成された時点をマークします。
  - [アクセッサー](../../integration/concept/data-accessor.md)

## 使用法

このタスクは、デバイスや外部ソースから収集されたデータを構造化して大規模なデータセットの一部として保存する必要があるシナリオで設計されています。IoT アプリケーション、データ分析ワークフロー、およびさまざまなソースからのデータを集約して処理および分析するあらゆる状況で特に役立ちます。

タスクを構成する際には、データセット ID がシステム内の既存のデータセットに対応していることを確認してください。ソース、生データ、およびデータパラメーターは、受信ペイロード内のデータを正確に位置付けて処理するために正しく指定されている必要があります。タイムスタンプパラメーターにより、データサンプルをその起源または収集点の時点と時間的に関連付けることができます。

このタスクは、データ収集および保存プロセスを自動化し、アプリケーション内で効率的なデータ管理および分析を可能にします。それは、データ中心のワークフローにシームレスに統合され、さまざまなソースからのデータが体系的にキャプチャされ、カタログ化されて将来の使用のために保存されることを保証します。