Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. [Scopri di più»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 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à. # CreateDataset Crea un set di dati di Amazon Forecast **Importante** Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. [Scopri di più»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) Le informazioni sul set di dati fornito aiutano Forecast a comprendere come utilizzare i dati per l'addestramento dei modelli. Questo include gli output seguenti: + * `DataFrequency` *: con quale frequenza vengono raccolti i dati storici delle serie temporali. + * `Domain` * e * `DatasetType` *: ogni set di dati ha un dominio del set di dati associato e un tipo all'interno del dominio. Amazon Forecast fornisce un elenco di domini e tipi predefiniti all'interno di ciascun dominio. Per ogni dominio e tipo di set di dati univoco all'interno del dominio, Amazon Forecast richiede che i dati contengano un set minimo di campi predefiniti. + * `Schema` *: uno schema specifica i campi nel set di dati, inclusi il nome del campo e il tipo di dati. Dopo aver creato un set di dati, importa i dati di training e aggiungi il set di dati al gruppo di set di dati. Puoi utilizzare il gruppo di set di dati per creare un predittore. Per ulteriori informazioni, consulta [Importazione di set di dati](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html). Per ottenere un elenco di tutti i tuoi set di dati, usa l'[ListDatasets](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasets.html)operazione. Ad esempio, i set di dati Forecast, consulta il [ GitHubrepository Amazon Forecast Sample](https://github.com/aws-samples/amazon-forecast-samples). **Nota** Lo `Status` di un set di dati deve essere `ACTIVE` prima di poter importare i dati di training. Utilizza l'operazione [DescribeDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDataset.html) per ottenere lo stato. ## Sintassi della richiesta ``` { "DataFrequency": "string", "DatasetName": "string", "DatasetType": "string", "Domain": "string", "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Parametri della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [DataFrequency](#API_CreateDataset_RequestSyntax) ** La frequenza della raccolta dei dati. Questo parametro è obbligatorio per i set dati RELATED\$1TIME\$1SERIES. Gli intervalli validi sono un numero intero seguito da Y (anno), M (mese), W (settimana), D (giorno), H (ora) e min (minuti). Ad esempio, "1D" indica ogni giorno e "15min" indica ogni 15 minuti. Non è possibile specificare un valore che si sovrapponga alla successiva frequenza più grande. Ciò significa, ad esempio, che non è possibile specificare una frequenza di 60 minuti, poiché equivale a 1 ora. Di seguito sono riportati i valori validi per ciascuna frequenza: + Minuti: 1-59 + Ora: 1-23 + Giorno: 1-6 + Settimana: 1-4 + Mese: 1-11 + Anno: 1 Pertanto, se desideri previsioni a settimane alterne, specifica "2W". Oppure, se desideri previsioni trimestrali, specifica "3M". Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 5. Modello: `^Y|M|W|D|H|30min|15min|10min|5min|1min$` Obbligatorio: no ** [DatasetName](#API_CreateDataset_RequestSyntax) ** Un nome per il set di dati. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri. Modello: `^[a-zA-Z][a-zA-Z0-9_]*` Obbligatorio: sì ** [DatasetType](#API_CreateDataset_RequestSyntax) ** Il tipo di set di dati. I valori validi dipendono da quelli scelti`Domain`. Tipo: String Valori validi: `TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA` Obbligatorio: sì ** [Domain](#API_CreateDataset_RequestSyntax) ** Il dominio associato al set di dati. Quando si aggiunge un set di dati a un gruppo di set di dati, questo valore e il valore specificato per il `Domain` parametro dell'[CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.html)operazione devono corrispondere. L'opzione `Domain` e `DatasetType` scelta determina i campi che devono essere presenti nei dati di addestramento importati nel set di dati. Ad esempio, se scegli il `RETAIL` dominio e `TARGET_TIME_SERIES` come tale`DatasetType`, Amazon Forecast richiede `item_id` che i `demand` campi siano presenti nei tuoi dati. `timestamp` Per ulteriori informazioni, consulta [Importazione di set di dati](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html). Tipo: String Valori validi: `RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` Obbligatorio: sì ** [EncryptionConfig](#API_CreateDataset_RequestSyntax) ** Una chiave AWS Key Management Service (KMS) e il ruolo AWS Identity and Access Management (IAM) che Amazon Forecast può assumere per accedere alla chiave. Tipo: oggetto [EncryptionConfig](API_EncryptionConfig.md) Obbligatorio: no ** [Schema](#API_CreateDataset_RequestSyntax) ** Lo schema per il set di dati. Gli attributi dello schema e il loro ordine devono corrispondere ai campi nei dati. Il set dati `Domain` e `DatasetType` che scegli determina i campi minimi richiesti nei tuoi dati di formazione. Per informazioni sui campi richiesti per un dominio e un tipo di set di dati specifici, vedi [Domini di set di dati e tipi di set di dati](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-domains-ds-types.html). Tipo: oggetto [Schema](API_Schema.md) Obbligatorio: sì ** [Tags](#API_CreateDataset_RequestSyntax) ** I metadati opzionali che applichi al set di dati per aiutarti a classificarli e organizzarli. Ogni tag è composto da una chiave e da un valore opzionale, entrambi personalizzabili. Ai tag si applicano le seguenti limitazioni di base: + Numero massimo di tag per risorsa: 50. + Per ogni risorsa, ogni chiave di tag deve essere unica e ogni chiave di tag può avere un solo valore. + Lunghezza massima della chiave: 128 caratteri Unicode in UTF-8. + Lunghezza massima del valore: 256 caratteri Unicode in UTF-8. + Se lo schema di assegnazione dei tag viene utilizzato in più servizi e risorse , tieni presente che altri servizi potrebbero prevedere limitazioni sui caratteri consentiti. I caratteri generalmente consentiti sono: lettere, numeri e spazi rappresentabili in UTF-8 e i seguenti caratteri: \$1 - =. \$1:/@. + I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole. + Non utilizzare alcuna combinazione maiuscola o minuscola `aws:``AWS:`, ad esempio un prefisso per le chiavi, poiché è riservata all'uso. AWS Non è possibile modificare o eliminare le chiavi dei tag con questo prefisso. I valori possono avere questo prefisso. Se il valore di un tag ha `aws` come prefisso ma la chiave no, Forecast lo considera un tag utente e verrà conteggiato nel limite di 50 tag. I tag con solo il prefisso chiave di `aws` non vengono conteggiati ai fini del limite di tag per risorsa. Tipo: matrice di oggetti [Tag](API_Tag.md) Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi. Obbligatorio: no ## Sintassi della risposta ``` { "DatasetArn": "string" } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [DatasetArn](#API_CreateDataset_ResponseSyntax) ** Il nome della risorsa Amazon (ARN) del set di dati. Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+` ## Errori ** InvalidInputException ** Non possiamo elaborare la richiesta perché include un valore non valido o un valore che supera l'intervallo valido. Codice di stato HTTP: 400 ** LimitExceededException ** Il limite del numero di risorse per account è stato superato. Codice di stato HTTP: 400 ** ResourceAlreadyExistsException ** Esiste già una risorsa con questo nome. Riprova con un nome diverso. Codice di stato HTTP: 400 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDataset) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDataset) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDataset) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDataset) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDataset) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDataset) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDataset) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDataset) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDataset) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDataset)