Nach reiflicher Überlegung haben wir uns entschieden, Amazon Kinesis Data Analytics für SQL-Anwendungen einzustellen: 1. Ab dem **1. September 2025** werden wir keine Bugfixes für Amazon Kinesis Data Analytics for SQL-Anwendungen bereitstellen, da wir aufgrund der bevorstehenden Einstellung nur eingeschränkten Support dafür haben werden. 2. Ab dem **15. Oktober 2025** können Sie keine neuen Kinesis Data Analytics for SQL-Anwendungen mehr erstellen. 3. 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](discontinuation.md). 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. # AddApplicationReferenceDataSource **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](/kinesisanalytics/latest/apiv2/Welcome.html). Fügt einer bestehenden Anwendung eine Referenzdatenquelle hinzu. Amazon-Kinesis-Analytics liest Referenzdaten (d. h. ein Amazon-S3-Objekt) und erstellt eine In-Application-Tabelle innerhalb Ihrer Anwendung. In der Anforderung geben Sie die Quelle (S3-Bucket-Name und Objektschlüsselname), den Namen der zu erstellenden In-Application-Tabelle und die notwendigen Zuordnungsinformationen an. Diese beschreiben, wie Daten im Amazon-S3-Objekt auf Spalten in der resultierenden In-Application-Tabelle abgebildet werden. Konzeptuelle Informationen finden Sie unter [Konfiguration des Anwendungseingangs](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html). Die Begrenzungen der Datenquellen, die Sie Ihrer Anwendung hinzufügen können, finden Sie unter [Begrenzungen](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html). Diese Operation erfordert zur Ausführung der `kinesisanalytics:AddApplicationOutput`-Aktion Berechtigungen. ## Anforderungssyntax ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "ReferenceDataSource": { "ReferenceSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "S3ReferenceDataSource": { "BucketARN": "string", "FileKey": "string", "ReferenceRoleARN": "string" }, "TableName": "string" } } ``` ## Anforderungsparameter Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [ApplicationName](#API_AddApplicationReferenceDataSource_RequestSyntax) ** Name einer bestehenden Anwendung. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen. Pattern: `[a-zA-Z0-9_.-]+` Erforderlich: Ja ** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) ** Version der Anwendung, für die Sie die Referenzdatenquelle hinzufügen. Sie können den [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html)Vorgang verwenden, um die aktuelle Anwendungsversion abzurufen. Wenn die angegebene Version nicht die aktuelle Version ist, wird `ConcurrentModificationException` zurückgegeben. Type: Long Gültiger Bereich: Mindestwert 1. Maximaler Wert von 999999999. Erforderlich: Ja ** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) ** Die Referenzdatenquelle kann ein Objekt in Ihrem Amazon-S3-Bucket sein. Amazon-Kinesis-Analytics liest das Objekt und kopiert die Daten in die erstellte In-Application-Tabelle. Sie stellen einen S3-Bucket, den Namen des Objektschlüssels und die daraus resultierende In-Applikation-Tabelle bereit. Sie müssen einer IAM-Rolle außerdem Berechtigungen geben, die Amazon-Kinesis-Analytics annehmen kann, um das Objekt in Ihrem S3-Bucket in Ihrem Namen zu lesen. Typ: [ReferenceDataSource](API_ReferenceDataSource.md) Objekt Erforderlich: Ja ## Antwortelemente Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück. ## Fehler ** ConcurrentModificationException ** Ausnahme, die als Ergebnis einer gleichzeitigen Änderung an einer Anwendung ausgelöst wurde. Beispiel: Zwei Personen versuchen, dieselbe Anwendung gleichzeitig zu bearbeiten. ** message ** HTTP-Statuscode: 400 ** InvalidArgumentException ** Der angegebene Eingabeparameterwert ist ungültig. ** message ** HTTP-Statuscode: 400 ** ResourceInUseException ** Die Anwendung ist für diesen Vorgang nicht verfügbar. ** message ** HTTP-Statuscode: 400 ** ResourceNotFoundException ** Die angegebene Anwendung kann nicht gefunden werden. ** message ** 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: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)