

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à.

# Crea un processo di importazione in blocco AWS IoT SiteWise ()AWS CLI
<a name="CreateBulkImportJob"></a>

Utilizza l'operazione [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)API per trasferire dati da Amazon S3 a. AWS IoT SiteWise L'[CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)API consente l'ingestione di grandi volumi di dati storici e l'ingestione bufferizzata di flussi di dati analitici in piccoli lotti. Fornisce una primitiva economica per l'ingestione dei dati. Gli esempi seguenti utilizzano AWS CLI.

**Importante**  
Prima di creare un processo di importazione in blocco, è necessario abilitare AWS IoT SiteWise il livello caldo o il livello freddo. AWS IoT SiteWise Per ulteriori informazioni, consulta [Configurare le impostazioni di archiviazione in AWS IoT SiteWise](configure-storage.md).  
 L'[CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)API supporta l'inserimento di dati storici AWS IoT SiteWise con l'opzione di impostare il parametro. adaptive-ingestion-flag   
Se impostata su`false`, l'API acquisisce i dati storici senza attivare calcoli o notifiche.
Se impostata su`true`, l'API acquisisce nuovi dati, calcola le metriche e trasforma i dati per ottimizzare le analisi e le notifiche continue entro sette giorni.

Eseguire il seguente comando seguente. *file-name*Sostituiscilo con il nome del file che contiene la configurazione del processo di importazione in blocco.

```
aws iotsitewise create-bulk-import-job --cli-input-json file://file-name.json
```

**Example Configurazione del processo di importazione in blocco**  
Di seguito sono riportati alcuni esempi di impostazioni di configurazione:  
+ Sostituisci *adaptive-ingestion-flag* con `true` o `false`.
  + Se impostato su`false`, il processo di importazione in blocco inserisce i dati storici in. AWS IoT SiteWise
  + Se impostato su`true`, il processo di importazione in blocco esegue le seguenti operazioni:
    + Inserisce nuovi dati in. AWS IoT SiteWise
    + Calcola metriche e trasformazioni e supporta notifiche per i dati con un timestamp entro sette giorni.
+ Sostituisci *delete-files-after-import-flag* con `true` per eliminare i dati dal bucket di dati Amazon S3 dopo l'inserimento in uno storage di livello caldo. AWS IoT SiteWise 
+ Sostituisci amzn-s3-demo-bucket con *-for-errors* il nome del bucket Amazon S3 a cui vengono inviati gli errori associati a questo processo di importazione in blocco.
+ Sostituisci amzn-s3-demo-bucket con *-for-errors-prefix* il prefisso del bucket Amazon S3 a cui vengono inviati gli errori associati a questo processo di importazione in blocco. 

  Amazon S3 utilizza il prefisso come nome di cartella per organizzare i dati nel bucket. Ogni oggetto Amazon S3 ha una chiave che è il suo identificatore univoco nel bucket. Per ogni oggetto in un bucket è presente esattamente una chiave. Il prefisso deve terminare con una barra (/). Per ulteriori informazioni, consulta [Organizing object using prefixes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) nella *Amazon Simple Storage Service User Guide*.
+ Sostituisci amzn-s3-demo-bucket con *-data* il nome del bucket Amazon S3 da cui vengono importati i dati.
+ Sostituisci *data-bucket-key* con la chiave dell'oggetto Amazon S3 che contiene i tuoi dati. Ogni oggetto ha una chiave che è un identificatore univoco. Ogni oggetto ha esattamente una chiave.
+ Sostituiscilo *data-bucket-version-id* con l'ID della versione per identificare una versione specifica dell'oggetto Amazon S3 che contiene i tuoi dati. Questo parametro è facoltativo.
+ Sostituisci *column-name* con il nome della colonna specificato nel file.csv.
+ *job-name*Sostituiscilo con un nome univoco che identifichi il processo di importazione in blocco.
+ Sostituisci *job-role-arn* con il ruolo IAM che consente di AWS IoT SiteWise leggere i dati di Amazon S3.
Assicurati che il tuo ruolo disponga delle autorizzazioni mostrate nell'esempio seguente. Sostituisci amzn-s3-demo-bucket con *-data* il nome del bucket Amazon S3 che contiene i tuoi dati. Inoltre, *amzn-s3-demo-bucket-for-errors* sostituiscilo con il nome del bucket Amazon S3 a cui vengono inviati gli errori associati a questo processo di importazione in blocco.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "s3:GetObject",
                "s3:GetBucketLocation"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket-data",
                "arn:aws:s3:::amzn-s3-demo-bucket-data/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:GetBucketLocation"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket-for-errors",
                "arn:aws:s3:::amzn-s3-demo-bucket-for-errors/*"
            ],
            "Effect": "Allow"
        }
    ]
}
```

```
{
   "adaptiveIngestion": adaptive-ingestion-flag,
   "deleteFilesAfterImport": delete-files-after-import-flag,       
   "errorReportLocation": { 
      "bucket": "amzn-s3-demo-bucket-for-errors",
      "prefix": "amzn-s3-demo-bucket-for-errors-prefix"
   },
   "files": [ 
      { 
         "bucket": "amzn-s3-demo-bucket-data",
         "key": "data-bucket-key",
         "versionId": "data-bucket-version-id"
      }
   ],
   "jobConfiguration": { 
      "fileFormat": { 
         "csv": { 
            "columnNames": [ "column-name" ]
         }
      }
   },
   "jobName": "job-name",
   "jobRoleArn": "job-role-arn"    
}
```

**Example risposta**  

```
{
   "jobId":"f8c031d0-01d1-4b94-90b1-afe8bb93b7e5",
   "jobStatus":"PENDING",
   "jobName":"myBulkImportJob"
}
```