기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon QLDB 액세스 **중요** 지원 종료 공지: 기존 고객은 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/)을 참조하세요. AWS Management Console, AWS Command Line Interface (AWS CLI) 또는 QLDB API를 사용하여 Amazon QLDB에 액세스할 수 있습니다. 다음 섹션에서는 이러한 옵션을 사용하는 방법과 이를 사용하기 위한 필수 조건을 설명합니다. ## 사전 조건 QLDB에 액세스하려면 아직 설정하지 않은 AWS 계정 경우를 설정해야 합니다. **Topics** + [에 가입 AWS 계정](#sign-up-for-aws) + [관리자 액세스 권한이 있는 사용자 생성](#create-an-admin) + [IAM에서 QLDB 권한 관리](#accessing.prereqs.permissions) + [프로그래밍 방식 액세스 권한 부여(선택 사항)](#grant-programmatic-access) ### 에 가입 AWS 계정 이 없는 경우 다음 단계를 AWS 계정완료하여 생성합니다. **에 가입하려면 AWS 계정** 1. [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup)을 엽니다. 1. 온라인 지시 사항을 따릅니다. 등록 절차 중 전화 또는 텍스트 메시지를 받고 전화 키패드로 확인 코드를 입력하는 과정이 있습니다. 에 가입하면 AWS 계정*AWS 계정 루트 사용자*이 생성됩니다. 루트 사용자에게는 계정의 모든 AWS 서비스 및 리소스에 액세스할 권한이 있습니다. 보안 모범 사례는 사용자에게 관리 액세스 권한을 할당하고, 루트 사용자만 사용하여 [루트 사용자 액세스 권한이 필요한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)을 수행하는 것입니다. AWS 는 가입 프로세스가 완료된 후 확인 이메일을 보냅니다. 언제든지 [https://aws.amazon.com/](https://aws.amazon.com/)으로 이동하고 **내 계정**을 선택하여 현재 계정 활동을 보고 계정을 관리할 수 있습니다. ### 관리자 액세스 권한이 있는 사용자 생성 에 가입한 후 일상적인 작업에 루트 사용자를 사용하지 않도록 관리 사용자를 AWS 계정보호 AWS IAM Identity Center, AWS 계정 루트 사용자활성화 및 생성합니다. **보안 AWS 계정 루트 사용자** 1. **루트 사용자를** 선택하고 AWS 계정 이메일 주소를 입력하여 계정 소유자[AWS Management Console](https://console.aws.amazon.com/)로에 로그인합니다. 다음 페이지에서 비밀번호를 입력합니다. 루트 사용자를 사용하여 로그인하는 데 도움이 필요하면 *AWS Sign-In User Guide*의 [루트 사용자로 로그인](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial)을 참조하세요. 1. 루트 사용자의 다중 인증(MFA)을 활성화합니다. 지침은 *IAM 사용 설명서*의 [AWS 계정 루트 사용자(콘솔)에 대한 가상 MFA 디바이스 활성화를 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html). **관리자 액세스 권한이 있는 사용자 생성** 1. IAM Identity Center를 활성화합니다. 지침은 *AWS IAM Identity Center 사용 설명서*의 [AWS IAM Identity Center설정](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-set-up-for-idc.html)을 참조하세요. 1. IAM Identity Center에서 사용자에게 관리 액세스 권한을 부여합니다. 를 자격 증명 소스 IAM Identity Center 디렉터리 로 사용하는 방법에 대한 자습서는 사용 *AWS IAM Identity Center 설명서*[의 기본값으로 사용자 액세스 구성을 IAM Identity Center 디렉터리](https://docs.aws.amazon.com/singlesignon/latest/userguide/quick-start-default-idc.html) 참조하세요. **관리 액세스 권한이 있는 사용자로 로그인** + IAM IDentity Center 사용자로 로그인하려면 IAM Identity Center 사용자를 생성할 때 이메일 주소로 전송된 로그인 URL을 사용합니다. IAM Identity Center 사용자를 사용하여 로그인[하는 데 도움이 필요하면 사용 설명서의 AWS 액세스 포털에 로그인](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html)을 참조하세요. *AWS Sign-In * **추가 사용자에게 액세스 권한 할당** 1. IAM Identity Center에서 최소 권한 적용 모범 사례를 따르는 권한 세트를 생성합니다. 지침은AWS IAM Identity Center 사용 설명서의 [Create a permission set](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-started-create-a-permission-set.html)를 참조하세요.** 1. 사용자를 그룹에 할당하고, 그룹에 Single Sign-On 액세스 권한을 할당합니다. 지침은 *AWS IAM Identity Center 사용 설명서*의 [Add groups](https://docs.aws.amazon.com/singlesignon/latest/userguide/addgroups.html)를 참조하세요. ### IAM에서 QLDB 권한 관리 AWS Identity and Access Management (IAM)를 사용하여 사용자의 QLDB 권한을 관리하는 방법에 대한 자세한 내용은 섹션을 참조하세요[Amazon QLDB에서 IAM을 사용하는 방법](security_iam_service-with-iam.md). ### 프로그래밍 방식 액세스 권한 부여(선택 사항) 사용자는 AWS 외부에서와 상호 작용하려는 경우 프로그래밍 방식의 액세스가 필요합니다 AWS Management Console. 프로그래밍 방식 액세스를 부여하는 방법은에 액세스하는 사용자 유형에 따라 다릅니다 AWS. 사용자에게 프로그래밍 방식 액세스 권한을 부여하려면 다음 옵션 중 하나를 선택합니다. **** | 프로그래밍 방식 액세스가 필요한 사용자는 누구인가요? | To | 액세스 권한을 부여하는 사용자 | | --- | --- | --- | | 작업 인력 ID (IAM Identity Center가 관리하는 사용자) | 임시 자격 증명을 사용하여 AWS CLI, AWS SDKs 또는 AWS APIs. | 사용하고자 하는 인터페이스에 대한 지침을 따릅니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/qldb/latest/developerguide/accessing.html) | | IAM | 임시 자격 증명을 사용하여 AWS CLI, AWS SDKs 또는 AWS APIs. | IAM 사용 설명서의 [AWS 리소스에서 임시 자격 증명 사용](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)의 지침을 따릅니다. | | IAM | (권장되지 않음)장기 자격 증명을 사용하여 AWS CLI, AWS SDKs 또는 AWS APIs. | 사용하고자 하는 인터페이스에 대한 지침을 따릅니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/qldb/latest/developerguide/accessing.html) | ## Amazon QLDB에 액세스하는 방법 를 설정하기 위한 사전 조건을 완료한 후 다음 주제를 AWS 계정참조하여 QLDB에 액세스하는 방법에 대해 자세히 알아보세요. + [콘솔 사용](console_QLDB.md) + [사용 AWS CLI (관리 API만 해당)](Tools.CLI.md) + [Amazon QLDB 쉘 사용(데이터 API만 해당)](data-shell.md) + [API 사용](Using.API.md) # 콘솔을 사용하여 Amazon QLDB에 액세스 **중요** 지원 종료 공지: 기존 고객은 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 편집기 빠른 참조 **중요** 지원 종료 공지: 기존 고객은 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 빠른 팁 다음은 QLDB에서 PartiQL을 사용하기 위한 팁과 모범 사례를 간략하게 요약한 것입니다. + **동시성 및 트랜잭션 제한 이해** - `SELECT` 쿼리를 포함한 모든 명령문은 30초의 트랜잭션 시간 제한을 포함하여 [OCC(Optimistic Concurrency Control)](concurrency.md) 충돌 및 [트랜잭션 제한](limits.md#limits.fixed)의 영향을 받습니다. + **인덱스 사용** - 카디널리티가 높은 인덱스를 사용하고 대상 쿼리를 실행하여 명령문을 최적화하고 전체 테이블 스캔을 방지합니다. 자세한 내용은 [쿼리 성능 최적화](working.optimize.md) 섹션을 참조하세요. + **동등 조건자 사용** - 인덱싱된 조회에는 *동등* 연산자(`=` 또는 `IN`)가 필요합니다. 부등 연산자(`<`, `>`, `LIKE`, `BETWEEN`)는 인덱싱된 조회에 적합하지 않으며 테이블 전체를 스캔해야 합니다. + **내부 조인만 사용** - QLDB는 내부 조인만 지원합니다. 가장 좋은 방법은 조인하려는 각 테이블에 대해 인덱싱된 필드를 조인하는 것입니다. 조인 기준과 동등 조건자 모두에 대해 높은 카디널리티 인덱스를 선택하세요. ### 명령 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 문 예제 **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' ``` ### 시스템 정의 뷰 QLDB에서는 다음과 같은 시스템 정의 테이블 뷰를 지원합니다. | 보기 | 설명 | | --- | --- | | table\$1name | 사용자 데이터의 현재 상태만 포함하는 테이블의 기본 [사용자 뷰](working.userdata.md)입니다. | | \$1ql\$1committed\$1table\$1name | 사용자 데이터와 시스템에서 생성한 메타데이터(예: 문서 ID)의 현재 상태를 모두 포함하는 테이블의 전체 시스템 정의 [커밋된 보기](working.metadata.md)입니다. | | history(table\$1name) | 테이블의 전체 개정 기록을 반환하는 내장 [기록 함수](working.history.md)입니다. | ### 기본 구문 규칙 QLDB는 PartiQL에 대해 다음과 같은 기본 구문 규칙을 지원합니다. | 문자 | 설명 | | --- | --- | | ' | 작은따옴표는 문자열 값 또는 Amazon Ion 구조의 필드 이름을 나타냅니다. | | " | 큰따옴표는 따옴표로 묶인 식별자를 나타냅니다(예: 테이블 이름으로 사용되는 [예약어](ql-reference.reserved.md)). | | ` | 백틱은 Ion 리터럴 값을 나타냅니다. | | . | 점 표기법은 상위 구조의 필드 이름에 액세스합니다. | | [ ] | 대괄호는 Ion list을 정의하거나 기존 목록의 0부터 시작하는 서수를 나타냅니다. | | \$1 \$1 | 중괄호는 Ion struct을 정의합니다. | | << >> | 이중 꺾쇠 괄호는 순서가 지정되지 않은 컬렉션인 PartiQL 백을 정의합니다. 백을 사용하여 여러 문서를 테이블에 삽입합니다. | | 대소문자 구분 | 필드 이름과 테이블 이름을 포함한 모든 QLDB 시스템 개체 이름은 대소문자를 구분합니다. | ### PartiQL 편집기 키보드 바로 가기 QLDB 콘솔의 *PartiQL 편집기*는 다음 키보드 단축키를 지원합니다. | Action | macOS | Windows | | --- | --- | --- | | Run | Cmd\$1Return | Ctrl\$1Enter | | 설명 | Cmd\$1/ | Ctrl\$1/ | | Clear | Cmd\$1Shift\$1Delete | Ctrl\$1Shift\$1Delete | # 를 사용하여 Amazon QLDB에 액세스 AWS CLI (관리 API만 해당) **중요** 지원 종료 공지: 기존 고객은 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/)을 참조하세요. AWS Command Line Interface (AWS CLI)를 사용하여 명령줄 AWS 서비스 에서 여러를 제어하고 스크립트를 통해 자동화할 수 있습니다. 필요에 AWS CLI 따라를 일회성 작업에 사용할 수 있습니다. 또한 이를 사용하여 유틸리티 스크립트 내에 Amazon QLDB 작업을 포함할 수도 있습니다. CLI 액세스를 위해서는 액세스 키 ID 및 비밀 액세스 키가 필요합니다. 가능하다면 장기 액세스 키 대신 임시 보안 인증 정보를 사용하세요. 임시 보안 인증도 액세스 키 ID와 비밀 액세스 키로 구성되지만 보안 인증이 만료되는 시간을 나타내는 보안 토큰이 포함되어 있습니다. 자세한 내용은 *IAM 사용 설명서*의 [AWS 리소스에서 임시 자격 증명 사용을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) 참조하세요. AWS CLI의 QLDB에 사용할 수 있는 모든 명령의 전체 목록을 보려면 [AWS CLI 명령 참조](https://docs.aws.amazon.com/cli/latest/reference/qldb/index.html)를 참조하세요. **참고** 는에 나열된 `qldb` 관리 API 작업 AWS CLI 만 지원합니다[Amazon QLDB API 참조](api-reference.md). 이 API는 원장 리소스 관리 및 비트랜잭션 데이터 작업에만 사용됩니다. 명령줄 인터페이스를 사용하여 `qldb-session` API로 데이터 트랜잭션을 실행하려면 [QLDB 쉘을 사용하여 Amazon QLDB에 액세스(데이터 API만 해당)](data-shell.md)을 참조하세요. **Topics** + [AWS CLI설치 및 구성](#Tools.CLI.InstallingAndConfiguring) + [QLDB AWS CLI 에서 사용](#Tools.CLI.UsingWithQLDB) ## AWS CLI설치 및 구성 는 Linux, macOS 또는 Windows에서 AWS CLI 실행됩니다. 이를 설치 및 구성하려면 *AWS Command Line Interface 사용 설명서*에서 다음 지침을 참조하세요. 1. [최신 버전의 설치 또는 업데이트 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 1. [빠른 설정](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html) ## QLDB AWS CLI 에서 사용 명령줄 형식은 Amazon QLDB 작업 이름과 해당 작업에 대한 파라미터 순으로 구성됩니다. 는 JSON 외에도 파라미터 값에 대한 간편 구문을 AWS CLI 지원합니다. `help`를 사용하여 QLDB에서 사용 가능한 모든 명령을 나열합니다. ``` aws qldb help ``` `help`를 사용하여 특정 명령을 설명하고 그 사용법에 대해 자세히 알아볼 수도 있습니다. ``` aws qldb create-ledger help ``` 예를 들어, 원장을 생성하려면: ``` aws qldb create-ledger --name my-example-ledger --permissions-mode STANDARD ``` # QLDB 쉘을 사용하여 Amazon QLDB에 액세스(데이터 API만 해당) **중요** 지원 종료 알림: 기존 고객은 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는 트랜잭션 데이터 API와의 상호 작용을 위한 명령행 쉘을 제공합니다. QLDB 쉘을 사용하면 원장 데이터에 대해 [PartiQL](ql-reference.md) 문을 실행할 수 있습니다. 이 쉘의 최신 버전은 Rust에서 작성되었으며 기본 `main` 브랜치에 있는 GitHub 리포지토리 [awslabs/amazon-qldb-shell](https://github.com/awslabs/amazon-qldb-shell)에서 오픈 소스로 제공됩니다. Python 버전(v1)도 `master` 브랜치의 동일한 리포지토리에서 계속 사용할 수 있습니다. **참고** Amazon QLDB 쉘은 `qldb-session` 트랜잭션 데이터 API만 지원합니다. 이 API는 QLDB 원장에서 PartiQL 문을 실행하는 데만 사용됩니다. 명령행 인터페이스를 사용하여 `qldb` 관리 API 작업과 상호 작용하려면 [를 사용하여 Amazon QLDB에 액세스 AWS CLI (관리 API만 해당)](Tools.CLI.md) 섹션을 참조하세요. 이 도구는 애플리케이션에 통합하거나 프로덕션 목적으로 채택하기 위한 것이 아닙니다. 이 도구의 목적은 QLDB 및 PartiQL을 빠르게 실험해 볼 수 있도록 하는 것입니다. 다음 섹션에서는 QLDB shell 작업을 시작하는 방법을 설명합니다. **Topics** + [사전 조건](#data-shell-prerequisites) + [쉘 설치](#data-shell-install) + [쉘 호출](#data-shell-invoking) + [쉘 파라미터](#data-shell-params) + [명령 참조](#data-shell-reference) + [개별 명령문 실행](#data-shell-indiv-statements) + [트랜잭션 관리](#data-shell-transactions) + [쉘 종료](#data-shell-exiting) + [예제](#data-shell-examples) ## 사전 조건 QLDB 쉘을 시작하기 전에 다음을 수행해야 합니다. 1. 의 AWS 설정 지침을 따릅니다[Amazon QLDB 액세스](accessing.md). 다음 내용이 포함됩니다: 1. 가입합니다 AWS. 1. 적절한 QLDB 권한을 가진 사용자를 생성합니다. 1. 개발을 위한 프로그래밍 방식 액세스 권한을 부여합니다. 1. AWS 자격 증명과 기본값을 설정합니다 AWS 리전. 자세한 설명은 *AWS Command Line Interface 사용자 가이드*에서 [구성 기본 사항](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html)을 참조하세요. 사용 가능한 리전의 전체 목록은 *AWS 일반 참조*에서 [Amazon QLDB 엔드포인트 및 할당량](https://docs.aws.amazon.com/general/latest/gr/qldb.html)을 참조하세요. 1. `STANDARD` 권한 모드의 모든 원장에 대해 적절한 표에서 PartiQL 문을 실행할 수 있는 권한을 부여하는 IAM 정책을 생성합니다. 이러한 정책을 생성하는 방법을 알아보려면 [Amazon QLDB에서 표준 권한 모드로 시작하기](getting-started-standard-mode.md)를 참조하세요. ## 쉘 설치 QLDB 쉘의 최신 버전을 설치하려면 GitHub의 [README.md](https://github.com/awslabs/amazon-qldb-shell/blob/main/README.md#installation) 파일을 참조하세요. QLDB는 GitHub 리포지토리의 [릴리스](https://github.com/awslabs/amazon-qldb-shell/releases) 섹션에서 Linux, macOS, Windows용으로 사전 빌드된 이진수 파일을 제공합니다. macOS의 경우 쉘은 `aws/tap` [Homebrew](https://docs.brew.sh/) 탭과 통합됩니다. Homebrew를 사용하여 macOS에 쉘을 설치하려면 다음 명령을 실행합니다. ``` $ xcode-select --install # Required to use Homebrew $ brew tap aws/tap # Add AWS as a Homebrew tap $ brew install qldbshell ``` ### 구성 설치 후 쉘은 초기화 중에 `$XDG_CONFIG_HOME/qldbshell/config.ion`에 있는 기본 구성 파일을 로드합니다. Linux 및 macOS의 경우 이 파일은 일반적으로 `~/.config/qldbshell/config.ion`에 있습니다. 이러한 파일이 없는 경우 쉘은 기본 설정으로 실행됩니다. 설치 후 수동으로 `config.ion` 파일을 만들 수 있습니다. 이 구성 파일은 [Amazon Ion](ion.md) 데이터 형식을 사용합니다. 다음은 최소 `config.ion` 파일의 예입니다. ``` { default_ledger: "my-example-ledger" } ``` `default_ledger`가 구성 파일에 설정되어 있지 않은 경우, 쉘을 호출할 때 `--ledger` 파라미터가 필요합니다. 구성 옵션의 전체 목록은 GitHub의 [README.md](https://github.com/awslabs/amazon-qldb-shell/blob/main/README.md#configuration) 파일을 참조하세요. ## 쉘 호출 명령행 터미널에서 특정 원장에 대해 QLDB 쉘을 호출하려면 다음 명령을 실행합니다. *my-example-ledger*를 원장 명칭을 바꿉니다. ``` $ qldb --ledger my-example-ledger ``` 이 명령은 기본값에 연결됩니다 AWS 리전. 지역을 명시적으로 지정하려면 다음 섹션에 설명된 대로 `--region` 또는 `--qldb-session-endpoint` 파라미터를 사용하여 명령을 실행할 수 있습니다. `qldb` 쉘 세션을 호출한 후 다음과 같은 입력 타입을 입력할 수 있습니다. + [쉘 명령](#data-shell-reference) + [개별 트랜잭션의 단일 PartiQL 명령문](#data-shell-indiv-statements) + [트랜잭션 내의 여러 PartiQL 명령문](#data-shell-transactions) ## 쉘 파라미터 쉘을 호출하는 데 사용할 수 있는 플래그 및 옵션의 전체 목록을 보려면 다음과 같이 `--help` 플래그와 함께 `qldb` 명령을 실행합니다. ``` $ qldb --help ``` 다음은 `qldb` 명령의 몇 가지 주요 플래그와 옵션입니다. 이러한 선택적 파라미터를 추가하여 자격 증명 프로필 AWS 리전, 엔드포인트, 결과 형식 및 기타 구성 옵션을 재정의할 수 있습니다. **사용량** ``` $ qldb [FLAGS] [OPTIONS] ```플래그 **`-h`, `--help`** 도움말 정보를 인쇄합니다. **`-v`, `--verbose`** 로깅 세부 사항을 구성합니다. 기본적으로 쉘은 오류만 기록합니다. 세부 사항 수준을 높이려면 이 인수(예:`-vv`)를 반복합니다. 가장 높은 수준은 `trace` 세부 수준에 해당하는 `-vvv`입니다. **`-V`, `--version`** 버전 정보를 인쇄합니다.OPTIONS **`-l`, `--ledger` *LEDGER\$1NAME*** 연결할 원장의 명칭입니다. `default_ledger`가 `config.ion` 파일에 설정되지 않은 경우 필요한 쉘 파라미터입니다. 이 파일에서 지역과 같은 추가 옵션을 설정할 수 있습니다. **`-c`, `--config` *CONFIG\$1FILE*** 모든 쉘 구성 옵션을 정의할 수 있는 파일입니다. 형식 지정 세부 정보 및 구성 옵션의 전체 목록은 GitHub의 [README.md](https://github.com/awslabs/amazon-qldb-shell/blob/main/README.md#configuration) 파일을 참조하세요. **`-f`, `--format` `ion|table`** 쿼리 결과의 출력 형식입니다. 기본값은 `ion`입니다. **`-p`, `--profile` *프로필*** 인증에 사용할 AWS 자격 증명 프로필의 위치입니다. 제공되지 않은 경우 쉘은에 있는 기본 AWS 프로파일을 사용합니다`~/.aws/credentials`. **`-r`, `--region` *REGION\$1CODE*** 연결할 QLDB 원장의 AWS 리전 코드입니다. 예: `us-east-1`. 제공하지 않으면 쉘이 AWS 프로필에 지정된 AWS 리전 기본값에 연결됩니다. **`-s`, `--qldb-session-endpoint` *QLDB\$1SESSION\$1ENDPOINT*** 연결할 `qldb-session` API 엔드포인트. 사용 가능한 QLDB 지역 및 엔드포인트의 전체 목록은 *AWS 일반 참조*에서 [Amazon QLDB 엔드포인트 및 할당량](https://docs.aws.amazon.com/general/latest/gr/qldb.html)을 참조하세요. ## 명령 참조 `qldb` 세션을 호출한 후 쉘은 다음 키와 데이터베이스 명령을 지원합니다. **쉘 키** | 키 | 함수 설명 | | --- | --- | | Enter | 문을 실행합니다. | | Escape\$1Enter (macOS, Linux) Shift\$1Enter (Windows) | 새 행을 시작하여 여러 행에 걸친 문을 입력합니다. 입력 텍스트를 여러 행로 복사하여 쉘에 붙여넣을 수도 있습니다. macOS에서 Meta 키로 Escape 대신 Option을 설정하는 방법에 대한 지침은 [OS X Daily](https://osxdaily.com/2013/02/01/use-option-as-meta-key-in-mac-os-x-terminal/) 사이트를 참조하세요. | | Ctrl\$1C | 현재 명령을 취소합니다. | | Ctrl\$1D | 파일 끝(EOF)에 신호를 보내고 쉘의 현재 수준을 종료합니다. 활성 트랜잭션에 없는 경우 쉘을 종료합니다. 활성 트랜잭션에서 트랜잭션을 중단합니다. | **쉘 데이터베이스 명령** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/qldb/latest/developerguide/data-shell.html) **참고** 모든 QLDB 쉘 명령은 대소문자를 구분하지 않습니다. ## 개별 명령문 실행 [README.md](https://github.com/awslabs/amazon-qldb-shell/blob/main/README.md#command-interface)에 나열된 데이터베이스 명령과 쉘 메타 명령을 제외하고 쉘은 사용자가 입력하는 각 명령을 별도의 PartiQL 문으로 해석합니다. 기본적으로 쉘은 `auto-commit` 모드를 활성화합니다. 이 모드는 구성할 수 있습니다. `auto-commit` 모드에서는 쉘이 각 명령문을 자체 트랜잭션에서 암시적으로 실행하고 오류가 발견되지 않으면 트랜잭션을 자동으로 체결합니다. 즉, 문을 실행할 때마다 `start transaction`(또는 `begin`) 및 `commit`을 수동으로 실행하지 않아도 됩니다. ## 트랜잭션 관리 또는 QLDB 쉘을 사용하여 트랜잭션을 수동으로 제어할 수 있습니다. 명령 및 명령문을 순차적으로 일괄 처리하여 트랜잭션 내에서 여러 명령문을 대화식으로 실행하거나 비대화식으로 실행할 수 있습니다. ### 대화형 트랜잭션 대화형 트랜잭션을 실행하려면 다음 단계를 수행합니다. 1. 트랜잭션을 시작하려면 `begin` 명령을 입력합니다. ``` qldb> begin ``` 트랜잭션을 시작하면 쉘에 다음 명령 프롬프트가 표시됩니다. ``` qldb *> ``` 1. 그러면 입력한 각 명령문이 동일한 트랜잭션에서 실행됩니다. + 예컨대 다음과 같이 단일 명령문을 실행할 수 있습니다. ``` qldb *> SELECT * FROM Vehicle WHERE VIN = '1N4AL11D75C109151' ``` Enter를 누르면 쉘에 명령문의 결과가 표시됩니다. + 다음과 같이 여러 개의 명령문이나 명령을 세미콜론(`;`)구분 기호로 구분하여 입력할 수도 있습니다. ``` qldb *> SELECT * FROM Vehicle WHERE VIN = '1N4AL11D75C109151'; commit ``` 1. 트랜잭션을 종료하려면 다음 명령 중 하나를 입력합니다. + `commit` 명령을 입력하여 트랜잭션을 원장 저널에 체결합니다. ``` qldb *> commit ``` + `abort` 명령을 입력하여 트랜잭션을 중지하고 변경한 내용을 거부합니다. ``` qldb *> abort transaction was aborted ``` **트랜잭션 시간 초과 제한** 대화형 트랜잭션은 QLDB의 [시간 초과 제한](limits.md#limits.fixed)을 준수합니다. 시작 후 **30초** 이내에 트랜잭션을 체결하지 않으면 QLDB는 트랜잭션을 자동으로 만료시키고 트랜잭션 중에 이루어진 모든 변경 사항을 거부합니다. 그러면 쉘은 명령문 결과를 표시하는 대신 만료 오류 메시지를 표시하고 일반 명령 프롬프트로 돌아갑니다. 다시 시도하려면 `begin` 명령을 다시 입력하여 새 트랜잭션을 시작해야 합니다. ``` transaction failed after 1 attempts, last error: communication failure: Transaction 2UMpiJ5hh7WLjVgEiMLOoO has expired ``` ### 비대화형 트랜잭션 다음과 같이 명령과 명령문을 순차적으로 일괄 처리하여 여러 명령문으로 전체 트랜잭션을 실행할 수 있습니다. ``` qldb> begin; SELECT * FROM Vehicle WHERE VIN = '1N4AL11D75C109151'; SELECT * FROM Person p, DriversLicense l WHERE p.GovId = l.LicenseNumber; commit ``` 각 명령과 명령문을 세미콜론(`;`) 구분 기호로 구분해야 합니다. 트랜잭션의 명령문이 유효하지 않은 경우 쉘은 자동으로 트랜잭션을 거부합니다. 쉘은 사용자가 입력한 후속 명령문을 처리하지 않습니다. 여러 트랜잭션을 설정할 수도 있습니다. ``` qldb> begin; statement1; commit; begin; statement2; statement3; commit ``` 이전 예와 마찬가지로, 트랜잭션이 실패하면 쉘은 사용자가 입력한 후속 트랜잭션이나 명령문을 진행하지 않습니다. 트랜잭션을 종료하지 않으면 쉘이 대화형 모드로 전환되고 다음 명령문이나 문을 입력하라는 메시지가 표시됩니다. ``` qldb> begin; statement1; commit; begin qldb *> ``` ## 쉘 종료 현재 `qldb` 쉘 세션을 종료하려면 `exit` 또는 `quit` 명령을 입력하거나 쉘이 트랜잭션에 있지 않은 경우 키보드 단축키 Ctrl\$1D를 사용합니다. ``` qldb> exit $ ``` ``` qldb> quit $ ``` ## 예제 QLDB에서 PartiQL 문을 작성하는 방법에 대한 자세한 설명은 [Amazon QLDB PartiQL 참조](ql-reference.md) 섹션을 참조하세요. **Example** 다음 예에서는 일반적인 기본 명령 순서를 보여줍니다. QLDB 쉘은 이 예의 각 PartiQL 문을 자체 트랜잭션으로 실행합니다. 이 예에서는 원장 `test-ledger`이 이미 존재하고 활성 상태라고 가정합니다. ``` $ qldb --ledger test-ledger --region us-east-1 qldb> CREATE TABLE TestTable qldb> INSERT INTO TestTable `{"Name": "John Doe"}` qldb> SELECT * FROM TestTable qldb> DROP TABLE TestTable qldb> exit ``` # API를 사용하여 Amazon QLDB에 액세스 **중요** 지원 종료 공지: 기존 고객은 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/)을 참조하세요. AWS Management Console 및 AWS Command Line Interface (AWS CLI)를 사용하여 Amazon QLDB와 대화식으로 작업할 수 있습니다. 그러나 QLDB를 최대한 활용하려면 QLDB 드라이버 또는 AWS SDK를 사용하여 애플리케이션 코드를 작성하여 APIs를 사용하여 원장과 상호 작용할 수 있습니다. 드라이버를 사용하면 애플리케이션이 *트랜잭션 데이터* API를 사용하여 QLDB와 상호 작용할 수 있습니다. AWS SDK는 QLDB *리소스 관리* API와의 상호 작용을 지원합니다. 이들 API에 대한 자세한 내용은 [Amazon QLDB API 참조](api-reference.md) 섹션을 참조하세요. 이 드라이버는 [Java](https://aws.amazon.com/sdk-for-java), [.NET](https://aws.amazon.com/sdk-for-net), [Go](https://aws.amazon.com/sdk-for-go), [Node.js](https://aws.amazon.com/sdk-for-node-js) 및 [Python](https://aws.amazon.com/sdk-for-python)에서 QLDB에 대한 지원을 제공합니다. 이러한 언어를 신속하게 사용하려면 [Amazon QLDB 드라이버 시작하기](getting-started-driver.md)을 참조하세요. 애플리케이션에서 QLDB 드라이버 또는 AWS SDK를 사용하려면 먼저 프로그래밍 방식 액세스 권한을 부여해야 합니다. 자세한 내용은 [프로그래밍 방식 액세스 권한 부여](accessing.md#grant-programmatic-access) 단원을 참조하십시오.