Sintassi della richiesta Parametri della richiesta Sintassi della risposta Elementi di risposta Errori Vedi anche

CreateDatasetImportJob

Importa i dati di allenamento in un set di dati Amazon Forecast. Fornisci la posizione dei tuoi dati di allenamento in un bucket Amazon Simple Storage Service (Amazon S3) e l'Amazon Resource Name (ARN) del set di dati in cui desideri importare i dati.

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ù»

È necessario specificare un DataSourceoggetto che includa un ruolo AWS Identity and Access Management (IAM) che Amazon Forecast può assumere per accedere ai dati, poiché Amazon Forecast crea una copia dei dati e li elabora in un AWS sistema interno. Per ulteriori informazioni, consulta Configurare le autorizzazioni.

I dati di addestramento devono essere in formato CSV o Parquet. Il delimitatore deve essere una virgola (,).

È possibile specificare il percorso di un file specifico, il bucket S3 o una cartella nel bucket S3. Negli ultimi due casi, Amazon Forecast importa tutti i file fino al limite di 10.000 file.

Poiché le importazioni di set di dati non sono aggregate, l'importazione di set di dati più recente è quella utilizzata per addestrare un predittore o generare una previsione. Assicurati che l'importazione più recente del set di dati contenga tutti i dati che desideri utilizzare come modello e non solo i nuovi dati raccolti dopo l'importazione precedente.

Per ottenere un elenco di tutti i processi di importazione del set di dati, filtrati in base a criteri specificati, utilizza l'operazione. ListDatasetImportJobs

Sintassi della richiesta


{
   "DatasetArn": "string",
   "DatasetImportJobName": "string",
   "DataSource": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "Format": "string",
   "GeolocationFormat": "string",
   "ImportMode": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimestampFormat": "string",
   "TimeZone": "string",
   "UseGeolocationForTimeZone": boolean
}

Parametri della richiesta

La richiesta accetta i seguenti dati in formato JSON.

DatasetArn

L'Amazon Resource Name (ARN) del set di dati Amazon Forecast in cui desideri importare i dati.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):forecast:.*:.*:.+

Campo obbligatorio: sì

DatasetImportJobName

Il nome del processo di importazione del set di dati. Si consiglia di includere il timestamp corrente nel nome, ad esempio. 20190721DatasetImport Questo può aiutarti a evitare un'ResourceAlreadyExistsExceptioneccezione.

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ì

DataSource

La posizione dei dati di formazione da importare e il ruolo AWS Identity and Access Management (IAM) che Amazon Forecast può assumere per accedere ai dati. I dati di addestramento devono essere archiviati in un bucket Amazon S3.

Se viene utilizzata la crittografia, DataSource deve includere una chiave AWS Key Management Service (KMS) e il ruolo IAM deve consentire l'autorizzazione di Amazon Forecast per accedere alla chiave. La chiave KMS e il ruolo IAM devono corrispondere a quelli specificati nel EncryptionConfig parametro dell'CreateDatasetoperazione.

Tipo: oggetto DataSource

Campo obbligatorio: sì

Format

Il formato dei dati importati, CSV o PARQUET. Il valore predefinito è CSV.

Tipo: stringa

Vincoli di lunghezza: lunghezza massima di 7.

Modello: ^CSV|PARQUET$

Campo obbligatorio: no

GeolocationFormat

Il formato dell'attributo di geolocalizzazione. L'attributo di geolocalizzazione può essere formattato in due modi:

LAT_LONG- la latitudine e la longitudine in formato decimale (Esempio: 47.61_-122.33).
CC_POSTALCODE(Solo Stati Uniti): il codice del paese (Stati Uniti), seguito dal codice postale a 5 cifre (esempio: US_98121).

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: ^[a-zA-Z0-9_]+$

Campo obbligatorio: no

ImportMode

Speciifica se il processo di importazione del set di dati è un processo di importazione. FULL INCREMENTAL L'importazione di un FULL set di dati sostituisce tutti i dati esistenti con i dati appena importati. Un'INCREMENTALimportazione aggiunge i dati importati ai dati esistenti.

Tipo: stringa

Valori validi: FULL | INCREMENTAL

Campo obbligatorio: no

Tags

I metadati opzionali che applichi al processo di importazione del 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 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

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

Campo obbligatorio: no

TimestampFormat

Il formato dei timestamp nel set di dati. Il formato specificato dipende da quello DataFrequency specificato al momento della creazione del set di dati. Sono supportati i seguenti formati

«aaaa-MM-gg»

Per le seguenti frequenze di dati: Y, M, W e D
«yyyy-MM-dd HH:mm:ss»

Per le seguenti frequenze di dati: H, 30 minuti, 15 minuti e 1 minuto e, facoltativamente, per: Y, M, W e D

Se il formato non è specificato, Amazon Forecast prevede che il formato sia «yyyy-MM-dd HH:mm:ss».

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: ^[a-zA-Z0-9\-\:\.\,\'\s]+$

Campo obbligatorio: no

TimeZone

Un unico fuso orario per ogni elemento del set di dati. Questa opzione è ideale per set di dati con tutti i timestamp all'interno di un unico fuso orario o se tutti i timestamp sono normalizzati su un unico fuso orario.

Fai riferimento all'API Joda-Time per un elenco completo dei nomi di fusi orari validi.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: ^[a-zA-Z0-9\/\+\-\_]+$

Campo obbligatorio: no

UseGeolocationForTimeZone

Deriva automaticamente le informazioni sul fuso orario dall'attributo di geolocalizzazione. Questa opzione è ideale per set di dati che contengono timestamp in più fusi orari e tali timestamp sono espressi in ora locale.

Tipo: Booleano

Campo obbligatorio: no

Sintassi della risposta


{
   "DatasetImportJobArn": "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.

DatasetImportJobArn

L'Amazon Resource Name (ARN) del processo di importazione 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

ResourceInUseException

La risorsa specificata è in uso.

Codice di stato HTTP: 400

ResourceNotFoundException

Non riusciamo a trovare una risorsa con questo Amazon Resource Name (ARN). Controlla l'ARN e riprova.

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:

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

CreateDatasetGroup

CreateExplainability