O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 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á. # CreateDataset Cria um conjunto de dados do Amazon Forecast. **Importante** O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) As informações fornecidas sobre o conjunto de dados ajudam o Forecast a entender como consumir os dados para treinamento de modelos. Essa transmissão inclui o seguinte: + * `DataFrequency` *: a frequência com a qual seus dados de séries temporais históricos são coletados. + * `Domain` * e * `DatasetType` *: cada conjunto de dados tem um domínio de conjunto de dados associado e um tipo dentro do domínio. O Amazon Forecast fornece uma lista de domínios e tipos predefinidos dentro de cada domínio. Para cada domínio e tipo de conjunto de dados exclusivos, o Amazon Forecast exige que os dados de entrada incluam um conjunto mínimo de campos predefinidos. + * `Schema` *: um esquema especifica os campos do conjunto de dados, incluindo o nome do campo e o tipo de dados. Depois de criar um conjunto de dados, você importa os dados de treinamento nele e o adiciona a um grupo de conjuntos de dados. Você utiliza esse grupo de conjuntos de dados para criar um agente de previsão. Para obter mais informações, consulte [Importar conjuntos de dados](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html). Para obter uma lista de todos os seus conjuntos de dados, use a [ListDatasets](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasets.html)operação. Por exemplo, conjuntos de dados do Forecast, consulte o [ GitHubrepositório Amazon Forecast Sample](https://github.com/aws-samples/amazon-forecast-samples). **nota** O `Status` de um conjunto de dados deve ser `ACTIVE` antes que você possa importar dados de treinamento. Use a operação [DescribeDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDataset.html) para obter o status. ## Sintaxe da solicitação ``` { "DataFrequency": "string", "DatasetName": "string", "DatasetType": "string", "Domain": "string", "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Parâmetros da solicitação A solicitação aceita os dados a seguir no formato JSON. ** [DataFrequency](#API_CreateDataset_RequestSyntax) ** A frequência da coleta de dados. Esse parâmetro é obrigatório para conjuntos de dados RELATED\$1TIME\$1SERIES. Os intervalos válidos são um número inteiro seguido de Y (ano), M (mês), W (semana), D (dia), H (hora) e min (minuto). Por exemplo, "1D" indica todos os dias e "15min" indica a cada 15 minutos. Você não pode especificar um valor que se sobreporia à próxima frequência maior. Isso significa, por exemplo, que você não pode especificar uma frequência de 60 minutos, porque isso equivale a 1 hora. Os valores válidos para cada frequência são os seguintes: + Minuto: 1 a 59 + Hora: 1 a 23 + Dia: 1 a 6 + Semana: 1 a 4 + Mês: 1 a 11 + Year (Ano): 1 Assim, se você quiser previsões a cada duas semanas, especifique "2W". Ou, se quiser previsões trimestrais, especifique "3M". Tipo: string Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 5. Padrão: `^Y|M|W|D|H|30min|15min|10min|5min|1min$` Obrigatório: não ** [DatasetName](#API_CreateDataset_RequestSyntax) ** Um nome para o conjunto de dados. Tipo: string Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63. Padrão: `^[a-zA-Z][a-zA-Z0-9_]*` Obrigatório: Sim ** [DatasetType](#API_CreateDataset_RequestSyntax) ** O tipo de conjunto de dados. Os valores válidos dependem do `Domain` escolhido. Tipo: string Valores válidos: `TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA` Obrigatório: Sim ** [Domain](#API_CreateDataset_RequestSyntax) ** O domínio associado ao conjunto de dados. Quando você adiciona um conjunto de dados a um grupo de conjuntos de dados, esse valor e o valor especificado para o `Domain` parâmetro da [CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.html)operação devem corresponder. O `Domain` e o `DatasetType` que você escolhe para determinar os campos que devem estar presentes nos dados de treinamento importados para um conjunto de dados. Por exemplo, se você escolher o domínio `RETAIL` e `TARGET_TIME_SERIES` como `DatasetType`, o Amazon Forecast exigirá que os campos `item_id`, `timestamp` e `demand` estejam presentes nos seus dados. Para obter mais informações, consulte [Importar conjuntos de dados](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html). Tipo: string Valores válidos: `RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` Obrigatório: Sim ** [EncryptionConfig](#API_CreateDataset_RequestSyntax) ** Uma chave AWS Key Management Service (KMS) e a função AWS Identity and Access Management (IAM) que o Amazon Forecast pode assumir para acessar a chave. Tipo: objeto [EncryptionConfig](API_EncryptionConfig.md) Obrigatório: não ** [Schema](#API_CreateDataset_RequestSyntax) ** O esquema do conjunto de dados. Os atributos do esquema e sua ordem devem corresponder aos campos nos seus dados. O conjunto de dados `Domain` e `DatasetType` que você escolher para determinar os campos mínimos obrigatórios nos seus dados de treinamento. Para saber mais sobre os campos obrigatórios de um domínio e tipo de conjunto de dados específicos, consulte [Domínios e tipos de conjunto de dados](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-domains-ds-types.html). Tipo: objeto [Schema](API_Schema.md) Obrigatório: Sim ** [Tags](#API_CreateDataset_RequestSyntax) ** Os metadados opcionais que você aplica ao conjunto de dados para categorizá-los e organizá-los. Cada tag consiste de uma chave e um valor opcional, que podem ser definidos. As restrições básicas a seguir se aplicam a tags: + Número máximo de tags por recurso: 50. + Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor. + Comprimento máximo da chave: 128 caracteres Unicode em UTF-8. + Comprimento máximo do valor: 256 caracteres Unicode em UTF-8. + Caso seu esquema de marcação seja usado em vários serviços e recursos da , lembre-se de que outros serviços podem possuir restrições em caracteres permitidos. Os caracteres geralmente permitidos são: letras, números e espaços representáveis em UTF-8 e os seguintes caracteres: \$1 - =. \$1:/@. + As chaves e valores das tags diferenciam maiúsculas de minúsculas. + Não use `aws:``AWS:`, ou qualquer combinação de maiúsculas ou minúsculas, como um prefixo para teclas, pois está reservado para uso. AWS Você não pode editar nem excluir chaves de tag com esse prefixo. Os valores podem ter esse prefixo. Se um valor de tag tiver `aws` como prefixo, mas a chave não, o Forecast o considerará uma tag de usuário e o contabilizará no limite de 50 tags. As tags que têm apenas o prefixo de chave `aws` não são contabilizadas entre suas tags por limite de recurso. Tipo: matriz de objetos [Tag](API_Tag.md) Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens. Obrigatório: não ## Sintaxe da resposta ``` { "DatasetArn": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [DatasetArn](#API_CreateDataset_ResponseSyntax) ** O nome do recurso da Amazon (ARN) do conjunto de dados. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):forecast:.*:.*:.+` ## Erros ** InvalidInputException ** Não podemos processar a solicitação porque ela inclui um valor inválido ou um valor que excede o intervalo válido. Código de status HTTP: 400 ** LimitExceededException ** O limite do número de recursos por conta foi excedido. Código de status HTTP: 400 ** ResourceAlreadyExistsException ** Já existe um recurso com esse nome. Tente novamente com outro nome. Código de Status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDataset) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDataset) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDataset) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDataset) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDataset) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDataset) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDataset) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDataset) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDataset) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDataset)