빠른 시작: .NET SDK 및 Azure Cosmos DB를 사용하여 Cassandra 앱 빌드

적용 대상: Cassandra API

이 빠른 시작에서는 GitHub에서 예제를 복제하여 프로필 앱을 빌드하기 위해 .NET과 Azure Cosmos DB Cassandra API를 사용하는 방법을 보여 줍니다. 또한 웹 기반 Azure Portal을 사용하여 Azure Cosmos DB 계정을 만드는 방법도 보여 줍니다.

Azure Cosmos DB는 전 세계에 배포된 Microsoft의 다중 모델 데이터베이스 서비스입니다. Azure Cosmos DB의 핵심인 전역 배포 및 수평적 크기 조정 기능의 이점을 활용하여 문서, 테이블, 키/값 및 그래프 데이터베이스를 빠르게 만들고 쿼리할 수 있습니다.

필수 구성 요소

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다. 또는 Azure 구독, 요금 및 약정 없이 Azure Cosmos DB 평가판을 사용할 수 있습니다.

또한 다음 항목도 필요합니다.

  • Azure 개발 워크로드가 포함된 최신 Visual Studio. 무료Visual Studio Community IDE로 시작할 수 있습니다. Visual Studio 설정 중에 Azure 개발 워크로드를 사용하도록 설정합니다.
  • Git을 설치하여 예제를 복제합니다.

데이터베이스 계정 만들기

  1. Azure Portal 메뉴 또는 페이지에서 리소스 만들기를 선택합니다.

  2. 새로 만들기 페이지에서 Azure Cosmos DB를 검색하여 선택합니다.

  3. Azure Cosmos DB 페이지에서 만들기를 선택합니다.

  4. Azure Cosmos DB 계정 만들기 페이지에서 새 Azure Cosmos 계정에 대한 기본 설정을 입력합니다.

    설정 설명
    Subscription 사용자의 구독 이 Azure Cosmos DB 계정에 사용하려는 Azure 구독을 선택합니다.
    리소스 그룹 새로 만들기

    그런 다음, 계정 이름과 같은 이름 입력
    새로 만들기를 선택합니다. 그런 다음, 계정의 새 리소스 그룹 이름을 입력합니다. 간단히 하기 위해 Azure Cosmos 계정 이름과 동일한 이름을 사용합니다.
    계정 이름 고유한 이름을 입력합니다. 내 Azure Cosmos DB 계정을 식별하는 고유한 이름을 입력합니다. 계정 URI는 고유한 계정 이름에 cassandra.cosmos.azure.com이 추가됩니다.

    계정 이름은 소문자, 숫자 및 하이픈(-) 문자만 포함할 수 있으며, 3-31자여야 합니다.
    API Cassandra API는 만들 계정의 형식을 결정합니다. Azure Cosmos DB는 문서 데이터베이스용 Core(SQL), 그래프 데이터베이스용 Gremlin, 문서 데이터베이스용 MongoDB, Azure Table 및 Cassandra의 5가지 API를 제공합니다. 각 API에 대한 별도의 계정을 만들어야 합니다.

    이 빠른 시작에서는 Cassandra API와 함께 작동하는 테이블을 만들고 있으므로 Cassandra를 선택합니다.

    Cassandra API에 대해 자세히 알아보세요.
    위치 사용자와 가장 가까운 지역 Azure Cosmos DB 계정을 호스트할 지리적 위치를 선택합니다. 데이터에 가장 빨리 액세스할 수 있도록 사용자와 가장 가까운 위치를 사용합니다.
    용량 모드 프로비저닝된 처리량 또는 서버리스 프로비저닝된 처리량을 선택하여 프로비저닝된 처리량 모드에서 계정을 만듭니다. 서버리스를 선택하여 서버리스 모드에서 계정을 만듭니다.
    Azure Cosmos DB 체험 계층 할인 적용 적용 또는 적용 안 함 Azure Cosmos DB 체험 계층을 사용하는 경우 처음에는 1000RU/초 및 25GB의 스토리지가 계정에 무료로 제공됩니다. 체험 계층에 대해 자세히 알아보세요.

    참고

    Azure 구독당 최대 1개의 체험 계층 Azure Cosmos DB 계정을 사용할 수 있으며 계정을 만들 때 옵트인해야 합니다. 체험 계층 할인을 적용하는 옵션이 표시되지 않으면 구독의 다른 계정에서 이미 체험 계층을 사용하도록 설정되었음을 의미합니다.

    The new account page for Azure Cosmos DB Cassandra API

  5. 전역 배포 탭에서 다음 세부 정보를 구성합니다. 이 빠른 시작의 목적을 위해 기본값을 그대로 둘 수 있습니다.

    설정 Description
    지리적 중복 사용 안 함 지역에 쌍 영역을 페어링하여 계정에서 글로벌 배포를 사용하거나 사용하지 않도록 설정합니다. 나중에 계정에 더 많은 지역을 추가할 수 있습니다.
    다중 지역 쓰기 사용 안 함 다중 영역 쓰기 기능을 사용하면 전 세계의 데이터베이스 및 컨테이너에 대해 프로비저닝된 처리량을 활용할 수 있습니다.

    참고

    용량 모드서버리스를 선택한 경우 다음 옵션을 사용할 수 없습니다.

    • 체험 계층 할인 적용
    • 지리적 중복
    • 다중 지역 쓰기
  6. 필요에 따라 다음 탭에서 추가 세부 정보를 구성할 수 있습니다.

    • 네트워킹 - 가상 네트워크에서 액세스를 구성합니다.
    • 백업 정책 - 주기적 또는 지속적인 백업 정책을 구성합니다.
    • 암호화 - 서비스 관리형 키 또는 고객 관리형 키를 사용합니다.
    • 태그 - 태그는 동일한 태그를 여러 개의 리소스 및 리소스 그룹에 적용하여 리소스를 범주화하고 통합된 청구를 볼 수 있는 이름/값 쌍입니다.
  7. 검토 + 만들기를 선택합니다.

  8. 계정 설정을 검토한 다음, 만들기를 선택합니다. 계정을 만드는 데 몇 분이 걸립니다. 포털 페이지에 배포가 완료됨이 표시되기를 기다립니다.

    The Azure portal Notifications pane

  9. 리소스로 이동을 선택하여 Azure Cosmos DB 계정 페이지로 이동합니다.

샘플 애플리케이션 복제

이제 코드 사용으로 전환해 보겠습니다. GitHub에서 Cassandra API 앱을 복제하고 연결 문자열을 설정한 다음 실행해 보겠습니다. 프로그래밍 방식으로 데이터 작업을 얼마나 쉽게 수행할 수 있는지 알게 될 것입니다.

  1. 명령 프롬프트를 엽니다. 이름이 git-samples인 새 폴더를 만듭니다. 그런 다음, 명령 프롬프트를 닫습니다.

    md "C:\git-samples"
    
  2. Git Bash와 같은 Git 터미널 창을 열고, cd 명령을 사용하여 샘플 앱을 설치할 새 폴더로 변경합니다.

    cd "C:\git-samples"
    
  3. 다음 명령을 실행하여 샘플 리포지토리를 복제합니다. 이 명령은 컴퓨터에서 샘플 앱의 복사본을 만듭니다.

    git clone https://github.com/Azure-Samples/azure-cosmos-db-cassandra-dotnet-getting-started.git
    
  4. 그런 다음 Visual Studio에서 CassandraQuickStartSample 솔루션 파일을 엽니다.

코드 검토

이 단계는 선택 사항입니다. 코드로 데이터베이스 리소스를 만드는 방법을 알아보려는 경우 다음 코드 조각을 검토할 수 있습니다. 이 코드 조각은 모두 C:\git-samples\azure-cosmos-db-cassandra-dotnet-getting-started\CassandraQuickStartSample 폴더에 설치된 Program.cs 파일에서 가져온 것입니다. 그렇지 않으면 연결 문자열 업데이트로 건너뛸 수 있습니다.

  • Cassandra 클러스터 엔드포인트에 연결하여 세션을 초기화합니다. Azure Cosmos DB의 Cassandra API는 TLSv1.2만 지원합니다.

    var options = new Cassandra.SSLOptions(SslProtocols.Tls12, true, ValidateServerCertificate);
    options.SetHostNameResolver((ipAddress) => CassandraContactPoint);
    Cluster cluster = Cluster.Builder().WithCredentials(UserName, Password).WithPort(CassandraPort).AddContactPoint(CassandraContactPoint).WithSSL(options).Build();
    ISession session = cluster.Connect();
    
  • 새 keyspace를 만듭니다.

    session.Execute("CREATE KEYSPACE uprofile WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'datacenter1' : 1 };"); 
    
  • 새 테이블을 만듭니다.

    session.Execute("CREATE TABLE IF NOT EXISTS uprofile.user (user_id int PRIMARY KEY, user_name text, user_bcity text)");
    
  • uprofile keyspace에 연결하는 새 세션과 함께 IMapper 개체를 사용하여 사용자 엔터티를 삽입합니다.

    mapper.Insert<User>(new User(1, "LyubovK", "Dubai"));
    
  • 모든 사용자 정보를 가져오기 위한 쿼리입니다.

    foreach (User user in mapper.Fetch<User>("Select * from user"))
    {
       Console.WriteLine(user);
    }
    
  • 단일 사용자 정보를 가져오기 위한 쿼리입니다.

    mapper.FirstOrDefault<User>("Select * from user where user_id = ?", 3);
    

연결 문자열 업데이트

이제 Azure Portal로 다시 이동하여 연결 문자열 정보를 가져와서 앱에 복사합니다. 연결 문자열 정보를 통해 앱이 호스트된 데이터베이스와 통신할 수 있습니다.

  1. Azure Portal에서 연결 문자열을 선택합니다.

  2. 화면 오른쪽에 있는 단추를 사용하여 USERNAME 값을 복사합니다.

    View and copy an access key in the Azure portal, Connection String page

  3. Visual Studio에서 Program.cs 파일을 엽니다.

  4. 포털의 USERNAME 값을 줄 13의 <FILLME>에 붙여넣습니다.

    이제 Program.cs의 줄 13은 다음과 같습니다.

    private const string UserName = "cosmos-db-quickstart";

  5. 포털로 돌아가서 PASSWORD 값을 복사합니다. 포털의 PASSWORD 값을 줄 14의 <FILLME>에 붙여넣습니다.

    이제 Program.cs의 줄 14는 다음과 같습니다.

    private const string Password = "2Ggkr662ifxz2Mg...==";

  6. 포털로 돌아가서 CONTACT POINT 값을 복사합니다. 포털의 CONTACT POINT 값을 줄 15의 <FILLME>에 붙여넣습니다.

    이제 Program.cs의 줄 15는 다음과 같습니다.

    private const string CassandraContactPoint = "cosmos-db-quickstarts.cassandra.cosmosdb.azure.com"; // DnsName

  7. Program.cs 파일을 저장합니다.

.NET 앱 실행

  1. Visual Studio에서 도구>NuGet 패키지 관리자>패키지 관리자 콘솔을 선택합니다.

  2. 명령 프롬프트에서 다음 명령을 사용하여 .NET 드라이버의 NuGet 패키지를 설치합니다.

    Install-Package CassandraCSharpDriver
    
  3. Ctrl+F5를 눌러 애플리케이션을 실행합니다. 앱이 콘솔 창에 표시됩니다.

    View and verify the output

    프로그램 실행을 중지하고 콘솔 창을 닫으려면 CTRL+C를 누릅니다.

  4. Azure Portal에서 데이터 탐색기를 열어 이 새 데이터를 쿼리/수정/사용합니다.

    View the data in Data Explorer

Azure Portal에서 SLA 검토

Azure Portal에서는 Cosmos DB 계정 처리량, 스토리지, 가용성, 대기 시간 및 일관성을 모니터링합니다. Azure Cosmos DB SLA(서비스 수준 계약)와 관련된 메트릭 차트에는 실제 성능 대비 SLA 값이 표시됩니다. 이 메트릭 모음을 통해 SLA를 투명하게 모니터링할 수 있습니다.

메트릭 및 SLA를 검토하려면 다음을 수행합니다.

  1. Cosmos DB 계정의 탐색 메뉴에서 메트릭을 선택합니다.

  2. 대기 시간과 같은 탭을 선택하고, 오른쪽에서 시간 프레임을 선택합니다. 차트의 실제SLA 줄을 비교합니다.

    Azure Cosmos DB metrics suite

  3. 다른 탭의 메트릭을 검토합니다.

리소스 정리

앱과 Azure Cosmos DB 계정을 모두 사용했으면 추가로 비용을 지불하지 않도록 만든 Azure 리소스를 삭제할 수 있습니다. 리소스를 삭제하려면:

  1. Azure Portal 검색 창에서 리소스 그룹을 검색하고 선택합니다.

  2. 목록에서 이 빠른 시작에서 만든 리소스 그룹을 선택합니다.

    Select the resource group to delete

  3. 리소스 그룹 개요 페이지에서 리소스 그룹 삭제를 선택합니다.

    Delete the resource group

  4. 새 창에서 삭제할 리소스 그룹의 이름을 입력한 다음, 삭제를 선택합니다.

다음 단계

이 빠른 시작에서, Azure Cosmos DB 계정을 만들고, 데이터 탐색기를 사용하여 컨테이너를 만들고, 웹앱을 실행하는 방법을 알아보았습니다. 이제 다른 데이터를 Cosmos DB 계정으로 가져올 수 있습니다.