RESTORE utasítások – HEADERONLY (Transact-SQL)

A következőkre vonatkozik:SQL ServerAzure SQL Managed Instance

Egy eredményhalmazt ad vissza, amely tartalmazza az SQL Server adott biztonsági mentési eszközén található összes biztonsági mentési csoport fejlécadatait.

Megjegyzés:

Az argumentumok leírását a RESTORE argumentumok (Transact-SQL) című témakörben találhatja meg.

Transact-SQL szintaxis konvenciók

Szemantika

RESTORE HEADERONLY
FROM <backup_device>
[ WITH
    {
    -- Backup set options
    FILE = { backup_set_file_number | @backup_set_file_number }
    | PASSWORD = { password | @password_variable }
    | [ METADATA_ONLY | SNAPSHOT ] [ DBNAME = { database_name | @database_name_variable } ]

    -- Media set options
    | MEDIANAME = { media_name | @media_name_variable }
    | MEDIAPASSWORD = { mediapassword | @mediapassword_variable }

    -- Error management options
    | { CHECKSUM | NO_CHECKSUM }
    | { STOP_ON_ERROR | CONTINUE_AFTER_ERROR }

    -- Tape options
    | { REWIND | NOREWIND }
    | { UNLOAD | NOUNLOAD }
    } [ , ...n ]
]
[ ; ]

<backup_device> ::=
{
   { logical_backup_device_name |
     @logical_backup_device_name_var }
   | { DISK | TAPE | URL } = { 'physical_backup_device_name' |
       @physical_backup_device_name_var }
}

Megjegyzés:

URL Az Azure Blob Storage helyének és fájlnevének megadására használt formátum, amely az SQL Server 2012 (11.x) SP 1 CU 2-től kezdve támogatott. Bár az Azure Storage szolgáltatás, a megvalósítás hasonló a lemezhez és a szalaghoz, így a három eszköz egységes és zökkenőmentes visszaállítási élményt biztosít.

Érvek

Az argumentumok leírását a RESTORE HEADERONLYRESTORE argumentumok (Transact-SQL) című témakörben találhatja meg.

Eredményhalmazok

Egy adott eszköz minden biztonsági mentésekor a kiszolgáló a következő oszlopokkal küld egy fejlécinformációs sort:

Oszlop név	Adattípus	Az SQL Server biztonsági mentési készleteinek leírása
BackupName 1	Nvarchar(128)	Biztonsági mentési csoport neve.
BackupDescription	nvarchar(255)	A biztonsági mentési csoport leírása. Null érték is lehet.
BackupType	kisméretű	Biztonsági mentés típusa: 1 = Adatbázis 2 = Tranzakciónapló 4 = Fájl 5 = Differenciáladatbázis 6 = Különbségfájl 7 = Részleges 8 = Differenciál részleges
ExpirationDate	datetime	A biztonsági mentési csoport lejárati dátuma.
Compressed	bit	Hogy a biztonsági mentési csoport szoftveralapú tömörítéssel van-e tömörítve: 0 = Nem 1 = Igen
Position	kisméretű	A biztonsági mentési csoport helye a kötetben (a FILE = beállítással való használatra).
DeviceType	tinyint	A biztonsági mentési művelethez használt eszköznek megfelelő szám. Lemez: - 2 = Logikai - 102 = Fizikai Szalag: - 5 = logikai - 105 = Fizikai Virtuális eszköz: - 7 = Logikai - 107 = fizikai URL-cím: - 9 = Logikai - 109 = Fizikai A logikai eszköznevek és az eszközszámok a következőben sys.backup_devicestalálhatók: . További információ: sys.backup_devices.
UserName	Nvarchar(128)	A biztonsági mentési műveletet végrehajtó felhasználónév.
ServerName	Nvarchar(128)	A biztonsági mentési csoportot megíró kiszolgáló neve.
DatabaseName	Nvarchar(128)	A biztonsági másolatot készítő adatbázis neve.
DatabaseVersion	Int	Annak az adatbázisnak a verziója, amelyből a biztonsági mentést létrehozták.
DatabaseCreationDate	datetime	Az adatbázis létrehozásának dátuma és időpontja.
BackupSize	numerikus(20,0)	A biztonsági mentés mérete bájtban.
FirstLSN	numerikus(25,0)	A biztonsági mentési készlet első naplórekordjának naplóütemezési száma.
LastLSN	numerikus(25,0)	A következő naplórekord naplóütemezési száma a biztonsági mentési csoport után.
CheckpointLSN	numerikus(25,0)	A legutóbbi ellenőrzőpont naplóütemezési száma a biztonsági mentés létrehozásakor.
DatabaseBackupLSN	numerikus(25,0)	A legutóbbi teljes adatbázis biztonsági mentésének naplóütemezési száma. DatabaseBackupLSN az "ellenőrzőpont kezdete", amely a biztonsági mentés indításakor aktiválódik. Ez az LSN egybeesik FirstLSN azzal, ha a biztonsági mentés az adatbázis inaktív állapotában történik, és nincs replikáció konfigurálva.
BackupStartDate	datetime	A biztonsági mentési művelet megkezdésének dátuma és időpontja.
BackupFinishDate	datetime	A biztonsági mentési művelet befejezésének dátuma és időpontja.
SortOrder	kisméretű	Kiszolgáló rendezési sorrendje. Ez az oszlop csak az adatbázis biztonsági mentésére érvényes. Visszamenőleges kompatibilitást biztosít.
CodePage	kisméretű	A kiszolgáló által használt kiszolgálókódlap vagy karakterkészlet.
UnicodeLocaleId	Int	A Unicode karakteradat-rendezéshez használt kiszolgálói Unicode területi azonosító konfigurációs beállítás. Visszamenőleges kompatibilitást biztosít.
UnicodeComparisonStyle	Int	A Kiszolgáló Unicode összehasonlító stílusának konfigurációs beállítása, amely további vezérlést biztosít a Unicode-adatok rendezése felett. Visszamenőleges kompatibilitást biztosít.
CompatibilityLevel	tinyint	Annak az adatbázisnak a kompatibilitásiszint-beállítása, amelyből a biztonsági mentést létrehozták.
SoftwareVendorId	Int	Szoftverszállító azonosító száma. SQL Server esetén ez a 4608 szám (vagy hexadecimális 0x1200).
SoftwareVersionMajor	Int	A biztonsági mentési csoportot létrehozó kiszolgáló főverziószáma.
SoftwareVersionMinor	Int	A biztonsági mentési csoportot létrehozó kiszolgáló alverziószáma.
SoftwareVersionBuild	Int	A biztonsági mentési csoportot létrehozó kiszolgáló buildszáma.
MachineName	Nvarchar(128)	A biztonsági mentési műveletet végrehajtó számítógép neve.
Flags	Int	Az egyes jelzők bit jelentései: - 1 = A napló biztonsági mentése tömegesen naplózott műveleteket tartalmaz. - 2 = Pillanatkép biztonsági mentése. - 4 = Az adatbázis írásvédett volt biztonsági másolat készítésekor. - 8 = Az adatbázis egyfelhasználós módban volt biztonsági másolat készítésekor. - 16 = A biztonsági mentés biztonsági mentési ellenőrzőösszegeket tartalmaz. - 32 = Az adatbázis sérült volt biztonsági mentéskor, de a biztonsági mentési műveletet a hibák ellenére is folytatni kellett. - 64 = Tail log backup. - 128 = A tail napló biztonsági mentése hiányos metaadatokkal. - 256 = Tail log backup with NORECOVERY. Fontos: Azt javasoljuk, hogy ahelyett Flags , hogy az egyes logikai oszlopokat használnánk (ebben a táblában kezdődjön HasBulkLoggedData és végződjön IsCopyOnly ).
BindingID	uniqueidentifier	Az adatbázis kötésazonosítója. Ez az érték a következőnek database_guidfelel megsys.database_recovery_status: . Az adatbázis visszaállításakor egy új érték lesz hozzárendelve. Lásd még FamilyGUID.
RecoveryForkID	uniqueidentifier	A befejező helyreállítási elágazás azonosítója. Ez az oszlop a last_recovery_fork_guid táblának felel meg. Az adatmentések RecoveryForkID esetében az egyenlő FirstRecoveryForkID.
Collation	Nvarchar(128)	Az adatbázis által használt rendezés.
FamilyGUID	uniqueidentifier	Létrehozáskor az eredeti adatbázis azonosítója. Ez az érték változatlan marad az adatbázis visszaállításakor.
HasBulkLoggedData	bit	1 = Tömegesen naplózott műveleteket tartalmazó napló biztonsági mentése.
IsSnapshot	bit	1 = Pillanatkép biztonsági mentése.
IsReadOnly	bit	1 = Az adatbázis írásvédett volt biztonsági másolat készítésekor.
IsSingleUser	bit	1 = Az adatbázis biztonsági másolat készítésekor egyfelhasználós volt.
HasBackupChecksums	bit	1 = A biztonsági mentés biztonsági mentési ellenőrzőösszegeket tartalmaz.
IsDamaged	bit	1 = Az adatbázis sérült, amikor biztonsági másolatot készít, de a biztonsági mentési művelet a hibák ellenére is folytatódik.
BeginsLogChain	bit	1 = Ez az első a naplók biztonsági mentéseinek folyamatos láncában. A naplólánc az adatbázis létrehozása után készült első napló biztonsági mentésével kezdődik, vagy amikor az Egyszerűről a Teljes vagy Bulk-Logged helyreállítási modellre vált.
HasIncompleteMetaData	bit	1 = A tail-log biztonsági mentése hiányos metaadatokkal. A hiányos biztonsági mentési metaadatokkal rendelkező tail-log biztonsági mentésekről további információt Tail-Log biztonsági másolatok (SQL Server) című témakörben talál.
IsForceOffline	bit	1 = A NORECOVERY használatával készített biztonsági mentés; az adatbázist biztonsági mentéssel offline állapotba hozta.
IsCopyOnly	bit	1 = Csak másolati biztonsági másolat. A csak másolással történő biztonsági mentés nem befolyásolja az adatbázis általános biztonsági mentési és visszaállítási eljárásait. További információ: Copy-Only biztonsági másolatok (SQL Server).
FirstRecoveryForkID	uniqueidentifier	A kezdő helyreállítási elágazás azonosítója. Ez az oszlop a first_recovery_fork_guid táblának felel meg. Az adatmentések FirstRecoveryForkID esetében az egyenlő RecoveryForkID.
ForkPointLSN	numerikus(25,0)	Ha FirstRecoveryForkID nem egyenlő, RecoveryForkIDakkor ez az érték az elágazáspont naplóütemezési száma. Ellenkező esetben ez az érték NULL.
RecoveryModel	nvarchar(60)	Az adatbázis helyreállítási modellje, az alábbiak egyike: -TELE - BULK-LOGGED -EGYSZERŰ
DifferentialBaseLSN	numerikus(25,0)	Egy-alapú különbségi biztonsági mentés esetén az érték megegyezik a FirstLSN különbségi alap értékével. Az LSN-ekkel végzett módosítások nagyobbak vagy egyenlők DifferentialBaseLSN a különbségi értékben. Több-alapú különbség esetén az érték NULL, az alap LSN-t pedig a fájl szintjén kell meghatározni. További információ: RESTORE FILELISTONLY. A nem különbözeti biztonsági mentési típusok esetében az érték mindig NULL. További információ: Különbözeti Biztonsági Másolatok (SQL Server).
DifferentialBaseGUID	uniqueidentifier	Az egy-alapú különbségi biztonsági mentés esetében az érték a különbségi alap egyedi azonosítója. Több-alapú különbség esetén az érték NULL, a különbségi bázist pedig fájlonként kell meghatározni. A nem különbözeti biztonsági mentési típusok esetében az érték NULL.
BackupTypeDescription	nvarchar(60)	Biztonsági mentés típusa sztringként, az alábbiak egyike: -ADATBÁZIS -TRANZAKCIÓNAPLÓ - FÁJL VAGY FÁJLCSOPORT - ADATBÁZIS-KÜLÖNBSÉG - FÁJLKÜLÖNBSÉG RÉSZLEGES - RÉSZLEGES KÜLÖNBSÉG
BackupSetGUID	uniqueidentifier	A biztonsági mentési csoport egyedi azonosítószáma, amellyel az adathordozón azonosítható. Null érték is lehet.
CompressedBackupSize	bigint	A biztonsági mentési csoport bájtszáma. Tömörítetlen biztonsági mentések esetén ez az érték megegyezik BackupSizea . A tömörítési arány kiszámításához használja CompressedBackupSize és BackupSize. A msdb frissítés során ez az érték úgy van beállítva, hogy megfeleljen az BackupSize oszlop értékének.
containment	tinyint	A: SQL Server 2012 (11.x) és újabb verziókra vonatkozik. Az adatbázis elszigetelési állapotát jelzi. 0 = az adatbázis-elszigetelés ki van kapcsolva 1 = az adatbázis részleges elszigetelés alatt áll
KeyAlgorithm	nvarchar(32)	A következőkre vonatkozik: SQL Server 2014 (12.x) CU 1 és újabb verziók. A biztonsági mentés titkosításához használt titkosítási algoritmus. NO_Encryption azt jelzi, hogy a biztonsági mentés nem volt titkosítva. Ha a helyes érték nem határozható meg, az értéknek NULL értékűnek kell lennie.
EncryptorThumbprint	varbinary(20)	A következőkre vonatkozik: SQL Server 2014 (12.x) CU 1 és újabb verziók. A titkosító ujjlenyomata, amely a tanúsítvány vagy az aszimmetrikus kulcs megkereséséhez használható az adatbázisban. Ha a biztonsági mentés nem lett titkosítva, ez az érték NULL.
EncryptorType	nvarchar(32)	A következőkre vonatkozik: SQL Server 2014 (12.x) CU 1 és újabb verziók. A használt titkosító típusa: tanúsítvány vagy aszimmetrikus kulcs. Ha a biztonsági mentés nem lett titkosítva, ez az érték NULL.
LastValidRestoreTime	datetime	Az: SQL Server 2022 (16.x) és újabb verziókra vonatkozik. Az utolsó érvényes visszaállítási idő.
TimeZone	nvarchar(32)	Az: SQL Server 2022 (16.x) és újabb verziókra vonatkozik. Annak a kiszolgálónak az időzónája, amelyről a biztonsági mentés készült.
CompressionAlgorithm	nvarchar(32)	Az: SQL Server 2022 (16.x) és újabb verziókra vonatkozik. A biztonsági mentési fájl tömörítéséhez használt tömörítési algoritmust azonosítja. Az alapértelmezett érték a MS_XPRESS. További információ: BACKUP.

¹ Ha a biztonsági mentési csoportokhoz jelszavak vannak definiálva, csak arra a biztonságimásolat-készletre vonatkozóan jelenít meg teljes információt, RESTORE HEADERONLY amelynek jelszava megegyezik a parancs megadott PASSWORD beállításával. RESTORE HEADERONLY A nem védett biztonsági mentési csoportok teljes adatait is megjeleníti. Az BackupName adathordozó többi jelszóval védett biztonsági mentési csoportjának oszlopa a null értékre 'Password Protected'van állítva.

Megjegyzések

Az ügyfél egy RESTORE HEADERONLY adott biztonsági mentési eszköz összes biztonsági mentésének fejlécadatait lekérheti. A biztonsági mentési eszköz minden biztonsági mentése esetén a kiszolgáló sorként küldi el a fejlécadatokat.

RESTORE HEADERONLY az adathordozón lévő összes biztonsági mentési készletet megvizsgálja. Ezért a nagy kapacitású szalagos meghajtók használatakor ennek az eredményhalmaznak a létrehozása eltarthat egy ideig. Ha gyorsan meg szeretné tekinteni az adathordozót anélkül, hogy minden biztonsági mentési csoportról információt kap, használja RESTORE LABELONLY vagy adja meg FILE = <backup_set_file_number>.

A Microsoft Tape Format jellegéből adódóan más szoftverprogramok biztonsági mentési készletei is helyet foglalhatnak ugyanazon az adathordozón, mint az SQL Server biztonsági mentési készletei. Az eredményhalmaz a RESTORE HEADERONLY többi biztonsági mentési csoporthoz tartalmaz egy sort.

Biztonság

A biztonsági mentési művelet opcionálisan megadhat jelszavakat egy médiakészlethez, egy biztonsági mentési csoporthoz vagy mindkettőhöz. Ha egy médiakészleten vagy biztonsági mentési készleten jelszó van meghatározva, a RESTORE utasításban meg kell adnia a megfelelő jelszót vagy jelszavakat. Ezek a jelszavak megakadályozzák a jogosulatlan visszaállítási műveleteket és a biztonsági mentési csoportok jogosulatlan hozzáfűzését a médiához SQL Server-eszközökkel. A jelszó azonban nem akadályozza meg a média felülírását a BACKUP utasítás FORMAT beállításával.

Fontos

A jelszó által biztosított védelem gyenge. Célja, hogy megakadályozza az SQL Server-eszközökkel való helytelen visszaállítást az arra jogosult vagy jogosulatlan felhasználók számára. Ez nem akadályozza meg a biztonsági mentési adatok más módon történő beolvasását vagy a jelszó cseréjét. Ez a funkció az SQL Server egy későbbi verziójában lesz eltávolítva. Ne használja ezt a funkciót az új fejlesztési munkában, és tervezze meg a funkciót jelenleg használó alkalmazások módosítását. A biztonsági mentések védelmének ajánlott eljárása a biztonsági mentési szalagok biztonságos helyen történő tárolása vagy a megfelelő hozzáférés-vezérlési listákkal (ACL-ekkel) védett lemezfájlok biztonsági mentése. Az ACL-eket azon a címtárgyökeren kell beállítani, amely alatt a biztonsági másolatok létrejönnek.

Engedélyek

A biztonsági mentési csoportra vagy biztonsági mentési eszközre vonatkozó információk beszerzéséhez CREATE DATABASE-engedély szükséges. További információ: GRANT-adatbázisengedélyek (Transact-SQL).

Példák

Az alábbi példa a lemezfájl C:\AdventureWorks-FullBackup.bakfejlécében található adatokat adja vissza.

RESTORE HEADERONLY
FROM DISK = N'C:\AdventureWorks-FullBackup.bak';
GO

Lásd még

• BIZTONSÁGI MENTÉS (Transact-SQL)
• biztonsági másolatkészlet (Transact-SQL)
• VISSZAÁLLÍTÁS VISSZATEKERÉS (Transact-SQL)
• VISSZAÁLLÍTÁS ELLENŐRZÉSE (Transact-SQL)
• VISSZAÁLLÍTÁS (Transact-SQL)
• Biztonsági Mentési Előzmények és Fejlécadatok (SQL Server)
• Biztonsági mentési ellenőrzőösszegek engedélyezése vagy letiltása mentés vagy visszaállítás során (SQL Server)
• médiakészletek, médiacsaládok és biztonsági mentési csoportok (SQL Server)
• helyreállítási modellek (SQL Server)