INSERT아마존의 명령 QLDB - 아마존 퀀텀 레저 데이터베이스 (아마존QLDB)
구문파라미터반환 값예드라이버를 사용하여 프로그래밍 방식으로 실행

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

INSERT아마존의 명령 QLDB

중요

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

QLDBAmazon에서는 INSERT 명령을 사용하여 하나 이상의 Amazon Ion 문서를 테이블에 추가합니다.

참고

특정 테이블에서 이 PartiQL 명령을 실행하기 위한 액세스를 제어하는 방법을 알아보려면 Amazon의 표준 권한 모드로 시작하기 QLDB 섹션을 참조하세요.

구문

단일 문서를 삽입합니다.

INSERT INTO table_name VALUE document

여러 문서를 삽입합니다.

INSERT INTO table_name << document, document, ... >>

파라미터

table_name

데이터를 삽입할 사용자 테이블의 이름입니다. 이미 있는 테이블이어야 합니다. DML명령문은 기본 사용자 보기에서만 지원됩니다.

document

유효한 QLDB문서입니다. 문서를 최소 하나 이상 지정해야 합니다. 여러 문서는 쉼표로 구분해야 합니다.

문서는 중괄호({...})로 표시해야 합니다.

문서의 각 필드 이름은 PartiQL에서 작은 따옴표('...')로 표시할 수 있는 대소문자를 구분하는 Ion 기호입니다.

문자열 값도 PartiQL에서 작은 따옴표('...')로 표시될 수 있습니다.

모든 Ion 리터럴은 백틱(`...`)으로 표시할 수 있습니다.

참고

이중 꺾쇠 괄호(<<...>>)는 정렬되지 않은 컬렉션(PartiQL에서는 백이라고 함)을 나타내며 여러 문서를 삽입하려는 경우에만 필요합니다.

반환 값

documentId - 삽입한 각 문서의 고유 ID입니다.

예

단일 문서를 삽입합니다.

INSERT INTO VehicleRegistration VALUE
{
    'VIN' : 'KM8SRDHF6EU074761', --string
    'RegNum' : 1722, --integer
    'State' : 'WA',
    'City' : 'Kent',
    'PendingPenaltyTicketAmount' : 130.75, --decimal
    'Owners' : { --nested struct
        'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ --list of structs
            { 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' },
            { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' }
        ]
    },
    'ValidFromDate' : `2017-09-14T`, --Ion timestamp literal with day precision
    'ValidToDate' : `2020-06-25T`
}

이 명령문은 삽입한 문서의 고유 ID를 다음과 같이 반환합니다.

{
    documentId: "2kKuOPNB07D2iTPBrUTWGl"
}

여러 문서를 삽입합니다.

INSERT INTO Person << 
{
    'FirstName' : 'Raul',
    'LastName' : 'Lewis',
    'DOB' : `1963-08-19T`,
    'GovId' : 'LEWISR261LL',
    'GovIdType' : 'Driver License',
    'Address' : '1719 University Street, Seattle, WA, 98109'
},
{
    'FirstName' : 'Brent',
    'LastName' : 'Logan',
    'DOB' : `1967-07-03T`,
    'GovId' : 'LOGANB486CG',
    'GovIdType' : 'Driver License',
    'Address' : '43 Stockert Hollow Road, Everett, WA, 98203'
},
{
    'FirstName' : 'Alexis',
    'LastName' : 'Pena',
    'DOB' : `1974-02-10T`,
    'GovId' : '744 849 301',
    'GovIdType' : 'SSN',
    'Address' : '4058 Melrose Street, Spokane Valley, WA, 99206'
}
>>

이 명령문은 삽입한 각 문서의 고유 ID를 다음과 같이 반환합니다.

{
    documentId: "6WXzLscsJ3bDWW97Dy8nyp"
},
{
    documentId: "35e0ToZyTGJ7LGvcwrkX65"
},
{
    documentId: "BVHPcH612o7JROQ4yP8jiH"
}

드라이버를 사용하여 프로그래밍 방식으로 실행

드라이버를 사용하여 이 명령문을 프로그래밍 방식으로 실행하는 방법을 알아보려면 QLDB 드라이버 시작하기에서 다음 자습서를 참조하십시오.