mongodump

JADUAL:

NAMA

mongodump - MongoDB

SINOPSIS

mongodump ialah utiliti untuk mencipta eksport binari kandungan pangkalan data.
Pertimbangkan untuk menggunakan utiliti ini sebagai sebahagian yang berkesan sandaran strategi. Gunakan bersama-sama dengan
kedai mongore untuk menyediakan fungsi pemulihan.

Nota Format data yang dicipta oleh mongodump alat daripada pengedaran 2.2 atau lebih baru ialah
berbeza dan tidak serasi dengan versi terdahulu mongod.

Lihat juga

"kedai mongore"Dan"/pentadbiran/sandaran".

PILIHAN

mongodump

- membantu Mengembalikan teks bantuan dan penggunaan asas.

--verbose, -v
Meningkatkan jumlah pelaporan dalaman yang dikembalikan pada baris arahan. Meningkat
verbositi dengan -v bentuk dengan memasukkan pilihan beberapa kali, (cth
-vvvvv.)

--versi
Mengembalikan versi mongodump utiliti dan pintu keluar.

--tuan rumah <:port>
Menentukan nama hos yang boleh diselesaikan untuk mongod yang anda ingin gunakan untuk mencipta
longgokan pangkalan data. Secara lalai mongodump akan cuba menyambung ke proses MongoDB
merosakkan nombor port localhost 27017.

Secara pilihan, tentukan nombor port untuk menyambungkan tika MongoDB yang berjalan pada port
selain daripada 27017.

Untuk menyambung ke set replika, gunakan --tuan rumah hujah dengan nama set, diikuti dengan a
slash dan senarai nama hos dan nombor port yang dipisahkan koma. The mongodump
utiliti akan, memandangkan benih sekurang-kurangnya satu ahli set yang disambungkan, menyambung ke
ahli utama set itu. Pilihan ini akan menyerupai:

mongodump --host repl0/mongo0.example.net,mongo0.example.net:27018,mongo1.example.net,mongo2.example.net

Anda sentiasa boleh menyambung terus ke satu contoh MongoDB dengan menentukan hos
dan nombor port secara langsung.

--pelabuhan
Menentukan nombor port, jika contoh MongoDB tidak berjalan pada standard
pelabuhan. (iaitu 27017) Anda juga boleh menentukan nombor port menggunakan --tuan rumah pilihan.

--ipv6 Mendayakan sokongan IPv6 yang membenarkan mongodump untuk menyambung ke contoh MongoDB menggunakan
rangkaian IPv6. Semua program dan proses MongoDB, termasuk mongodump, lumpuhkan
Sokongan IPv6 secara lalai.

--ssl Baharu dalam versi 2.4: MongoDB menambah sokongan untuk sambungan SSL mongod contoh
dalam mongodump.

Perhatikan sokongan SSL dalam mongodump tidak disusun ke dalam pengedaran lalai MongoDB.
Lihat /pentadbiran/ssl untuk maklumat lanjut tentang SSL dan MongoDB.

Selain itu, mongodump tidak menyokong sambungan ke mongod contoh yang
memerlukan pengesahan sijil pelanggan.

Membenarkan mongodump untuk menyambung kepada mongod contoh melalui sambungan SSL.

--nama pengguna , -u
Menentukan nama pengguna untuk mengesahkan kepada contoh MongoDB, jika pangkalan data anda
memerlukan pengesahan. Gunakan bersama-sama dengan --kata laluan pilihan untuk membekalkan a
kata laluan.

--kata laluan , -p
Menentukan kata laluan untuk mengesahkan kepada contoh MongoDB. Guna bersama
dengan --nama pengguna pilihan untuk membekalkan nama pengguna.

Jika anda nyatakan a --nama pengguna tanpa --kata laluan pilihan, mongodump akan meminta
untuk kata laluan secara interaktif.

--authenticationDatabase
Baru dalam versi 2.4.

Menentukan pangkalan data yang menyimpan milik pengguna (cth --nama pengguna) kelayakan.

Secara lalai, mongodump menganggap bahawa pangkalan data yang ditentukan kepada --db hujah
memegang bukti kelayakan pengguna, melainkan anda nyatakan --authenticationDatabase.

Lihat sumber pengguna, /reference/privilege-documents and /rujukan/keistimewaan-pengguna khususnya
maklumat lanjut tentang pengesahan yang diwakilkan dalam MongoDB.

--mekanisme pengesahan
Baru dalam versi 2.4.

Menentukan mekanisme pengesahan. Secara lalai, mekanisme pengesahan adalah
MONGODB-CR, iaitu mekanisme pengesahan cabaran/tindak balas MongoDB. Dalam
Edisi Pelanggan MongoDB, mongodump juga termasuk sokongan untuk GSSAPI kepada
mengendalikan pengesahan Kerberos.

Lihat /tutorial/control-access-to-mongodb-with-kerberos-authentication selama lebih
maklumat tentang pengesahan Kerberos.

--dbpath
Menentukan direktori fail data MongoDB. Jika digunakan, --dbpath pilihan
membolehkan mongodump untuk melampirkan terus ke fail data tempatan dan menyalin data tanpa
yang mongod. Untuk berlari dengan --dbpath, mongodump perlu menyekat akses kepada data
direktori: akibatnya, tidak mongod boleh mengakses laluan yang sama semasa proses berjalan.

--directoryperdb
Menggunakan --directoryperdb bersempena dengan pilihan yang sepadan untuk mongod.
Pilihan ini membolehkan mongodump untuk membaca fail data yang disusun dengan setiap pangkalan data
terletak dalam direktori yang berbeza. Pilihan ini hanya relevan apabila menentukan
--dbpath pilihan.

--jurnal
Membenarkan mongodump operasi untuk menggunakan ketahanan jurnal untuk memastikan bahawa eksport
berada dalam keadaan yang konsisten. Pilihan ini hanya relevan apabila menentukan --dbpath
pilihan.

--db , -d
Menggunakan --db pilihan untuk menentukan pangkalan data untuk mongodump untuk membuat sandaran. Jika kamu tidak
nyatakan DB, mongodump menyalin semua pangkalan data dalam contoh ini ke dalam fail dump.
Gunakan pilihan ini untuk membuat sandaran atau menyalin subset data anda yang lebih kecil.

--koleksi , -c
Menggunakan --koleksi pilihan untuk menentukan koleksi untuk mongodump untuk membuat sandaran. Jika awak
jangan nyatakan koleksi, pilihan ini menyalin semua koleksi dalam yang ditentukan
pangkalan data atau contoh kepada fail dump. Gunakan pilihan ini untuk membuat sandaran atau menyalin yang lebih kecil
subset data anda.

--keluar , -o
Menentukan laluan di mana mongodump dan simpan output dump pangkalan data. Untuk mengeluarkan
longgokan pangkalan data kepada output standard, nyatakan a - bukannya jalan.

--pertanyaan , -q
Menyediakan pertanyaan untuk mengehadkan (pilihan) dokumen yang disertakan dalam output
mongodump.

--oplog
Gunakan pilihan ini untuk memastikannya mongodump mencipta lambakan pangkalan data yang
merangkumi sebuah oplog, untuk mencipta petikan titik dalam masa bagi keadaan a mongod
contoh. Untuk memulihkan kepada sandaran titik dalam masa tertentu, gunakan output yang dibuat
dengan pilihan ini bersama-sama dengan kedai mongore --oplogReplay.

Tanpa --oplog, jika terdapat operasi tulis semasa operasi dump, dump
tidak akan mencerminkan satu saat pun dalam masa. Perubahan yang dibuat pada pangkalan data semasa
proses kemas kini boleh menjejaskan output sandaran.

--oplog tidak memberi kesan apabila berlari mongodump terhadap a mongos contoh untuk membuang
keseluruhan kandungan gugusan yang dipecahkan. Walau bagaimanapun, anda boleh menggunakan --oplog untuk membuang
serpihan individu.

Nota --oplog hanya berfungsi terhadap nod yang mengekalkan a oplog. Ini termasuk semua ahli
daripada set replika, serta master nod dalam penempatan replikasi induk/hamba.

--baik pulih
Gunakan pilihan ini untuk menjalankan pilihan pembaikan selain membuang pangkalan data. The
pilihan pembaikan cuba membaiki pangkalan data yang mungkin dalam keadaan tidak konsisten seperti
akibat daripada penutupan yang tidak betul atau mongod kemalangan.

--forceTableScan
Angkatan mongodump untuk mengimbas stor data secara langsung: biasanya, mongodump menyelamatkan
entri seperti yang terdapat dalam indeks _ID padang. guna --forceTableScan untuk melangkau
indeks dan imbas data secara langsung. Biasanya terdapat dua kes di mana ini
tingkah laku adalah lebih baik daripada lalai:

1. Jika anda mempunyai saiz kunci melebihi 800 bait yang tidak akan terdapat dalam _ID indeks.

2. Pangkalan data anda menggunakan tersuai _ID lapangan.

Apabila anda berlari dengan --forceTableScan, mongodump tidak menggunakan $gambar. Akibatnya,
tempat pembuangan yang dihasilkan oleh mongodump boleh mencerminkan keadaan pangkalan data di banyak
titik masa yang berbeza.

Amaran
Penggunaan --forceTableScan dengan berhati-hati dan bertimbang rasa.

Amaran
Diubah dalam versi 2.2: Apabila digunakan dalam kombinasi dengan fsync or db.fsyncLock(),
mongod mungkin menyekat beberapa bacaan, termasuk yang daripada mongodump, bila beratur tulis
operasi menunggu di belakang fsync kunci.

PERILAKU

Semasa berlari mongodump terhadap a mongos contoh di mana pecah kelompok terdiri daripada
membalas set, yang membaca pilihan operasi akan lebih suka membaca daripada menengah
ahli set.

PENGGUNAAN

Melihat /tutorial/backup-databases-with-binary-database-dumps untuk gambaran keseluruhan yang lebih besar tentang
mongodump penggunaan. Lihat juga "kedai mongore" dokumen untuk gambaran keseluruhan kedai mongore,
yang menyediakan fungsi songsang yang berkaitan.

Perintah berikut, mencipta fail dump yang mengandungi hanya koleksi bernama
koleksi dalam pangkalan data bernama ujian. Dalam kes ini pangkalan data berjalan pada tempatan
antara muka pada port 27017:

mongodump --collection collection --db test

Dalam contoh seterusnya, mongodump mencipta sandaran contoh pangkalan data yang disimpan dalam
/srv/mongodb direktori pada mesin tempatan. Ini memerlukan bahawa tidak mongod contoh ialah
menggunakan /srv/mongodb direktori.

mongodump --dbpath /srv/mongodb

Dalam contoh terakhir, mongodump mencipta tempat pembuangan pangkalan data yang terletak di
/opt/backup/mongodump-2011-10-24, daripada pangkalan data yang berjalan pada port 37017 pada tuan rumah
mongodb1.example.net dan mengesahkan menggunakan nama pengguna pengguna dan kata laluan lulus, Seperti
ikut:

mongodump --host mongodb1.example.net --port 37017 --username user --password /opt/backup/mongodump-2011-10-24

Gunakan mongodump dalam talian menggunakan perkhidmatan onworks.net