DolphinDB启动脚本教程

What this page covers

• 启动脚本功能概述与用途。
• 启动顺序与初始化脚本、函数视图、定时任务的关系。
• startup 参数配置、路径规则、权限、日志与错误处理。
• 常见应用场景示例（共享表、流数据、插件与故障日志）。
• 编写与调试建议（module、日志、try-catch）。
• 不适用场景与限制（定时任务相关功能、系统级函数位置、跨节点依赖风险）。

技能认证特训营第二期报名推广 (cta)

页面顶部提供活动报名引导与限时报名链接信息。

• 提供“技能认证特训营第二期”的报名入口信息。
• 包含可点击的报名链接。

DolphinDB启动脚本教程（作者与日期） (product_overview)

文章包含标题、作者署名与发布日期，表明内容是关于 DolphinDB 启动脚本的教程。

• 文章主题为“DolphinDB启动脚本教程”。
• 作者署名为 Junxi。
• 发布日期为 2021-08-05。

启动脚本功能概述与用途 (definition)

介绍 DolphinDB 从 1.0 开始提供启动脚本，通过 startup 参数指定用户级脚本并在启动时自动执行初始化类任务。

• DolphinDB 从 1.0 版本开始提供启动脚本功能。
• startup 参数用于指定用户级启动脚本。
• startup 参数默认值为 startup.dos。
• 启动脚本可用于初始化流数据。
• 启动脚本可用于定义共享变量。

DolphinDB启动顺序与相关组件 (how_it_works)

说明与启动脚本相关的初始化脚本、函数视图与定时任务，并给出组件资源初始化顺序及其影响。

• init 参数用于指定系统级初始化脚本。
• 系统级初始化脚本（init）的默认值为 dolphindb.dos。
• 启动过程相关内容至少包括：init、函数视图、定时任务。
• dolphindb.dos 是必需的系统级初始化脚本。
• 函数视图在启动脚本执行之前加载。

启动脚本的执行与配置方式 (how_it_works)

说明 startup 配置项的参数含义、默认值、路径搜索规则、单机/集群配置位置、权限与登录要求、错误处理与日志记录。

• startup 可配置为自定义脚本文件名，支持绝对或相对路径。
• 相对路径时会依次搜索 home、工作目录、可执行文件目录。
• 单机模式的 startup 参数配置在 dolphindb.cfg。
• 集群模式的 startup 参数配置在节点配置文件 cluster.cfg。
• 启动脚本输出会记录在本地节点日志文件中。

启动脚本常见应用场景与示例 (use_case)

列举系统重启后常见初始化工作，并给出共享内存表、流数据表初始化与订阅、以及加载插件的示例与故障日志。

• 系统重启后可在启动脚本中定义并共享内存表。
• 示例：可将内存表 t 分享为 sharedT 供其他会话访问。
• 流数据表的定义不可在 DolphinDB 中持久化保存。
• 示例：可订阅流数据表并将数据追加写入分布式库表。
• 示例：可在启动脚本中加载 odbc 插件以支持相关定时任务反序列化。

启动脚本的编写与调试建议 (how_it_works)

说明启动脚本可使用 module、可定义函数并使用分布式功能，并建议使用日志输出与 try-catch 进行调试与异常处理。

• 启动脚本可使用 module 声明并使用可重用模块。
• 启动脚本可以自定义函数。
• 调试建议：使用 print 与 writeLog 输出日志。
• 异常处理建议：用 try-catch 防止异常中断后续脚本。

启动脚本不适用的场景与限制 (limitations)

列出启动脚本不应涉及的定时任务相关功能、系统级函数定义位置，以及依赖其他节点的任务风险。

• 启动脚本中不能使用 scheduleJob 等定时任务相关功能。
• 系统级函数应在 dolphindb.dos 中定义。
• 依赖其他节点的任务不适合放在启动脚本中执行。

Facts Index