サポート終了通知: 2025 年 12 月 15 日に、 AWS はサポートを終了します AWS IoT Analytics。2025 年 12 月 15 日以降、 AWS IoT Analytics コンソールまたは AWS IoT Analytics リソースにアクセスできなくなります。詳細については、[AWS IoT Analytics 「サポート終了](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html)」を参照してください。

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

# データセットの作成
<a name="create-dataset"></a>

 データストアからデータを取得するには、SQL データセットまたはコンテナデータセットを作成します。 AWS IoT Analytics はデータをクエリして分析の質問に回答できます。データストアはデータベースではありませんが、SQL 式を使用してデータにクエリを実行すると、生成された結果はデータセットに保存されます。

**Topics**
+ [データのクエリ](#query-data)
+ [クエリされたデータへのアクセス](#access-queried-data)

## データのクエリ
<a name="query-data"></a>

データに対してクエリを実行するには、データセットを作成します。データセットには、データストアにクエリを実行するために使用する SQL と、選択した日時にクエリを繰り返すオプションのスケジュールが含まれます。オプションのスケジュールを作成するには、[Amazon CloudWatch のスケジュール式](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html)に似た式を使用します。

次のコマンドを実行してデータセットを作成します。

```
aws iotanalytics create-dataset --cli-input-json file://mydataset.json
```

`mydataset.json` ファイルには次のコンテンツが含まれます。

```
{
    "datasetName": "mydataset",
    "actions": [
        {
            "actionName":"myaction",
            "queryAction": {
                "sqlQuery": "select * from mydatastore"
            }
        }
    ]
}
```

クエリの実行によりデータセットのコンテンツを作成するには、次のコマンドを実行します。

```
aws iotanalytics create-dataset-content --dataset-name mydataset
```

データセットのコンテンツが作成されるまで数分待ってから、作業を続行してください。

## クエリされたデータへのアクセス
<a name="access-queried-data"></a>

クエリ結果は、CSV 形式のファイルとして保存されたデータセットコンテンツです。このファイルは Amazon S3 経由で用意されています。以下の例では、結果の準備が完了してファイルをダウンロードできることを確認する方法を示しています。

次の `get-dataset-content` コマンドを実行します。

```
aws iotanalytics get-dataset-content --dataset-name mydataset
```

データセットにデータが含まれている場合、`get-dataset-content` の出力は [`status`] フィールドに「`"state": "SUCCEEDED"`」と表示されます。以下はその例です。

```
{
    "timestamp": 1508189965.746,
    "entries": [
        {
          "entryName": "someEntry",
          "dataURI": "https://aws-iot-analytics-datasets-f7253800-859a-472c-aa33-e23998b31261.s3.amazonaws.com/results/f881f855-c873-49ce-abd9-b50e9611b71f.csv?X-Amz-"
          
        }
    ],
    "status": {
      "state": "SUCCEEDED",
      "reason": "A useful comment."
    }
}
```

`dataURI` は、出力結果の署名付き URL です。有効期間は短時間 (数時間) です。このコマンドを呼び出すことで新しい署名付き URL が生成されるため、ワークフローによっては、コンテンツにアクセスする前に常に `get-dataset-content` を呼び出すようにします。