Tài liệu về nhà → Hướng dẫn sử dụng MongoDB → MongoDB Manual
listDatabases
Lệnh listDatabases
cung cấp một danh sách tất cả các cơ sở dữ liệu hiện có cùng với các số liệu thống kê cơ bản về chúng. listDatabases
phải chạy đối với cơ sở dữ liệu db.adminCommand[ { listDatabases: 1 } ]
0, như trong ví dụ sau:The
listDatabases
command provides a list of all existing databases along with basic statistics about them. The listDatabases
must run against the
db.adminCommand[ { listDatabases: 1 } ]
0 database, as in the following example:
db.adminCommand[ { listDatabases: 1 } ]
Giá trị [ví dụ:
db.adminCommand[ { listDatabases: 1 } ]
1] không ảnh hưởng đến đầu ra của lệnh.Lệnh có thể lấy các trường tùy chọn sau:
db.adminCommand[ { listDatabases: 1 } ] | tài liệu | Không bắt buộc. Một vị từ truy vấn xác định cơ sở dữ liệu nào được liệt kê. Bạn có thể chỉ định một điều kiện trên bất kỳ trường nào trong đầu ra của
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
db.adminCommand[ { listDatabases: 1 } ] | boolean | Không bắt buộc. Một cờ để cho biết liệu lệnh có chỉ trả về tên cơ sở dữ liệu hay trả về cả tên cơ sở dữ liệu và thông tin kích thước. Thông tin kích thước trả về yêu cầu khóa từng cơ sở dữ liệu một lần, trong khi chỉ trả về tên không yêu cầu khóa bất kỳ cơ sở dữ liệu nào. Giá trị mặc định là 9, vì vậy listDatabases trả về thông tin tên và kích thước của mỗi cơ sở dữ liệu.listDatabases returns the name and size information of each database.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| boolean | Không bắt buộc. Một lá cờ xác định cơ sở dữ liệu nào được trả về dựa trên các đặc quyền của người dùng khi kiểm soát truy cập được bật.
Nếu người dùng không có hành động Để biết thêm thông tin, xem hành vi. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Mới trong phiên bản 4.0.5. | Optional. không tí nào
Đầu ra 3, trong trường 2.Một nhận xét có thể là bất kỳ loại BSON hợp lệ [chuỗi, số nguyên, đối tượng, mảng, v.v.]. |
Mới trong phiên bản 4.4.
Khi xác thực được bật:
Ghi chú
5 connected to earlier versions of MongoDB deployment [e.g. 3.6.10],{ "databases" : [ { "name" : "admin" }, { "name" : "local" }, { "name" : "test" } ], "ok" : 1 }
Đối với
5 được kết nối với các phiên bản triển khai MongoDB trước đó [ví dụ: 3.6.10],{ "databases" : [ { "name" : "admin" }, { "name" : "local" }, { "name" : "test" } ], "ok" : 1 } Nếu người dùng có hành động
listDatabases
trên tài nguyên cụm,
7 sẽ trả về tất cả các cơ sở dữ liệu.{ "databases" : [ { "name" : "admin" }, { "name" : "local" }, { "name" : "test" } ], "ok" : 1 }
Nếu người dùng không có hành động listDatabases
trên tài nguyên cụm,
{ "databases" : [ { "name" : "admin" }, { "name" : "local" }, { "name" : "test" } ], "ok" : 1 }
7 chỉ trả về cơ sở dữ liệu mà người dùng có đặc quyền [bao gồm cả cơ sở dữ liệu mà người dùng có đặc quyền trên các bộ sưu tập cụ thể].listDatabases
disconnects before the operation completes, MongoDB marks
listDatabases
for termination using db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
2Bắt đầu từ MongoDB 4.2, nếu khách hàng phát hành listDatabases
ngắt kết nối trước khi hoạt động hoàn thành, MongoDB đánh dấu listDatabases
để chấm dứt bằng cách sử dụng
db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
2listDatabases
operations require the member to be in db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
4 or db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
5 state. If the member is
in another state, such as db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
6, the operation errors.Bắt đầu từ MongoDB 4.4, để chạy trên một thành viên tập hợp, các hoạt động listDatabases
yêu cầu thành viên phải ở trạng thái
db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
4 hoặc db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
5. Nếu thành viên ở một trạng thái khác, chẳng hạn như db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
6, các lỗi hoạt động.Trong các phiên bản trước, các hoạt động cũng chạy khi thành viên ở
db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
6. Các hoạt động đợi cho đến khi thành viên chuyển sang db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
8listDatabases
against the db.adminCommand[ { listDatabases: 1 } ]
0 database:db.adminCommand[ { listDatabases: 1 } ]
Chạy listDatabases
so với cơ sở dữ liệu
db.adminCommand[ { listDatabases: 1 } ]
0:listDatabases
result:{ "databases" : [ { "name" : "admin", "sizeOnDisk" : 83886080, "empty" : false }, { "name" : "local", "sizeOnDisk" : 83886080, "empty" : false }, { "name" : "test", "sizeOnDisk" : 83886080, "empty" : false } ], "totalSize" : 251658240, "totalSizeMb" : 251, "ok" : 1 }
Sau đây là một ví dụ về kết quả listDatabases
:listDatabases
against the
db.adminCommand[ { listDatabases: 1 } ]
0 database. Specify the { "databases" : [ { "name" : "admin", "sizeOnDisk" : 16384, "empty" : false, "shards" : { "config" : 16384 } }, { "name" : "config", "sizeOnDisk" : 176128, "empty" : false, "shards" : { "clients" : 28672, "patients" : 8192, "config" : 139264 } }, { "name" : "test", "sizeOnDisk" : 12288, "empty" : false, "shards" : { "clients" : 12288 } } ], "totalSize" : 204800, "totalSizeMb" : 0, "ok" : 1 }
4 option:db.adminCommand[ { listDatabases: 1, nameOnly: true} ]
Chạy listDatabases
so với cơ sở dữ liệu
db.adminCommand[ { listDatabases: 1 } ]
0. Chỉ định tùy chọn { "databases" : [ { "name" : "admin", "sizeOnDisk" : 16384, "empty" : false, "shards" : { "config" : 16384 } }, { "name" : "config", "sizeOnDisk" : 176128, "empty" : false, "shards" : { "clients" : 28672, "patients" : 8192, "config" : 139264 } }, { "name" : "test", "sizeOnDisk" : 12288, "empty" : false, "shards" : { "clients" : 12288 } } ], "totalSize" : 204800, "totalSizeMb" : 0, "ok" : 1 }
4:listDatabases
results when run with the { "databases" : [ { "name" : "admin", "sizeOnDisk" : 16384, "empty" : false, "shards" : { "config" : 16384 } }, { "name" : "config", "sizeOnDisk" : 176128, "empty" : false, "shards" : { "clients" : 28672, "patients" : 8192, "config" : 139264 } }, { "name" : "test", "sizeOnDisk" : 12288, "empty" : false, "shards" : { "clients" : 12288 } } ], "totalSize" : 204800, "totalSizeMb" : 0, "ok" : 1 }
4 option:{ "databases" : [ { "name" : "admin" }, { "name" : "local" }, { "name" : "test" } ], "ok" : 1 }
Sau đây là một ví dụ về kết quả listDatabases
khi chạy với tùy chọn
{ "databases" : [ { "name" : "admin", "sizeOnDisk" : 16384, "empty" : false, "shards" : { "config" : 16384 } }, { "name" : "config", "sizeOnDisk" : 176128, "empty" : false, "shards" : { "clients" : 28672, "patients" : 8192, "config" : 139264 } }, { "name" : "test", "sizeOnDisk" : 12288, "empty" : false, "shards" : { "clients" : 12288 } } ], "totalSize" : 204800, "totalSizeMb" : 0, "ok" : 1 }
4:listDatabases
against the db.adminCommand[ { listDatabases: 1 } ]
0 database. Specify the db.adminCommand[ { listDatabases: 1 } ]
2 option to only list databases that match
the specified filter criteria.Chạy listDatabases
so với cơ sở dữ liệu
db.adminCommand[ { listDatabases: 1 } ]
0. Chỉ định tùy chọn db.adminCommand[ { listDatabases: 1 } ]
2 để chỉ liệt kê các cơ sở dữ liệu phù hợp với tiêu chí bộ lọc được chỉ định.listDatabases
only returns information on databases whose name matches the specified listDatabases
1db.adminCommand[ { listDatabases: 1, filter: { "name": /^rep/ } } ]
Ví dụ: sau đây chỉ định một bộ lọc sao cho listDatabases
chỉ trả về thông tin trên cơ sở dữ liệu có tên khớp với listDatabases
1 được chỉ địnhlistDatabases
Khi được thực thi theo một ví dụ
listDatabases
2,listDatabases
Thêm một tài liệu nhúng
7 vào tài liệu tóm tắt của mỗi cơ sở dữ liệu nếudb.adminCommand[ { listDatabases: 1 } ]
listDatabases
5 và
Không bao gồm cơ sở dữ liệu listDatabases
6.
Trường
db.adminCommand[ { listDatabases: 1 } ]
5 đại diện cho tổng kích thước của tất cả các bộ sưu tập và chỉ mục được liệt kê.Ví dụ:
{ "databases" : [ { "name" : "admin", "sizeOnDisk" : 16384, "empty" : false, "shards" : { "config" : 16384 } }, { "name" : "config", "sizeOnDisk" : 176128, "empty" : false, "shards" : { "clients" : 28672, "patients" : 8192, "config" : 139264 } }, { "name" : "test", "sizeOnDisk" : 12288, "empty" : false, "shards" : { "clients" : 12288 } } ], "totalSize" : 204800, "totalSizeMb" : 0, "ok" : 1 }
Mẹo
Xem thêm:
listDatabases
9Type: MảngType: Array
Mảng tài liệu, mỗi tài liệu chứa thông tin trên một cơ sở dữ liệu.
listDatabases
0Type: ChuỗiType: String
Tên của cơ sở dữ liệu.
listDatabases
1Type: Số nguyênType: Integer
Tổng kích thước của các tệp cơ sở dữ liệu trên đĩa, được thể hiện bằng byte.
listDatabases
2Type: BooleanType: Boolean
Chỉ định xem cơ sở dữ liệu có trống không.
listDatabases
3Type: Tài liệuType: Document
Mỗi phần tử trong tài liệu
db.adminCommand[ { listDatabases: 1 } ]
7 bao gồm một trường có khóa đặt tên của một bộ sưu tập trên mảnh vỡ đó và giá trị của nó đại diện cho kích thước của bộ sưu tập tính bằng byte.db.adminCommand[ { listDatabases: 1 } ]
7 chỉ xuất hiện trong đầu ra nếu listDatabases
5.Xem các cụm Sharded để biết chi tiết.Sharded Clusters for details.
listDatabases
7Type: Số nguyênType: Integer
Tổng của tất cả các trường
db.adminCommand[ { listDatabases: 1 } ]
5 trong byte.listDatabases
9Type: Số nguyênType: Integer
Tổng của tất cả các trường
db.adminCommand[ { listDatabases: 1 } ]
5, được thể hiện bằng megabyte.listDatabases
1Type: Số nguyênType: Integer
Trả về giá trị cho lệnh. Giá trị của
db.adminCommand[ { listDatabases: 1 } ]
1 cho thấy thành công.