.NET/ C# 드라이버 시작하기

개요

.NET/ C# 드라이버 MongoDB 에 연결하고 통신하는 데 사용할 수 있는 NuGet 패키지 입니다. 이 가이드 .NET/ C# 드라이버 사용하여 MongoDB Atlas 에서 호스팅되는 MongoDB cluster 에 연결하는 애플리케이션 만드는 방법을 보여줍니다.

이 가이드 에 따라 샘플 C# 애플리케이션 MongoDB Atlas 배포서버 에 연결합니다. 다른 운전자 또는 프로그래밍 언어 사용하여 MongoDB 에 연결하려는 경우 공식 드라이버 목록을 참조하세요.

.NET/ C# 드라이버 다운로드

mkdir csharp-quickstart
cd csharp-quickstart
dotnet new console

dotnet add package MongoDB.Driver

이 단계를 완료하면 새 .NET 프레임워크 프로젝트 와 .NET/ C# 드라이버 설치됩니다.

MongoDB Atlas 클러스터 배포

MongoDB Atlas에 프리 티어 MongoDB 배포를 생성하여 데이터를 저장하고 관리할 수 있습니다. MongoDB Atlas는 클라우드에서 MongoDB database를 호스팅하고 관리합니다.

이 단계를 완료하면 Atlas에 새로운 무료 티어 MongoDB 배포, 데이터베이스 사용자 자격 증명, 샘플 데이터가 데이터베이스에 로드됩니다.

연결 문자열 만들기

연결 문자열이라고도 하는 연결 URI을 제공하여 MongoDB 배포서버에 연결할 수 있으며, 이 연결 문자열은 드라이버에 MongoDB 배포서버로 연결하는 방법과 연결된 동안 동작하는 방법을 지시합니다.

연결 문자열에는 배포서버의 호스트 이름 또는 IP 주소와 포트, 인증 메커니즘, 해당되는 경우 사용자 자격 증명, 연결 옵션 등이 포함됩니다.

1

MongoDB Atlas 연결 문자열 찾기

이전 단계에서 만든 배포서버에 대한 연결 문자열 조회 하려면 Atlas 계정에 로그 Database 섹션으로 이동한 다음 새 배포서버에 대한 Connect 버튼을 클릭합니다.

Connect your application 섹션으로 이동하여 Driver 선택 메뉴에서 "C# / .NET"을 선택하고 Version 선택 메뉴에서 설치한 버전과 가장 일치하는 버전을 선택합니다.

Password (SCRAM) 인증 메커니즘을 선택합니다.

연결 문자열을 보려면 Include full driver code example 옵션을 선택 취소합니다.

2

연결 문자열 복사

다음 스크린샷에 표시된 대로 연결 문자열 오른쪽에 있는 버튼을 클릭하여 클립보드에 복사합니다.

3

자리 표시자 업데이트

이 연결 문자열을 원하는 텍스트 편집기의 파일에 붙여넣고 <db_username> 및 <db_password> 자리 표시자를 데이터베이스 사용자의 사용자 이름 및 비밀번호로 바꿉니다.

다음 단계에서 사용할 수 있도록 이 파일을 안전한 위치에 저장합니다.

4

환경 변수 설정

셸 에서 다음 코드를 실행 MongoDB 연결 문자열 환경 변수에 저장합니다.<your MongoDB URI> 를 이전 단계에서 파일 에 저장한 연결 문자열 로 바꿉니다.

export MONGODB_URI="<your MongoDB URI>"

참고

PowerShell

Microsoft PowerShell을 사용하는 경우 다음 명령을 대신 실행 .

set MONGODB_URI="<your MongoDB URI>"

환경 변수에 자격 증명 저장하는 것이 소스 코드 에 하드코딩하는 것보다 안전합니다.

이 단계를 완료하면 데이터베이스 사용자 이름과 비밀번호가 포함된 연결 문자열이 생성됩니다.

샘플 쿼리 실행

using MongoDB.Driver;
using MongoDB.Bson;
var connectionString = Environment.GetEnvironmentVariable("MONGODB_URI");
if (connectionString == null)
{
    Console.WriteLine("You must set your 'MONGODB_URI' environment variable. To learn how to set it, see http://www.mongodb.com/ko-kr/docs/drivers/csharp/current/get-started/create-connection-string");
    Environment.Exit(0);
}
var client = new MongoClient(connectionString);
var collection = client.GetDatabase("sample_mflix").GetCollection<BsonDocument>("movies");
var filter = Builders<BsonDocument>.Filter.Eq("title", "Back to the Future");
var document = collection.Find(filter).First();
Console.WriteLine(document);

dotnet run csharp-quickstart.csproj

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}

이 단계를 완료한 후에는 드라이버를 사용하여 MongoDB deployment에 연결하고, 샘플 데이터에 대해 쿼리를 실행하고, 결과를 출력하는 등 정상적으로 작동하는 애플리케이션을 갖게 될 것입니다.

다음 단계

튜토리얼을 완료한 것을 축하합니다!

이 튜토리얼에서는 MongoDB Atlas 에서 호스팅되는 MongoDB deployment 서버에 연결하고 쿼리 와 일치하는 문서 검색하는 C# 애플리케이션 만들었습니다.

다음 리소스에서 .NET/ C# 드라이버 에 대해 자세히 보기 .

• 문서 삽입 섹션에서 문서를 삽입하는 방법을 알아보세요.

• 읽기 작업 섹션에서 문서를 찾는 방법을 알아보세요.

• 1개 업데이트 및 다수 업데이트 섹션에서 문서를 업데이트 방법을 알아보세요.

• 문서 삭제 섹션에서 문서를 삭제 방법을 알아보세요.