Docs Menu
Docs Home
/ / /
루비 드라이버

Ruby 드라이버 시작하기

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 탭 사용하여 피드백 제출 수도 있습니다.

1

개발을 시작하기 전에 개발 환경에 Ruby 버전 2.7 이상을 설치해야 합니다. Ruby 는 macOS 및 일부 Linux 배포판에 사전 설치되어 있지만 버전을 업데이트 해야 할 수도 있습니다.

중요

Ruby 운전자 Windows 에서 공식적으로 지원되지 않습니다.

2

셸 에서 다음 명령을 실행하여 이 프로젝트 에 대해 ruby-quickstart 디렉토리 만듭니다.

mkdir ruby-quickstart

그런 다음 다음 명령을 실행 ruby-quickstart 디렉토리 에 quickstart.rb 파일 만듭니다.

cd ruby-quickstart
touch quickstart.rb
3

quickstart.rb 파일 열고 다음 코드를 추가합니다.

require 'bundler/inline'
gemfile do
source 'https://rubygems.org'
gem 'mongo'
end

이 코드는 번들러 종속성 관리 도구를 사용하여 Ruby 운전자 종속성으로 추가합니다.

이 단계를 완료하면 운전자 종속성이 설치된 새 프로젝트 디렉토리 생성됩니다.

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

1

Atlas 시작하기 가이드를 완료하여 새 Atlas 계정을 설정하고 새로운 프리 계층 MongoDB 배포서버에 샘플 데이터를 로드하세요.

2

데이터베이스 사용자를 생성한 후 다음 단계에서 사용할 수 있도록 해당 사용자의 사용자 이름과 비밀번호를 안전한 위치에 저장하세요.

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

운전자 에 MongoDB deployment 에 연결하는 방법과 연결된 동안 동작하는 방법을 지시하는 연결 문자열 이라고도 하는 연결 URI를 제공하여 MongoDB deployment 에 연결할 수 있습니다.

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

Atlas 에서 호스팅되지 않는 인스턴스 또는 배포서버 에 연결하는 방법을 학습 연결 대상 선택 가이드 참조하세요.

1

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

Atlas UI의 클러스터 섹션에 있는 연결 버튼

Connect your application 섹션으로 이동합니다. Driver 선택 메뉴에서 "Ruby"를 선택하고 Version 선택 메뉴에서 설치된 버전과 가장 일치하는 버전을 선택합니다.

2

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

Atlas UI의 연결 문자열 복사 버튼
3

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

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

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

1

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
2

<connection string> 자리 표시자를 이 튜토리얼의 연결 문자열 만들기 단계에서 복사한 연결 문자열로 바꿉니다.

3

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 운전자 에 대해 자세히 보기 .

  • 문서 쿼리 섹션에서 읽기 작업을 수행하는 방법을 알아보세요.

  • 문서 삽입 섹션에서 쓰기 (write) 작업을 수행하는 방법을 알아보세요.

돌아가기

개요