개요
MongoDB Ruby 드라이버 Ruby 애플리케이션이 MongoDB 데이터베이스와 상호 작용 수 있도록 하는 라이브러리입니다. Ruby 운전자 사용하여 MongoDB 에 연결하고 일반적인 데이터 작업을 수행할 수 있습니다. 이 가이드 Ruby 운전자 사용하여 MongoDB Atlas 에서 호스팅되는 MongoDB cluster 에 연결하고 클러스터 의 데이터를 쿼리 애플리케이션 만드는 방법을 설명합니다.
팁
MongoDB Atlas는 관리형 클라우드 데이터베이스 서비스로, MongoDB deployment를 호스팅합니다. 이 가이드의 단계에 따라 자체 무료(신용카드 필요 없음) MongoDB Atlas 배포서버를 생성할 수 있습니다.
다른 운전자 또는 프로그래밍 언어 사용하여 MongoDB 에 연결하려는 경우 공식 드라이버 목록을 참조하세요.
참고
이 단계에서 문제가 실행 하면 MongoDB Stack Overflow 태그 또는 MongoDB Reddit Community에서 도움을 요청하세요. 이 페이지의 오른쪽에 있는 Rate this page 탭 사용하여 피드백 제출 수도 있습니다.
다운로드 및 설치
종속성 설치
개발을 시작하기 전에 개발 환경에 Ruby 버전 2.7 이상을 설치해야 합니다. Ruby 는 macOS 및 일부 Linux 배포판에 사전 설치되어 있지만 버전을 업데이트 해야 할 수도 있습니다.
중요
Ruby 운전자 Windows 에서 공식적으로 지원되지 않습니다.
프로젝트 에 Ruby 운전자 추가
quickstart.rb
파일 열고 다음 코드를 추가합니다.
require 'bundler/inline' gemfile do source 'https://rubygems.org' gem 'mongo' end
이 코드는 번들러 종속성 관리 도구를 사용하여 Ruby 운전자 종속성으로 추가합니다.
이 단계를 완료하면 운전자 종속성이 설치된 새 프로젝트 디렉토리 생성됩니다.
MongoDB Deployment 생성
MongoDB Atlas에 프리 티어 MongoDB 배포를 생성하여 데이터를 저장하고 관리할 수 있습니다. MongoDB Atlas는 클라우드에서 MongoDB database를 호스팅하고 관리합니다.
Atlas에서 무료 MongoDB 배포서버 생성
Atlas 시작하기 가이드를 완료하여 새 Atlas 계정을 설정하고 새로운 프리 계층 MongoDB 배포서버에 샘플 데이터를 로드하세요.
이 단계를 완료하면 Atlas에 새로운 무료 티어 MongoDB 배포, 데이터베이스 사용자 자격 증명, 샘플 데이터가 데이터베이스에 로드됩니다.
연결 문자열 만들기
운전자 에 MongoDB deployment 에 연결하는 방법과 연결된 동안 동작하는 방법을 지시하는 연결 문자열 이라고도 하는 연결 URI를 제공하여 MongoDB deployment 에 연결할 수 있습니다.
연결 문자열에는 배포서버의 호스트 이름 또는 IP 주소와 포트, 인증 메커니즘, 해당되는 경우 사용자 자격 증명, 연결 옵션 등이 포함됩니다.
Atlas 에서 호스팅되지 않는 인스턴스 또는 배포서버 에 연결하는 방법을 학습 연결 대상 선택 가이드 참조하세요.
MongoDB Atlas 연결 문자열 찾기
이전 단계에서 생성한 배포서버에 대한 연결 문자열 조회 하려면 Atlas 계정에 로그인 Clusters 섹션으로 이동합니다. 그런 다음 새 배포서버 대한 Connect 버튼을 클릭합니다.

Connect your application 섹션으로 이동합니다. Driver 선택 메뉴에서 "Ruby"를 선택하고 Version 선택 메뉴에서 설치된 버전과 가장 일치하는 버전을 선택합니다.
이 단계를 완료하면 데이터베이스 사용자 이름과 비밀번호가 포함된 연결 문자열이 생성됩니다.
MongoDB에 연결
Ruby 애플리케이션 파일 편집
ruby-quickstart
디렉토리 에서 quickstart.rb
파일 로 이동합니다. 이 튜토리얼의 다운로드 및 설치 단계 에서 번들러 코드 아래에 다음 코드를 복사하여 붙여넣습니다. 이 코드는 MongoDB 에 연결하여 sample_mflix
데이터베이스 에서 movies
컬렉션 쿼리합니다.
uri = '<connection string>' begin client = Mongo::Client.new(uri) database = client.use('sample_mflix') movies = database[:movies] # Queries for a movie that has the title 'Back to the Future' query = { title: 'Back to the Future' } movie = movies.find(query).first # Prints the movie document puts movie ensure client&.close end
연결 문자열 할당
<connection string>
자리 표시자를 이 튜토리얼의 연결 문자열 만들기 단계에서 복사한 연결 문자열로 바꿉니다.
Ruby 애플리케이션 실행
ruby-quickstart
디렉토리 에서 다음 셸 명령을 실행 애플리케이션 실행 .
ruby quickstart.rb
명령줄 출력에는 검색된 영화 문서에 대한 세부 정보가 포함됩니다.
{"_id"=>BSON::ObjectId('...'), "plot"=>"A young man is accidentally sent 30 years into the past in a time-traveling DeLorean invented by his friend, Dr. Emmett Brown, and must make sure his high-school-age parents unite in order to save his own existence.", ... "title"=>"Back to the Future", ...
오류가 발생하거나 출력이 표시되지 않는 경우 quickstart.rb
파일 에 올바른 연결 문자열 지정했는지, 샘플 데이터를 로드했는지 확인합니다.
이 단계를 완료한 후에는 드라이버를 사용하여 MongoDB deployment에 연결하고, 샘플 데이터에 대해 쿼리를 실행하고, 결과를 출력하는 등 정상적으로 작동하는 애플리케이션을 갖게 될 것입니다.
다음 단계
빠른 시작 튜토리얼을 완료하신 것을 축하드립니다!
이 튜토리얼에서는 MongoDB Atlas 에서 호스팅되는 MongoDB deployment 에 연결하고 쿼리 와 일치하는 문서 검색하는 Ruby 애플리케이션 만들었습니다.
다음 리소스에서 Ruby 운전자 에 대해 자세히 보기 .