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à. # 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ù»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) È necessario specificare un [DataSource](https://docs.aws.amazon.com/forecast/latest/dg/API_DataSource.html)oggetto 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](https://docs.aws.amazon.com/forecast/latest/dg/aws-forecast-iam-roles.html). 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](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasetImportJobs.html) ## 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](#API_CreateDatasetImportJob_RequestSyntax) ** L'Amazon Resource Name (ARN) del set di dati Amazon Forecast in cui desideri importare i dati. Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+` Obbligatorio: sì ** [DatasetImportJobName](#API_CreateDatasetImportJob_RequestSyntax) ** 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'`ResourceAlreadyExistsException`eccezione. 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ì ** [DataSource](#API_CreateDatasetImportJob_RequestSyntax) ** 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'[CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html)operazione. Tipo: oggetto [DataSource](API_DataSource.md) Obbligatorio: sì ** [Format](#API_CreateDatasetImportJob_RequestSyntax) ** Il formato dei dati importati, CSV o PARQUET. Il valore predefinito è CSV. Tipo: String Vincoli di lunghezza: lunghezza massima di 7. Modello: `^CSV|PARQUET$` Obbligatorio: no ** [GeolocationFormat](#API_CreateDatasetImportJob_RequestSyntax) ** 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\$1-122.33). + `CC_POSTALCODE`(Solo Stati Uniti): il codice del paese (Stati Uniti), seguito dal codice postale a 5 cifre (esempio: US\$198121). Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `^[a-zA-Z0-9_]+$` Obbligatorio: no ** [ImportMode](#API_CreateDatasetImportJob_RequestSyntax) ** 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'`INCREMENTAL`importazione aggiunge i dati importati ai dati esistenti. Tipo: String Valori validi: `FULL | INCREMENTAL` Campo obbligatorio: no ** [Tags](#API_CreateDatasetImportJob_RequestSyntax) ** 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 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 ** [TimestampFormat](#API_CreateDatasetImportJob_RequestSyntax) ** 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: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `^[a-zA-Z0-9\-\:\.\,\'\s]+$` Obbligatorio: no ** [TimeZone](#API_CreateDatasetImportJob_RequestSyntax) ** 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](http://joda-time.sourceforge.net/timezones.html). Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `^[a-zA-Z0-9\/\+\-\_]+$` Obbligatorio: no ** [UseGeolocationForTimeZone](#API_CreateDatasetImportJob_RequestSyntax) ** 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 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](#API_CreateDatasetImportJob_ResponseSyntax) ** L'Amazon Resource Name (ARN) del processo di importazione 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 ** 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: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDatasetImportJob)