Avviso di fine del supporto: il 15 dicembre 2025, AWS terminerà il supporto per AWS IoT Analytics. Dopo il 15 dicembre 2025, non potrai più accedere alla AWS IoT Analytics console o AWS IoT Analytics alle risorse. Per ulteriori informazioni, consulta [AWS IoT Analytics Fine del supporto](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione di un set di dati
<a name="create-dataset"></a>

 È possibile recuperare i dati da un data store creando un set di dati SQL o un set di dati contenitore. AWS IoT Analytics può interrogare i dati per rispondere a domande analitiche. Sebbene un data store non sia un database, si utilizzano espressioni SQL per interrogare i dati e produrre risultati archiviati in un set di dati.

**Topics**
+ [Interrogazione dei dati](#query-data)
+ [Accesso ai dati richiesti](#access-queried-data)

## Interrogazione dei dati
<a name="query-data"></a>

Per interrogare i dati, si crea un set di dati. Un set di dati contiene il codice SQL utilizzato per interrogare il data store insieme a una pianificazione opzionale che ripete la query nel giorno e all'ora scelti. Le pianificazioni opzionali vengono create utilizzando espressioni simili alle [espressioni di CloudWatch pianificazione di Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html). 

Esegui il comando seguente per creare un set di dati.

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

Dove il `mydataset.json` file contiene il seguente contenuto.

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

Esegui il comando seguente per creare il contenuto del set di dati eseguendo la query.

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

Attendi qualche minuto per la creazione del contenuto del set di dati prima di continuare.

## Accesso ai dati richiesti
<a name="access-queried-data"></a>

Il risultato della query è il contenuto del set di dati, archiviato come file, in formato CSV. Il file è disponibile per l'utente tramite Amazon S3. L'esempio seguente mostra come si può controllare se i risultati sono pronti e scaricare il file.

Eseguire il seguente comando `get-dataset-content`.

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

Se il set di dati contiene dati, l'output di`get-dataset-content`, ha `"state": "SUCCEEDED"` nel `status` campo, come nell'esempio seguente.

```
{
    "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` è un URL firmato per l'output dei risultati. È valido per un breve periodo di tempo (poche ore). A seconda del flusso di lavoro, potresti sempre chiamare `get-dataset-content` prima di accedere al contenuto perché questo comando genera un nuovo URL firmato.