跳到正文
HNROS 帮助中心
中文
免费开始
目录位置与使用者开始之前第 1 步 — FirebirdSQL 检查第 2 步 — 源文件将备份准备为 UTF-8 并连接 / 测试连接第 3 步 — 表清单和选项第 4 步 — 迁移和进度第 5 步 — 结果和对账维护面板常见错误在 Linux 上

从旧程序迁移数据(Firebird):设置 › 数据迁移

旧程序(FirebirdSQL)中的数据——往来单位和库存卡片、发票、送货单、支票、配方、图片和文件——在您登录后,通过 设置 › 数据迁移(从旧程序) 迁移到 HNR。首次设置向导不再迁移数据。只有系统管理员能看到此部分;在手机上(花园 + 步骤界面),同一流程会分步打开。

请先用向导创建公司:数据会迁移到已经建立的公司中;此部分不会新建公司。迁移前请备份目标公司。旧程序的数据库只读取:迁移过程中不会更改任何一行。

位置与使用者

设置 › 数据迁移(从旧程序)。只有系统管理员能看到并使用此部分;没有管理员权限的用户会看到“数据导入仅对系统管理员开放。”如果服务器处于只读模式(写入闸门关闭),迁移不会开始。

首次设置向导中的“导入数据库(从旧公司迁移数据)”按钮不再迁移数据,只显示一条提示:请先创建公司,登录后打开 设置 › 数据迁移 部分。

在手机上(花园 + 步骤界面),同一部分会分步打开:每一步是单独的屏幕,按钮大小便于手指点按,表格以卡片形式显示。

开始之前

第 1 步 — FirebirdSQL 检查

页面打开时,会检查本机是否安装了 FirebirdSQL、是否正在运行以及版本。旧程序的数据通过本机的 FirebirdSQL 读取:服务器就是本机(localhost),端口为 3050(如果安装时更改过,则为 firebird.conf 中的 RemoteServicePort 值),用户为 SYSDBA。这些都不会询问,只需输入密码。

情况怎么做
未安装。屏幕显示“请先安装 FirebirdSQL。”,无法继续。通过“FirebirdSQL 下载页面”(firebirdsql.org)链接,以默认设置(端口 3050、SYSDBA)安装 FirebirdSQL 3.0、4.0 或 5.0,然后点击“重新检查”。
已安装但服务未运行。警告中还会显示版本和端口。打开 Windows 服务,启动“Firebird Server - DefaultInstance”服务,然后点击“重新检查”。
版本不受支持。会出现“不支持此 FirebirdSQL 版本”的警告。请安装 FirebirdSQL 3.0、4.0 或 5.0。
就绪。绿色框中显示“FirebirdSQL 已安装并正在运行”,以及版本、localhost:端口和 SYSDBA。点击“继续”进入第 2 步。

此步骤还会显示“导入前请备份目标公司。”警告。如果之前进行过迁移,“显示上次导入的结果”按钮会打开该结果。

第 2 步 — 源文件

选择文件按钮会打开 Windows 的文件打开窗口。请选择旧程序的备份(.FBK)或数据库(.FDB);也接受 .BAK 和 .GDB 扩展名。选择其他类型的文件会被拒绝(KAYNAK_DOSYA_TURU)。

EK1(图片和文件数据库,例如 HESAP_EK1.FBK 或 HESAP.FDB_EK1.FBK)无需另行选择:系统会在同一文件夹中自动找到它,并在所选文件下方显示“已找到 EK1”。如果找不到,会出现“未找到 EK1,仅迁移主文件”的警告,图片和文件不会迁移;请把 EK1 放到与主文件相同的文件夹中,然后重新选择文件。

当 HNR 作为 Windows 服务运行时,文件通过浏览器自身的文件选择窗口选择。此时请在同一窗口中(按住 Ctrl 键)同时选择主文件和 EK1 文件。所选文件会以百分比进度复制到本机的迁移文件夹(aktarim\kaynak)中;原始文件不会被改动。

大文件的快捷方式:对于数 GB 的备份,请先将主文件和 EK1 文件复制到本机的迁移文件夹(aktarim\kaynak;选择文件前,完整路径显示在按钮下方),然后通过选择文件只选择主文件。文件夹中已有的同名同大小文件不会再次复制;屏幕上会显示“该文件已在导入文件夹中,未再次复制。”,并会在同一文件夹中自动找到 EK1。从浏览器上传的大文件会分段发送。

选择文件后只需输入 SYSDBA 密码。SYSDBA / masterkey 是 Firebird 的初始值;如果安装 Firebird 时更改过密码,请输入您自己的密码。

将备份准备为 UTF-8 并连接 / 测试连接

如果您选择了备份(.FBK),按钮会变为将备份准备为 UTF-8 并连接。备份在服务器上恢复(“正在恢复备份…”),转换为 UTF-8 并验证内容(“UTF-8 转换和内容验证…”);进度以表数和行数显示。通过验证的副本将用作数据源,原始备份保持不变。此操作需要约为备份大小 4 倍的可用磁盘空间。

如果您选择了数据库(.FDB),按钮会变为测试连接:它连接到数据源,并显示版本、表数以及是否找到 EK1。成功后显示“已连接 · 版本 … · … 个表”,读取清单按钮变为可用。

第 3 步 — 表清单和选项

读取清单会列出数据源中的所有表;不会有任何表被悄悄遗漏。每个表都带有以下四种决定之一:

决定含义
对象从表中生成卡片/单据,并通过公司自身的写入路径保存(例如 MUSTERI → 往来单位卡片)。
复制如果目标中存在同名表,则逐行复制共有的列。
派生不复制:往来单位余额、库存现有量等值由写入路径重新生成。
跳过系统表或日志表。

在同一步骤中设置迁移选项:

单据编号会被保留:数据源中的发票、支票和凭证编号在目标中保持不变。如果再次迁移同一数据源,不会写入重复记录;已有的记录会被跳过。

第 4 步 — 迁移和进度

开始导入会在服务器上启动迁移。屏幕上显示阶段、百分比和已用时间,以及逐表的卡片/单据/已写入/已跳过/出错数量、文件数和迁移日志的最后几行;如果引擎使用多个线程,还会显示线程数及明细。

迁移在服务器上进行:即使关闭此窗口或浏览器,任务也不会停止。重新打开页面时,系统会找到正在进行的迁移并显示其进度。停止会停止任务并显示“导入已停止。”

第 5 步 — 结果和对账

迁移结束后显示“导入已完成。”,对账表会比较来源与目标:往来单位余额、库存现有量、支票、发票、配方和文件。每一行显示项目、来源、目标、差异和状态(一致 / 偏差 / 已知偏差);此外还显示逐表结果、耗时、示例行错误和自动更正的数量。

如果对账存在偏差,屏幕会显示“导入已完成——但对账存在偏差。”并列出出现偏差的指标。使用迁移后的公司之前,请检查对账表;您可以通过旧系统对账报告 · PDF按钮获取 PDF 报告,或用打印将其打印出来。

出错行的示例列在“示例行错误”下;如果迁移无法完成,请查看迁移日志了解详情。

维护面板

第 2 步下方的维护面板提供两项操作:

常见错误

错误消息会显示服务器的详细信息,并在括号中给出错误代码;例如“服务器上未配置备份准备工具。— gbak/gfix not found (KAYNAK_HAZIRLIK_AYAR)”。联系支持时请提供该代码。

代码含义和解决方法
FIREBIRD_KURULU_DEGIL“本机未安装 FirebirdSQL。”请安装 FirebirdSQL 3.0、4.0 或 5.0,然后点击“重新检查”。
FIREBIRD_CALISMIYORFirebirdSQL 已安装,但其服务器未运行。请在 Windows 服务中启动“Firebird Server - DefaultInstance”服务,然后重新检查。
KAYNAK_KIMLIK“源数据库用户名或密码被拒绝。”请重新输入 SYSDBA 密码;如果安装 Firebird 时更改过密码,请输入该密码(默认为 masterkey)。
KAYNAK_HAZIRLIK_AYAR“服务器上未配置备份准备工具。”如果详细信息中显示 gbak/gfix not found,说明未安装 FirebirdSQL;如果显示 Firebird server not running,请启动 Firebird 服务。检查安装和服务后重试;如果问题仍然存在,请将代码转告支持团队。
KAYNAK_HAZIRLIK_DISK“磁盘空间不足,无法恢复备份并创建 UTF-8 副本。”请在迁移文件夹所在的磁盘上腾出约为备份大小 4 倍的空间,然后重试。
KAYNAK_YEDEK_GECERSIZ“该文件不是有效的 Firebird FBK/BAK 备份。”文件可能已损坏或属于其他类型;请从旧程序重新备份并选择,或选择 FDB 文件。
KAYNAK_DOSYA_TURU“只能选择 Firebird 数据库或备份文件(.fbk、.fdb、.bak、.gdb)。”请选择扩展名合适的文件;不要把 EK1 文件选作主文件。
HEDEF_DOLU“目标公司已有记录。”如果该公司以前使用过,新建一个公司更安全;如果您有意继续,请先备份,并在第 3 步勾选“即使目标已有数据也继续”。

同一公司同一时间只能运行一个迁移(“该公司已有一个数据导入正在进行。”)。如果服务器处于只读模式(“写入闸门已关闭”),迁移不会开始。

在 Linux 上

FirebirdSQL 可通过您所用发行版的软件包管理器或 firebirdsql.org 安装。gbak 和 gfix 工具必须位于 PATH 中或 /opt/firebird 下;其余步骤与 Windows 相同。

相关指南:安装、设置、数据清理。

相关指南