개요
MongoDB deployment에 연결하려면 다음 두 가지가 필요합니다.
연결 문자열 이라고도 하는연결 URI는 Ruby 운전자 에 연결할 MongoDB deployment 알려줍니다.
Mongo::Client 객체- MongoDB deployment 에 대한 연결을 생성하고 해당 배포서버에서 작업을 수행할 수 있도록 합니다.
이러한 구성 요소 중 하나를 사용하여 MongoDB 에 연결된 동안 Ruby 운전자 작동하는 방식을 사용자 지정할 수도 있습니다.
이 가이드에서는 연결 string 을 만들고 Mongo::Client
객체를 사용하여 MongoDB 에 연결하는 방법을 보여 줍니다.
연결 URI
표준 연결 string 에는 다음 구성 요소가 포함됩니다.
구성 요소 | 설명 |
---|---|
| 필수 사항입니다. 표준 연결 형식의 문자열로 식별하는 접두사입니다. |
| 선택 사항. 인증 자격 자격 증명. 이를 포함하면 클라이언트 |
| 필수입니다. MongoDB 실행 호스트 이름 및 선택적 포트 번호입니다. 포트 번호를 포함하지 않으면 운전자 기본값 포트인 |
| 선택 사항. 연결 string 에 |
| 선택 사항. 연결별 옵션을 |
연결 생성에 대한 자세한 string 내용은 MongoDB Server 설명서에서 연결 문자열 을 참조하세요.
Mongo::Client 생성
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 닫기
Mongo::Client
객체 사용을 마치면 다음 예시 와 같이 객체의 close
메서드를 호출합니다. 이렇게 하면 객체 와 연결된 모든 리소스가 확보됩니다.
client.close
또는 Ruby의 차단 구문을 사용하여 Mongo::Client
객체 만들 수 있습니다. 이 구문을 사용하면 차단 실행이 완료된 후 클라이언트 자동으로 닫힙니다.
다음 예시 차단 구문을 사용하여 Mongo::Client
객체 만드는 방법을 보여 줍니다.
Mongo::Client.new("mongodb://localhost:27017") do |client| # work with the client end
API 문서
Ruby 운전자 사용하여 Mongo::Client
객체 만드는 방법에 대해 자세히 학습 Mongo::Client에 대한 API 설명서를 참조하세요.