CreateTable - Amazon Timestream

Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. 여기에서 자세히 알아보세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CreateTable

사용자 계정의 기존 데이터베이스에 새 테이블을 추가합니다. AWS 계정에서 테이블 이름이 동일한 데이터베이스에 있는 경우 각 리전 내에서 최소한 고유해야 합니다. 테이블이 별도의 데이터베이스에 있는 경우 동일한 리전에서 동일한 테이블 이름을 가질 수 있습니다. 테이블을 생성하는 동안 테이블 이름, 데이터베이스 이름 및 보존 속성을 지정해야 합니다. 서비스 할당량이 적용됩니다. 자세한 내용은 코드 샘플을 참조하세요.

구문 요청

{ "DatabaseName": "string", "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

요청 파라미터

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 공통 파라미터를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

DatabaseName

Timestream 데이터베이스의 이름입니다.

유형: 문자열

길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256입니다.

패턴: [a-zA-Z0-9_.-]+

필수 여부: 예

MagneticStoreWriteProperties

마그네틱 스토어 쓰기를 활성화할 때 테이블에 설정할 속성이 들어 있습니다.

유형: MagneticStoreWriteProperties객체

필수 여부: 아니요

RetentionProperties

메모리 스토어와 마그네틱 스토어에 시계열 데이터를 저장해야 하는 기간입니다.

유형: RetentionProperties객체

필수 여부: 아니요

Schema

테이블의 스키마입니다.

유형: Schema객체

필수 여부: 아니요

TableName

Timestream 테이블의 이름입니다.

유형: 문자열

길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 256입니다.

패턴: [a-zA-Z0-9_.-]+

필수 여부: 예

Tags

테이블에 레이블을 지정할 키-값 페어의 목록입니다.

유형: Tag객체 어레이

어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

필수 여부: 아니요

응답 구문

{ "Table": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } }

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

Table

새로 생성된 Timestream 테이블입니다.

타입: Table 객체

오류

모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하세요.

AccessDeniedException

이 작업을 수행할 권한이 없습니다.

HTTP 상태 코드: 400

ConflictException

Timestream은 이미 존재하는 리소스를 포함하기 때문에 이 요청을 처리할 수 없습니다.

HTTP 상태 코드: 400

InternalServerException

내부 서버 오류로 인해 Timestream이 이 요청을 완전히 처리할 수 없습니다.

HTTP 상태 코드: 500

InvalidEndpointException

요청된 엔드포인트가 유효하지 않습니다.

HTTP 상태 코드: 400

InvalidEndpointException

요청된 엔드포인트가 유효하지 않습니다.

HTTP 상태 코드: 400

ResourceNotFoundException

작업이 존재하지 않는 리소스에 액세스하려고 했습니다. 리소스가 올바르게 지정되지 않았거나 상태가 ACTIVE가 아닐 수 있습니다.

HTTP 상태 코드: 400

ServiceQuotaExceededException

이 계정에 대한 리소스의 인스턴스 할당량을 초과했습니다.

HTTP 상태 코드: 400

ThrottlingException

사용자가 너무 많은 요청을 했으며 서비스 할당량을 초과했습니다. 요청에 병목 현상이 발생했습니다.

HTTP 상태 코드: 400

ValidationException

유효하지 않거나 잘못된 형식의 요청입니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.