CreateDatasetImportJob - Amazon Forecast
Sintaxe da SolicitaçãoParâmetros da solicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. Saiba mais

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

CreateDatasetImportJob

Importa os dados do treinamento para um conjunto de dados do Amazon Forecast. Você fornece a localização dos seus dados de treinamento em um bucket do Amazon Simple Storage Service (Amazon S3) e o Amazon Resource Name ARN () do conjunto de dados para o qual você deseja importar os dados.

Importante

O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. Saiba mais

Você deve especificar um DataSourceobjeto que inclua uma função AWS Identity and Access Management (IAM) que o Amazon Forecast possa assumir para acessar os dados, pois o Amazon Forecast faz uma cópia dos seus dados e os processa em um AWS sistema interno. Para obter mais informações, consulte Configurar permissões.

Os dados de treinamento devem estar no CSV formato Parquet. O delimitador deve ser uma vírgula (,).

Você pode especificar um caminho para um arquivo específico, para o bucket do S3 ou para uma pasta no bucket do S3. Nos dois últimos casos, o Amazon Forecast importa todos os arquivos até o limite de 10.000 arquivos.

Como as importações de conjuntos de dados não são agregadas, sua importação mais recente de conjuntos de dados é a utilizada ao treinar um preditor ou gerar uma previsão. Certifique-se de que sua importação mais recente de conjuntos de dados contém todos os dados dos quais você deseja modelar, e não apenas os novos dados coletados desde a importação anterior.

Para obter uma lista de todos os seus trabalhos de importação de conjuntos de dados, filtrados por critérios especificados, use a ListDatasetImportJobsoperação.

Sintaxe da Solicitação

{
   "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
}

Parâmetros da solicitação

A solicitação aceita os seguintes dados no JSON formato.

DatasetArn

O Amazon Resource Name (ARN) do conjunto de dados Amazon Forecast para o qual você deseja importar dados.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: arn:([a-z\d-]+):forecast:.*:.*:.+

Exigido: Sim

DatasetImportJobName

O nome do trabalho de importação do conjunto de dados. Recomendamos incluir o carimbo de data e hora atual no nome, por exemplo, 20190721DatasetImport. Isso pode ajudar você a evitar a exceção ResourceAlreadyExistsException.

Tipo: string

Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63.

Padrão: ^[a-zA-Z][a-zA-Z0-9_]*

Exigido: Sim

DataSource

A localização dos dados de treinamento a serem importados e uma função AWS Identity and Access Management (IAM) que o Amazon Forecast pode assumir para acessar os dados. Os dados de treinamento devem ser armazenados em um bucket do Amazon S3.

Se a criptografia for usada, DataSource deve incluir uma chave AWS Key Management Service (KMS) e a IAM função deve permitir que a Amazon Forecast acesse a chave. A KMS chave e a IAM função devem corresponder às especificadas no EncryptionConfig parâmetro da CreateDatasetoperação.

Tipo: objeto DataSource

Obrigatório: Sim

Format

O formato dos dados importados CSV ouPARQUET. O valor padrão éCSV.

Tipo: string

Restrições de Tamanho: O tamanho máximo é 7.

Padrão: ^CSV|PARQUET$

Obrigatório: Não

GeolocationFormat

O formato do atributo de geolocalização. O atributo de geolocalização pode ser formatado de duas maneiras:

  • LAT_LONG - a latitude e a longitude em formato decimal (Exemplo: 47,61_-122,33).

  • CC_POSTALCODE(Somente nos EUA) - o código do país (EUA), seguido pelo ZIP código de 5 dígitos (exemplo: US_98121).

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: ^[a-zA-Z0-9_]+$

Obrigatório: Não

ImportMode

Especifica se o trabalho de importação de conjunto de dados é uma importação FULL ou INCREMENTAL. A importação de conjunto de dados FULL substitui todos os dados existentes pelos dados recém-importados. Uma importação INCREMENTAL anexa os dados importados aos dados existentes.

Tipo: string

Valores Válidos: FULL | INCREMENTAL

Obrigatório: Não

Tags

Os metadados opcionais que você aplica ao trabalho de importação de conjunto de dados para categorizá-los e organizá-los. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você.

As restrições básicas a seguir se aplicam a tags:

  • Número máximo de tags por recurso: 50.

  • Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor.

  • Tamanho máximo da chave - 128 caracteres Unicode em UTF -8.

  • Tamanho máximo do valor - 256 caracteres Unicode em UTF -8.

  • Caso seu esquema de marcação seja usado em vários serviços e recursos , lembre-se de que outros serviços podem possuir restrições em caracteres permitidos. Os caracteres geralmente permitidos são: letras, números e espaços representáveis em UTF -8 e os seguintes caracteres: + - =. _:/@.

  • As chaves e valores das tags diferenciam maiúsculas de minúsculas.

  • Não use aws:AWS:, ou qualquer combinação de maiúsculas ou minúsculas, como um prefixo para teclas, pois está reservado para uso. AWS Você não pode editar nem excluir chaves de tag com esse prefixo. Os valores podem ter esse prefixo. Se um valor de tag tiver aws como prefixo, mas a chave não, o Forecast o considerará uma tag de usuário e o contabilizará no limite de 50 tags. As tags que têm apenas o prefixo de chave aws não são contabilizadas entre suas tags por limite de recurso.

Tipo: matriz de objetos Tag

Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.

Obrigatório: Não

TimestampFormat

O formato dos carimbos de data/hora no conjunto de dados. O formato que você especifica depende da DataFrequency especificada quando o conjunto de dados foi criado. Os formatos a seguir são compatíveis.

  • “aaaa-MM-dd”

    Para as seguintes frequências de dados: A, M, S e D

  • “aaaa-MM-dd HH:mm:ss”

    Para as seguintes frequências de dados: H, 30 min, 15 min e 1 min; e opcionalmente, para: A, M, S e D

Se o formato não for especificado, o Amazon Forecast espera que o formato seja “aaaa-MM-dd HH:mm:ss”.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

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

Obrigatório: Não

TimeZone

Um único fuso horário de cada item em seu conjunto de dados. Essa opção é ideal para conjuntos de dados com todos os carimbos de data/hora em um único fuso horário ou se todos os carimbos de data/hora estiverem normalizados para um único fuso horário.

Consulte o Joda-Time API para obter uma lista completa dos nomes de fuso horário válidos.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: ^[a-zA-Z0-9\/\+\-\_]+$

Obrigatório: Não

UseGeolocationForTimeZone

Derive automaticamente as informações de fuso horário do atributo de geolocalização. Essa opção é ideal para conjuntos de dados que contêm carimbos de data/hora em vários fusos horários, esses carimbos de data/hora são expressos no horário local.

Tipo: booliano

Obrigatório: não

Sintaxe da Resposta

{
   "DatasetImportJobArn": "string"
}

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.

Os dados a seguir são retornados em JSON formato pelo serviço.

DatasetImportJobArn

O Amazon Resource Name (ARN) do trabalho de importação do conjunto de dados.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: arn:([a-z\d-]+):forecast:.*:.*:.+

Erros

InvalidInputException

Não podemos processar a solicitação porque ela inclui um valor inválido ou um valor que excede o intervalo válido.

HTTPCódigo de status: 400

LimitExceededException

O limite do número de recursos por conta foi excedido.

HTTPCódigo de status: 400

ResourceAlreadyExistsException

Já existe um recurso com esse nome. Tente novamente com outro nome.

HTTPCódigo de status: 400

ResourceInUseException

O recurso especificado está em uso.

HTTPCódigo de status: 400

ResourceNotFoundException

Não conseguimos encontrar um recurso com esse nome de recurso da Amazon (ARN). Verifique ARN e tente novamente.

HTTPCódigo de status: 400

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: