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

# 時系列データ
<a name="clarify-processing-job-data-format-time-series"></a>

時系列データとは、3 次元のデータフレームにロードできるデータを指します。フレームでは、すべてのタイムスタンプで、各行がターゲットレコードを表し、各ターゲットレコードには単数または複数の関連列があります。各データフレームセル内の値は、数値、カテゴリ、またはテキストデータ型にすることができます。

## 時系列データセットの前提条件
<a name="clarify-processing-job-data-format-time-series-prereq"></a>

分析の前に、データクリーニングや特徴量エンジニアリングなど、データ準備に必要な前処理手順を完了しておきます。1 つまたは複数のデータセットを提供できます。複数のデータセットを指定する場合は、以下のいずれかの方法を使用して、SageMaker Clarify 処理ジョブにデータセットを提供します。
+ `dataset` という名前の [ProcessingInput](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ProcessingInput.html) または分析設定 `dataset_uri` のいずれかを使用してメインデータセットを指定します。`dataset_uri` の詳細については、「[分析設定ファイル](clarify-processing-job-configure-analysis.md)」の「パラメータリスト」を参照してください。
+ 分析析設定ファイルにある `baseline` パラメータを使用します。ベースラインデータセットがある場合は、`static_covariates` で指定する必要があります。分析設定ファイルの詳細と例については、「[分析設定ファイル](clarify-processing-job-configure-analysis.md)」を参照してください。

次の表は、サポートされているデータ形式、ファイル拡張子、MIME タイプの一覧です。


| データ形式 | ファイル拡張子 | MIME タイプ | 
| --- | --- | --- | 
|  `item_records`  |  json  |  `application/json`  | 
|  `timestamp_records`  |  json  |  `application/json`  | 
|  `columns`  |  json  |  `application/json`  | 

JSON は、あらゆるレベルの複雑さを持つ構造化データを表現するための柔軟な形式です。表に示されるとおり、SageMaker Clarify は `item_records` 形式、`timestamp_records` 形式、`columns` 形式をサポートしています。

## 時系列データセットの設定例
<a name="clarify-processing-job-data-format-time-series-ex"></a>

このセクションでは、JSON 形式の時系列データに対して `time_series_data_config` を使用して分析設定を設定する方法を説明します。次のとおり、タイムスタンプ (t)、ターゲット時系列 (x)、2 つの関連する時系列 (r)、2 つの静的共変量 (u) をそれぞれ含む 2 つの項目を持つデータセットがあるとします。

 t1 = [0,1,2], t2 = [2,3]

x1 = [5,6,4], x2 = [0,4]

r1 = [0,1,0], r21 = [1,1]

r12 = [0,0,0], r22 = [1,0]

u11 = -1, u21 = 0

u12 = 1, u22 = 2

このデータセットは、`dataset_format` に応じて、`time_series_data_config` を使用してデータセットを 3 つの異なる方法でエンコードできます。以降のセクションでは、それぞれの方法について説明します。

### `dataset_format` が `columns` の場合の時系列データの設定
<a name="clarify-processing-job-data-format-time-series-columns"></a>

次の例では、`dataset_format` に `columns` 値を使用しています。次の JSON ファイルは、前のデータセットを表します。

```
{
    "ids": [1, 1, 1, 2, 2],
    "timestamps": [0, 1, 2, 2, 3], # t
    "target_ts": [5, 6, 4, 0, 4], # x
    "rts1": [0, 1, 0, 1, 1], # r1
    "rts2": [0, 0, 0, 1, 0], # r2
    "scv1": [-1, -1, -1, 0, 0], # u1
    "scv2": [1, 1, 1, 2, 2], # u2
}
```

項目 ID が `ids` フィールドで繰り返されることに注意が必要です。`time_series_data_config` の適切な実装は、以下に示されるとおりです。

```
"time_series_data_config": {
    "item_id": "ids",
    "timestamp": "timestamps",
    "target_time_series": "target_ts",
    "related_time_series": ["rts1", "rts2"],
    "static_covariates": ["scv1", "scv2"],
    "dataset_format": "columns"
}
```

### `dataset_format` が `item_records` の場合の時系列データの設定
<a name="clarify-processing-job-data-format-time-series-itemrec"></a>

次の例では、`dataset_format` に `item_records` 値を使用しています。次の JSON ファイルは、データセットを表します。

```
[
    {
        "id": 1,
        "scv1": -1,
        "scv2": 1,
        "timeseries": [
            {"timestamp": 0, "target_ts": 5, "rts1": 0, "rts2": 0},
            {"timestamp": 1, "target_ts": 6, "rts1": 1, "rts2": 0},
            {"timestamp": 2, "target_ts": 4, "rts1": 0, "rts2": 0}
        ]
    },
    {
        "id": 2,
        "scv1": 0,
        "scv2": 2,
        "timeseries": [
            {"timestamp": 2, "target_ts": 0, "rts1": 1, "rts2": 1},
            {"timestamp": 3, "target_ts": 4, "rts1": 1, "rts2": 0}
        ]
    }
]
```

各項目は、JSON で個別のエントリとして表されます。次のスニペットは、対応する `time_series_data_config` (JMESPath を使用) を示しています。

```
"time_series_data_config": {
    "item_id": "[*].id",
    "timestamp": "[*].timeseries[].timestamp",
    "target_time_series": "[*].timeseries[].target_ts",
    "related_time_series": ["[*].timeseries[].rts1", "[*].timeseries[].rts2"],
    "static_covariates": ["[*].scv1", "[*].scv2"],
    "dataset_format": "item_records"
}
```

### `dataset_format` が `timestamp_record` の場合の時系列データの設定
<a name="clarify-processing-job-data-format-time-series-tsrec"></a>

次の例では、`dataset_format` に `timestamp_record` 値を使用しています。次の JSON ファイルは、前のデータセットを表します。

```
[
    {"id": 1, "timestamp": 0, "target_ts": 5, "rts1": 0, "rts2": 0, "svc1": -1, "svc2": 1},
    {"id": 1, "timestamp": 1, "target_ts": 6, "rts1": 1, "rts2": 0, "svc1": -1, "svc2": 1},
    {"id": 1, "timestamp": 2, "target_ts": 4, "rts1": 0, "rts2": 0, "svc1": -1, "svc2": 1},
    {"id": 2, "timestamp": 2, "target_ts": 0, "rts1": 1, "rts2": 1, "svc1": 0, "svc2": 2},
    {"id": 2, "timestamp": 3, "target_ts": 4, "rts1": 1, "rts2": 0, "svc1": 0, "svc2": 2},
]
```

JSON の各エントリは、単一のタイムスタンプを表し、単一の項目に対応しています。`time_series_data_config` の実装は、以下に示されるとおりです。

```
{
    "item_id": "[*].id",
    "timestamp": "[*].timestamp",
    "target_time_series": "[*].target_ts",
    "related_time_series": ["[*].rts1"],
    "static_covariates": ["[*].scv1"],
    "dataset_format": "timestamp_records"
}
```