Nach reiflicher Überlegung haben wir beschlossen, Amazon Kinesis Data Analytics für SQL-Anwendungen in zwei Schritten einzustellen:
1. Ab dem 15. Oktober 2025 können Sie keine neuen Kinesis Data Analytics for SQL-Anwendungen mehr erstellen.
2. Wir werden Ihre Anwendungen ab dem 27. Januar 2026 löschen. Sie können Ihre Amazon Kinesis Data Analytics for SQL-Anwendungen nicht starten oder betreiben. Ab diesem Zeitpunkt ist kein Support mehr für Amazon Kinesis Data Analytics for SQL verfügbar. Weitere Informationen finden Sie unter Einstellung von Amazon Kinesis Data Analytics für SQL-Anwendungen.
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
Anmerkung
Diese Dokumentation bezieht sich auf Version 1 der Amazon-Kinesis-Data-Analytics-API, die nur SQL-Anwendungen unterstützt. Version 2 der API unterstützt SQL- und Java-Anwendungen. Weitere Informationen zu Version 2 finden Sie in der Amazon-Kinesis-Data-Analytics-API-V2-Dokumentation.
Leitet ein Schema ab, indem Beispieldatensätze für die angegebene Streaming-Quelle (Amazon-Kinesis-Stream oder Amazon-Kinesis Firehose-Bereitstellungsstream) oder das 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. Konzeptuelle Informationen finden Sie unter Konfiguration des Anwendungseingangs. Beachten Sie, dass, wenn Sie eine Anwendung mit der Amazon-Kinesis-Analytics-Konsole erstellen, die Konsole diesen Vorgang verwendet, um ein Schema abzuleiten und es in der Benutzeroberfläche der Konsole anzuzeigen.
Diese Operation erfordert zur Ausführung der kinesisanalytics:DiscoverInputSchema-Aktion Berechtigungen.
Anforderungssyntax
{
"InputProcessingConfiguration": {
"InputLambdaProcessor": {
"ResourceARN": "string",
"RoleARN": "string"
}
},
"InputStartingPositionConfiguration": {
"InputStartingPosition": "string"
},
"ResourceARN": "string",
"RoleARN": "string",
"S3Configuration": {
"BucketARN": "string",
"FileKey": "string",
"RoleARN": "string"
}
}Anforderungsparameter
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- InputProcessingConfiguration
-
Der InputProcessingConfiguration, der verwendet werden soll, um die Datensätze vorzuverarbeiten, bevor das Schema der Datensätze ermittelt wird.
Typ: InputProcessingConfiguration Objekt
Erforderlich: Nein
- InputStartingPositionConfiguration
-
Punkt, an dem Amazon-Kinesis-Analytics mit dem Lesen von Datensätzen für den angegebenen Zweck der Streaming-Quellenerkennung beginnen soll.
Typ: InputStartingPositionConfiguration Objekt
Erforderlich: Nein
- ResourceARN
-
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
- RoleARN
-
Der ARN der IAM-Rolle, den Amazon-Kinesis-Analytics verwenden kann, um für Sie auf den Stream zuzugreifen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.
Pattern:
arn:.*Erforderlich: Nein
- S3Configuration
-
Geben Sie diesen Parameter an, um ein Schema anhand von Daten in einem Amazon-S3-Objekt zu ermitteln.
Typ: S3Configuration Objekt
Erforderlich: Nein
Antwortsyntax
{
"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
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
-
Aus der Streaming-Quelle abgeleitetes 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 Objekt
- ParsedInputRecords
-
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
-
Streamen Sie Daten, die von dem im
InputProcessingConfiguration-Parameter angegebenen Prozessor geändert wurden.Typ: Zeichenfolgen-Array
- RawInputRecords
-
Stream-Rohdaten, aus denen Stichproben entnommen wurden, um das Schema abzuleiten.
Typ: Zeichenfolgen-Array
Fehler
- InvalidArgumentException
-
Der angegebene Eingabeparameterwert ist ungültig.
HTTP Status Code: 400
- ResourceProvisionedThroughputExceededException
-
Discovery konnte aufgrund der Amazon Kinesis Streams ProvisionedThroughputExceededException keinen Datensatz von der Streaming-Quelle abrufen. Weitere Informationen finden Sie GetRecordsin der Amazon Kinesis Streams API-Referenz.
HTTP Status Code: 400
- ServiceUnavailableException
-
Der Service ist nicht verfügbar. Gehen Sie zurück und versuchen Sie den Vorgang erneut.
HTTP Status Code: 500
- UnableToDetectSchemaException
-
Das Datumsformat ist nicht gültig. Amazon-Kinesis-Analytics kann für die angegebene Streaming-Quelle kein Schema erkennen.
HTTP Status Code: 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 Status Code: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
