Aviso de fim do suporte: em 15 de dezembro de 2025, AWS encerrará o suporte para AWS IoT Analytics. Depois de 15 de dezembro de 2025, você não poderá mais acessar o AWS IoT Analytics console ou os AWS IoT Analytics recursos. Para obter mais informações, consulte [AWS IoT Analytics Fim do suporte](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criação de um conjunto de dados
<a name="create-dataset"></a>

 Você recupera dados de um armazenamento de dados criando um conjunto de dados SQL ou um conjunto de dados de contêiner. AWS IoT Analytics pode consultar os dados para responder a perguntas analíticas. Embora um datastore não seja um banco de dados, você pode usar expressões SQL para consultar os dados e produzir resultados que estão armazenados em um conjunto de dados.

**Topics**
+ [Consultar dados](#query-data)
+ [Acessando os dados consultados](#access-queried-data)

## Consultar dados
<a name="query-data"></a>

Para consultar os dados, crie um conjunto de dados. Um conjunto de dados contém o SQL usado para consultar o datastore juntamente com um agendamento adicional que repete a consulta em um dia e horário de sua escolha. Você cria os agendamentos opcionais usando expressões semelhantes às expressões de [ CloudWatch agendamento da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html). 

Execute o comando a seguir para criar um conjunto de dados.

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

Onde o arquivo `mydataset.json` contém o seguinte conteúdo:

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

Execute o comando a seguir para criar o conteúdo do conjunto de dados executando a consulta.

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

Aguarde alguns minutos para que o conteúdo do conjunto de dados seja criado antes de continuar.

## Acessando os dados consultados
<a name="access-queried-data"></a>

O resultado da consulta é o conteúdo do conjunto de dados, armazenado como um arquivo no formato CSV. O arquivo é disponibilizado por meio do Amazon S3. O exemplo a seguir mostra como você pode verificar se os resultados estão prontos e fazer download do arquivo.

Execute o seguinte comando `get-dataset-content`.

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

Se o conjunto de dados contiver dados, a saída do `get-dataset-content` terá `"state": "SUCCEEDED"` no campo `status`, como o seguinte exemplo:

```
{
    "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` é uma URL assinada para os resultados de saída. Tem validade por um curto período de tempo (algumas horas). Dependendo do seu fluxo de trabalho, você sempre pode chamar `get-dataset-content` antes de acessar o conteúdo, porque chamar esse comando gera uma nova URL assinada.