Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# DiscoverInputSchema
<a name="API_DiscoverInputSchema"></a>

Leitet ein Schema für eine SQL-basierte Kinesis Data Analytics Analytics-Anwendung ab, indem Beispieldatensätze auf der angegebenen Streaming-Quelle (Kinesis-Datenstream oder Kinesis Data Firehose-Lieferstream) oder dem Amazon S3 S3-Objekt ausgewertet werden. In der Antwort gibt die Operation das abgeleitete Schema und auch die Beispieldatensätze zurück, die bei der Operation zur Ableitung des Schemas verwendet wurden.

 Sie können das abgeleitete Schema bei der Konfiguration einer Streaming-Quelle für Ihre Anwendung verwenden. Wenn Sie eine Anwendung mit der Kinesis Data Analytics Analytics-Konsole erstellen, verwendet die Konsole diesen Vorgang, um ein Schema abzuleiten und es in der Benutzeroberfläche der Konsole anzuzeigen. 

## Anforderungssyntax
<a name="API_DiscoverInputSchema_RequestSyntax"></a>

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

## Anforderungsparameter
<a name="API_DiscoverInputSchema_RequestParameters"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-InputProcessingConfiguration"></a>
Der[InputProcessingConfiguration](API_InputProcessingConfiguration.md), der zur Vorverarbeitung der Datensätze verwendet werden soll, bevor das Schema der Datensätze ermittelt wird.  
Typ: [InputProcessingConfiguration](API_InputProcessingConfiguration.md) Objekt  
Erforderlich: Nein

 ** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-InputStartingPositionConfiguration"></a>
Der Punkt, an dem Kinesis Data Analytics mit dem Lesen von Datensätzen aus der angegebenen Streaming-Quelle zu Ermittlungszwecken beginnen soll.  
Typ: [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) Objekt  
Erforderlich: Nein

 ** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-ResourceARN"></a>
Der Amazon-Ressourcenname (ARN) der Streaming-Quelle.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.  
Pattern: `arn:.*`   
Erforderlich: Nein

 ** [S3Configuration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-S3Configuration"></a>
Geben Sie diesen Parameter an, um ein Schema anhand von Daten in einem Amazon-S3-Objekt zu ermitteln.  
Typ: [S3Configuration](API_S3Configuration.md) Objekt  
Erforderlich: Nein

 ** [ServiceExecutionRole](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-ServiceExecutionRole"></a>
Der ARN der Rolle, die für den Zugriff auf die Streaming-Quelle verwendet wird.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.  
Pattern: `arn:.*`   
Erforderlich: Ja

## Antwortsyntax
<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" ]
}
```

## Antwortelemente
<a name="API_DiscoverInputSchema_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [InputSchema](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-InputSchema"></a>
Das von der Streaming-Quelle abgeleitete Schema. Erkennt das Format der Daten in der Streaming-Quelle, und wie jedes Datenelement auf die entsprechenden Spalten im In-Application-Stream abgebildet wird, die Sie erzeugen können.  
Typ: [SourceSchema](API_SourceSchema.md) Objekt

 ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-ParsedInputRecords"></a>
Ein Array von Elementen, wobei jedes Element einer Zeile in einem Stream-Datensatz entspricht (ein Stream-Datensatz kann mehr als eine Zeile enthalten).  
Typ: Array von Arrays von Strings

 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-ProcessedInputRecords"></a>
Die Stream-Daten, die von dem im `InputProcessingConfiguration` Parameter angegebenen Prozessor geändert wurden.  
Typ: Zeichenfolgen-Array

 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-RawInputRecords"></a>
Die rohen Stream-Daten, aus denen Stichproben entnommen wurden, um das Schema abzuleiten.  
Typ: Zeichenfolgen-Array

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

 ** InvalidArgumentException **   
Der angegebene Eingabeparameterwert ist nicht gültig.  
HTTP-Statuscode: 400

 ** InvalidRequestException **   
Die JSON-Anforderung ist für den Vorgang nicht gültig.  
HTTP-Statuscode: 400

 ** ResourceProvisionedThroughputExceededException **   
Discovery konnte aufgrund der Kinesis Streams `ProvisionedThroughputExceededException` keinen Datensatz von der Streaming-Quelle abrufen. Weitere Informationen finden Sie [GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html)in der Amazon Kinesis Streams API-Referenz.  
HTTP-Statuscode: 400

 ** ServiceUnavailableException **   
Der Service kann die Anfrage nicht abschließen.  
HTTP Status Code: 500

 ** UnableToDetectSchemaException **   
Das Datenformat ist nicht gültig. Kinesis Data Analytics kann das Schema für die angegebene Streaming-Quelle nicht erkennen.    
 ** ProcessedInputRecords **   
Streamen Sie Daten, die von dem im `InputProcessingConfiguration`-Parameter angegebenen Prozessor geändert wurden.   
 ** RawInputRecords **   
Stream-Rohdaten, aus denen Stichproben entnommen wurden, um das Schema abzuleiten.
HTTP-Statuscode: 400

 ** UnsupportedOperationException **   
Die Anfrage wurde abgelehnt, weil ein bestimmter Parameter nicht unterstützt wird oder eine angegebene Ressource für diesen Vorgang nicht gültig ist.   
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_DiscoverInputSchema_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema)