Amazon QLDB 문서 - Amazon Quantum Ledger Database(QLDB)
Ion 문서 구조PartiQL-Ion 유형 매핑문서 ID

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

Amazon QLDB 문서

중요

지원 종료 알림: 기존 고객은 07/31/2025에 지원이 종료될 때까지 Amazon QLDB를 사용할 수 있습니다. 자세한 내용은 Amazon QLDB 원장을 Amazon Aurora PostgreSQL로 마이그레이션을 참조하세요.

Amazon QLDB는 데이터 레코드를 문서로 저장합니다. 문서는 테이블에 삽입되는 Amazon Ion struct 객체입니다. Ion 사양은 Amazon Ion GitHub 사이트를 참조하세요.

Ion 문서 구조

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

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

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

또한 JSON과 마찬가지로 struct는 중괄호({...})로 표시되고 list는 대괄호([...])로 표시됩니다. 다음 예제는 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 쿼리 언어는 SQL 호환성을 유지하고 Amazon Ion 데이터 형식은 JSON 호환성을 유지할 수 있습니다. QLDB에서 PartiQL의 구문 및 시맨틱에 대한 자세한 내용은 PartiQL을 사용하여 Ion 쿼리하기 섹션을 참조하세요.

PartiQL-Ion 유형 매핑

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

  • SQL 스칼라 유형은 해당 Ion 유형에 의해 적용됩니다. 예시:

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

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

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

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

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

문서 ID

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

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

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