빠른 시작
이 페이지의 내용
이 가이드에서는 .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://<db_username>:<db_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>"
중요
연결 문자열의 <db_username>
및 <db_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에 연결하고 샘플 데이터에 대한 쿼리를 실행합니다. 선호하는 텍스트 편집기나 통합 개발 환경(IDE)이 필요합니다 설치 및 실행 중입니다.
프로젝트의 기본 디렉토리에서 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# 드라이버를 사용하여 데이터를 읽고 수정하는 방법 또는 사용 예시에서 일반적인 작업을 수행하는 방법을 알아보세요.