문서 메뉴

문서 홈 → 애플리케이션 개발 → MongoDB 드라이버 → C#/.NET

빠른 시작

이 페이지의 내용

  • MongoDB 클러스터 생성
  • Atlas에서 무료 티어 클러스터 설정하기
  • 연결 문자열 설정
  • 프로젝트 설정
  • 프로젝트 만들기
  • 종속성으로 MongoDB 추가하기
  • 애플리케이션에서 MongoDB 클러스터 쿼리하기
  • 다음 단계

이 가이드에서는 .NET/C# 드라이버 를 사용하여 MongoDB Atlas 클러스터 에 연결하는 애플리케이션을 만드는 방법을 보여줍니다. 다른 드라이버 또는 프로그래밍 언어를 사용하여 MongoDB에 연결하려는 경우 공식 MongoDB 드라이버 목록을 참조하세요.

.NET/C# 드라이버를 사용하면 .NET 애플리케이션에서 MongoDB 클러스터에 연결하고 통신할 수 있습니다.

MongoDB Atlas는 MongoDB 클러스터에서 데이터를 호스팅하는 완전 관리형 클라우드 데이터베이스 서비스입니다. 이 가이드에서는 무료(신용카드 필요 없음) 클러스터를 시작하는 방법을 보여줍니다.

아래 단계에 따라 .NET 애플리케이션을 MongoDB Atlas 클러스터와 연결하세요.

MongoDB 클러스터 생성

Atlas에서 무료 티어 클러스터 설정하기

이 가이드에 필요한 Atlas 무료 계층 클러스터를 설정하려면 MongoDB Atlas 설정 가이드를 완료하세요.

Atlas 가이드의 단계를 완료하면 Atlas에 배포된 새 MongoDB 클러스터, 새 데이터베이스 사용자 및 샘플 데이터 세트가 클러스터에 로드 됩니다. 또한 복사 버퍼에 다음과 유사한 연결 문자열이 있습니다.

"mongodb+srv://<username>:<password>@cluster0.abc.mongodb.net/?retryWrites=true&w=majority"

연결 문자열 설정

명령 프롬프트에서 다음 코드를 실행하여 MongoDB 연결 문자열 을 환경 변수에 저장합니다. 이 방법은 소스 코드에 자격 증명을 포함하는 것보다 안전합니다.

export MONGODB_URI="<your MongoDB URI>"

참고

PowerShell 환경 변수

Microsoft PowerShell을 사용하는 경우 다음 명령을 실행하여 연결 문자열을 환경 변수에 저장합니다.

set MONGODB_URI="<your MongoDB URI>"

중요

연결 문자열의 <username> 및 <password> 섹션을 Atlas 사용자의 사용자 이름 및 비밀번호로 바꿔야 합니다.

연결 문자열에 대한 자세한 내용은 연결 문자열을 참조하세요 .

프로젝트 설정

프로젝트 만들기

다음과 같이 dotnet new 명령을 사용해 새로운 디렉토리를 만들고 프로젝트를 초기화합니다.

mkdir csharp-quickstart
cd csharp-quickstart
dotnet new console

종속성으로 MongoDB 추가하기

dotnet add 명령을 사용하여 .NET/C# 드라이버를 프로젝트에 종속성으로 추가합니다.

dotnet add package MongoDB.Driver

애플리케이션에서 MongoDB 클러스터 쿼리하기

이 단계에서는 .NET/C# 드라이버를 사용하여 MongoDB cluster에 연결하고 샘플 데이터에 대한 쿼리를 실행합니다.

프로젝트의 기본 디렉토리에서 Program.cs 파일을 엽니다. 다음 샘플 코드를 Program.cs에 복사합니다.

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 https://www.mongodb.com/ko-kr/docs/drivers/csharp/current/quick-start/#set-your-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);

이 샘플 코드는 MongoDB Atlas의 샘플 데이터 세트에 대해 쿼리를 실행합니다. 명령줄에서 다음 명령을 사용하여 실행합니다.

dotnet run csharp-quickstart.csproj

Program.cs를 실행하면 샘플 데이터세트에서 다음 영화의 세부정보가 출력됩니다.

{
    "_id": "573a1398f29313caabce9682",
    ...
    "title": "Back to the Future",
    ...
}

팁

출력이 비어 있으면 샘플 데이터 세트 를 클러스터에 로드했는지 확인합니다.

이 단계를 완료하면 .NET/C# 드라이버를 사용하여 MongoDB cluster에 연결하고 샘플 데이터에 대해 쿼리를 실행하고 결과를 출력하는 등 정상적으로 작동하는 애플리케이션이 만들어져야 합니다.

.NET/C# 드라이버를 사용하여 Atlas에 연결하는 방법에 대해 자세히 알아보려면 Atlas 드라이버 연결 가이드를 참조하고 Select your language 드롭다운에서 C# 을 선택합니다.

다음 단계

CRUD 작업 가이드에서 .NET/C# 드라이버를 사용하여 데이터를 읽고 수정하는 방법 또는 사용 예제에서 일반적인 작업을 수행하는 방법을 알아보세요.

← 이전 버전
빠른 참조 →

이 페이지의 내용