다음을 통해 공유

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

적용 대상: 카산드라

이 빠른 시작에서는 Azure Cosmos DB for Apache Cassandra 계정을 만들고 CQLSH를 사용하여 Cassandra 데이터베이스 및 컨테이너를 만듭니다. Azure Cosmos DB는 글로벌 배포 및 수평적 크기 조정 기능을 사용하여 문서, 테이블, 키 값 및 그래프 데이터베이스를 빠르게 만들고 쿼리할 수 있는 다중 모델 데이터베이스 서비스입니다.

필수 구성 요소

데이터베이스 계정 만들기

문서 데이터베이스를 만들려면 Azure Cosmos DB로 Cassandra 계정을 만들어야 합니다.

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

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

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

  4. API 페이지의 Cassandra 섹션에서 만들기를 선택합니다.

    API는 만들 계정의 형식을 결정합니다. Azure Cosmos DB는 문서 데이터베이스용 NoSQL, 그래프 데이터베이스용 Gremlin, 문서 데이터베이스용 MongoDB, Azure Table 및 Cassandra 등 5개의 API를 제공합니다. 각 API에 대한 별도의 계정을 만들어야 합니다.

    이 자습서에서는 Cassandra 용 API와 함께 작동하는 테이블을 만들기 때문에 Cassandra를 선택합니다.

    Cassandra용 API에 대한 자세한 내용은 Apache Cassandra용 Azure Cosmos DB란?을 참조하세요.

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

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

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

    계정 이름은 소문자, 숫자 및 하이픈(-)만 사용할 수 있으며 길이는 3자에서 31자 사이여야 합니다.
    위치 사용자에게 가장 가까운 지역입니다. Azure Cosmos DB 계정을 호스트할 지리적 위치를 선택합니다. 데이터에 가장 빨리 액세스할 수 있도록 사용자와 가장 가까운 위치를 사용합니다.
    용량 모드 프로비전된 처리량 또는 서버리스입니다. 프로비전된 처리량 모드에서 계정을 만들려면 프로비전된 처리량을 선택합니다. 서버리스를 선택하여 서버리스 모드에서 계정을 만듭니다.
    Azure Cosmos DB 무료 계층 할인 적용 적용 하거나 적용하지 마세요. Azure Cosmos DB 무료 계층을 사용하면 계정에서 처음 1,000RU/s 및 25GB의 스토리지를 무료로 사용할 수 있습니다. 무료 계층에 대해 자세히 알아봅니다.
    총 계정 처리량 제한 계정의 처리량을 제한하려면 선택합니다. 이 옵션은 계정의 총 처리량을 특정 값으로 제한하려는 경우에 유용합니다.

    참고

    Azure 구독당 최대 하나의 무료 계층 Azure Cosmos DB 계정을 가질 수 있습니다. 계정을 만들 때 옵트인해야 합니다. 무료 계층 할인 옵션이 보이지 않는 경우, 구독의 다른 계정에서 무료 계층이 사용 설정된 상태일 수 있습니다.

    Azure Cosmos DB for Apache Cassandra의 새 계정 페이지

  6. 전역 배포 탭에서 다음 세부 정보를 구성합니다. 이 자습서의 기본값을 사용합니다.

    설정 값 설명
    지역 중복성 사용 안 함 지역에 쌍 영역을 페어링하여 계정에서 글로벌 배포를 사용하거나 사용하지 않도록 설정합니다. 나중에 계정에 더 많은 지역을 추가할 수 있습니다.
    다중 영역 쓰기 사용 안 함 다중 지역 쓰기 기능을 사용하면 전 세계 데이터베이스 및 컨테이너에 대해 프로비전된 처리량을 활용할 수 있습니다.
    가용성 영역 사용 안 함 가용성 영역은 Azure 지역 내에서 격리된 위치입니다. 각 영역은 독립된 전원, 냉각 및 네트워킹을 갖춘 하나 이상의 데이터 센터로 구성됩니다.

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

    • 무료 계층 할인 적용
    • 지리적 중복도
    • 다중 영역 쓰기

  7. 필요에 따라 다음 탭에서 다른 세부 정보를 구성할 수 있습니다.

    • 네트워킹: 가상 네트워크에서 액세스를 구성합니다.
    • 백업 정책: 정기 또는 연속 백업 정책을 구성합니다.
    • 암호화: 서비스 관리형 키 또는 고객 관리형 키를 사용합니다.
    • 태그: 태그는 여러 리소스 및 리소스 그룹에 동일한 태그를 적용하여 리소스를 분류하고 통합 청구를 보는 데 사용할 수 있는 이름/값 쌍입니다.

  8. 검토 + 만들기를 선택합니다.

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

    Azure Portal 알림 창을 보여 주는 스크린샷.

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

독립 실행형 CQLSH 도구 설치

독립 실행형 cqlsh 도구를 시작하는 방법에 대한 단계는 CQL 셸을 참조하세요.

연결 문자열 업데이트

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

  1. Azure Portal의 Azure Cosmos DB 계정에서 연결 문자열을 선택합니다.

    Azure Portal, 연결 문자열 페이지에서 사용자 이름 보기 및 복사

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

  3. 터미널에서 SSL 변수를 설정합니다.

    # Export the SSL variables:
export SSL_VERSION=TLSv1_2
export SSL_VALIDATE=false

  4. Azure Cosmos DB for Apache Cassandra에 연결:

    • 명령에 USERNAME 및 PASSWORD 값을 붙여넣습니다.
    cqlsh <USERNAME>.cassandra.cosmos.azure.com 10350 -u <USERNAME> -p <PASSWORD> --ssl --protocol-version=4

앱을 만들고 실행하기 위한 CQL 명령

  • 키스페이스 만들기
CREATE KEYSPACE IF NOT EXISTS uprofile 
WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'datacenter1' : 1 };
  • 테이블 만들기
CREATE TABLE IF NOT EXISTS uprofile.user (user_id int PRIMARY KEY, user_name text, user_bcity text);
  • 사용자 테이블에 행 삽입
INSERT INTO  uprofile.user (user_id, user_name, user_bcity) VALUES (101,'johnjoe','New York')

COPY 명령을 사용하여 데이터를 삽입할 수도 있습니다.

COPY uprofile.user(user_id, user_name, user_bcity) FROM '/path to file/fileName.csv' 
WITH DELIMITER = ',' ;
  • 사용자 테이블 쿼리
SELECT * FROM uprofile.users;

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

Azure Portal에서 SLA 검토

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

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

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

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

    Azure Cosmos DB 메트릭 도구 모음

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

리소스 정리

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

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

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

    삭제할 리소스 그룹 선택

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

    리소스 그룹 삭제

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

다음 단계

이 빠른 시작에서는 Cassandra 데이터베이스 및 컨테이너를 만드는 CQLSH와 함께 API for Cassandra를 사용하여 Azure Cosmos DB 계정을 만드는 방법을 알아보았습니다. 이제 Azure Cosmos DB 계정으로 추가 데이터를 가져올 수 있습니다.

Azure Cosmos DB로 Cassandra 데이터 가져오기

  • Last updated on