

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Crea un trabajo de importación AWS IoT SiteWise masiva ()AWS CLI
<a name="CreateBulkImportJob"></a>

Utilice la operación de [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)API para transferir datos de Amazon S3 a AWS IoT SiteWise. La [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)API permite la ingesta de grandes volúmenes de datos históricos y la ingesta en búfer de flujos de datos analíticos en lotes pequeños. Proporciona un método básico rentable para la ingesta de datos. El siguiente ejemplo utiliza AWS CLI.

**importante**  
Antes de crear un trabajo de importación masiva, debe habilitar el nivel AWS IoT SiteWise cálido o el nivel frío. AWS IoT SiteWise Para obtener más información, consulte [Configure los ajustes de almacenamiento en AWS IoT SiteWise](configure-storage.md).  
 La [CreateBulkImportJob](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateBulkImportJob.html)API admite la ingesta de datos históricos AWS IoT SiteWise con la opción de configurar el adaptive-ingestion-flag parámetro.   
Cuando se configura en `false`, la API ingiere datos históricos sin activar cálculos ni notificaciones.
Cuando se configura en `true`, la API ingiere nuevos datos, calculando métricas y transformando los datos para optimizar los análisis y las notificaciones continuos en un plazo de siete días.

Ejecute el comando siguiente. *file-name*Sustitúyalo por el nombre del archivo que contiene la configuración del trabajo de importación masiva.

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

**Example Configuración de trabajos de importación masiva**  
A continuación se ofrecen ejemplos de configuración:  
+ Reemplace *adaptive-ingestion-flag* por `true` o `false`.
  + Si se establece en `false`, el trabajo de importación masiva ingiere datos históricos en AWS IoT SiteWise.
  + Si se establece en `true`, el trabajo de importación masiva hace lo siguiente:
    + Ingiere nuevos datos en. AWS IoT SiteWise
    + Calcula métricas y transformaciones, y admite notificaciones de datos con una marca de tiempo de siete días.
+ *delete-files-after-import-flag*Sustitúyalos por `true` para eliminar los datos del depósito de datos de Amazon S3 después de ingerirlos en un almacenamiento de nivel AWS IoT SiteWise cálido.
+ Sustituya amzn-s3-demo-bucket por el *-for-errors* nombre del bucket de Amazon S3 al que se envían los errores asociados a este trabajo de importación masiva.
+ Sustituya amzn-s3-demo-bucket por el *-for-errors-prefix* prefijo del bucket de Amazon S3 al que se envían los errores asociados a este trabajo de importación masiva. 

  Amazon S3 usa el prefijo como nombre de carpeta para organizar los datos del bucket. Cada objeto de Amazon S3 tiene una clave que es su identificador único en el bucket. Cada objeto de un bucket tiene exactamente una clave. El prefijo debe terminar con una barra diagonal: (/). Para obtener más información, consulte [Organizar objetos usando prefijos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) en la *Guía para usuarios de Amazon Simple Storage Service*.
+ Sustituya amzn-s3-demo-bucket por el *-data* nombre del bucket de Amazon S3 desde el que se importan los datos.
+ *data-bucket-key*Sustitúyala por la clave del objeto de Amazon S3 que contiene los datos. Cada objeto tiene una clave que es un identificador único. Cada objeto tiene exactamente una clave.
+ *data-bucket-version-id*Sustitúyalo por el ID de versión para identificar una versión específica del objeto de Amazon S3 que contiene sus datos. Este parámetro es opcional.
+ *column-name*Sustitúyalo por el nombre de la columna especificado en el archivo.csv.
+ *job-name*Sustitúyalo por un nombre único que identifique el trabajo de importación masiva.
+ *job-role-arn*Sustitúyalo por el rol de IAM que AWS IoT SiteWise permite leer los datos de Amazon S3.
Asegúrese de que el rol tenga los permisos que se muestran en el siguiente ejemplo. Sustituya amzn-s3-demo-bucket por el *-data* nombre del bucket de Amazon S3 que contiene los datos. Además, *amzn-s3-demo-bucket-for-errors* sustitúyalo por el nombre del bucket de Amazon S3 al que se envían los errores asociados a este trabajo de importación masiva.    
****  

```
{
    "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 response**  

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