慎重に検討した結果、Amazon Kinesis Data Analytics for SQL アプリケーションを中止することにしました。 1. **2025 年 9 月 1** 日以降、Amazon Kinesis Data Analytics for SQL アプリケーションのバグ修正は提供されません。これは、今後の廃止によりサポートが制限されるためです。 2. **2025 年 10 月 15** 日以降、新しい Kinesis Data Analytics for SQL アプリケーションを作成することはできません。 3. **2026 年 1 月 27 日**以降、アプリケーションは削除されます。Amazon Kinesis Data Analytics for SQL アプリケーションを起動することも操作することもできなくなります。これ以降、Amazon Kinesis Data Analytics for SQL のサポートは終了します。詳細については、「[Amazon Kinesis Data Analytics for SQL アプリケーションのサポート終了](discontinuation.md)」を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # エラー処理 Amazon Kinesis Data Analytics は、API や SQL のエラーを直接ユーザーに返します。API オペレーションの詳細については、「[アクション](API_Operations.md)」を参照してください。SQL エラーの処理の詳細については、「[Amazon Kinesis Data Analytics SQL Reference](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/analytics-sql-reference.html)」を参照してください。 Amazon Kinesis Data Analytics は、`error_stream` というアプリケーション内エラーストリームを使用して、ランタイムエラーをレポートします。 ## アプリケーション内エラーストリームを使用してエラーをレポートする Amazon Kinesis Data Analytics は、`error_stream` というアプリケーション内エラーストリームを使用して、ランタイムエラーをレポートします。発生する可能性のあるエラーの例を以下に示します。 + ストリーミングソースから読み取られたレコードが入力スキーマに適合していない。 + アプリケーションコードがゼロでの除算を指定している。 + 行が入れ替わっている (たとえば、ユーザーによって `ROWTIME` 値が変更されたレコードがストリームに現れると、レコードの順序が乱れます)。 + ソースストリームのデータをスキーマで指定されたデータ型に変換することはできません (強制エラー)。変換できるデータ型の詳細については、「[JSON データ型から SQL データ型へのマッピング](sch-mapping.md#sch-mapping-datatypes)」を参照してください。 これらのエラーは、SQL コードでプログラム的に処理するか、外部宛先へのエラーストリームにデータを保持することをお勧めします。これには、アプリケーションに出力設定を追加する必要があります (「[アプリケーション出力の設定](how-it-works-output.md)」を参照)。アプリケーション内エラーストリームの動作の例については、「[例: アプリケーション内エラーストリームの確認](app-explore-error-stream.md)」を参照してください。 **注記** エラーストリームはシステムアカウントを使用して作成されるため、Kinesis Data Analytics アプリケーションはプログラムでエラーストリームにアクセスすることや、エラーストリームを変更することはできません。エラー出力を使用して、アプリケーションで発生する可能性のあるエラーを確認する必要があります。次に、アプリケーションの SQL コードを記述して、予期されるエラー条件を処理します。 ### エラーストリームのスキーマ エラーストリームには、次のスキーマがあります。 **** | | | | | --- |--- |--- | | *フィールド* | *データ型* | *Notes* (メモ) | | ERROR\$1TIME | TIMESTAMP | エラーが発生した時刻。 | | ERROR\$1LEVEL | VARCHAR(10) | | | ERROR\$1NAME | VARCHAR(32) | | | MESSAGE | VARCHAR(4096) | | | DATA\$1ROWTIME | TIMESTAMP | 受信レコードの ROWTIME。 | | DATA\$1ROW | VARCHAR(49152) | 元の行の 16 進エンコードデータ。標準ライブラリを使用してこの値を 16 進数でデコードするか、この [Hex to String Converter](http://string-functions.com/hex-string.aspx) などのウェブリソースを使用できます。 | | PUMP\$1NAME | VARCHAR(128) | `CREATE PUMP` で定義されている送信ポンプ。 |