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

MongoDB 클라이언트 만들기

MongoDB deployment에 연결하려면 다음 두 가지가 필요합니다.

  • 연결 문자열 이라고도 하는연결 URI는 Ruby 운전자 에 연결할 MongoDB deployment 알려줍니다.

  • Mongo::Client 객체- MongoDB deployment 에 대한 연결을 생성하고 해당 배포서버에서 작업을 수행할 수 있도록 합니다.

이러한 구성 요소 중 하나를 사용하여 MongoDB 에 연결된 동안 Ruby 운전자 작동하는 방식을 사용자 지정할 수도 있습니다.

이 가이드에서는 연결 string 을 만들고 Mongo::Client 객체를 사용하여 MongoDB 에 연결하는 방법을 보여 줍니다.

표준 연결 string 에는 다음 구성 요소가 포함됩니다.

구성 요소
설명

mongodb://

필수 사항입니다. 표준 연결 형식의 문자열로 식별하는 접두사입니다.

db_username:db_password

선택 사항. 인증 자격 자격 증명. 이를 포함하면 클라이언트 authSource에 지정된 데이터베이스 에 대해 사용자를 인증합니다. 연결 옵션에 대한 자세한 내용은 인증 authSource 메커니즘 가이드 참조하세요.

hostname[:port]

필수입니다. MongoDB 실행 호스트 이름 및 선택적 포트 번호입니다. 포트 번호를 포함하지 않으면 운전자 기본값 포트인 27017를 사용합니다.

/defaultauthdb

선택 사항. 연결 string 에 db_username:db_password@ 인증 자격 증명이 포함되어 있지만 authSource 옵션이 없는 경우에 사용할 인증 데이터베이스입니다. 이 구성 요소를 포함하지 않으면 클라이언트는 admin 데이터베이스에 대해 사용자를 인증합니다.

?<options>

선택 사항. 연결별 옵션을 <name>=<value> 쌍으로 지정하는 쿼리 string 입니다. 이러한 옵션에 대한 전체 설명은 연결 옵션 지정 을 참조하세요.

연결 생성에 대한 자세한 string 내용은 MongoDB Server 설명서에서 연결 문자열 을 참조하세요.

MongoDB 에 대한 연결을 생성하려면 Mongo::Client 클래스의 인스턴스 생성하고 연결 URI를 생성자에 전달합니다. 다음 예시 localhost의 포트 27017 에서 MongoDB deployment 에 연결하기 위해 Mongo::Client 객체 구성합니다.

client = Mongo::Client.new("mongodb://localhost:27017")

또는 각각 호스트 이름과 포트 번호가 포함된 문자열 배열 Mongo::Client 생성자에 전달할 수 있습니다. 다음 예시 이 구문을 사용하여 localhost의 포트 27017 에 연결하는 방법을 보여줍니다.

client = Mongo::Client.new(['localhost:27017'])

클라이언트 재사용

Mongo::Client 객체 는 데이터베이스 에 대한 연결 풀을 나타내기 때문에 대부분의 애플리케이션은 여러 요청에 걸쳐 Mongo::Client 의 단일 인스턴스 만 필요로 합니다.

Mongo::Client 객체 사용을 마치면 다음 예시 와 같이 객체의 close 메서드를 호출합니다. 이렇게 하면 객체 와 연결된 모든 리소스가 확보됩니다.

client.close

또는 Ruby의 차단 구문을 사용하여 Mongo::Client 객체 만들 수 있습니다. 이 구문을 사용하면 차단 실행이 완료된 후 클라이언트 자동으로 닫힙니다.

다음 예시 차단 구문을 사용하여 Mongo::Client 객체 만드는 방법을 보여 줍니다.

Mongo::Client.new("mongodb://localhost:27017") do |client|
# work with the client
end

Ruby 운전자 사용하여 Mongo::Client 객체 만드는 방법에 대해 자세히 학습 Mongo::Client에 대한 API 설명서를 참조하세요.

돌아가기

연결

이 페이지의 내용