아마존 QLDB 문서 - 아마존 퀀텀 레저 데이터베이스 (아마존QLDB)
Ion 문서 구조PartiQL-Ion 유형 매핑문서 ID

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

아마존 QLDB 문서

중요

지원 종료 알림: 기존 고객은 2025년 7월 31일 지원이 종료될 QLDB 때까지 Amazon을 사용할 수 있습니다. 자세한 내용은 아마존 QLDB 원장을 Amazon Aurora SQL Postgre로 마이그레이션을 참조하십시오.

Amazon은 데이터 레코드를 문서로 QLDB 저장하는데, 이는 테이블에 삽입되는 Amazon Ion struct 객체일 뿐입니다. 이온 사양은 Amazon Ion GitHub 사이트를 참조하십시오.

Ion 문서 구조

JSON마찬가지로 QLDB 문서는 다음과 같은 구조의 이름-값 쌍으로 구성됩니다.

{
  name1: value1,
  name2: value2,
  name3: value3,
  ...
  nameN: valueN
}

이름은 심볼 토큰이며 값에는 제한이 없습니다. 각 이름-값 쌍을 필드라고 합니다. 필드 값은 컨테이너 유형(중첩 구조체, 목록, 구조체 목록)을 비롯한 모든 Ion 데이터 타입이 될 수 있습니다.

또한 struct a는 JSON 중괄호 () 로 표시되고 list a는 대괄호 ({...}) 로 표시됩니다. [...] 다음 예제는 Amazon QLDB 콘솔 시작하기의 표본 데이터에서 다양한 유형의 값이 포함된 문서입니다.

{
    VIN: "1N4AL11D75C109151",
    LicensePlateNumber: "LEWISR261LL",
    State: "WA",
    City: "Seattle",
    PendingPenaltyTicketAmount: 90.25,
    ValidFrom: 2017-08-21T,
    ValidTo: 2020-05-11T,
    Owners: {
        PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" },
        SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }]
    }
}
중요

Ion에서 큰따옴표는 문자열 값을 나타내고 따옴표가 없는 기호는 필드 이름을 나타냅니다. 그러나 PartiQL에서 작은따옴표는 문자열과 필드 이름을 모두 나타냅니다.

이러한 구문 차이로 인해 PartiQL 쿼리 언어는 호환성을 유지하고 Amazon Ion 데이터 형식은 호환성을 SQL 유지할 수 있습니다. JSON 에서 PartiQL의 구문 및 의미에 대한 자세한 내용은 을 참조하십시오. QLDB PartiQL을 사용하여 Ion 쿼리하기

PartiQL-Ion 유형 매핑

에서 QLDB PartiQL은 의 유형 시스템을 Ion 데이터 모델을 포함하도록 SQL 확장합니다. 이 매핑은 다음과 같이 설명됩니다.

  • SQL스칼라 유형은 해당 Ion 유형에 해당합니다. 예:

    • CHAR 및 VARCHAR는 Ion string 유형에 매핑되는 유니코드 시퀀스입니다.

    • NUMBER는 Ion decimal 유형에 매핑됩니다.

  • Ion의 struct 타입은 전통적으로 테이블 행을 나타내는 SQL 튜플과 동일합니다.

    • 그러나 콘텐츠가 열려 있고 스키마가 없는 경우 SQL 튜플의 순서가 지정된 특성 (예: 출력 순서) 을 사용하는 쿼리는 지원되지 않습니다. SELECT *

  • NULL 외에도 PartiQL에는 MISSING 유형이 있습니다. 이는 NULL의 전문화로 필드가 부족함을 나타냅니다. Ion struct 필드가 희소할 수 있으므로 이 유형이 필요합니다.

문서 ID

QLDB테이블에 삽입하는 각 문서에 문서 ID를 할당합니다. 시스템에서 IDs 할당하는 모든 식별자는 Base62로 인코딩된 문자열 (예:UUID) 로 표시되는 범용 고유 식별자 () 입니다. 3Qv67yjXEwB9SjmvkuG6Cp 자세한 내용은 아마존 IDs 유일의 제품 QLDB 단원을 참조하십시오.

각 문서 개정은 문서 ID와 0으로 시작하는 버전 번호의 조합으로 고유하게 식별됩니다.

문서 ID 및 버전 필드는 문서의 메타데이터에 포함되며, 커밋된 보기(테이블의 시스템 정의 뷰)에서 쿼리할 수 있습니다. 의 뷰에 대한 자세한 내용은 을 참조하십시오. QLDB 핵심 개념 메타데이터에 대해 자세히 알아보려면 문서 메타데이터 쿼리 섹션을 참조하세요.