QLDBQLDB셸을 사용하여 Amazon에 액세스 (API데이터만 해당)

QLDBAmazon은 트랜잭션 데이터와의 상호 작용을 위한 명령줄 셸을 제공합니다. API QLDB셸을 사용하면 원장 데이터에 대해 PartiQL 문을 실행할 수 있습니다.

이 셸의 최신 버전은 Rust로 작성되었으며 기본 브랜치에 있는 amazon-qldb-shellawslabs/ GitHub 리포지토리의 오픈 소스입니다. main Python 버전(v1)도 master 브랜치의 동일한 리포지토리에서 계속 사용할 수 있습니다.

이 도구는 애플리케이션에 통합하거나 프로덕션 목적으로 채택하기 위한 것이 아닙니다. 이 도구의 목적은 PartiQL을 빠르게 실험해 볼 수 있도록 하는 것입니다. QLDB

다음 섹션에서는 셸을 QLDB 시작하는 방법을 설명합니다.

사전 조건

QLDB셸을 시작하기 전에 다음을 수행해야 합니다.

쉘 설치

QLDB셸의 최신 버전을 README설치하려면.md 파일을 참조하십시오. GitHub QLDB리포지토리의 GitHub Releases 섹션에 Linux, macOS 및 Windows용으로 미리 빌드된 바이너리 파일을 제공합니다.

macOS의 경우 쉘은 aws/tap Homebrew 탭과 통합됩니다. 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 데이터 형식을 사용합니다. 다음은 최소 config.ion 파일의 예입니다.

{
  default_ledger: "my-example-ledger"
}

default_ledger가 구성 파일에 설정되어 있지 않은 경우, 쉘을 호출할 때 --ledger 파라미터가 필요합니다. 구성 옵션의 전체 목록은 README.md 파일을 참조하십시오. GitHub

쉘 호출

명령줄 터미널에서 특정 원장에 대한 QLDB 셸을 호출하려면 다음 명령을 실행합니다. Replace my-example-ledger 원장 이름을 입력하세요.

$ qldb --ledger my-example-ledger

이 명령은 AWS 리전기본값에 연결됩니다. 지역을 명시적으로 지정하려면 다음 섹션에 설명된 대로 --region 또는 --qldb-session-endpoint 파라미터를 사용하여 명령을 실행할 수 있습니다.

qldb 쉘 세션을 호출한 후 다음과 같은 입력 타입을 입력할 수 있습니다.

쉘 파라미터

쉘을 호출하는 데 사용할 수 있는 플래그 및 옵션의 전체 목록을 보려면 다음과 같이 --help 플래그와 함께 qldb 명령을 실행합니다.

$ qldb --help

다음은 qldb 명령의 몇 가지 주요 플래그와 옵션입니다. 이러한 선택적 매개 변수를 추가하여 자격 증명 프로필, 엔드포인트 AWS 리전, 결과 형식 및 기타 구성 옵션을 재정의할 수 있습니다.

사용량

$ qldb [FLAGS] [OPTIONS]

명령 참조

qldb 세션을 호출한 후 쉘은 다음 키와 데이터베이스 명령을 지원합니다.

개별 명령문 실행

README.md에 나열된 데이터베이스 명령과 셸 메타 명령을 제외하고 셸은 사용자가 입력하는 각 명령을 별도의 PartiQL 문으로 해석합니다. 기본적으로 쉘은 auto-commit 모드를 활성화합니다. 이 모드는 구성할 수 있습니다.

auto-commit 모드에서는 쉘이 각 명령문을 자체 트랜잭션에서 암시적으로 실행하고 오류가 발견되지 않으면 트랜잭션을 자동으로 체결합니다. 즉, 문을 실행할 때마다 start transaction(또는 begin) 및 commit을 수동으로 실행하지 않아도 됩니다.

트랜잭션 관리

또는 QLDB 셸을 사용하여 트랜잭션을 수동으로 제어할 수도 있습니다. 명령 및 명령문을 순차적으로 일괄 처리하여 트랜잭션 내에서 여러 명령문을 대화식으로 실행하거나 비대화식으로 실행할 수 있습니다.

대화형 트랜잭션

대화형 트랜잭션을 실행하려면 다음 단계를 수행합니다.

트랜잭션 시간 초과 제한

대화형 트랜잭션은 QLDB 의 트랜잭션 제한 시간을 준수합니다. 시작 후 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+D를 사용합니다.

qldb> exit
$ 

qldb> quit
$ 

예

PartiQL 문을 작성하는 방법에 대한 자세한 내용은 를 참조하십시오QLDB. 아마존 QLDB PartiQL 레퍼런스

$ 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