Criar um trabalho de importação em massa (AWS CLI)

Você pode usar a operação CreateBulkImportJobda API para transferir dados do Amazon S3 paraAWS IoT SiteWise o. O exemplo a seguir usa AWS CLI.

Importante

Você deveAWS IoT SiteWise habilitar a exportação de dados para o Amazon S3 antes de criar um trabalho de importação em massa. Para obter mais informações sobre como definir as configurações de armazenamento, consulteDefinindo configurações de armazenamento.

Execute o comando a seguir. Substitua file-name pelo nome do arquivo que contém a configuração da trabalho de importação em massa.

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

exemplo configuração do trabalho de importação em massa

• Substitua error-bucket pelo nome do bucket do Amazon S3 para o qual os erros associados a esse trabalho de importação em massa são enviados.

• error-bucket-prefixSubstitua pelo prefixo do bucket do Amazon S3 para o qual os erros associados a esse trabalho de importação em massa são enviados.

  O Amazon S3 usa o prefixo como nome de pasta para organizar dados no bucket. Cada objeto do Amazon S3 tem uma chave que é seu identificador exclusivo no bucket. Cada objeto em um bucket tem exatamente uma chave. O prefixo deve terminar com uma barra (/). Para obter mais informações, consulte Organizar objetos usando prefixos no Guia do usuário do Amazon Simple Storage Service.

• Substitua data-Bucket pelo nome do bucket do Amazon S3 do Amazon S3 do qual os dados são importados.

• data-bucket-keySubstitua pela chave do objeto Amazon S3 que contém seus dados. Cada objeto tem uma chave que é um identificador exclusivo. Cada objeto tem exatamente uma chave.

• data-bucket-version-idSubstitua pelo ID da versão para identificar uma versão específica do objeto Amazon S3 que contém seus dados. Esse parâmetro é opcional.

• Substitua o nome da coluna pelo nome da coluna especificado no arquivo.csv.

• Substitua o nome do trabalho por um nome exclusivo que identifique o trabalho de importação em massa.

• job-role-arnSubstitua pela função IAM queAWS IoT SiteWise permite ler dados do Amazon S3.

  nota

  Certifique-se de que sua função tenha as permissões mostradas no exemplo a seguir. Substitua data-a-Bucket pelo nome do bucket do Amazon S3 que contém seus dados e error-pelo nome do bucket do Amazon S3 que contém seus dados.

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

{
   "errorReportLocation": { 
      "bucket": "error-bucket",
      "prefix": "error-bucket-prefix"
   },
   "files": [ 
      { 
         "bucket": "data-bucket",
         "key": "data-bucket-key",
         "versionId": "data-bucket-version-id"
      }
   ],
   "jobConfiguration": { 
      "fileFormat": { 
         "csv": { 
            "columnNames": [ "column-name" ]
         }
      }
   },
   "jobName": "job-name",
   "jobRoleArn": "job-role-arn"
}

exemplo response

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