아마존 QLDB 드라이버. NET

중요

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

원장에 있는 데이터로 작업하려면 QLDB Microsoft에서 Amazon에 연결할 수 있습니다. NET AWS 제공된 드라이버를 사용하여 신청하십시오. 드라이버 대상. NET스탠다드 2.0. 보다 구체적으로, 지원합니다. NET코어 (LTS) 2.1+ 및. NET프레임워크 4.5.2+. 호환성에 대한 자세한 내용은 을 참조하십시오. NETMicrosoft Docs 사이트의 표준입니다.

Amazon Ion 유형과 네이티브 C# 유형 간에 수동으로 변환할 필요가 없도록 하려면 Ion 객체 매퍼를 사용하는 것이 좋습니다.

다음 항목에서는 의 QLDB 드라이버를 시작하는 방법을 설명합니다. NET.

주제

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

드라이버 리소스

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

• API참조

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

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

• Amazon Ion Cookbook

• 이온 객체 매퍼 () GitHub

사전 조건

에 대한 QLDB 드라이버를 시작하기 전에 NET, 다음을 수행해야 합니다.

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

   1. 가입하세요 AWS.

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

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

2. 다운로드 및 설치. NET마이크로소프트의 코어 SDK 버전 2.1 이상 NET다운로드 사이트.

3. (선택 사항) Visual Studio, Mac용 Visual Studio 또는 Visual Studio Code와 같은 통합 개발 환경 (IDE) 을 원하는 대로 설치합니다. 이러한 프로그램은 Microsoft Visual Studio 사이트에서 다운로드할 수 있습니다.

4. AWS SDK for .NET를 위한 개발 환경 구성:

   1. AWS 자격 증명을 설정합니다. 공유 보안 인증 파일을 생성할 것을 권장합니다.

      지침은 AWS SDK for .NET 개발자 안내서의 보안 인증 파일을 사용하여 AWS 보안 인증 구성을 참조하세요.

   2. 기본 AWS 리전을 설정하세요. 방법을 알아보려면 AWS 리전 선택을 참조하세요.

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

다음으로 기본 샘플 애플리케이션을 설정하고 단축 코드 예제를 실행하거나 기존 애플리케이션에 드라이버를 설치할 수 있습니다. NET프로젝트.

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

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

설치

NuGet 패키지 관리자를 사용하여 QLDB 드라이버를 설치합니다. NET. Visual Studio 또는 원하는 것을 사용하여 프로젝트 종속성을 추가하는 것이 좋습니다. IDE 드라이버 패키지 이름은 Amazon입니다. QLDB.드라이버.

예를 들어 Visual Studio의 경우 도구 메뉴에서 NuGet 패키지 관리자 콘솔을 엽니다. 그런 다음 PM> 프롬프트에 다음 명령을 입력합니다.

PM> Install-Package Amazon.QLDB.Driver

드라이버를 설치하면 및 AWS SDK for .NET Amazon Ion 패키지를 비롯한 종속 항목도 설치됩니다.

Ion 객체 매퍼 설치

드라이버의 버전 1.3.0입니다. QLDB NETAmazon Ion을 사용할 필요 없이 네이티브 C# 데이터 형식을 수락하고 반환할 수 있는 지원을 소개합니다. 이 기능을 사용하려면 프로젝트에 다음 패키지를 추가하세요.

• 아마존. QLDB.Driver.Serialization — Ion 값을 C# 일반 CLR 객체 (POCO) 에 매핑하거나 그 반대의 방식으로 매핑할 수 있는 라이브러리입니다. 이 Ion 객체 매퍼를 사용하면 애플리케이션이 Ion을 사용할 필요 없이 네이티브 C# 데이터 유형과 직접 상호 작용할 수 있습니다. 이 라이브러리를 사용하는 방법에 대한 간단한 가이드는 저장소의.md 파일을 참조하십시오. SERIALIZATION GitHub awslabs/amazon-qldb-driver-dotnet

이 패키지를 설치하려면 다음 명령을 입력합니다.

PM> Install-Package Amazon.QLDB.Driver.Serialization

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