gbak - Online in de cloud

PROGRAMMA:

NAAM

gbak — Maak een back-up/herstel van de Firebird-database

KORTE INHOUD

bak -b [back-upoptie ...] [algemene optie ...] (bron) doel

bak -c|-r [hersteloptie ...] [algemene optie ...] (bron) doel

PRODUCTBESCHRIJVING

bak is de tool voor het beheren van Firebird-databaseback-up en -herstel.

In back-upmodus (bron) is een bestaand databasepad (kan de servernaam bevatten) en doel is
back-up bestandsnaam. Het kan ook een speciale apparaatnaam zijn, zoals /dev/stdout (om het bestand om te leiden
back-upgegevens naar STDOUT) of /dev/st om de back-up op tape te zetten.

In herstelmodus (bron) is een bestaand back-upbestand (of een speciaal apparaat zoals /dev/stdin voor
STDIN of /dev/st om de back-up van tape te halen) en doel is het pad naar de firebird-database en
kan de servernaam bevatten.

Alle opties kunnen worden afgekort. Hieronder beide volledige versies van opties en de kortste
mogelijke versies worden gegeven.

GEMEENSCHAPPELIJKE OPTIES

-gebruiker gebruikersnaam
Gebruikersnaam die moet worden gebruikt bij het verbinden met de database. Negeert omgevingsvariabele. Zien
MILIEU.

-rol] rol naam
SQL-rol die moet worden gebruikt bij het verbinden met de database. Negeert omgevingsvariabele. Zien
MILIEU.

-wachtwoord] wachtwoord
Wachtwoord om te gebruiken bij het verbinden met de database. Negeert omgevingsvariabele. Zien
MILIEU.

-dienst]
Gebruik Services Manager wanneer u met een database praat.

-verifiëren]
Rapporteer elke actie.

Geeft uitgebreide informatie weer over welke metadata wordt verwerkt, welke tabel wordt gebruikt
waarvan een back-up is gemaakt/teruggezet en hoeveel records zijn verwerkt.

-y pad
Leid status-/foutmeldingen om naar het opgegeven pad.

-z
Rapporteer het volledige versienummer voordat u iets anders doet.

BACK-UP OPTIES

-b[ackup_database]
Schakel de back-upmodus in.

-overzetten]
Converteer externe tabellen naar tabellen.

Normaliter worden externe tabellen genegeerd tijdens back-up en herstel. Met -overzetten optie
externe tabellen worden in de back-up opgenomen zoals elke andere reguliere tabel. Wanneer zo'n back-up
wordt hersteld, worden deze eerder externe tabellen gemaakt als normale tabellen.

-factor] num
Blokkerende factor. Uitvoer wordt geschreven in blok van num bytes. Handig bij het maken van een back-up naar een
tape.

-g[arbage_collect]
Verbied afvalinzameling.

Normaal gesproken voert Firebird een vuilnisman uit bij het lezen van de tabellen. Sinds de
back-upproces leest alle tabellen, dit dwingt de afvalinzameling van de hele database af.
In het geval dat u de back-up maakt om deze over de bestaande database te herstellen, is dit afval
verzamelen is niet nodig. Een andere reden om deze opties te gebruiken is als een afvalinzameling
wordt op een andere manier ingeschakeld - hetzij door gfix of de automatische sweep te gebruiken. Deze schakelaar gebruiken
versnelt het back-upproces en kan in sommige gevallen ook helpen bij het maken van een beschadigde back-up
databases.

-negeren]
Negeer records met slechte checksums.

Deze optie mag alleen worden gebruikt bij het maken van back-ups van beschadigde databases.

-l[imbo]
Negeer transacties in het ongewisse.

Deze schakeloptie zorgt ervoor dat het back-upproces transacties in limbostatus negeert.

-m[etadata_only]
Alleen back-up metadata.

Bij deze optie wordt alleen de metadata naar de back-up geschreven. Dit omvat alles
tabellen/views/triggers/indexen/opgeslagen procedures/domeinen/generatoren enz. Er zijn geen tabelgegevens
opgenomen in back-up. Zo'n back-up is handig om een ​​"lege" kopie van een database te maken.

-nt
Gebruik een niet-transporteerbaar back-upformaat.

Standaard wordt een "transporteerbaar" back-upformaat gebruikt. Dit betekent dat u een back-up van een database kunt maken
op little-endian-machine en herstel het op big-endian-machine en vice versa. Door het gebruiken van -nt
de back-up is alleen nuttig op machines met dezelfde "endianness".

-ol[d_beschrijvingen]
sla metadatabeschrijvingen in oude stijl op

HERSTELLEN OPTIES

-c[reate_database]
Schakel de herstelmodus in.

doel database wordt gemaakt en mag nog niet bestaan.

-r[creëer_database] [o[verschrijven]]
Like -creëer_database, maar door toe te voegen beschrijven men kan vervanging van het doelwit forceren
database.

-rep[kant_database]
Like -creëer_database, maar het doel wordt overschreven als het bestaat.

-bu[biedt] num
Negeer bij het maken van de doeldatabase informatie over databasebuffers die zijn opgeslagen in het
back-up en gebruik opgegeven aantal buffers.

-uitbreiden]
Normaal gesproken gebruikt Firebird RLE-compressie voor tekenreeksen wanneer ze op schijf worden opgeslagen. Deze optie
schakelt deze compressie uit.

-inactief]
Herstel indexen in inactieve staat. Dit kan worden gebruikt om een ​​back-up met gegevens te herstellen
niet consistent met externe sleutel/unieke beperkingen.

-doden]
Creëer geen schaduwen bij het herstellen.

Normaal gesproken worden database-schaduwen gemaakt tijdens het herstellen. Deze optie remt dit.

-mo[de] toegang
Herstel de database met gegeven toegang.

Geldige waarden voor toegang zijn alleen lezen en lezen schrijven. Standaard is het herstellen van de database
met zijn oorspronkelijke toegangsmodus.

-n[o_geldigheid]
Herstel de database zonder de geldigheidsbeperkingen. Dit omvat externe sleutel, uniek en
beperkingen controleren. Handig voor het herstellen van een back-up met inconsistente gegevens.

-een per keer]
Commit herstellende transactie na het herstellen van elke tabel.

-pagina grootte] num
Negeer het paginaformaat dat is opgeslagen in de back-up. Geldige waarden voor num zijn 1024, 2048, 4096, 8192,
16384 en 32768.

-gebruik_[alle_ruimte]
Normaal gesproken reserveert Fireburd wat ruimte op elke gegevenspagina voor verder gebruik. Dit voorbehouden
ruimte wordt gebruikt voor nieuw ingevoegde gegevens en voor het bewaren van oudere versies van de gegevens. Hebben
hiervoor gereserveerde ruimte "nabij" de gegevens versnelt wijzigingen. Als de
database zal voornamelijk worden gebruikt voor leesbewerkingen, met vermelding van -gebruik_alle_ruimte zal wat besparen
ruimte.

Deze optie is met name handig bij het herstellen van een alleen-lezen database, aangezien deze alleen-lezen is
databases hebben geen extra ruimte nodig voor back-versies.

-fix_fss_metadata karakterset
Probeer bij het herstellen van metadata, in het geval dat het geen geldige UTF8 is, te converteren van de gespecificeerde
karakterset. Handig wanneer tabelbeschrijvingen worden gegeven in sommige nationale niet-UTF8
codering, wat mogelijk was met Firebird vóór versie 2.5

-fix_fss_gegevens karakterset
Bij het herstellen van tabelgegevens, in het geval dat een kolom is gedefinieerd met de UNICODE_FSS-tekenset
geen geldige UTF8 bevat (wat mogelijk was met versies van Firebird ouder dan 2.5), probeer het dan
converteer de gegevens van de opgegeven tekenset.

HERSTELLEN TO MEERDERE BESTANDEN DATABASE

Voorheen kon Firebird niet werken met 64-bits bestandsaanwijzers, wat een beperking betekende
databases tot (ongeveer) 2GB per database.

Aangezien 2 GB al jaren niet veel gegevens meer is, is er een mechanisme om de database te verspreiden
in meerdere bestanden. Op deze manier kunt u meerdere bestanden van 2 GB hebben, met daarin al uw gegevens.

Bij het herstellen naar een database met meerdere bestanden heeft het doelargument de volgende vorm: bestand_1 pagina's_1
bestand_2 pagina's_2 ... bestand_N-1 pagina's_N-1 bestand_N

Elke pagina's_n geeft aan hoeveel pagina's er maximaal moeten worden ingevoerd bestand_n. Laatste in de lijst is een
bestandsnaam zonder paginalimiet - het zal alle pagina's bevatten die er niet in passen bestand_N-1. Merk op dat
pagina's_n wordt gemeten in pagina's, niet in bytes, dus het maximaal mogelijke aantal hangt af van de pagina
grootte.

Stel je voor dat je een bestandssysteem hebt (of een oud besturingssysteem) dat alleen 32-bits bestandsaanwijzers ondersteunt.
Om veilig te spelen, besluit u uw database op te splitsen in bestanden van 2 GB. Als het paginaformaat voor de
database 8192 is, dan kan elk bestand maximaal 2*1024*1024*1024/8192 = 262144 pagina's bevatten.

NOTITIE
Merk op dat Firebird op een recent besturingssysteem en bestandssysteem 64-bit bestandsaanwijzers kan renderen
databases met meerdere bestanden overbodig.

MILIEU

Net als alle andere Firebird-hulpprogramma's accepteert gbak de volgende omgevingsvariabelen:

ISC_USER standaardwaarde voor -gebruiker optie

ISC_ROLE standaardwaarde voor -rol optie

ISC_WACHTWOORD
standaardwaarde voor -wachtwoord optie

Voorbeelden

In alle voorbeelden -gebruiker, -rol en -wachtwoord opties zijn voor de duidelijkheid weggelaten. In een echt
wereldsituatie moeten ze (of hun overeenkomstige omgevingsvariabelen) worden gebruikt.

Merk op dat de hier gebruikte bestandsnaamextensies slechts worden aanbevolen. Uniforme extensies gebruiken
schema helpt het bestandstype te raden door gewoon naar de extensie te kijken.

Hier zijn enkele veelgebruikte extensies:

.fdb Firebird-database

.gdb Firebird-database, verouderde extensie uit de tijd dat Firebird Interbase was.
gdb komt eigenlijk uit de Grotton-database, genoemd naar het bedrijf dat het heeft gemaakt
de software in 1984.

.fdb.2 Tweede bestand van database met meerdere bestanden

.fdb.3 Derde bestand van database met meerdere bestanden

.fdb.N N-th bestand van database met meerdere bestanden

.fbk Firebird-back-upbestand

.gbk Legacy-extensie voor back-upbestand

.fbk.gz Gzipped back-upbestand

backup a databank in a gecomprimeerde formaat:
gbak -b db-srv:/database.fdb /dev/stdout | gzip > /bestand.fbk.gz

herstellen a databank in nieuwe bestandsnaam:
zcat /bestand.fbk.gz | gbak -c /dev/stdin db-srv:/nieuwe-database.fdb

Gebruik gbak online met behulp van onworks.net-services