.NET 코드 예시

이 안내서에는 .NET 코드 조각과 실행 준비된 프로그램이 포함되어 있습니다. 다음 단원에서 이들 코드 예제를 찾을 수 있습니다.

• 항목 및 속성 작업

• DynamoDB의 테이블 및 데이터 작업

• DynamoDB의 쿼리 작업

• DynamoDB에서 스캔 작업

• 보조 인덱스를 사용하여 데이터 액세스 향상

• .NET: 문서 모델

• .NET: 객체 지속성 모델

• DynamoDB Streams에 대한 변경 데이터 캡처

AWS SDK for .NET 및 Toolkit for Visual Studio를 함께 사용하면 빠르게 시작할 수 있습니다.

.NET 코드 예제를 실행하려면((Visual Studio 사용)

1. Microsoft Visual Studio를 다운로드하여 설치합니다.

2. Toolkit for Visual Studio를 다운로드하여 설치합니다.

3. Visual Studio를 시작합니다. 파일, 새로 만들기, 프로젝트를 선택합니다.

4. New Project에서 AWS Empty Project를 선택한 다음 OK를 선택합니다.

5. AWS Access Credentials에서 Use existing profile을 선택하고, 목록에서 자격 증명 프로필을 선택한 다음 OK를 선택합니다.

   Toolkit for Visual Studio를 처음 사용하는 경우, Use a new profile(새 프로필 사용)을 선택하여 AWS 자격 증명을 설정합니다.

6. Visual Studio 프로젝트에서 프로그램 소스 코드(Program.cs) 탭을 선택합니다. 설명서 페이지에서 코드 예제를 Visual Studio 에디터로 복사하여 에디터에 표시된 일체의 코드를 대체합니다.

7. 유형 또는 네임스페이스 이름을...찾을 수 없습니다. 형식의 오류 메시지가 표시되면 다음과 같이 DynamoDB용 AWS SDK 어셈블리를 설치해야 합니다.

   1. Solution Exploer에서 프로젝트의 컨텍스트 메뉴를 열고(마우스 오른쪽 버튼 클릭) Manage NuGet Packages를 선택합니다.

   2. NuGet Package Manager에서 Browse를 선택합니다.

   3. 검색 상자에 AWSSDK.DynamoDBv2를 입력하고 검색이 완료되기를 기다립니다.

   4. AWSSDK.DynamoDBv2를 선택한 다음 설치를 선택합니다.

   5. 설치가 완료되면 Program.cs 탭을 선택하여 프로그램으로 돌아갑니다.

8. 코드를 실행하려면 Visual Studio 도구 모음에서 시작을 선택합니다.

AWS SDK for .NET은 DynamoDB 작업을 위한 스레드 세이프(thread-safe) 클라이언트를 제공합니다. 모범 사례로서 애플리케이션에서 클라이언트 하나를 생성한 후 스레드 간에 재사용해야 합니다.

자세한 내용은 AWS SDK for .NET을 참조하세요.

참고

이 안내서의 코드 예제는 AWS SDK for .NET의 최신 버전과 함께 사용해야 합니다.

.NET: AWS 보안 인증 정보 설정

AWS SDK for .NET에서는 런타임에 애플리케이션에 AWS 자격 증명을 제공해야 합니다. 이 가이드의 코드 예시에서는 AWS SDK for .NET 개발자 안내서의 SDK 스토어 사용에 설명된 대로 SDK 스토어를 사용하여 AWS 보안 인증 정보 파일을 관리한다고 가정합니다.

Toolkit for Visual Studio는 계정 수에 제한 없이 다수의 자격 증명 집합을 지원합니다. 각 집합을 프로필이라고 부릅니다. Visual Studio는 애플리케이션이 런타임 도중에도 AWS 자격 증명을 찾을 수 있도록 프로젝트의 App.config 파일에 항목을 추가합니다.

다음 예제에서는 Toolkit for Visual Studio를 사용하여 새 프로젝트를 만들 때 생성되는 기본 App.config 파일을 보여줍니다.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
    <add key="AWSProfileName" value="default"/>
    <add key="AWSRegion" value="us-west-2" />
 </appSettings>
</configuration>

런타임에 프로그램은 AWSProfileName 항목에 지정된 대로 default 자격 증명의 AWS 집합을 사용합니다. AWS 자격 증명 자체는 암호화된 형식으로 SDK 스토어에 보관됩니다. Toolkit for Visual Studio는 Visual Studio 안에서 자격 증명을 모두 관리할 수 있는 그래픽 사용자 인터페이스를 제공합니다. 자세한 내용은 AWS Toolkit for Visual Studio 사용 설명서에서 보안 인증 정보 지정을 참조하세요.

참고

기본적으로 코드 예제는 미국 서부(오레곤) 리전에서 DynamoDB에 액세스합니다. App.config 파일의 AWSRegion 항목을 수정하여 리전을 변경할 수 있습니다. AWSRegion은 DynamoDB를 사용할 수 있는 어느 리전으로도 설정할 수 있습니다. 전체 목록은 Amazon Web Services 일반 참조에서 AWS 리전 및 엔드포인트를 참조하세요.

.NET: AWS 리전 및 엔드포인트 설정

기본적으로 코드 예제는 미국 서부(오레곤) 리전에서 DynamoDB에 액세스합니다. App.config 파일의 AWSRegion 항목을 수정하여 리전을 변경할 수 있습니다. 또는 AmazonDynamoDBClient 속성을 수정하여 리전을 변경할 수 있습니다.

다음 코드 예제에서는 새 AmazonDynamoDBClient를 인스턴스화합니다. 클라이언트가 수정되어 코드가 다른 리전의 DynamoDB에 대해 실행됩니다.

AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig();
// This client will access the US East 1 region.
clientConfig.RegionEndpoint = RegionEndpoint.USEast1;
AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig); 

전체 리전 목록은 Amazon Web Services 일반 참조에서 AWS 리전 및 엔드포인트를 참조하세요.

컴퓨터에서 로컬로 DynamoDB를 사용하여 코드 예제를 실행하려면 다음과 같이 엔드포인트를 설정합니다.

AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig();
// Set the endpoint URL
clientConfig.ServiceURL = "http://localhost:8000";
AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig);