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á.
DiscoverInputSchema
Deduz um esquema para um aplicativo Kinesis Data Analytics baseado em SQL avaliando registros de amostra na fonte de streaming especificada (stream de dados do Kinesis ou stream de distribuição do Kinesis Data Firehose) ou objeto do Amazon S3. Na resposta, a operação retorna o esquema inferido e também os registros de amostra que a operação usou para inferir o esquema.
Você pode usar o esquema inferido ao configurar uma origem de streaming para seu aplicativo. Quando você cria um aplicativo usando o console do Kinesis Data Analytics, o console usa essa operação para inferir um esquema e mostrá-lo na interface de usuário do console.
Sintaxe da Solicitação
{
"InputProcessingConfiguration": {
"InputLambdaProcessor": {
"ResourceARN": "string
"
}
},
"InputStartingPositionConfiguration": {
"InputStartingPosition": "string
"
},
"ResourceARN": "string
",
"S3Configuration": {
"BucketARN": "string
",
"FileKey": "string
"
},
"ServiceExecutionRole": "string
"
}
Parâmetros da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- InputProcessingConfiguration
-
O InputProcessingConfiguration a ser usado para pré-processar os registros antes de descobrir o esquema dos registros.
Tipo: objeto InputProcessingConfiguration
Obrigatório: Não
- InputStartingPositionConfiguration
-
O ponto em que você deseja que o Kinesis Data Analytics comece a ler registros da fonte de streaming especificada para fins de descoberta.
Tipo: objeto InputStartingPositionConfiguration
Obrigatório: Não
- ResourceARN
-
O nome do recurso da Amazon (ARN) da origem do streaming do Kinesis.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.
Padrão:
arn:.*
Obrigatório: não
- S3Configuration
-
Especifique esse parâmetro para descobrir um esquema de dados em um objeto do Amazon S3.
Tipo: objeto S3Configuration
Obrigatório: Não
- ServiceExecutionRole
-
O ARN do perfil usado para acessar a origem do streaming.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.
Padrão:
arn:.*
Exigido: Sim
Sintaxe da Resposta
{
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"ParsedInputRecords": [
[ "string" ]
],
"ProcessedInputRecords": [ "string" ],
"RawInputRecords": [ "string" ]
}
Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- InputSchema
-
O esquema inferido da origem do streaming. Ele identifica o formato dos dados na origem do streaming e como cada elemento de dados é mapeado para as colunas correspondentes que são criadas no fluxo na aplicação.
Tipo: objeto SourceSchema
- ParsedInputRecords
-
Uma matriz de elementos, em que cada elemento corresponde a uma linha em um registro de fluxo (um registro de fluxo pode ter mais de uma linha).
Tipo: matriz das matrizes de strings
- ProcessedInputRecords
-
Os dados do fluxo que foram modificados pelo processador especificado no parâmetro
InputProcessingConfiguration
.Tipo: matriz de strings
- RawInputRecords
-
Os dados brutos do fluxo que foram amostrados para inferir o esquema.
Tipo: matriz de strings
Erros
- InvalidArgumentException
-
O valor do parâmetro de entrada especificado não é válido.
Código de Status HTTP: 400
- InvalidRequestException
-
A solicitação de JSON não é válida para a operação.
Código de Status HTTP: 400
- ResourceProvisionedThroughputExceededException
-
O Discovery não conseguiu obter um registro da origem do streaming por causa do Kinesis Streams
ProvisionedThroughputExceededException
. Para obter mais informações, consulte a GetRecordsReferência da API do Amazon Kinesis Streams.Código de Status HTTP: 400
- ServiceUnavailableException
-
O serviço não pode concluir a solicitação.
Código de Status HTTP: 500
- UnableToDetectSchemaException
-
O formato de dados é inválido. O Kinesis Data Analytics não consegue detectar o esquema de uma determinada fonte de streaming.
Código de Status HTTP: 400
- UnsupportedOperationException
-
A solicitação foi rejeitada porque um parâmetro especificado não é compatível ou um recurso especificado não é válido para esta operação.
Código de Status HTTP: 400
Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: