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
<a name="API_DiscoverInputSchema"></a>

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 do usuário do console. 

## Sintaxe da solicitação
<a name="API_DiscoverInputSchema_RequestSyntax"></a>

```
{
   "InputProcessingConfiguration": { 
      "InputLambdaProcessor": { 
         "ResourceARN": "string"
      }
   },
   "InputStartingPositionConfiguration": { 
      "InputStartingPosition": "string"
   },
   "ResourceARN": "string",
   "S3Configuration": { 
      "BucketARN": "string",
      "FileKey": "string"
   },
   "ServiceExecutionRole": "string"
}
```

## Parâmetros da solicitação
<a name="API_DiscoverInputSchema_RequestParameters"></a>

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

 ** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-InputProcessingConfiguration"></a>
O [InputProcessingConfiguration](API_InputProcessingConfiguration.md) a ser usado para pré-processar os registros antes de descobrir o esquema dos registros.  
Tipo: objeto [InputProcessingConfiguration](API_InputProcessingConfiguration.md)  
Obrigatório: não

 ** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-InputStartingPositionConfiguration"></a>
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](API_InputStartingPositionConfiguration.md)  
Obrigatório: não

 ** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-ResourceARN"></a>
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](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-S3Configuration"></a>
Especifique esse parâmetro para descobrir um esquema a partir dos dados em um objeto do Amazon S3.  
Tipo: objeto [S3Configuration](API_S3Configuration.md)  
Obrigatório: não

 ** [ServiceExecutionRole](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-ServiceExecutionRole"></a>
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:.*`   
Obrigatório: sim

## Sintaxe da resposta
<a name="API_DiscoverInputSchema_ResponseSyntax"></a>

```
{
   "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
<a name="API_DiscoverInputSchema_ResponseElements"></a>

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](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-InputSchema"></a>
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](API_SourceSchema.md)

 ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-ParsedInputRecords"></a>
Uma matriz de elementos, em que cada elemento corresponde a uma linha em um registro de stream (um registro de stream pode ter mais de uma linha).  
Tipo: matriz das matrizes de strings

 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-ProcessedInputRecords"></a>
Os dados do fluxo que foram modificados pelo processador especificado no parâmetro `InputProcessingConfiguration`.  
Tipo: matriz de strings

 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-RawInputRecords"></a>
Os dados brutos do fluxo que foram amostrados para inferir o esquema.  
Tipo: matriz de strings

## Erros
<a name="API_DiscoverInputSchema_Errors"></a>

 ** 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 [GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html)Referê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.    
 ** ProcessedInputRecords **   
Transmita dados que foram modificados pelo processador especificado no parâmetro `InputProcessingConfiguration`.   
 ** RawInputRecords **   
Dados brutos do stream que foram amostrados para inferir o esquema.
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 essa operação.   
Código de Status HTTP: 400

## Consulte também
<a name="API_DiscoverInputSchema_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema)