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ù»
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ù»
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
eDatasetType
: 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.
Per ottenere un elenco di tutti i tuoi set di dati, usa l'ListDatasetsoperazione.
Ad esempio, i set di dati Forecast, consulta il GitHubrepository Amazon Forecast Sample
Nota
Lo Status
di un set di dati deve essere ACTIVE
prima di poter importare i dati di training. Utilizza l'operazione DescribeDataset 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
-
La frequenza della raccolta dei dati. Questo parametro è obbligatorio per i set dati RELATED_TIME_SERIES.
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: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 5.
Modello:
^Y|M|W|D|H|30min|15min|10min|5min|1min$
Campo obbligatorio: no
-
- DatasetName
-
Un nome per il set di dati.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.
Modello:
^[a-zA-Z][a-zA-Z0-9_]*
Campo obbligatorio: sì
- DatasetType
-
Il tipo di set di dati. I valori validi dipendono da quelli scelti
Domain
.Tipo: stringa
Valori validi:
TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA
Campo obbligatorio: sì
- Domain
-
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'CreateDatasetGroupoperazione devono corrispondere.L'opzione
Domain
eDatasetType
scelta determina i campi che devono essere presenti nei dati di addestramento importati nel set di dati. Ad esempio, se scegli ilRETAIL
dominio eTARGET_TIME_SERIES
come taleDatasetType
, Amazon Forecast richiedeitem_id
che idemand
campi siano presenti nei tuoi dati.timestamp
Per ulteriori informazioni, consulta Importazione di set di dati.Tipo: stringa
Valori validi:
RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS
Campo obbligatorio: sì
- EncryptionConfig
-
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
Campo obbligatorio: no
- Schema
-
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
eDatasetType
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.Tipo: oggetto Schema
Campo obbligatorio: sì
- Tags
-
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 ciascuna risorsa, ogni chiave del tag deve essere univoca e ogni chiave del 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 formato UTF-8 e i seguenti caratteri speciali + – = . _ : / @.
-
I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
-
Non utilizzare alcuna combinazione di lettere maiuscole o minuscole
aws:
AWS:
, ad esempio un prefisso per le chiavi, poiché è riservato 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 haaws
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 diaws
non vengono conteggiati ai fini del limite di tag per risorsa.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Campo 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
-
Il nome della risorsa Amazon (ARN) del set di dati.
Tipo: stringa
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: