Avis de fin de support : le 15 décembre 2025, AWS le support de AWS IoT Analytics. Après le 15 décembre 2025, vous ne pourrez plus accéder à la AWS IoT Analytics console ni aux AWS IoT Analytics ressources. Pour plus d'informations, voir [AWS IoT Analytics fin du support](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création d'un jeu de données
<a name="create-dataset"></a>

 Vous extrayez des données d'un magasin de données en créant un ensemble de données SQL ou un ensemble de données conteneur. AWS IoT Analytics peut interroger les données pour répondre à des questions analytiques. Bien qu'un magasin de données ne soit pas une base de données, vous utilisez des expressions SQL pour interroger les données et produire des résultats qui sont stockés dans un ensemble de données.

**Topics**
+ [Interrogation de données](#query-data)
+ [Accès aux données demandées](#access-queried-data)

## Interrogation de données
<a name="query-data"></a>

Pour interroger les données, vous créez un ensemble de données. Un ensemble de données contient le code SQL que vous utilisez pour interroger le magasin de données ainsi qu'un calendrier facultatif qui répète la requête au jour et à l'heure de votre choix. Vous créez les plannings facultatifs à l'aide d'expressions similaires aux [expressions CloudWatch de planning Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html). 

Exécutez la commande suivante pour créer un ensemble de données.

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

Où le `mydataset.json` fichier contient le contenu suivant.

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

Exécutez la commande suivante pour créer le contenu de l'ensemble de données en exécutant la requête.

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

Attendez quelques minutes que le contenu du jeu de données soit créé avant de continuer.

## Accès aux données demandées
<a name="access-queried-data"></a>

Le résultat de la requête est le contenu de votre ensemble de données, stocké sous forme de fichier, au format CSV. Le fichier est mis à votre disposition par le biais d'Amazon S3. L'exemple suivant montre comment vous pouvez vérifier que vos résultats sont prêts et que vous pouvez télécharger le fichier.

Exécutez la commande suivante `get-dataset-content`.

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

Si votre ensemble de données contient des données, la sortie de `get-dataset-content` contient `"state": "SUCCEEDED"` dans le `status` champ, comme dans l'exemple suivant.

```
{
    "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` est une URL signée menant aux résultats. Elle est valide pendant une brève période (quelques heures). En fonction de votre flux de travail, vous souhaiterez peut-être toujours appeler `get-dataset-content` avant d'accéder au contenu, car l'appel de cette commande génère une nouvelle URL signée.