Python용 아마존 QLDB 드라이버

중요

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

원장의 데이터로 작업하려면 AWS 제공된 드라이버를 사용하여 Python QLDB 애플리케이션에서 Amazon에 연결할 수 있습니다. 다음 항목에서는 Python용 QLDB 드라이버를 시작하는 방법을 설명합니다.

주제

• 드라이버 리소스
• 사전 조건
• 설치
• 빠른 시작 자습서
• Cookbook 참조

드라이버 리소스

Python 드라이버에서 지원하는 기능에 대한 자세한 내용은 다음 리소스를 참조하세요.

• API참조: 3.x, 2.x

• 드라이버 소스 코드 () GitHub

• 샘플 애플리케이션 소스 코드 (GitHub)

• Amazon Ion 코드 예제

사전 조건

Python용 QLDB 드라이버를 시작하기 전에 다음을 수행해야 합니다.

1. 의 AWS 설정 지침을 따르십시오아마존 액세스 QLDB. 다음 내용이 포함됩니다:

   1. 가입하세요 AWS.

   2. 적절한 QLDB 권한을 가진 사용자를 만드세요.

   3. 개발을 위한 프로그래밍 방식 액세스 권한을 부여합니다.

2. Python 다운로드 사이트에서 다음 버전의 Python 중 하나를 설치합니다.

   • 3.6 이상 — Python v3용 QLDB 드라이버

   • 3.4 이상 — 파이썬 v2용 QLDB 드라이버

3. AWS 자격 증명과 기본값을 AWS 리전설정합니다. 지침은 설명서의 Quickstart를 AWS SDK for Python (Boto3) 참조하십시오.

   사용 가능한 지역의 전체 목록은 의 Amazon QLDB 엔드포인트 및 할당량을 참조하십시오. AWS 일반 참조

다음으로 전체 자습서 샘플 애플리케이션을 다운로드하거나 Python 프로젝트에 드라이버만 설치하고 단축 코드 예제를 실행할 수 있습니다.

• 기존 프로젝트에 QLDB 드라이버와 를 AWS SDK for Python (Boto3) 설치하려면 로 진행하십시오. 설치

• 프로젝트를 설정하고 원장에 대한 기본 데이터 트랜잭션을 보여주는 단축 코드 예제를 실행하려면 빠른 시작 자습서를 참조하세요.

• 전체 자습서 샘플 애플리케이션에서 데이터 및 관리 API 작업에 대한 보다 자세한 예제를 실행하려면 를 참조하십시오Python 자습서.

설치

QLDB는 다음 드라이버 버전과 Python 종속성을 지원합니다.

드라이버 버전	Python 버전	상태 표시기	최근 릴리스 날짜
2.x	3.4 이상	프로덕션 릴리스	2020년 5월 7일
3.x	3.6 이상	프로덕션 릴리스	2021년 10월 28일

pip(Python용 패키지 관리자) 를 사용하여 PyPI에서 QLDB 드라이버를 설치하려면 명령줄에 다음을 입력합니다.

3.x

pip install pyqldb

2.x

pip install pyqldb==2.0.2

드라이버를 설치하면 AWS SDK for Python (Boto3) 및 Amazon Ion 패키지를 포함한 종속 항목도 설치됩니다.

드라이버를 사용하여 원장에 연결

그런 다음 드라이버를 가져와서 원장에 연결하는 데 사용할 수 있습니다. 다음 Python 코드 예제에서는 지정된 원장 이름에 대한 세션을 생성하는 방법을 보여줍니다.

3.x

from pyqldb.driver.qldb_driver import QldbDriver
qldb_driver = QldbDriver(ledger_name='testLedger')

for table in qldb_driver.list_tables():
    print(table)

2.x

from pyqldb.driver.pooled_qldb_driver import PooledQldbDriver

qldb_driver = PooledQldbDriver(ledger_name='testLedger')
qldb_session = qldb_driver.get_session()

for table in qldb_session.list_tables():
    print(table)

원장에서 기본 데이터 트랜잭션을 실행하는 방법에 대한 단축 코드 예제는 Cookbook 참조를 참조하세요.