다음을 통해 공유

JS용 Azure Cosmos DB for NoSQL SDK의 예

  • 아티클

적용 대상: NoSQL

Azure Cosmos DB 리소스에 대한 CRUD 작업 및 기타 일반적인 작업을 수행하는 샘플 솔루션은 JavaScript SDK for Azure Cosmos DB GitHub 리포지토리에 포함됩니다. 이 문서는 다음을 제공합니다.

  • 각 Node.js 예제 프로젝트 파일에서 작업에 연결합니다.
  • 관련된 API 참조 콘텐츠에 대한 링크입니다.

필수 조건

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

Azure 구독 및 약정 없이 Azure Cosmos DB를 무료로 사용해 볼 수 있습니다. 또는 무료로 처음 1000RU/s와 25GB의 스토리지를 사용하여 Azure Cosmos DB 무료 계층 계정을 만들 수 있습니다. 또한 URI가 https://localhost:8081인 Azure Cosmos DB Emulator를 사용할 수도 있습니다. 에뮬레이터에서 사용할 키는 요청 인증을 참조하세요.

JavaScript SDK도 필요합니다.

참고 항목

각 샘플은 자체 포함되며 자체를 설정하고 자체를 정리합니다. 따라서 샘플은 Containers.create에 대한 여러 호출을 실행합니다. 구독에 이렇게 영향을 줄 때마다 생성되는 컨테이너의 성능 계층당 1시간 사용에 대한 요금이 청구됩니다.

데이터베이스 예제

DatabaseManagement 파일은 데이터베이스에서 CRUD 작업을 수행하는 방법을 보여줍니다. 다음 샘플을 실행하기 전에 Azure Cosmos DB 데이터베이스에 대해 알아보려면 데이터베이스, 컨테이너 및 항목 작업 개념 문서를 참조하세요.

작업 API 참조
새 데이터베이스 만들기(존재하지 않는 경우) Databases.createIfNotExists
계정에 대한 데이터베이스 나열 Databases.readAll
ID별 데이터베이스 읽기 Database.read
데이터베이스 삭제 Database.delete

컨테이너 예제

ContainerManagement 파일은 컨테이너에서 CRUD 작업을 수행하는 방법을 보여줍니다. 다음 샘플을 실행하기 전에 Azure Cosmos DB 컬렉션에 대해 알아보려면 데이터베이스, 컨테이너 및 항목 작업 개념 문서를 참조하세요.

작업 API 참조
컨테이너 만들기(존재하지 않는 경우) Containers.createIfNotExists
계정의 컨테이너 나열 Containers.readAll
컨테이너 정의 읽기 Container.read
컨테이너 삭제 Container.delete

항목 예제

ItemManagement 파일은 항목에서 CRUD 작업을 수행하는 방법을 보여줍니다. 다음 샘플을 실행하기 전에 Azure Cosmos DB 문서에 대해 알아보려면 데이터베이스, 컨테이너 및 항목 작업 개념 문서를 참조하세요.

작업 API 참조
항목 만들기 Items.create
컨테이너의 모든 항목 읽기 Items.readAll
ID별로 항목 읽기 Item.read
항목이 변경된 경우에만 항목 읽기 Item.read - RequestOptions.accessCondition
문서에 대한 쿼리 Items.query
항목 바꾸기 Item.replace
항목을 조건부 ETag 검사로 바꾸기 Item.replace - RequestOptions.accessCondition
항목 삭제 Item.delete

청구 예제

IndexManagement 파일은 인덱싱 관리 방법을 보여줍니다. 다음 샘플을 실행하기 전에 Azure Cosmos DB에서 인덱싱에 대해 자세히 알아보려면 인덱싱 정책, 인덱싱 유형 및 인덱싱 경로 개념 문서를 참조하세요.

작업 API 참조
수동으로 특정 항목 인덱스 RequestOptions.indexingDirective: 'include'
수동으로 특정 항목을 인덱스에서 제외 RequestOptions.indexingDirective: 'exclude'
인덱스에서 경로 제외 IndexingPolicy.ExcludedPath
문자열 경로에 범위 인덱스 만들기 IndexKind.Range, IndexingPolicy, Items.query
기본 indexPolicy로 컨테이너를 만든 다음, 컨테이너 온라인으로 업데이트 Containers.create

서버 쪽 프로그래밍 예제

index.ts 파일은 다음 작업을 수행하는 방법을 보여 줍니다. 다음 샘플을 실행하기 전에 Azure Cosmos DB의 서버 측 프로그래밍에 대해 자세히 알아보려면 저장 프로시저, 트리거 및 사용자 정의 함수 개념 문서를 참조하세요.

작업 API 참조
저장 프로시저 만들기 StoredProcedures.create
저장 프로시저 실행 StoredProcedure.execute
저장 프로시저를 사용하여 대량 업데이트 StoredProcedure.execute

서버 쪽 프로그래밍에 대한 자세한 내용은 Azure Cosmos DB 서버 쪽 프로그래밍: 저장 프로시저, 데이터베이스 트리거 및 UDF를 참조하세요.

Microsoft Entra Auth 예

EntraAuth.ts 파일은 다음 작업을 수행하는 방법을 보여 줍니다.

작업 API 참조
Create credential object from @azure/identity API
클라이언트 생성자에 토큰 자격 증명 전달 API
aad 자격 증명을 사용하여 cosmos 클라이언트 실행 API

기타 샘플

다음 큐레이팅된 샘플은 일반적인 시나리오를 보여 줍니다.

작업 API 참조
쿼리 처리량 변경 API
쿼리 처리량 가져오기 API
Cosmos DB 리소스에 범위가 지정된 액세스 권한을 부여하기 위해 SasTokens 사용 API

다음 단계

Azure Cosmos DB로 마이그레이션하기 위한 용량 계획을 수행하려고 하시나요? 용량 계획을 위해 기존 데이터베이스 클러스터에 대한 정보를 사용할 수 있습니다.