Visual Studio 연결된 서비스를 사용하여 앱에 Azure Cosmos DB 추가

적용 대상:Visual Studio Mac용 Visual Studio Visual Studio Code

Visual Studio를 사용하면 연결된 서비스 기능을 사용하여 Azure Cosmos DB에 다음을 연결할 수 있습니다.

• .NET Framework 콘솔 앱
• ASP.NET MVC(.NET Framework)
• ASP.NET Core
• .NET Core(콘솔 앱, WPF, Windows Forms, 클래스 라이브러리 포함)
• .NET Core 작업자 역할
• Azure Functions
• 유니버설 Windows 플랫폼 앱
• Xamarin
• Cordova

연결된 서비스 기능은 필요한 모든 참조와 연결 코드를 프로젝트에 추가하고 구성 파일을 적절하게 수정합니다.

참고

이 토픽은 Windows용 Visual Studio에만 적용됩니다. Mac용 Visual Studio는 Mac용 Visual Studio의 연결된 서비스를 참조하세요.

사전 요구 사항

• Azure 워크로드가 설치된 Visual Studio
• 지원되는 형식 중 하나인 프로젝트

연결된 서비스를 사용하여 Azure Cosmos DB에 연결

참고 항목

.NET Framework 프로젝트의 경우 연결된 서비스 UI는 약간 다릅니다. 차이점을 확인하려면 이 페이지의 Visual Studio 2019 버전과 비교 합니다.

1. Visual Studio에서 새 프로젝트를 엽니다.

2. 솔루션 탐색기에서 연결된 서비스 노드를 마우스 오른쪽 단추로 클릭하고 상황에 맞는 메뉴에서 추가를 선택하여 사용 가능한 서비스의 메뉴를 엽니다.

   

3. Azure Cosmos DB를 선택합니다. 종속성에 연결 페이지가 나타납니다. 로컬 에뮬레이터 , 컨테이너의 Azure Cosmos DB 에뮬레이터(로컬) 및 라이브 Azure Cosmos DB 서비스에 연결하기 위한 두 가지 옵션이 표시됩니다. 로컬 에뮬레이터부터 시작하여 비용을 절감하고 초기 개발을 간소화할 수 있습니다. 이러한 단계를 반복하고 다른 옵션을 선택하여 나중에 라이브 서비스로 마이그레이션할 수 있습니다.

   

   Azure Cosmos DB 에뮬레이터를 사용하도록 선택한 경우 다음을 클릭하여 프로젝트 수정 방법을 보여 줍니다. 변경 내용 요약 화면이 표시됩니다. NuGet 패키지 참조가 프로젝트에 추가되고 로컬 에뮬레이터에 대한 연결 코드가 프로젝트에 추가됩니다. 마지막 화면에서 마침을 클릭하면 에뮬레이터에 대한 컨테이너가 만들어집니다. 출력 창에 이미지 다운로드 상태가 표시됩니다.

   Azure 서비스에 연결하려면 다음 단계를 계속 진행하거나 아직 로그인하지 않은 경우 계속하기 전에 Azure 계정에 로그인합니다. Azure 계정이 없으면 평가판에 등록할 수 있습니다.

4. Azure Cosmos DB 화면에서 기존 Azure Cosmos DB를 선택하고 다음을 선택합니다.

   데이터베이스를 만들어야 하는 경우 다음 단계로 이동합니다. 그러지 않은 경우 7단계로 건너뜁니다.

   

5. Azure Cosmos DB를 만들려면 다음을 수행합니다.

   1. 화면 맨 아래에서 새 Azure Cosmos DB 만들기를 선택합니다.

   2. Azure Cosmos DB: 새로 만들기 화면에 입력하고 만들기를 선택합니다.

      

   3. Azure Cosmos DB 구성 대화 상자가 표시되면 새 데이터베이스가 목록에 표시됩니다. 목록에서 새 데이터베이스를 선택하고 다음을 선택합니다.

6. 연결 문자열 이름을 입력하고 연결 문자열을 로컬 비밀 파일에 저장할지, 아니면 Azure Key Vault에 저장할지 선택합니다.

   

   연결 문자열은 비밀로 추가되고 앱 구성에서 사용할 수 있습니다. ASP.NET Core 앱에서는 개체의 Configuration 속성을 사용하여 이 연결 문자열에 WebApplicationBuild 액세스할 수 있습니다.

7. 변경 내용 요약 화면에는 프로세스를 완료할 경우 프로젝트에 적용되는 모든 수정 사항이 표시됩니다. 변경 내용이 맞으면 마침을 선택합니다.

   

8. 솔루션 탐색기에서 연결된 서비스 노드를 두 번 클릭하여 연결된 서비스 탭을 엽니다. 연결은 서비스 종속성 섹션 아래에 표시됩니다.

   

   추가한 종속성 옆에 있는 세 개의 점을 클릭하면 연결과 같은 다양한 옵션을 확인하여 마법사를 다시 열고 연결을 변경할 수 있습니다. 창의 오른쪽 위에 있는 세 개의 점을 클릭하여 로컬 종속성을 시작하고 설정을 변경하는 옵션을 확인할 수도 있습니다.

다음 단계

ASP.NET Core에서 개발 중인 앱 비밀의 안전한 스토리지에 따라 비밀을 안전하게 저장하는 방법을 알아봅니다. 특히 비밀 저장소에서 연결 문자열을 읽으려면 구성 API를 통해 비밀 읽기에서와 같이 코드를 추가할 수 있습니다. 코드는 다음과 같을 수 있습니다. 여기서 builder 해당 인스턴스는 ASP.NET Core 프로젝트 템플릿의 WebApplicationBuild Program.cs에 표시됩니다.

// New instance of CosmosClient class using a connection string
using CosmosClient client = new(
    connectionString: builder.Configuration["CosmosDBConnectionString"]
);

다양한 CosmosClient 방법을 통해 Cosmos DB 기능에 액세스할 수 있습니다. 인스턴스 CosmosClient가 있으면 이 가이드 에 따라 NoSQL 데이터베이스를 만들 수 있습니다. .NET을 사용하여 Azure Cosmos DB for NoSQL에서 데이터베이스를 만듭니다.

참고 항목

• Azure Cosmos DB 제품 페이지
• Azure Cosmos DB 설명서
• 연결된 서비스(Mac용 Visual Studio)
• ASP.NET Core에서 종속성 주입