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 형식으로 반환됩니다.
오류
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하세요.
- 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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.