gbak - Online di Awan

PROGRAM:

NAMA

gbak — Mencadangkan/memulihkan basis data Firebird

RINGKASAN

gbak -b [opsi cadangan ...] [opsi umum ...] sumber target

gbak -c|-r [opsi pemulihan ...] [opsi umum ...] sumber target

DESKRIPSI

gbak adalah alat untuk mengelola pencadangan dan pemulihan basis data Firebird.

Dalam mode cadangan sumber adalah jalur basis data yang ada (mungkin termasuk nama server) dan target is
nama file cadangan. Bisa juga nama perangkat khusus seperti /dev/stdout (untuk mengalihkan
backup data ke STDOUT) atau /dev/st untuk meletakkan backup pada tape.

Dalam mode pemulihan sumber apakah file cadangan yang ada (atau perangkat khusus seperti /dev/stdin untuk
STDIN atau /dev/st untuk mendapatkan cadangan dari tape) dan target adalah jalur ke database firebird dan
dapat menyertakan nama server.

Semua opsi dapat disingkat. Di bawah opsi versi lengkap dan terpendek
versi yang mungkin diberikan.

UMUM PILIHAN

-user nama pengguna
Nama pengguna yang akan digunakan saat menghubungkan ke database. Mengganti variabel lingkungan. Lihat
LINGKUNGAN.

-peran] nama peran
Peran SQL untuk digunakan saat menghubungkan ke database. Mengganti variabel lingkungan. Lihat
LINGKUNGAN.

-kata sandi] kata sandi
Kata sandi untuk digunakan saat menghubungkan ke database. Mengganti variabel lingkungan. Lihat
LINGKUNGAN.

-melayani]
Gunakan manajer layanan saat berbicara dengan database.

-memeriksa]
Laporkan setiap tindakan.

Menampilkan informasi verbose tentang metadata apa yang sedang diproses, tabel apa yang sedang diproses
dicadangkan/dipulihkan dan berapa banyak catatan yang diproses.

-y path
Redirect status/pesan kesalahan ke jalur yang diberikan.

-z
Laporkan nomor versi lengkap sebelum melakukan hal lain.

CADANGAN PILIHAN

-b[backup_database]
Aktifkan mode cadangan.

-mengubah]
Ubah tabel eksternal menjadi tabel.

Biasanya tabel eksternal diabaikan selama pencadangan dan pemulihan. Dengan -mengubah Option
tabel eksternal disertakan dalam cadangan seperti tabel biasa lainnya. Ketika cadangan seperti itu
dipulihkan, tabel eksternal ini sebelumnya dibuat sebagai tabel biasa.

-faktor] num
Faktor pemblokiran. Output ditulis dalam blok num byte. Berguna saat mencadangkan ke a
keran.

-g[arbage_collect]
Menghambat pengumpulan sampah.

Biasanya Firebird menjalankan pengumpul sampah saat membaca tabel. Sejak
proses backup membaca semua tabel, ini memaksa pengumpulan sampah dari seluruh database.
Jika Anda membuat cadangan hanya untuk mengembalikannya ke database yang ada, sampah ini
pengumpulan tidak perlu. Alasan lain untuk menggunakan opsi ini adalah jika pengumpulan sampah
digunakan dengan cara lain - baik dengan menggunakan gfix atau sapuan otomatis. Menggunakan sakelar ini
mempercepat proses pencadangan dan juga dapat membantu dalam beberapa kasus pencadangan yang rusak
database.

-mengabaikan]
Abaikan catatan dengan checksum yang buruk.

Opsi ini harus digunakan hanya saat membuat cadangan database yang rusak.

-l[imbo]
Abaikan transaksi dalam limbo.

Sakelar ini menyebabkan proses pencadangan mengabaikan transaksi dalam keadaan limbo.

-m[hanya_etadata]
Cadangkan metadata saja.

Dengan opsi ini hanya metadata yang ditulis ke cadangan. Ini termasuk semua
tabel/tampilan/pemicu/indeks/prosedur tersimpan/domain/generator dll. Tidak ada data tabel yang
termasuk dalam cadangan. Cadangan semacam itu berguna untuk membuat salinan database yang "kosong".

-tidak
Gunakan format cadangan yang tidak dapat diangkut.

Secara default, format cadangan "yang dapat diangkut" digunakan. Ini berarti Anda dapat membuat cadangan database
pada mesin little-endian dan mengembalikannya pada mesin big-endian dan sebaliknya. Dengan menggunakan -tidak
cadangan hanya berguna pada mesin dengan "endianness" yang sama.

-ol[d_deskripsi]
simpan deskripsi metadata gaya lama

MENGEMBALIKAN PILIHAN

-c[reate_database]
Aktifkan mode pemulihan.

target database akan dibuat dan tidak boleh sudah ada.

-r[ecreate_database] [o[menimpa]]
Seperti -buat_database, tetapi dengan menambahkan menimpa seseorang dapat memaksa penggantian target
database.

-rep[renda_database]
Seperti -buat_database, tetapi target akan ditimpa jika ada.

-bu[menawarkan] num
Saat membuat database target, abaikan informasi tentang buffer database yang disimpan di
backup dan gunakan jumlah buffer yang ditentukan.

-mengembangkan]
Biasanya, Firebird menggunakan kompresi RLE untuk string saat menyimpannya di disk. Pilihan ini
mematikan kompresi ini.

-i[tidak aktif]
Pulihkan indeks dalam keadaan tidak aktif. Ini dapat digunakan untuk memulihkan cadangan, yang berisi data
tidak konsisten dengan kunci asing/kendala unik.

-membunuh]
Jangan membuat bayangan saat memulihkan.

Biasanya dan bayangan basis data dibuat selama pemulihan. Opsi ini menghambat ini.

-mode] mengakses
Pulihkan basis data dengan yang diberikan mengakses.

Nilai yang valid untuk mengakses adalah baca_saja dan Baca tulis. Defaultnya adalah mengembalikan database
dengan mode akses aslinya.

-n[o_validitas]
Pulihkan basis data tanpa batasan validitasnya. Ini termasuk kunci asing, unik dan
memeriksa kendala. Berguna untuk memulihkan cadangan, berisi data yang tidak konsisten.

-satu per satu]
Komit memulihkan transaksi setelah memulihkan setiap tabel.

-ukuran halaman] num
Ganti ukuran halaman yang disimpan dalam cadangan. Nilai yang valid untuk num adalah 1024, 2048, 4096, 8192,
16384 dan 32768.

-gunakan_[semua_spasi]
Biasanya, Fireburd mencadangkan beberapa ruang pada setiap halaman data untuk digunakan lebih lanjut. Ini dipesan
ruang digunakan untuk data yang baru dimasukkan dan untuk menyimpan versi data yang lebih lama. Memiliki
ruang yang disediakan untuk tujuan ini "dekat" dengan data mempercepat modifikasi. jika
database akan digunakan terutama untuk operasi baca, menentukan -gunakan_semua_ruang akan menghemat beberapa
ruang.

Opsi ini sangat berguna saat memulihkan database hanya-baca, karena hanya-baca
database tidak memerlukan ruang tambahan untuk versi belakang.

-fix_fss_metadata rangkaian karakter
Saat memulihkan metadata, jika itu bukan UTF8 yang valid, cobalah untuk mengonversi dari yang ditentukan
set karakter. Berguna ketika deskripsi tabel diberikan di beberapa negara non-UTF8
pengkodean, yang dimungkinkan dengan Firebird sebelum versi 2.5

-fix_fss_data rangkaian karakter
Saat memulihkan data tabel, jika kolom didefinisikan dengan set karakter UNICODE_FSS
tidak mengandung UTF8 yang valid (yang dimungkinkan dengan versi Firebird sebelum 2.5), coba
mengkonversi data dari set karakter yang ditentukan.

PEMULIHAN UNTUK GANDA-FILE DATABASE

Sebelumnya, Firebird tidak dapat bekerja dengan pointer file 64-bit sehingga membatasi
database ke (sekitar) 2GB ukuran per database.

Karena 2GB tidak banyak data sejak bertahun-tahun, ada mekanisme untuk menyebarkan database
menjadi beberapa file. Dengan cara ini Anda dapat memiliki beberapa file 2GB, yang berisi semua data Anda.

Saat memulihkan ke database multi-file, argumen target berbentuk: file_1 halaman_1
file_2 halaman_2 ... file_N-1 halaman_N-1 file_N

Masing-masing halaman_n menentukan paling banyak berapa banyak halaman yang akan dimasukkan file_n. Terakhir dalam daftar adalah
nama file tanpa batas halaman - itu akan berisi semua halaman yang tidak cocok file_N-1. Catat itu
halaman_n diukur dalam halaman, bukan byte sehingga jumlah maksimum yang mungkin tergantung pada halaman
ukuran.

Bayangkan Anda memiliki sistem file (atau OS kuno) yang hanya mendukung pointer file 32-bit.
Untuk bermain aman, Anda memutuskan untuk membagi database Anda pada file 2GB. Jika ukuran halaman untuk
database adalah 8192, maka setiap file dapat memiliki hingga 2*1024*1024*1024/8192 = 262144 halaman.

CATATAN
Perhatikan bahwa pada OS dan sistem file terbaru, Firebird dapat menggunakan rendering pointer file 64-bit
database multi-file yang tidak perlu.

LINGKUNGAN

Seperti semua utilitas Firebird lainnya, gbak menerima variabel lingkungan berikut:

Nilai default ISC_USER untuk -user Option

Nilai default ISC_ROLE untuk -wewenang Option

ISC_PASSWORD
nilai default untuk -kata sandi Option

CONTOH

Dalam semua contoh -user, -wewenang dan -kata sandi pilihan dihilangkan untuk kejelasan. secara nyata
situasi dunia mereka (atau variabel lingkungan yang sesuai) harus digunakan.

Perhatikan bahwa ekstensi nama file yang digunakan di sini hanya disarankan. Menggunakan ekstensi terpadu
skema membantu menebak jenis file hanya dengan melihat ekstensinya.

Berikut adalah beberapa ekstensi yang umum digunakan:

Basis data Firebird .fdb

Database .gdb Firebird, ekstensi lama sejak Firebird masih Interbase.
gdb sebenarnya berasal dari basis data Grotton, dinamai berdasarkan perusahaan yang menciptakan
perangkat lunak kembali pada tahun 1984.

.fdb.2 File kedua dari database multi-file

.fdb.3 File ketiga dari database multi-file

.fdb.N N-file ke-th dari database multi-file

File cadangan .fbk Firebird

Ekstensi lama .gbk untuk file cadangan

.fbk.gz Gzip file cadangan

backup a Database ke a dikompresi format:
gbak -b db-srv:/database.fdb /dev/stdout | gzip > /file.fbk.gz

mengembalikan a Database ke yang baru nama file:
zcat /file.fbk.gz | gbak -c /dev/stdin db-srv:/database baru.fdb

Gunakan gbak online menggunakan layanan onworks.net