RESTORE DATABASE 命令

示例

1. 在以下示例中，数据库 WSDB 是在所有 4 数据库分区上定义的，编号为 0-3。 可从所有数据库分区访问路径 /dev3/backup 。 可以从 /dev3/backup 获取下列脱机备份映像：

       wsdb.0.db2inst1.DBPART000.200802241234.001
       wsdb.0.db2inst1.DBPART001.200802241234.001
       wsdb.0.db2inst1.DBPART002.200802241234.001
       wsdb.0.db2inst1.DBPART003.200802241234.001

   要先复原目录分区，然后从 /dev3/backup 目录复原 WSDB 数据库的所有其他数据库分区，从其中一个数据库分区发出下列命令：

       db2_all '<<+0< db2 RESTORE DATABASE wsdb FROM /dev3/backup 
       TAKEN AT 200802241234 
         INTO wsdb REPLACE EXISTING'
       db2_all '<<+1< db2 RESTORE DATABASE wsdb FROM /dev3/backup 
       TAKEN AT 200802241234 
         INTO wsdb REPLACE EXISTING'
       db2_all '<<+2< db2 RESTORE DATABASE wsdb FROM /dev3/backup 
       TAKEN AT 200802241234 
         INTO wsdb REPLACE EXISTING'
       db2_all '<<+3< db2 RESTORE DATABASE wsdb FROM /dev3/backup 
       TAKEN AT 200802241234 
         INTO wsdb REPLACE EXISTING'

   db2_all 实用程序将对每个指定的数据库分区发出复原命令。 使用 db2_all 执行复原时，应始终指定 REPLACE EXISTING 和/或 WITHOUT PROMPTING。 否则，如果有提示，那么该操作看起来像挂起一样。 这是因为 db2_all 不支持用户提示。
2. 以下是一个典型的重定向复原方案，用于别名为 MYDB 的数据库：
   1. 发出带有 REDIRECT 选项的 RESTORE DATABASE 命令。

         restore db mydb replace existing redirect

      成功完成步骤 1 之后且在完成步骤 3 之前，通过发出以下命令来中止复原操作：

         restore db mydb abort

   2. 对必须重新定义容器的每个表空间发出 SET TABLESPACE CONTAINERS 命令。 例如：

         set tablespace containers for 5 using
            (file 'f:\ts3con1' 20000, file 'f:\ts3con2' 20000)

      要验证复原数据库的容器是否是在此步骤中指定的那些容器，请发出 LIST TABLESPACE CONTAINERS 命令。
   3. 在成功完成了步骤 1 和 2 之后，发出：

         restore db mydb continue

      这是“重定向复原”操作的最后一步。
   4. 如果步骤 3 失败，或者如果中止了复原操作，那么可从步骤 1 开始重新启动重定向的复原。
3. 以下示例是对可恢复数据库每周进行的增量备份策略的样本。 包括一个每周进行的完整数据库备份操作、一个每天进行的非累积（差异）备份操作以及一个在每周中期进行的累积（增量）备份操作：

      (Sun) backup db mydb use TSM
      (Mon) backup db mydb online incremental delta use TSM
      (Tue) backup db mydb online incremental delta use TSM
      (Wed) backup db mydb online incremental use TSM
      (Thu) backup db mydb online incremental delta use TSM
      (Fri) backup db mydb online incremental delta use TSM
      (Sat) backup db mydb online incremental use TSM

   要对在星期五早上创建的映像自动进行数据库复原，请发出：

      restore db mydb incremental automatic use TSM taken at (Fri)

   要对在星期五早上创建的映像手工进行数据库复原，请发出：

          restore db mydb incremental use TSM taken at (Fri)
          restore db mydb incremental use TSM taken at (Sun)
          restore db mydb incremental use TSM taken at (Wed)
          restore db mydb incremental use TSM taken at (Thu)
          restore db mydb incremental use TSM taken at (Fri)

4. 要产生包括日志的备份映像，以传送至远程站点：

      backup db sample online to /dev3/backup include logs

   要复原备份映像，请提供 LOGTARGET 路径并在 ROLLFORWARD 期间指定此路径：

   restore db sample from /dev3/backup logtarget /dev3/logs
      rollforward db sample to end of logs and stop overflow log path ( /dev3/logs )

5. 要仅从包含日志的备份映像中检索活动日志文件，请执行以下操作:

      restore db sample logs from /dev3/backup logtarget /dev3/logs

6. 在以下示例中，在数据库 SAMPLE 上为备份操作指定了三个完全相同的目标目录。 数据将被并行地备份到这三个目标目录中，并且将生成三个备份映像，其扩展名分别为 .001、.002 和 .003。

   backup db sample to /dev3/backup, /dev3/backup, /dev3/backup

   要从目标目录恢复备份映像，请发出以下命令：

   restore db sample from /dev3/backup, /dev3/backup, /dev3/backup

7. 可以使用 USE TSM OPTIONS 关键字指定 TSM 信息，以供复原操作使用。 在 Windows 平台上，省略 -fromowner 选项。
   • 指定定界字符串：

     restore db sample use TSM options '"-fromnode=bar -fromowner=dmcinnis"'

   • 指定标准文件：

     restore db sample use TSM options @/u/dmcinnis/myoptions.txt

     文件 myoptions.txt 包含以下信息：-fromnode=bar -fromowner=dmcinnis
8. 以下是一个使用新存储路径来简单复原启用了多分区自动存储器的数据库的示例。 数据库最初使用一个存储路径 /myPath0: 来创建
   • 在目录分区上发出：restore db mydb on /myPath1,/myPath2
   • 在所有非目录分区上发出：restore db mydb
9. 通过在非自动存储器数据库上执行以下命令来运行脚本:

   restore db sample from /home/jseifert/backups taken at 20050301100417 redirect 
   generate script SAMPLE_NODE0000.clp

   输出将类似于以下示例:

   -- ****************************************************************************
   -- ** automatically created redirect restore script
   -- ****************************************************************************
   UPDATE COMMAND OPTIONS USING S ON Z ON SAMPLE_NODE0000.out V ON;
   SET CLIENT ATTACH_DBPARTITIONNUM  0;
   SET CLIENT CONNECT_DBPARTITIONNUM 0;
   -- ****************************************************************************
   -- ** initialize redirected restore
   -- ****************************************************************************
   RESTORE DATABASE SAMPLE
   -- USER  ‘<username>'
   -- USING ‘<password>'
   FROM ‘/home/jseifert/backups'
   TAKEN AT 20050301100417
   -- DBPATH ON ‘<target-directory>'
   INTO SAMPLE
   -- NEWLOGPATH DEFAULT
   -- WITH <num-buff> BUFFERS
   -- BUFFER <buffer-size>
   -- REPLACE HISTORY FILE
   -- REPLACE EXISTING
   REDIRECT
   -- PARALLELISM <n>
   -- WITHOUT ROLLING FORWARD
   -- WITHOUT PROMPTING
   ;
   -- ****************************************************************************
   -- ** tablespace definition
   -- ****************************************************************************
   -- ****************************************************************************
   -- ** Tablespace name                            = SYSCATSPACE
   -- **   Tablespace ID                            = 0
   -- **   Tablespace Type                          = System managed space
   -- **   Tablespace Content Type                  = Any data
   -- **   Tablespace Page size (bytes)             = 4096
   -- **   Tablespace Extent size (pages)           = 32
   -- **   Using automatic storage                  = No
   -- **   Total number of pages                    = 5572
   -- ****************************************************************************
   SET TABLESPACE CONTAINERS FOR 0
   -- IGNORE ROLLFORWARD CONTAINER OPERATIONS
   USING (
     PATH   ‘SQLT0000.0'
   );
   -- ****************************************************************************
   -- ** Tablespace name                            = TEMPSPACE1
   -- **   Tablespace ID                            = 1
   -- **   Tablespace Type                          = System managed space
   -- **   Tablespace Content Type                  = System Temporary data
   -- **   Tablespace Page size (bytes)             = 4096
   -- **   Tablespace Extent size (pages)           = 32
   -- **   Using automatic storage                  = No
   -- **   Total number of pages                    = 0
   -- ****************************************************************************
   SET TABLESPACE CONTAINERS FOR 1
   -- IGNORE ROLLFORWARD CONTAINER OPERATIONS
   USING (
     PATH   ‘SQLT0001.0'                                                           
   );
   -- ****************************************************************************
   -- ** Tablespace name                            = USERSPACE1
   -- **   Tablespace ID                            = 2
   -- **   Tablespace Type                          = System managed space
   -- **   Tablespace Content Type                  = Any data
   -- **   Tablespace Page size (bytes)             = 4096
   -- **   Tablespace Extent size (pages)           = 32
   -- **   Using automatic storage                  = No
   -- **   Total number of pages                    = 1
   -- ****************************************************************************
   SET TABLESPACE CONTAINERS FOR 2
   -- IGNORE ROLLFORWARD CONTAINER OPERATIONS
   USING (
     PATH   ‘SQLT0002.0'                                                            
   );
   -- ****************************************************************************
   -- ** Tablespace name                            = DMS
   -- **   Tablespace ID                            = 3
   -- **   Tablespace Type                          = Database managed space
   -- **   Tablespace Content Type                  = Any data
   -- **   Tablespace Page size (bytes)             = 4096
   -- **   Tablespace Extent size (pages)           = 32
   -- **   Using automatic storage                  = No
   -- **   Auto-resize enabled                      = No
   -- **   Total number of pages                    = 2000
   -- **   Number of usable pages                   = 1960
   -- **   High water mark (pages)                  = 96
   -- ****************************************************************************
   SET TABLESPACE CONTAINERS FOR 3
   -- IGNORE ROLLFORWARD CONTAINER OPERATIONS
   USING (
     FILE   /tmp/dms1                                                    1000
   , FILE   /tmp/dms2                                                    1000
   );
   -- ****************************************************************************
   -- ** Tablespace name                            = RAW
   -- **   Tablespace ID                            = 4
   -- **   Tablespace Type                          = Database managed space
   -- **   Tablespace Content Type                  = Any data
   -- **   Tablespace Page size (bytes)             = 4096
   -- **   Tablespace Extent size (pages)           = 32
   -- **   Using automatic storage                  = No
   -- **   Auto-resize enabled                      = No
   -- **   Total number of pages                    = 2000
   -- **   Number of usable pages                   = 1960
   -- **   High water mark (pages)                  = 96
   -- ****************************************************************************
   SET TABLESPACE CONTAINERS FOR 4
   -- IGNORE ROLLFORWARD CONTAINER OPERATIONS
   USING (
     DEVICE ‘/dev/hdb1'                                          1000
   , DEVICE ‘/dev/hdb2'                                          1000
   );
   -- ****************************************************************************
   -- ** start redirect restore
   -- ****************************************************************************
   RESTORE DATABASE SAMPLE CONTINUE;
   -- ****************************************************************************
   -- ** end of file
   -- ****************************************************************************

10. 自动存储器数据库上以下命令的脚本输出：

    restore db test from /home/jseifert/backups taken at 20050304090733 redirect
    generate script TEST_NODE0000.clp

    输出将类似于以下示例:

    -- ****************************************************************************
    -- ** automatically created redirect restore script
    -- ****************************************************************************
    UPDATE COMMAND OPTIONS USING S ON Z ON TEST_NODE0000.out V ON;
    SET CLIENT ATTACH_MEMBER  0;
    SET CLIENT CONNECT_MEMBER 0;
    -- ****************************************************************************
    -- ** initialize redirected restore
    -- ****************************************************************************
    RESTORE DATABASE TEST
    -- USER  ‘<username>'
    -- USING ‘<password>'
    FROM ‘/home/jseifert/backups'
    TAKEN AT 20050304090733
    ON ‘/home/jseifert'
    -- DBPATH ON <target-directory>
    INTO TEST
    -- NEWLOGPATH DEFAULT
    -- WITH <num-buff> BUFFERS
    -- BUFFER <buffer-size>
    -- REPLACE HISTORY FILE
    -- REPLACE EXISTING
    REDIRECT
    -- PARALLELISM <n>
    -- WITHOUT ROLLING FORWARD
    -- WITHOUT PROMPTING
    ;
    -- *****************************************************************************
    -- ** storage group definition
    -- **   Default storage group ID                 = 0
    -- **   Number of storage groups                 = 3
    -- *****************************************************************************
    -- *****************************************************************************
    -- ** Storage group name                         = SG_DEFAULT
    -- **   Storage group ID                         = 0
    -- **   Data tag                                 = None
    -- *****************************************************************************
    -- SET STOGROUP PATHS FOR SG_DEFAULT
    -- ON '/hdd/path1'
    -- ,  '/hdd/path2'
    -- ;
    -- *****************************************************************************
    -- ** Storage group name                         = SG_HOT
    -- **   Storage group ID                         = 1
    -- **   Data tag                                 = 1
    -- *****************************************************************************
    -- SET STOGROUP PATHS FOR SG_HOT
    -- ON '/ssd/fs1'
    -- ,  '/ssd/fs2'
    -- ;
    -- *****************************************************************************
    -- ** Storage group name                         = SG_COLD
    -- **   Storage group ID                         = 2
    -- **   Data tag                                 = 9
    -- *****************************************************************************
    -- SET STOGROUP PATHS FOR SG_COLD
    -- ON '/hdd/slowpath1'
    -- ;
    -- ****************************************************************************
    -- ** tablespace definition
    -- ****************************************************************************
    -- ****************************************************************************
    -- ** Tablespace name                            = SYSCATSPACE
    -- **   Tablespace ID                            = 0
    -- **   Tablespace Type                          = Database managed space
    -- **   Tablespace Content Type                  = Any data
    -- **   Tablespace Page size (bytes)             = 4096
    -- **   Tablespace Extent size (pages)           = 4
    -- **   Using automatic storage                  = Yes
    -- **   Storage group ID                         = 0
    -- **   Source storage group ID                  = -1
    -- **   Data tag                                 = None
    -- **   Auto-resize enabled                      = Yes
    -- **   Total number of pages                    = 6144
    -- **   Number of usable pages                   = 6140
    -- **   High water mark (pages)                  = 5968
    -- ****************************************************************************
    -- ****************************************************************************
    -- ** Tablespace name                            = TEMPSPACE1
    -- **   Tablespace ID                            = 1
    -- **   Tablespace Type                          = System managed space
    -- **   Tablespace Content Type                  = System Temporary data
    -- **   Tablespace Page size (bytes)             = 4096
    -- **   Tablespace Extent size (pages)           = 32
    -- **   Using automatic storage                  = Yes
    -- **   Total number of pages                    = 0
    -- ****************************************************************************
    -- ****************************************************************************
    -- ** Tablespace name                            = USERSPACE1
    -- **   Tablespace ID                            = 2
    -- **   Tablespace Type                          = Database managed space
    -- **   Tablespace Content Type                  = Any data
    -- **   Tablespace Page size (bytes)             = 4096
    -- **   Tablespace Extent size (pages)           = 32
    -- **   Using automatic storage                  = Yes
    -- **   Storage group ID                         = 1
    -- **   Source storage group ID                  = -1
    -- **   Data tag                                 = 1
    -- **   Auto-resize enabled                      = Yes
    -- **   Total number of pages                    = 256
    -- **   Number of usable pages                   = 224
    -- **   High water mark (pages)                  = 96
    -- ****************************************************************************
    -- ****************************************************************************
    -- ** Tablespace name                            = DMS
    -- **   Tablespace ID                            = 3
    -- **   Tablespace Type                          = Database managed space
    -- **   Tablespace Content Type                  = Any data
    -- **   Tablespace Page size (bytes)             = 4096
    -- **   Tablespace Extent size (pages)           = 32
    -- **   Using automatic storage                  = No
    -- **   Storage group ID                         = 2
    -- **   Source storage group ID                  = -1
    -- **   Data tag                                 = 9
    -- **   Auto-resize enabled                      = No
    -- **   Total number of pages                    = 2000
    -- **   Number of usable pages                   = 1960
    -- **   High water mark (pages)                  = 96
    -- ****************************************************************************
    SET TABLESPACE CONTAINERS FOR 3
    -- IGNORE ROLLFORWARD CONTAINER OPERATIONS
    USING (
      FILE   ‘/tmp/dms1'                                          1000
    , FILE   ‘/tmp/dms2'                                          1000
    );
    -- ****************************************************************************
    -- ** Tablespace name                            = RAW
    -- **   Tablespace ID                            = 4
    -- **   Tablespace Type                          = Database managed space
    -- **   Tablespace Content Type                  = Any data
    -- **   Tablespace Page size (bytes)             = 4096
    -- **   Tablespace Extent size (pages)           = 32
    -- **   Using automatic storage                  = No
    -- **   Auto-resize enabled                      = No
    -- **   Total number of pages                    = 2000
    -- **   Number of usable pages                   = 1960
    -- **   High water mark (pages)                  = 96
    -- ****************************************************************************
    SET TABLESPACE CONTAINERS FOR 4
    -- IGNORE ROLLFORWARD CONTAINER OPERATIONS
    USING (
      DEVICE ‘/dev/hdb1'                                          1000
    , DEVICE ‘/dev/hdb2'                                          1000
    );
    -- ****************************************************************************
    -- ** start redirect restore
    -- ****************************************************************************
    RESTORE DATABASE TEST CONTINUE;
    -- ****************************************************************************
    -- ** end of file
    -- ****************************************************************************

11. 以下是使用 SNAPSHOT 选项的 RESTORE DB 命令的示例:
    从快照映像复原日志目录卷且不提示。

    db2 restore db sample use snapshot LOGTARGET INCLUDE without prompting

    不复原日志目录卷且不提示。

    db2 restore db sample use snapshot LOGTARGET EXCLUDE without prompting

    不复原日志目录卷且不提示。 如果未指定 LOGTARGET，那么缺省值为 LOGTARGET EXCLUDE。

    db2 restore db sample use snapshot without prompting

    在复原包含相冲突的日志目录的快照映像时，允许覆盖和替换当前数据库中的现有日志目录，但不提示。

    db2 restore db sample use snapshot LOGTARGET EXCLUDE FORCE without prompting

    在复原包含相冲突的日志目录的快照映像时，允许覆盖和替换当前数据库中的现有日志目录，但不提示。

    db2 restore db sample use snapshot LOGTARGET INCLUDE FORCE without prompting

12. 以下是将 RESTORE 命令与 TRANSPORT REDIRECT 选项配合使用的传输操作的示例:
    提供一个源数据库 (TT_SRC) 备份映像（存储路径在 /src 上）和一个目标数据库 (TT_TGT)（存储路径在 /tgt 上）：

    > RESTORE DB TT_SRC TABLESPACE (AS1) SCHEMA (KRODGER) 
         TRANSPORT INTO TT_TGT REDIRECT
    
    SQL1277W A redirected restore operation is being performed.  Table space
    configuration can now be viewed and table spaces that do not use automatic
    storage can have their containers reconfigured.
    DB20000I The RESTORE DATABASE command completed successfully.

    将表空间“AS1”传输到容器路径中，类似于：/tgt/krodger/NODE0000/TT_TGT/T0000003/C0000000.LRG

    要为传输的表空间指定目标存储器组，可以使用 RESTORE 命令的 USING STOGROUP 选项。 在以下示例中，将表空间 TS1 和 TS2 复原到 SG_COLD 存储器组中：

    > RESTORE DB TT_SRC TABLESPACE (TS1, TS2) SCHEMA (KRODGER)
         TRANSPORT INTO TT_TGT USING STOGROUP SG_COLD

    注: RESTORE 命令的 USING STOGROUP 选项仅在传输操作期间有效，不能用于在任何其他复原操作期间指定目标存储器组。
    要执行到目标数据库的缺省存储器组的传输，不需要指定 USING STOGROUP 选项：

    > RESTORE  DB TT_SRC TABLESPACE (TS3) SCHEMA (KRODGER) 
         TRANSPORT INTO TT_TGT

    在传输操作期间在 RESTORE 命令上指定的存储器组名当前必须在目标数据库中定义。 不必在备份映像或源数据库中进行定义。
13. 以下示例显示如何指定加密选项。
    使用缺省加密选项复原到名为 CCARDS 的新加密数据库中:

    RESTORE DATABASE ccards ENCRYPT;

    使用显式提供的加密选项将备份映像解密，以复原到同一数据库中:

    RESTORE DATABASE ccards
      ENCRLIB 'libdb2encr.so'
      ENCROPTS 'Master key Label=mylabel.mydb.myinstance.myserver';

    如果您无法记住用于保护备份映像的主密钥标签，请运行带有 SHOW MASTER KEY DETAILS 加密选项的 RESTORE DATABASE 命令; 其输出等同于运行 ADMIN_GET_ENCRYPTION_INFO 表函数。 不恢复数据库。 例如：

    RESTORE DATABASE ccards
      ENCRLIB 'libdb2encr.so'
      ENCROPTS 'show master key details'

    此命令返回用于保护备份映像的每个主密钥的标签。 此命令还会返回有关执行备份时主密钥位置的信息。 此信息在名称具有以下格式的文件中的 sqllib/db2dump 目录中可用:

    db-name.inst-type.inst-name.
      db-partition.timestamp.masterKeyDetails

14. 以下是从名为 PROD的现有数据库复原到名为 TEST的非现有数据库的示例。 在此示例中，使用非缺省日志路径配置了 PROD ，并且正在与 PROD相同的实例上复原 TEST 。 复原将使用非缺省日志路径配置 TEST 。

    db2 restore db PROD INTO TEST NEWLOGPATH /dev/db2/testdb

15. 下面的示例显示了从名为 "SAMPLE的现有数据库向名为 "SAMPLE2的非现有数据库运行还原操作的命令语法，其中 NEWLOGPATH 被配置为使用默认日志路径。
    注意：NEWLOGPATH DEFAULT 选项在Db2 11.5.6及更高版本中可用。

    db2 restore db SAMPLE into SAMPLE2 NEWLOGPATH DEFAULT

16. 您可以使用命名管道将一个数据库直接备份到另一个数据库中，而不保存中间备份映像。
    以下示例将源数据库 (srcdb) 复制到目标数据库 (tgtdb) 中。 可以按任一顺序输入 BACKUP 和 RESTORE 命令。
    (在一次会议中)

    $ db2 backup db srcdb to /<pipename> 

    (在另一届会议上)

    $ db2 restore db srcdb from /<pipename> into tgtdb

如果使用参数 AT DBPARTITIONNUM 重新创建已删除的数据库分区（由于该分区已损坏），那么此数据库分区中的数据库将处于复原暂挂状态。 重新创建此数据库分区之后，必须立即在此数据库分区上复原该数据库。