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

# 콘솔을 사용하여 Amazon QLDB에 액세스
<a name="console_QLDB"></a>

**중요**  
지원 종료 공지: 기존 고객은 07/31/2025에 지원이 종료될 때까지 Amazon QLDB를 사용할 수 있습니다. 자세한 내용은 [Amazon QLDB 원장을 Amazon Aurora PostgreSQL로 마이그레이션](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)을 참조하세요.

[https://console.aws.amazon.com/qldb](https://console.aws.amazon.com/qldb) AWS Management Console for Amazon QLDB에 액세스할 수 있습니다.

콘솔을 사용하여 QLDB에서 다음을 수행할 수 있습니다.
+ 원장을 생성, 삭제, 설명하고 목록을 작성합니다
+ *PartiQL 편집기*를 사용하여 [PartiQL](ql-reference.md) 문을 실행합니다.
+ QLDB 리소스의 태그를 관리합니다.
+ 저널 데이터를 암호로 검증합니다.
+ 저널 블록을 내보내거나 스트리밍할 수 있습니다.

Amazon QLDB 원장을 생성하고 이를 샘플 애플리케이션 데이터로 설정하는 방법을 알아보려면 [Amazon QLDB 콘솔 시작하기](getting-started.md) 섹션을 참조하세요.

## PartiQL 편집기 빠른 참조
<a name="partiql-editor-reference"></a>

**중요**  
지원 종료 공지: 기존 고객은 07/31/2025에 지원이 종료될 때까지 Amazon QLDB를 사용할 수 있습니다. 자세한 내용은 [Amazon QLDB 원장을 Amazon Aurora PostgreSQL로 마이그레이션](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)을 참조하세요.

Amazon QLDB는 [PartiQL](https://partiql.org/)의 하위 집합을 쿼리 언어로 지원하고 [Amazon Ion](http://amzn.github.io/ion-docs/)은 문서 지향 데이터 형식으로 지원합니다. PartiQL의 QLDB 구현에 대한 전체 안내서와 자세한 내용은 [Amazon QLDB PartiQL 참조](ql-reference.md) 섹션을 참조하세요.

다음 항목에서는 QLDB에서 PartiQL을 사용하는 방법에 대한 간략한 참조 개요를 제공합니다.

**Topics**
+ [QLDB의 PartiQL 빠른 팁](#partiql-editor-ref-tips)
+ [명령](#partiql-editor-ref-commands)
+ [시스템 정의 뷰](#partiql-editor-ref-views)
+ [기본 구문 규칙](#partiql-editor-ref-syntax)
+ [PartiQL 편집기 키보드 바로 가기](#console_QLDB.partiql-editor-shortcuts)

### QLDB의 PartiQL 빠른 팁
<a name="partiql-editor-ref-tips"></a>

다음은 QLDB에서 PartiQL을 사용하기 위한 팁과 모범 사례를 간략하게 요약한 것입니다.
+ **동시성 및 트랜잭션 제한 이해** - `SELECT` 쿼리를 포함한 모든 명령문은 30초의 트랜잭션 시간 제한을 포함하여 [OCC(Optimistic Concurrency Control)](concurrency.md) 충돌 및 [트랜잭션 제한](limits.md#limits.fixed)의 영향을 받습니다.
+ **인덱스 사용** - 카디널리티가 높은 인덱스를 사용하고 대상 쿼리를 실행하여 명령문을 최적화하고 전체 테이블 스캔을 방지합니다. 자세한 내용은 [쿼리 성능 최적화](working.optimize.md) 섹션을 참조하세요.
+ **동등 조건자 사용** - 인덱싱된 조회에는 *동등* 연산자(`=` 또는 `IN`)가 필요합니다. 부등 연산자(`<`, `>`, `LIKE`, `BETWEEN`)는 인덱싱된 조회에 적합하지 않으며 테이블 전체를 스캔해야 합니다.
+ **내부 조인만 사용** - QLDB는 내부 조인만 지원합니다. 가장 좋은 방법은 조인하려는 각 테이블에 대해 인덱싱된 필드를 조인하는 것입니다. 조인 기준과 동등 조건자 모두에 대해 높은 카디널리티 인덱스를 선택하세요.

### 명령
<a name="partiql-editor-ref-commands"></a>

QLDB에서는 다음 PartiQL 명령을 지원합니다.


**데이터 정의 언어(DDL)**  

| Command | 설명 | 
| --- | --- | 
| [CREATE INDEX](ql-reference.create-index.md) | 테이블의 최상위 문서 필드에 대한 인덱스를 생성합니다. | 
| [CREATE TABLE](ql-reference.create-table.md) | 테이블을 생성합니다. | 
| [DROP INDEX](ql-reference.drop-index.md) | 테이블에서 인덱스를 삭제합니다. | 
| [DROP TABLE](ql-reference.drop-table.md) | 기존 테이블을 비활성화합니다. | 
| [UNDROP TABLE](ql-reference.undrop-table.md) | 비활성 테이블을 다시 활성화합니다. | 


**데이터 조작 언어(DML)**  

| Command | 설명 | 
| --- | --- | 
| [DELETE](ql-reference.delete.md) | 문서의 최종 수정본을 새로 만들어 활성 문서를 삭제된 것으로 표시합니다. | 
| [FROM (INSERT, REMOVE, 또는 SET)](ql-reference.from.md) | 의미상 UPDATE과 같습니다. | 
| [INSERT](ql-reference.insert.md) | 테이블에 하나 이상의 [문서](ql-reference.docs.md)를 추가합니다. | 
| [SELECT](ql-reference.select.md) | 하나 이상의 테이블에서 데이터를 가져옵니다. | 
| [UPDATE](ql-reference.update.md) | 문서 내의 특정 요소를 업데이트, 삽입 또는 제거합니다. | 

#### DML 문 예제
<a name="partiql-editor-ref-commands-examples"></a>

**INSERT**

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

**UPDATE-INSERT**

```
UPDATE Vehicle AS v
INSERT INTO v VALUE 26500 AT 'Mileage'
WHERE v.VIN = '1N4AL11D75C109151'
```

**UPDATE-REMOVE**

```
UPDATE Person AS p
REMOVE p.Address
WHERE p.GovId = '111-22-3333'
```

**SELECT - 상관 하위 쿼리**

```
SELECT r.VIN, o.SecondaryOwners
FROM VehicleRegistration AS r, @r.Owners AS o
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')
```

**SELECT - 내부 조인**

```
SELECT v.Make, v.Model, r.Owners
FROM VehicleRegistration AS r INNER JOIN Vehicle AS v
ON r.VIN = v.VIN
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')
```

**SELECT - BY 절을 사용하여 문서 ID 가져오기**

```
SELECT r_id FROM VehicleRegistration AS r BY r_id
WHERE r.VIN = '1HVBBAANXWH544237'
```

### 시스템 정의 뷰
<a name="partiql-editor-ref-views"></a>

QLDB에서는 다음과 같은 시스템 정의 테이블 뷰를 지원합니다.


| 보기 | 설명 | 
| --- | --- | 
| table\$1name | 사용자 데이터의 현재 상태만 포함하는 테이블의 기본 [사용자 뷰](working.userdata.md)입니다. | 
| \$1ql\$1committed\$1table\$1name | 사용자 데이터와 시스템에서 생성한 메타데이터(예: 문서 ID)의 현재 상태를 모두 포함하는 테이블의 전체 시스템 정의 [커밋된 보기](working.metadata.md)입니다. | 
| history(table\$1name) | 테이블의 전체 개정 기록을 반환하는 내장 [기록 함수](working.history.md)입니다. | 

### 기본 구문 규칙
<a name="partiql-editor-ref-syntax"></a>

QLDB는 PartiQL에 대해 다음과 같은 기본 구문 규칙을 지원합니다.


| 문자 | 설명 | 
| --- | --- | 
| ' | 작은따옴표는 문자열 값 또는 Amazon Ion 구조의 필드 이름을 나타냅니다. | 
| " | 큰따옴표는 따옴표로 묶인 식별자를 나타냅니다(예: 테이블 이름으로 사용되는 [예약어](ql-reference.reserved.md)). | 
| ` | 백틱은 Ion 리터럴 값을 나타냅니다. | 
| . | 점 표기법은 상위 구조의 필드 이름에 액세스합니다. | 
| [ ] | 대괄호는 Ion list을 정의하거나 기존 목록의 0부터 시작하는 서수를 나타냅니다. | 
| \$1 \$1 | 중괄호는 Ion struct을 정의합니다. | 
| << >> | 이중 꺾쇠 괄호는 순서가 지정되지 않은 컬렉션인 PartiQL 백을 정의합니다. 백을 사용하여 여러 문서를 테이블에 삽입합니다. | 
| 대소문자 구분 | 필드 이름과 테이블 이름을 포함한 모든 QLDB 시스템 개체 이름은 대소문자를 구분합니다. | 

### PartiQL 편집기 키보드 바로 가기
<a name="console_QLDB.partiql-editor-shortcuts"></a>

QLDB 콘솔의 *PartiQL 편집기*는 다음 키보드 단축키를 지원합니다.


| Action | macOS | Windows | 
| --- | --- | --- | 
| Run | Cmd\$1Return | Ctrl\$1Enter | 
| 설명 | Cmd\$1/ | Ctrl\$1/ | 
| Clear | Cmd\$1Shift\$1Delete | Ctrl\$1Shift\$1Delete |