三分钟搞定跨机恢复！YashanDB yasrman异地恢复黑科技实战

解决跨环境恢复的路径适配难题

一、Mapped File功能深度解析

核心价值

当数据库从环境A迁移到环境B时，存储路径往往存在差异。yasrman的mapped file功能通过路径映射规则，实现：
✅ 智能路径转换：自动将备份文件中的原始路径转换为目标环境路径
✅ 多层映射控制：支持全局替换、表空间级定制、日志文件专用映射
✅ 零数据丢失：确保所有文件（数据文件/日志文件/控制文件）完整迁移

技术原理

二、典型应用场景：跨环境恢复演练

📍客户痛点：

生产库(A)与演练库(B)存在路径差异：

• 数据文件分布在不同目录：/data/db1, /data/db2
• 日志文件跨多路径：/redo/path1, /redo/path2
• 存储架构不同：NVMe SSD → SATA HDD

🚀 解决方案：双层路径映射策略

1. 全局路径兜底映射

   • db_target_home：所有未特殊配置的文件默认存放路径
   • redo_target_path：REDO日志专用目录（独立于数据文件）

2. 关键文件精准映射

   • 对核心/特殊文件单独配置路径
   • 优先级：文件级映射 = REDO专用路径 > 全局路径

🔍 详细映射规则解析

1. 全局基础配置

# 源库基础路径（自动生成，仅参考）
db_origin_home:/data/yashan/ha_home

# ⭐ 目标库全局路径（所有文件的默认存放位置）
db_target_home:/backup/yashan_recovery

# ⭐ 目标库REDO日志专用路径（可选配置）
redo_target_path:/backup/redo_logs

2. 关键文件特殊映射

# 系统表空间特殊存储
tablespace id:0, datafile id:0
origin_path:/data/db1/system 
target_path:/backup/db_files/system  # 优先级最高

# 用户表空间独立存储
tablespace id:1, datafile id:0
origin_path:/data/db2/users 
target_path:/backup/db_files/users   # 优先级最高

3. 路径映射流程图解
   

4. 规则优先级说明（从高到低）

⚠️ 重要注意事项

1. REDO日志不可单独配置

   # 错误示例（不支持）
   tablespace id:99, datafile id:0
   origin_path:/old/redo.log
   target_path:/new/redo.log  # 此配置无效！
   

   ✅ 正确做法：所有REDO日志通过redo_target_path统一配置

2. 路径转换逻辑

   • 未配置target_path的文件：
     /data/yashan/ha_home/... → /backup/yashan_recovery/...
   • 配置target_path的文件：完全跳过全局映射规则

3. 生成映射文件时必须使用绝对路径

   # 错误命令（触发YAS-06009）
   yasrman ... list backupset tag 'tag_name' mapped file 'mappfile'
   
   # 正确命令
   yasrman ... list backupset tag 'tag_name' mapped file '/absolute/path/mappfile'
   

💡 配置效果演示

源环境结构

/data/yashan/ha_home
├── dbfiles
│   ├── system  # 表空间0
│   └── users   # 表空间1
└── redo.log    # REDO日志

映射规则配置

databasc_node_id:1-1
db_origin_home:/data/yashan/ha_home
db_target_home:/backup/yashan_recovery
redo_target_path:/backup/redo_logs

tablespace id:0, datafile id:0
origin_path:/data/yashan/ha_home/node_1/dbfi1es/system 
target_path:/backup/dbfiles/system

tablespace id:4,datafile id:0
origin_path:/data/yashan/ha_home/node_1/dbfiles/users 
target_path:/backup/dbfiles/users

目标环境映射后

/backup
├── yashan_recovery    # 全局路径
│   └──dbfiles
        ├──...         # 其他未配置文件
├── db_files           # 特殊映射目录
│   ├── system         # 表空间0
│   └── users          # 表空间1
└── redo_logs          # REDO专用目录
    └── redo.log

通过此方案，既实现了核心文件的精准定位，又保证了普通文件的自动迁移，完美解决多路径环境迁移难题！

三、实战演练：跨服务器恢复

环境说明

步骤1：源库准备（192.168.7.91）

-- 创建测试环境
CREATE TABLE test(a INT); 
INSERT INTO test VALUES(1);

-- 添加多路径文件
ALTER DATABASE ADD LOGFILE '/data/yashan/ha_home/node_1/redo4' SIZE 128M;
ALTER TABLESPACE users ADD DATAFILE '/data/yashan/ha_home/node_1/users1' SIZE 64M;

-- 验证文件分布
SELECT ID, NAME FROM v$datafile;  -- 显示7个数据文件
SELECT * FROM v$logfile;          -- 显示4个日志文件

步骤2：执行备份并生成映射模板

# 清理旧备份
yasrman sys/****0127.0.0.1:1601 -c "delete backupset if exists tag 'prod_full_backup'" -D "/backup/catalog"

# 全量备份
yasrman sys/****0127.0.0.1:1601 -c "backup database tag 'prod_full_backup' format 'prod_full_%U' dest client" -D "/backup/catalog"

# 生成映射模板
yasrman sys/****0127.0.0.1:1601 -c "list backupset tag 'prod_full_backup' mapped file '/backup/mapfile_recovery'" -D "/backup/catalog"

# 查看映射模板的内容
$ cat /backup/mapfile_recovery
databasc_node_id: 1-1
db_origin_home:/data/yashan/ha_home/node_1
db_target_home:
redo_target_path:

tablespace id:0, datafile id:0
origin_path:/data/yashan/ha_home/node_1/dbfi1es/system 
target_path:

tablespace id:1, datafile id:0
origin path:/data/yashan/ha home/node_1/dbfiles/sysaux 
target_path:

tablespace id:2, datafile id:0
origin_path:/data/yashan/ha_home/node_1/dhfiles/temp 
target_path:

tablespace id:3, datafile id:0
origin_path:/data/yashan/ha_home/node_1/dbfiles/swap 
target_path:

tablespace id:4, datafile id:0
origin_path:/data/yashan/ha_home/node_1/dbfiles/users 
target_path:

tablespace id:4, datarile id:1
origin_path:/data/yashan/ha_home/node_1/users1 
target_path:

tablespace id:5, datarile id:0
origin_path:/data/yashan/ha_home/node_1/dbfiles/undo 
target_path:

步骤3：编辑映射文件（核心步骤）

# 修改并保存映射文件
$ vi /backup/mapfile_recovery

# 查看修改后的映射文件
$ cat /backup/mapfile_recovery
databasc_node_id: 1-1
db_origin_home:/data/yashan/ha_home/node_1
db_target_home:/home/yashan/data_dev/ha_home/node_1
redo_target_path:/home/yashan/data_dev/ha_home/node_1/dbfiles

tablespace id:0, datafile id:0
origin_path:/data/yashan/ha_home/node_1/dbfi1es/system
target_path:

tablespace id:1,datafile id:0
origin path:/data/yashan/ha home/node_1/dbfiles/sysaux 
target_path:

tablespace id:2, datafile id:0
origin_path:/data/yashan/ha_home/node_1/dbfiles/temp 
target_path:

tablespace id:3, datafile id:0
origin_path:/data/yashan/ha_home/node_1/dbfiles/swap 
target_path:

tablespace id:4,datafile id:0
origin_path:/data/yacyaning/ha_home/node_1/dbfiles/users 
target_path:

tablespace id:4, datarile id:1
origin_path:/data/yashan/ha_home/node_1/users1
target_path:/home/yashan/data_dev/ha_home/users1

tablespace id:5, datarile id:0
origin_path:/data/yashan/ha_home/node_1/dbfiles/undo 
target_path:

步骤4：目标库恢复（192.168.7.92）

# 清理环境（谨慎操作！）
rm -rf /home/yashan/data_dev/ha_home/node_1/dbfiles/*
rm -rf /home/yashan/data_dev/ha_home/node_1/archive/*
rm -rf /home/yashan/data_dev/ha_home/node_1/local_fs/*
rm -rf /home/yashan/data_dev/ha_home/node_1/fra/*
rm -rf /data/yashan/ha_home/node_1/users1
rm -rf /data/yashan/ha_home/node_1/redo4

# 重启到NOMOUNT状态
yasql sys/****@192.168.7.92:1601 -c "shutdown abort"
yasql sys/****@192.168.7.92:1601 -c "startup nomount"

# 执行映射恢复
yasrman sys/****@192.168.7.92:1601 -c "restore database from tag 'prod_full_backup' mapped file '/backup/mapfile_recovery' dest client" -D "/backup/catalog"

步骤5：验证恢复结果

-- 检查数据库状态
SELECT status, data_home FROM v$instance;
/* 预期输出：
OPEN | /home/yashan/data_dev/ha_home/node_1
*/

-- 验证测试数据
SELECT * FROM test;  -- 应返回数据 1

-- 验证文件路径映射
SELECT ID, NAME FROM v$datafile;
/* 重点检查：
  5 /home/yashan/data_dev/ha_home/node_1/dbfiles/undo  # 全局路径db_target_home路径生效
  6 /home/yashan/data_dev/ha_home/users1  # users1文件的target_path路径生效
*/

SELECT * FROM v$logfile;
/* 重点检查：
  3 /home/yashan/data_dev/ha_home/node_1/dbfiles/redo4  # 日志专用路径redo_target_path生效
*/

四、关键技术要点

1. 路径映射规则

2. 避坑指南

3. 高级技巧

# 恢复时启用并行加速
yasrman ... -c "restore ... PARALLELISM 8"

五、最佳实践总结

1. 预验证机制

   # 校验备份集有效性
   yasrman -c "VALIDATE BACKUPSET tag 'prod_full_backup'"
   

2. 自动化脚本模板

   #!/bin/bash
   # 自动生成映射文件
   gen_mapfile() {
     yasrman ... -c "list backupset ... mapped file '$1'"
     sed -i "s|/old_path|/new_path|g" $1
   }
   
   # 执行恢复
   restore_with_map() {
     yasrman ... -c "restore ... mapped file '$1'"
   }
   

温馨提示：生产环境恢复前务必在测试环境验证映射方案！
官方文档：YashanDB 备份恢复手册

技术没有银弹，但好的工具能让恢复效率提升10倍
遇到路径迁移问题？记住：
mapped file + 预验证 = 无忧恢复 💯