Aviso de fin del soporte: el 15 de diciembre de 2025, AWS finalizará el soporte para AWS IoT Analytics. Después del 15 de diciembre de 2025, ya no podrás acceder a la AWS IoT Analytics consola ni a AWS IoT Analytics los recursos. Para obtener más información, consulta [AWS IoT Analytics el fin del soporte](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Creación de un conjunto de datos
<a name="create-dataset"></a>

 Para recuperar datos de un banco de datos, crea un conjunto de datos SQL o un conjunto de datos contenedor. AWS IoT Analytics puede consultar los datos para responder a preguntas analíticas. Aunque un almacén de datos no es una base de datos, se utilizan expresiones SQL para consultar los datos y producir resultados que se almacenan en un conjunto de datos.

**Topics**
+ [Consulta de datos](#query-data)
+ [Acceso a los datos consultados](#access-queried-data)

## Consulta de datos
<a name="query-data"></a>

Para consultar los datos, se crea un conjunto de datos. Un conjunto de datos contiene el SQL que se utiliza para consultar el almacén de datos, junto con una programación opcional que repite la consulta en el día y la hora que se elijan. Las programaciones opcionales se crean mediante expresiones similares a las [expresiones de CloudWatch programación de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html). 

Ejecute el siguiente comando de para crear un conjunto de datos.

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

Donde el archivo `mydataset.json` incluye el siguiente contenido.

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

Ejecute el siguiente comando para crear el contenido del conjunto de datos ejecutando la consulta.

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

Espere unos minutos a que se cree el contenido del conjunto de datos antes de continuar.

## Acceso a los datos consultados
<a name="access-queried-data"></a>

El resultado de la consulta es su contenido de conjuntos de datos almacenados como un archivo en formato CSV. El archivo se pone a su disposición a través de Amazon S3. En el siguiente ejemplo, se muestra cómo puede comprobar que los resultados están listos y descargar el archivo.

Ejecute el siguiente comando de la `get-dataset-content`.

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

Si su conjunto de datos contiene algún dato, entonces la salida de `get-dataset-content`, tiene `"state": "SUCCEEDED"` en el campo `status`, como en el siguiente ejemplo.

```
{
    "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` es una URL firmada a los resultados de salida. Es válida durante un breve periodo de tiempo (unas pocas horas). En función de su flujo de trabajo, es posible que desee llamar siempre a `get-dataset-content` antes de tener acceso al contenido, ya que al llamar a este comando se genera una nueva URL firmada.