Amazon QLDB 원장의 기본 작업 - 아마존 퀀텀 레저 데이터베이스 (아마존QLDB)

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

Amazon QLDB 원장의 기본 작업

중요

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

QLDBAPI또는 AWS Command Line Interface (AWS CLI) 를 사용하여 QLDB Amazon에서 원장을 생성, 업데이트 및 삭제할 수 있습니다. 계정에 속한 모든 원장을 나열하거나 특정 원장에 대한 정보를 가져올 수도 있습니다.

다음 주제에서는 및 를 사용하는 원장 작업의 일반적인 단계를 보여주는 단축 코드 예제를 제공합니다. AWS SDK for Java AWS CLI

전체 샘플 애플리케이션에서 이러한 작업을 보여주는 코드 예제는 다음 드라이버 시작하기 자습서 및 GitHub 리포지토리를 참조하십시오.

원장 생성

AWS 계정작업을 사용하여 CreateLedger에서 원장을 생성합니다. 다음 정보를 제공해야 합니다.

  • 원장 명칭 - 계정에 생성하려는 원장의 명칭입니다. 이 명칭은 현재 AWS 리전에 있는 귀하의 모든 원장에 고유해야 합니다.

    원장 명칭에 대한 명명 제약 조건은 아마존의 할당량 및 한도 QLDB에서 정의됩니다.

  • 권한 모드 - 원장에 할당할 권한 모드입니다. 다음 옵션 중 하나를 선택하세요:

    • 모두 허용 — 원장에 대해 특정 API 수준의 세분성으로 액세스를 제어할 수 있는 레거시 권한 모드입니다.

      이 모드에서는 이 원장에 대한 SendCommand API 권한이 있는 사용자가 지정된 원장의 모든 테이블에서 모든 PartiQL 명령 (즉ALLOW_ALL,) 을 실행할 수 있습니다. 이 모드에서는 원장에 대해 생성한 테이블 수준 또는 명령 IAM 수준의 권한 정책을 무시합니다.

    • 표준 - (권장) 원장, 테이블 및 PartiQL 명령에 대해 보다 세분화된 액세스 제어를 가능하게 하는 권한 모드입니다.. 원장 데이터의 보안을 극대화하기 위해 이 권한 모드를 사용하는 것을 강력 권장합니다.

      기본적으로 이 모드는 이 원장의 모든 테이블에서 PartiQL 명령을 실행하려는 모든 요청을 거부합니다. PartiQL 명령을 허용하려면 원장에 대한 권한 외에도 특정 테이블 리소스 및 PartiQL 작업에 대한 권한 정책을 IAM 생성해야 합니다. SendCommand API 자세한 내용은 Amazon의 표준 권한 모드로 시작하기 QLDB을 참조하세요.

  • 삭제 보호 - (옵션) 사용자가 원장을 삭제하는 것을 방지하는 플래그입니다. 원장 생성 중 이를 정의하지 않는 경우에도 이 기능은 기본적으로 활성화됩니다(true).

    삭제 방지가 활성화된 경우 원장을 삭제하려면 먼저 이 기능을 비활성화해야 합니다. UpdateLedger 작업을 사용하여 플래그를 false로 설정함으로써 비활성화할 수 있습니다.

  • AWS KMS key - (옵션) 저장 데이터를 암호화하는 데 사용할 AWS Key Management Service (AWS KMS)의 키입니다. 다음 AWS KMS keys타입 중 하나를 선택하세요:

    • AWS 소유 KMS 키 — 사용자 대신 소유하고 관리하는 KMS 키를 사용합니다. AWS

      원장 생성 중에 이 파라미터를 정의하지 않으면 원장이 기본적으로 이 타입의 키를 사용합니다. 문자열 AWS_OWNED_KMS_KEY를 사용하여 이 키 타입을 지정할 수 있습니다. 이 옵션은 추가 설정이 필요하지 않습니다.

    • 고객 관리 KMS 키 — 생성, 소유 및 관리하는 계정에서 대칭 암호화 KMS 키를 사용합니다. QLDB비대칭 키는 지원하지 않습니다.

      이 옵션을 사용하려면 계정에서 KMS 키를 만들거나 기존 키를 사용해야 합니다. 고객 관리 키를 만드는 방법에 대한 지침은 AWS Key Management Service 개발자 안내서의 대칭 암호화 KMS 키 만들기를 참조하십시오.

      ID, 별칭 또는 Amazon 리소스 이름 (ARN) 을 사용하여 고객 관리 KMS 키를 지정할 수 있습니다. 자세히 알아보려면 AWS Key Management Service 개발자 안내서의 키 식별자 (KeyId) 를 참조하십시오.

      참고

      교차 리전 키는 지원되지 않습니다. 지정된 KMS 키는 원장 내에 있어야 AWS 리전 합니다.

    자세한 내용은 Amazon의 저장 중 암호화 QLDB 단원을 참조하십시오.

  • 태그 - (선택 사항) 태그를 키-값 쌍으로 연결하여 메타데이터를 원장에 추가합니다. 원장에 태그를 추가함으로써 쉽게 원장을 조직화하고 식별할 수 있습니다. 자세한 내용은 Amazon QLDB 리소스에 태그 지정 단원을 참조하십시오.

원장을 QLDB 생성하고 상태를 로 설정하기 전까지는 원장을 사용할 준비가 되지 않습니다. ACTIVE

를 사용하여 원장을 생성하려면 AWS SDK for Java
  1. AmazonQLDB 클래스의 인스턴스를 만듭니다.

  2. CreateLedgerRequest 클래스 인스턴스를 만들어 요청 정보를 입력합니다.

    원장 명칭과 권한 모드를 제공해야 합니다.

  3. 요청 객체를 파라미터로 입력하여 createLedger 메서드를 실행합니다.

createLedger 요청은 원장에 대한 정보가 있는 CreateLedgerResult 객체를 반환합니다. 원장 생성 후 DescribeLedger 작업을 사용하여 원장 상태를 확인하는 예는 다음 섹션을 참조하세요.

다음 예는 이전 단계를 설명합니다.

예 - 기본 구성 설정 사용
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build(); CreateLedgerRequest request = new CreateLedgerRequest() .withName(ledgerName) .withPermissionsMode(PermissionsMode.STANDARD); CreateLedgerResult result = client.createLedger(request);
참고

지정하지 않을 경우 원장은 다음과 같은 기본 설정을 사용합니다.

  • 삭제 보호 - 활성화 (true).

  • KMS키 — AWS 소유 KMS 키.

예 — 삭제 방지를 비활성화하고, 고객 관리 KMS 키를 사용하고, 태그를 첨부합니다.
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build(); Map<String, String> tags = new HashMap<>(); tags.put("IsTest", "true"); tags.put("Domain", "Test"); CreateLedgerRequest request = new CreateLedgerRequest() .withName(ledgerName) .withPermissionsMode(PermissionsMode.STANDARD) .withDeletionProtection(false) .withKmsKey("arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab") .withTags(tags); CreateLedgerResult result = client.createLedger(request);

기본 구성 설정을 사용하여 vehicle-registration라는 명칭의 새 원장을 생성합니다.

aws qldb create-ledger --name vehicle-registration --permissions-mode STANDARD
참고

지정하지 않을 경우 원장은 다음과 같은 기본 설정을 사용합니다.

  • 삭제 보호 - 활성화 (true).

  • KMS키 — AWS 소유 KMS 키.

또는 삭제 방지 기능이 비활성화되고 지정된 고객 관리 KMS 키와 지정된 태그를 사용하여 이름이 vehicle-registration 지정된 새 원장을 생성할 수 있습니다.

aws qldb create-ledger \ --name vehicle-registration \ --no-deletion-protection \ --permissions-mode STANDARD \ --kms-key arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \ --tags IsTest=true,Domain=Test

AWS CloudFormation 템플릿을 사용하여 원장을 생성할 수도 있습니다. 자세한 내용은 사용 설명서의 AWS::QLDB: :Ledger 리소스를 참조하십시오.AWS CloudFormation

원장 설명

원장에 대한 세부 정보를 보려면 DescribeLedger 작업을 사용하세요. 원장 명칭을 입력해야 합니다. DescribeLedger 출력은 CreateLedger 출력의 형식과 동일합니다. 여기에는 다음 정보가 포함됩니다.

  • 원장 명칭 - 설명하려는 원장의 명칭입니다.

  • ARN— 다음 형식의 원장의 Amazon 리소스 이름 (ARN).

    arn:aws:qldb:aws-region:account-id:ledger/ledger-name
  • 삭제 보호 - 삭제 보호 기능이 활성화되었는지 여부를 나타내는 플래그입니다.

  • 생성 날짜 및 시간 - Epoch 시간 형식의 원장이 생성된 날짜 및 시간입니다.

  • 상태 - 원장의 현재 상태입니다. 다음 값 중 하나일 수 있습니다:

    • CREATING

    • ACTIVE

    • DELETING

    • DELETED

  • 권한 모드 - 원장에 할당된 권한 모드입니다. 다음 값 중 하나일 수 있습니다:

    • ALLOW_ALL— 원장에 대해 API 1단계 세분화로 액세스를 제어할 수 있는 레거시 권한 모드입니다.

    • STANDARD - 원장, 테이블 및 PartiQL 명령에 대해 보다 세분화된 액세스 제어를 가능하게 하는 권한 모드입니다..

  • 암호화 설명 - 원장의 저장 데이터 암호화에 대한 정보입니다. 다음 항목이 해당됩니다:

    • AWS KMS key ARN— 원장이 저장 ARN 중 암호화에 사용하는 고객 관리 KMS 키의. 이 값이 정의되지 않은 경우 원장은 AWS 소유한 KMS 키를 암호화에 사용합니다.

    • 암호화 상태 - 원장에 대한 저장된 암호화의 현재 상태입니다. 다음 값 중 하나일 수 있습니다:

      • ENABLED - 지정된 키를 사용하여 암호화가 완전히 활성화되었습니다.

      • UPDATING - 지정된 키 변경이 활발히 처리되고 있습니다.

        키 QLDB 변경은 비동기적으로 이루어집니다. 키 변경이 처리되는 동안 성능에 영향을 주지 않고 원장에 완전히 액세스할 수 있습니다. 키를 업데이트하는 데 걸리는 시간은 원장 크기에 따라 다릅니다

      • KMS_KEY_INACCESSIBLE— 지정된 고객 관리 KMS 키에 액세스할 수 없으며 원장이 손상되었습니다. 키가 비활성화 또는 삭제되었거나 키에 대한 권한 부여가 취소되었습니다. 원장이 손상되면 해당 원장에 접근할 수 없으며 읽기 또는 쓰기 요청을 수락할 수 없습니다.

        손상된 원장은 키에 대한 권한 부여를 복원한 후 또는 비활성화된 키를 다시 활성화하면 자동으로 활성 상태로 돌아갑니다. 하지만 고객 관리 KMS 키를 삭제하면 되돌릴 수 없습니다. 키가 삭제된 후에는 해당 키로 보호되는 원장에 더 이상 액세스할 수 없으며 데이터를 영구적으로 복구할 수 없게 됩니다.

    • 액세스할 수 없음 AWS KMS key - 오류가 발생한 경우 KMS 키에 처음 액세스할 수 없게 된 날짜 및 시간 (에포크 타임 형식) 입니다.

      키에 액세스할 수 있는 경우에는 정의되지 않습니다. KMS

    자세한 내용은 Amazon의 저장 중 암호화 QLDB 단원을 참조하십시오.

참고

QLDB원장을 생성한 후 상태가 에서 CREATING 로 변경되면 사용할 준비가 된 것입니다. ACTIVE

다음을 사용하여 원장을 설명하려면 AWS SDK for Java
  1. AmazonQLDB 클래스의 인스턴스를 만듭니다. 또는 CreateLedger 요청을 위해 인스턴스화한 것과 동일한 AmazonQLDB 클라이언트 인스턴스를 사용할 수 있습니다.

  2. DescribeLedgerRequest 클래스의 인스턴스를 생성하고, 삭제하려는 원장 명칭을 입력하세요.

  3. 요청 객체를 파라미터로 입력하여 describeLedger 메서드를 실행합니다.

  4. describeLedger 요청은 원장에 대한 최신 정보가 있는 DescribeLedgerResult 객체를 반환합니다.

다음 코드 예에서는 이전 단계를 설명합니다. 클라이언트의 describeLedger 메서드를 호출하여 언제든지 원장 정보를 가져올 수 있습니다.

AmazonQLDB client = AmazonQLDBClientBuilder.standard().build(); DescribeLedgerRequest request = new DescribeLedgerRequest().withName(ledgerName); DescribeLedgerResult result = client.describeLedger(request); System.out.printf("%s: ARN: %s \t State: %s \t CreationDateTime: %s \t DeletionProtection: %s \t PermissionsMode: %s \t EncryptionDescription: %s", result.getName(), result.getArn(), result.getState(), result.getCreationDateTime(), result.getDeletionProtection(), result.getPermissionsMode(), result.getEncryptionDescription());

방금 생성한 vehicle-registration 원장에 대해 설명합니다.

aws qldb describe-ledger --name vehicle-registration

원장 업데이트

현재 UpdateLedger 작업을 통해 기존 원장에 대해 다음과 같은 구성 설정을 변경할 수 있습니다.

  • 삭제 보호 - 사용자가 원장을 삭제하는 것을 방지하는 플래그입니다. 이 기능이 활성화된 경우 원장을 삭제하려면 먼저 플래그를 false로 설정하여 이 기능을 비활성화해야 합니다.

    이 파라미터를 정의하지 않으면 원장의 삭제 보호 설정이 변경되지 않습니다.

  • AWS KMS key— 저장된 데이터를 암호화하는 데 사용할 키 in AWS Key Management Service (AWS KMS). 이 매개변수를 정의하지 않으면 원장 KMS 키가 변경되지 않습니다.

    참고

    Amazon은 2021년 7월 AWS KMS keys 22일에 고객 관리형 고객 지원을 QLDB 시작했습니다. 출시 이전에 생성된 모든 원장은 AWS 소유 키 기본적으로 보호되지만, 현재는 고객 관리 키를 사용하여 저장된 데이터를 암호화할 수 없습니다.

    콘솔에서 원장 생성 시간을 볼 수 있습니다. QLDB

    다음 옵션 중 하나를 사용하십시오.

    • AWS 소유 KMS 키 — 본인 대신 소유하고 AWS 관리하는 KMS 키를 사용합니다. 이 타입의 키를 사용하려면 이 파라미터에 대해 AWS_OWNED_KMS_KEY 문자열을 지정하세요. 이 옵션은 추가 설정이 필요하지 않습니다.

    • 고객 관리 KMS 키 — 생성, 소유 및 관리하는 계정에서 대칭 암호화 KMS 키를 사용합니다. QLDB비대칭 키는 지원하지 않습니다.

      이 옵션을 사용하려면 계정에서 KMS 키를 만들거나 기존 키를 사용해야 합니다. 고객 관리 키를 만드는 방법에 대한 지침은 AWS Key Management Service 개발자 안내서의 대칭 암호화 KMS 키 만들기를 참조하십시오.

      ID, 별칭 또는 Amazon 리소스 이름 (ARN) 을 사용하여 고객 관리 KMS 키를 지정할 수 있습니다. 자세히 알아보려면 AWS Key Management Service 개발자 안내서의 키 식별자 (KeyId) 를 참조하십시오.

      참고

      교차 리전 키는 지원되지 않습니다. 지정된 KMS 키는 원장 내에 있어야 AWS 리전 합니다.

    키 QLDB 변경은 비동기적으로 이루어집니다. 키 변경이 처리되는 동안 성능에 영향을 주지 않고 원장에 완전히 액세스할 수 있습니다.

    필요한 만큼 자주 키를 전환할 수 있지만 키를 업데이트하는 데 걸리는 시간은 원장 크기에 따라 다릅니다. DescribeLedger 작업을 사용하여 저장 상태의 암호화를 확인할 수 있습니다.

    자세한 내용은 Amazon의 저장 중 암호화 QLDB을 참조하세요.

UpdateLedger 출력은 CreateLedger 출력의 형식과 동일합니다.

를 사용하여 원장을 업데이트하려면 AWS SDK for Java
  1. AmazonQLDB 클래스의 인스턴스를 만듭니다.

  2. UpdateLedgerRequest 클래스 인스턴스를 만들어 요청 정보를 입력합니다.

    삭제 방지를 위한 새 Boolean 값 또는 키의 새 문자열 값과 함께 원장 이름을 제공해야 합니다. KMS

  3. 요청 객체를 파라미터로 입력하여 updateLedger 메서드를 실행합니다.

다음 코드 예는 이전 단계를 설명합니다. UpdateLedgerResult 요청은 원장에 대한 정보가 업데이트된 updateLedger 객체를 반환합니다.

예 - 삭제 보호 비활성화
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build(); UpdateLedgerRequest request = new UpdateLedgerRequest() .withName(ledgerName) .withDeletionProtection(false); UpdateLedgerResult result = client.updateLedger(request);
예 — 고객 관리 키 사용 KMS
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build(); UpdateLedgerRequest request = new UpdateLedgerRequest() .withName(ledgerName) .withKmsKey("arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab") UpdateLedgerResult result = client.updateLedger(request);
예 — AWS 소유 KMS 키 사용
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build(); UpdateLedgerRequest request = new UpdateLedgerRequest() .withName(ledgerName) .withKmsKey("AWS_OWNED_KMS_KEY") UpdateLedgerResult result = client.updateLedger(request);

vehicle-registration 원장에 삭제 보호가 활성화된 경우, 원장을 삭제하려면 먼저 이 기능을 비활성화해야 합니다.

aws qldb update-ledger --name vehicle-registration --no-deletion-protection

고객 관리 KMS 키를 사용하도록 원장의 저장 중 암호화 설정을 변경할 수도 있습니다.

aws qldb update-ledger --name vehicle-registration --kms-key arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

또는 저장 중 암호화 설정을 변경하여 AWS 소유 KMS 키를 사용할 수 있습니다.

aws qldb update-ledger --name vehicle-registration --kms-key AWS_OWNED_KMS_KEY

원장 권한 모드 업데이트

UpdateLedgerPermissionsMode 작업을 통해 기존 원장의 권한 모드를 변경할 수 있습니다. 다음 옵션 중 하나를 선택하세요:

  • 모두 허용 - 원장에 대해 특정 API 수준의 세분화로 액세스를 제어할 수 있는 레거시 권한 모드입니다.

    이 모드에서는 이 원장에 대한 SendCommand API 권한이 있는 사용자가 지정된 원장의 모든 테이블에서 모든 PartiQL 명령 (즉ALLOW_ALL,) 을 실행할 수 있습니다. 이 모드에서는 원장에 대해 생성한 테이블 수준 또는 명령 IAM 수준의 권한 정책을 무시합니다.

  • 표준 - (권장) 원장, 테이블 및 PartiQL 명령에 대해 보다 세분화된 액세스 제어를 가능하게 하는 권한 모드입니다.. 원장 데이터의 보안을 극대화하기 위해 이 권한 모드를 사용하는 것을 강력 권장합니다.

    기본적으로 이 모드는 이 원장의 모든 테이블에서 PartiQL 명령을 실행하려는 모든 요청을 거부합니다. PartiQL 명령을 허용하려면 원장에 대한 권한 외에도 특정 테이블 리소스 및 PartiQL 작업에 대한 권한 정책을 IAM 생성해야 합니다. SendCommand API 자세한 내용은 Amazon의 표준 권한 모드로 시작하기 QLDB을 참조하세요.

중요

STANDARD권한 모드로 전환하기 전에 먼저 필요한 모든 IAM 정책과 테이블 태그를 생성하여 사용자에게 방해가 되지 않도록 해야 합니다. 자세히 알아보려면 표준 권한 모드로 마이그레이션 섹션을 참조하세요.

를 사용하여 원장 권한 모드를 업데이트하려면 AWS SDK for Java
  1. AmazonQLDB 클래스의 인스턴스를 만듭니다.

  2. UpdateLedgerPermissionsModeRequest 클래스 인스턴스를 만들어 요청 정보를 입력합니다.

    권한 모드의 새 문자열 값과 함께 원장 명칭을 제공해야 합니다.

  3. 요청 객체를 파라미터로 입력하여 updateLedgerPermissionsMode 메서드를 실행합니다.

다음 코드 예는 이전 단계를 설명합니다. UpdateLedgerPermissionsModeResult 요청은 원장에 대한 정보가 업데이트된 updateLedgerPermissionsMode 객체를 반환합니다.

예 - 표준 권한 모드 할당
AmazonQLDB client = AmazonQLDBClientBuilder.standard().build(); UpdateLedgerPermissionsModeRequest request = new UpdateLedgerPermissionsModeRequest() .withName(ledgerName) .withPermissionsMode(PermissionsMode.STANDARD); UpdateLedgerPermissionsModeResult result = client.updateLedgerPermissionsMode(request);

vehicle-registration 원장에 STANDARD 권한 모드를 할당합니다.

aws qldb update-ledger-permissions-mode --name vehicle-registration --permissions-mode STANDARD

표준 권한 모드로 마이그레이션

STANDARD권한 모드로 마이그레이션하려면 QLDB 액세스 패턴을 분석하고 사용자에게 리소스에 액세스할 수 있는 적절한 권한을 부여하는 IAM 정책을 추가하는 것이 좋습니다.

STANDARD권한 모드로 전환하기 전에 먼저 필요한 모든 IAM 정책과 테이블 태그를 생성해야 합니다. 그렇지 않으면 권한 모드를 전환하면 올바른 IAM 정책을 생성하거나 권한 모드를 원래대로 되돌릴 때까지 사용자 작업이 중단될 수 있습니다. ALLOW_ALL 이러한 정책 생성에 대한 자세한 설명은 Amazon의 표준 권한 모드로 시작하기 QLDB 섹션을 참조하세요.

AWS 관리형 정책을 사용하여 모든 QLDB 리소스에 대한 전체 액세스 권한을 부여할 수도 있습니다. AmazonQLDBFullAccessAmazonQLDBConsoleFullAccess 관리형 정책에는 모든 PartiQL QLDB 작업을 포함한 모든 작업이 포함됩니다. 이러한 정책 중 하나를 주체에 연결하는 것은 해당 주체에 대한 ALLOW_ALL 권한 모드와 동일합니다. 자세한 내용은 AWS 아마존 관리형 정책 QLDB을 참조하세요.

원장 삭제

DeleteLedger 작업을 사용하여 원장과 모든 콘텐츠를 삭제합니다. 원장 삭제 작업은 취소할 수 없습니다.

원장에 대해 삭제 보호가 활성화된 경우, 먼저 이를 비활성화해야 원장을 삭제할 수 있습니다.

DeleteLedger 요청을 발행하면 원장의 상태가 ACTIVE에서 DELETING으로 바뀝니다. 사용하는 스토리지 용량에 따라 원장을 삭제하는 데 시간이 걸릴 수 있습니다. DeleteLedger작업이 끝나면 원장은 더 이상 존재하지 않습니다. QLDB

를 사용하여 원장을 삭제하려면 AWS SDK for Java
  1. AmazonQLDB 클래스의 인스턴스를 만듭니다.

  2. DeleteLedgerRequest 클래스의 인스턴스를 생성하고 삭제하려는 원장의 명칭을 입력합니다.

  3. 요청 객체를 파라미터로 입력하여 deleteLedger 메서드를 실행합니다.

다음 코드 예에서는 이전 단계를 설명합니다.

AmazonQLDB client = AmazonQLDBClientBuilder.standard().build(); DeleteLedgerRequest request = new DeleteLedgerRequest().withName(ledgerName); DeleteLedgerResult result = client.deleteLedger(request);

vehicle-registration 원장을 삭제합니다.

aws qldb delete-ledger --name vehicle-registration

원장 등재

ListLedgers 작업은 현재 AWS 계정 및 지역의 모든 QLDB 원장에 대한 요약 정보를 반환합니다.

다음을 사용하여 계정의 원장을 나열하려면 AWS SDK for Java
  1. AmazonQLDB 클래스의 인스턴스를 만듭니다.

  2. ListLedgersRequest 클래스의 인스턴스를 만듭니다.

    이전 ListLedgers 호출의 응답에서 NextToken 값을 받은 경우 이 요청에 해당 값을 제공해야 다음 결과 페이지를 확인할 수 있습니다.

  3. 요청 객체를 파라미터로 입력하여 listLedgers 메서드를 실행합니다.

  4. listLedgers 요청은 ListLedgersResult 객체를 반환합니다. 이 객체에는 LedgerSummary 객체 목록과 더 많은 결과가 있는지 여부를 나타내는 페이지 매김 토큰이 있습니다.

    • NextToken이 비어 있는 경우 결과의 마지막 페이지가 처리된 것이며, 더 이상 결과가 없습니다.

    • NextToken이 비어 있지 않으면 더 많은 결과를 사용할 수 있습니다. 결과의 그 다음 페이지를 검색하려면 후속 ListLedgers 호출에서 NextToken의 값을 사용합니다.

다음 코드 예에서는 이전 단계를 설명합니다.

AmazonQLDB client = AmazonQLDBClientBuilder.standard().build(); List<LedgerSummary> ledgerSummaries = new ArrayList<>(); String nextToken = null; do { ListLedgersRequest request = new ListLedgersRequest().withNextToken(nextToken); ListLedgersResult result = client.listLedgers(request); ledgerSummaries.addAll(result.getLedgers()); nextToken = result.getNextToken(); } while (nextToken != null);

현재 AWS 계정 및 지역의 모든 원장을 나열하십시오.

aws qldb list-ledgers