Tài liệu này mô tả định dạng URI để xác định kết nối giữa các ứng dụng và phiên bản MongoDB trong trình điều khiển MongoDB chính thức Show
Định dạng chuỗi kết nối tiêu chuẩn¶Phần này mô tả định dạng tiêu chuẩn của URI kết nối MongoDB được sử dụng để kết nối với máy chủ cơ sở dữ liệu MongoDB. Định dạng giống nhau cho tất cả các trình điều khiển MongoDB chính thức. For a list of drivers and links to driver documentation, see 驱动程序和客户端 Sau đây là sơ đồ kết nối URI tiêu chuẩn mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]] Các thành phần của chuỗi này là
Thí dụ Để mô tả kết nối với bộ bản sao có tên test , với mongod hosts:
Bạn sẽ sử dụng một chuỗi kết nối giống như sau mongodb://db1.example.net,db2.example.net:2500/?replicaSet=test Tùy chọn chuỗi kết nối¶Phần này liệt kê tất cả các tùy chọn kết nối được sử dụng trong Định dạng chuỗi kết nối tiêu chuẩn. Các tùy chọn không phân biệt chữ hoa chữ thường Tùy chọn kết nối là các cặp ở dạng sau. tên=giá trị . Các tùy chọn riêng biệt với dấu và (i. e. & ) ký tự. Trong ví dụ sau, một kết nối sử dụng tùy chọn replicaSet và connectTimeoutMS . mongodb://db1.example.net,db2.example.net:2500/?replicaSet=test&connectTimeoutMS=300000 Dấu phân cách dấu chấm phẩy cho các đối số chuỗi kết nối Để cung cấp khả năng tương thích ngược, trình điều khiển hiện chấp nhận dấu chấm phẩy (i. e. ; ) làm dấu phân tách tùy chọn. Tùy chọn bộ bản sao¶nước tiểu. replicaSet¶Chỉ định tên của bộ bản sao, nếu mongod là thành viên của bộ bản sao. Khi kết nối với bộ bản sao, điều quan trọng là phải cung cấp danh sách gốc gồm ít nhất hai phiên bản mongod . Nếu bạn chỉ cung cấp điểm kết nối của một phiên bản mongod và bỏ qua replicaSet, the client will create a standalone connection. Tùy chọn kết nối¶nước tiểu. ssl¶true . Bắt đầu kết nối với SSL. sai . Bắt đầu kết nối không có SSL. Giá trị mặc định là false . 注解 Tùy chọn ssl không được hỗ trợ bởi tất cả các trình điều khiển. See your driver documentation and the 使用SSL连接MongoDB document. nước tiểu. connectTimeoutMS¶Thời gian tính bằng mili giây để thử kết nối trước khi hết thời gian chờ. Mặc định là không bao giờ hết thời gian chờ, mặc dù các trình điều khiển khác nhau có thể khác nhau. Xem tài liệu trình điều khiển nước tiểu. socketTimeoutMS¶Thời gian tính bằng mili giây để thử gửi hoặc nhận trên một ổ cắm trước khi hết thời gian thử. Mặc định là không bao giờ hết thời gian chờ, mặc dù các trình điều khiển khác nhau có thể khác nhau. Xem tài liệu trình điều khiển Tùy chọn nhóm kết nối¶Hầu hết các trình điều khiển triển khai một số loại tổng hợp kết nối xử lý việc này cho bạn ở hậu trường. Một số trình điều khiển không hỗ trợ nhóm kết nối. Xem tài liệu trình điều khiển của bạn để biết thêm thông tin về triển khai tổng hợp kết nối. Các tùy chọn này cho phép các ứng dụng định cấu hình nhóm kết nối khi kết nối với triển khai MongoDB nước tiểu. maxPoolSize¶Số lượng kết nối tối đa trong nhóm kết nối. Giá trị mặc định là 100 . nước tiểu. minPoolSize¶Số lượng kết nối tối thiểu trong nhóm kết nối. Giá trị mặc định là 0 . 注解 Tùy chọn minPoolSize không được hỗ trợ bởi tất cả các trình điều khiển. Để biết thông tin về trình điều khiển của bạn, hãy xem tài liệu trình điều khiển. nước tiểu. maxIdleTimeMS¶Số mili giây tối đa mà một kết nối có thể không hoạt động trong nhóm trước khi bị xóa và đóng Tùy chọn này không được hỗ trợ bởi tất cả các trình điều khiển nước tiểu. waitQueueMultiple¶Một số mà trình điều khiển nhân giá trị maxPoolSize để cung cấp số luồng tối đa được phép chờ kết nối khả dụng . For default values, see the 驱动程序和客户端 documentation. nước tiểu. waitQueueTimeoutMS¶Thời gian tối đa tính bằng mili giây mà một chuỗi có thể chờ kết nối khả dụng. For default values, see the 驱动程序和客户端 documentation Viết Tùy chọn Mối quan tâm¶Viết mối quan tâm mô tả các loại đảm bảo rằng chương trình. mongod và trình điều khiển cung cấp cho ứng dụng về sự thành công và độ bền của thao tác ghi. Để có giải thích đầy đủ về mối quan tâm ghi và thao tác ghi nói chung, hãy xem phần. 写 nước tiểu. w¶Xác định mức độ và loại mối quan tâm ghi mà trình điều khiển sử dụng khi gọi getLastError . Tùy chọn này có thể lấy một số hoặc một chuỗi làm giá trị. Tùy chọn
Thời gian tính bằng mili giây để chờ sao chép thành công, như được chỉ định trong tùy chọn w , trước khi hết thời gian chờ. nước tiểu. tạp chí¶Kiểm soát liệu các thao tác ghi có đợi cho đến khi mongod xác nhận các thao tác ghi và đưa dữ liệu vào nhật ký trên đĩa hay không. Tùy chọn
Đọc tùy chọn ưu tiên¶Tùy chọn đọc mô tả hành vi của hoạt động đọc liên quan đến bộ bản sao. Các tham số này cho phép bạn chỉ định tùy chọn đọc trên cơ sở mỗi kết nối trong chuỗi kết nối nước tiểu. readPreference¶Chỉ định tùy chọn đọc bộ bản sao cho kết nối này. Cài đặt này sẽ ghi đè bất kỳ giá trị slaveOk nào. Các giá trị ưu tiên đọc như sau.
Để biết mô tả về từng giá trị, hãy xem Chế độ tùy chọn đọc Giá trị mặc định là chính , giá trị này sẽ gửi tất cả các thao tác đọc tới giá trị chính của bộ bản sao. nước tiểu. readPreferenceTags¶Chỉ định một bộ thẻ dưới dạng danh sách các cặp khóa-giá trị được phân tách bằng dấu phẩy. Ví dụ dc:ny,rack:1 Để chỉ định danh sách bộ thẻ, hãy sử dụng nhiều readPreferenceTags . Phần sau chỉ định hai bộ thẻ và một bộ thẻ trống. readPreferenceTags=dc:ny,rack:1&readPreferenceTags=dc:ny&readPreferenceTags= Thứ tự quan trọng khi sử dụng nhiều readPreferenceTags . Cấu hình khác¶nước tiểu. uuidRepresentation¶参数
Đối với mặc định, hãy xem tài liệu trình điều khiển cho trình điều khiển của bạn 注解 Không phải tất cả trình điều khiển đều hỗ trợ tùy chọn uuidRepresentation . Để biết thông tin về trình điều khiển của bạn, hãy xem tài liệu trình điều khiển. Ví dụ¶Hãy xem xét các chuỗi URI MongoDB ví dụ sau, chỉ định các kết nối phổ biến
|