신중한 고려 끝에 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) 단원을 참조하십시오. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # DiscoverInputSchema **참고** 이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 [Amazon Kinesis Data Analytics API V2 설명서](/kinesisanalytics/latest/apiv2/Welcome.html)를 참조하십시오. 지정된 스트리밍 소스 (Amazon Kinesis 스트림 또는 Amazon Kinesis Firehose 전송 스트림) 또는 S3 객체의 샘플 레코드를 평가하여 스키마를 유추합니다. 응답에서 작업은 추론된 스키마와 작업에서 스키마를 추론하는 데 사용한 샘플 레코드를 반환합니다. 애플리케이션의 스트리밍 소스를 구성할 때 유추된 스키마를 사용할 수 있습니다. 개념 정보는 [애플리케이션 입력 구성](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)을 참조하십시오. Amazon Kinesis Analytics 콘솔을 사용하여 애플리케이션을 생성하면 콘솔은 이 작업을 사용하여 스키마를 유추하고 콘솔 사용자 인터페이스에 표시한다는 점에 유의하십시오. 이 작업에는 `kinesisanalytics:DiscoverInputSchema` 조치를 수행할 권한이 요구됩니다. ## 구문 요청 ``` { "InputProcessingConfiguration": { "InputLambdaProcessor": { "ResourceARN": "string", "RoleARN": "string" } }, "InputStartingPositionConfiguration": { "InputStartingPosition": "string" }, "ResourceARN": "string", "RoleARN": "string", "S3Configuration": { "BucketARN": "string", "FileKey": "string", "RoleARN": "string" } } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) ** 레코드의 스키마를 발견하기 전에 레코드를 사전 처리하는 데 사용할 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html). 유형: [InputProcessingConfiguration](API_InputProcessingConfiguration.md)객체 필수 여부: 아니요 ** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) ** Amazon Kinesis Analytics가 지정된 스트리밍 소스 검색 목적의 레코드 읽기를 시작하도록 하려는 시점입니다. 유형: [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md)객체 필수 여부: 아니요 ** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) ** 스트리밍 소스의 Amazon 리소스 이름(ARN). 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 패턴: `arn:.*` 필수 여부: 아니요 ** [RoleARN](#API_DiscoverInputSchema_RequestSyntax) ** Amazon Kinesis Analytics가 스트림에 액세스할 수 있는 권한을 주는 IAM 역할의 ARN입니다. 유형: 문자열 길이 제약: 최소 길이는 1. 최대 길이는 2,048. 패턴: `arn:.*` 필수 여부: 아니요 ** [S3Configuration](#API_DiscoverInputSchema_RequestSyntax) ** Amazon S3 객체의 데이터에서 스키마를 검색하려면 이 파라미터를 지정합니다. 유형: [S3Configuration](API_S3Configuration.md)객체 필수 항목 여부: 아니요 ## 응답 구문 ``` { "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" ] } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [InputSchema](#API_DiscoverInputSchema_ResponseSyntax) ** 스트리밍 소스에서 추론된 스키마. 스트리밍 소스의 데이터의 형식을 식별하고 각 데이터 요소가 애플리케이션 내 스트림에서 생성할 수 있는 해당 열에 매핑하는 방법을 설명합니다. 유형: [SourceSchema](API_SourceSchema.md)객체 ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** 각 요소가 스트림 레코드의 행에 해당하는 요소 배열 (스트림 레코드는 행을 두 개 이상 포함할 수 있음). 유형: 문자열 배열들의 배열 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** `InputProcessingConfiguration` 파라미터에 지정된 프로세서가 수정한 스트림 데이터. 유형: 문자열 배열 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** 스키마를 유추하기 위해 샘플링된 원시 스트림 데이터입니다. 유형: 문자열 배열 ## 오류 ** InvalidArgumentException ** 지정한 입력 파라미터 값이 유효하지 않습니다. ** message ** HTTP 상태 코드: 400 ** ResourceProvisionedThroughputExceededException ** Amazon Kinesis Streams의 프로비저닝된 처리량 ProvisionedExceedExceedeException 때문에 디스커버리가 스트리밍 소스에서 레코드를 가져오지 못했습니다. 자세한 내용을 알아보려면 Amazon Kinesis 스트림 API 참조의 [GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html)를 참조하십시오. HTTP 상태 코드: 400 ** ServiceUnavailableException ** 이 서비스를 사용할 수 없습니다. 작업을 다시 시도하십시오. HTTP 상태 코드: 500 ** UnableToDetectSchemaException ** 유효하지 않는 날짜 형식입니다. Amazon Kinesis Analytics는 지정된 스트리밍 소스에 대한 스키마를 탐지할 수 없습니다. HTTP 상태 코드: 400 ** UnsupportedOperationException ** 지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DiscoverInputSchema)