资源描述
I C S 3 5.0 8 0C C S L 7 7DB4403深 圳 市 地 方 标 准D B 4 4 0 3/T 3 8 4.5 2 0 2 3代 替 S Z D B/Z 6.2 2 0 0 7基 础 教 育 管 理 信 息 化 技 术 规 范第 5 部 分：数 据 交 换T e c h n i c a l s p e c i f i c a t i o n s f o rb a s i c e d u c a t i o n m a n a g e m e n t i n f o r m a t i z a t i o n P a r t 5：D a t a e x c h a n g e2 0 2 3-1 1-1 5 发 布 2 0 2 3-1 2-0 1 实 施深 圳 市 市 场 监 督 管 理 局发 布D B 4 4 0 3/T 3 8 4.5 2 0 2 3I目 次前 言.I引 言.I I I1 范 围.12 规 范 性 引 用 文 件.13 术 语 和 定 义.14 缩 略 语.15 数 据 共 享 交 换 基 本 要 求.16 数 据 共 享 交 换 方 式.26.1 基 于 数 据 库 的 交 换 方 式.26.2 基 于 文 件 的 交 换 方 式.26.3 基 于 服 务 接 口 的 交 换 方 式.37 共 享 平 台 接 入 方 式.47.1 接 入 流 程.47.2 接 口 说 明.47.3 消 息 确 认 模 式.4附 录 A（资 料 性）数 据 交 换 接 口 参 数.6附 录 B（资 料 性）错 误 码 信 息.1 5附 录 C（资 料 性）消 息 体 格 式.1 6参 考 文 献.1 8D B 4 4 0 3/T 3 8 4.5 2 0 2 3I I前 言本 文 件 按 照 G B/T 1.1 2 0 2 0 标 准 化 工 作 导 则 第 1 部 分：标 准 化 文 件 的 结 构 和 起 草 规 则 的 规定 起 草。本 文 件 是 D B 4 4 0 3/T 3 8 4 2 0 2 3 基 础 教 育 管 理 信 息 化 技 术 规 范 的 第 5 部 分。D B 4 4 0 3/T 3 8 4 2 0 2 3已 经 发 布 了 以 下 部 分：第 1 部 分：数 据 结 构；第 2 部 分：数 据 代 码；第 3 部 分：教 育 大 数 据 统 计 分 析；第 4 部 分：教 育 用 户 数 据；第 5 部 分：数 据 交 换。本 文 件 代 替 S Z D B/Z 6.2 2 0 0 7 深 圳 市 基 础 教 育 管 理 信 息 化 技 术 规 范 第 二 部 分：数 据 交 换，与S Z D B/Z 6.2 2 0 0 7 相 比，对 结 构 和 内 容 都 进 行 了 调 整。主 要 技 术 变 化 如 下：a)增 加 了“数 据 共 享 交 换 基 本 要 求”（见 第 4 章）；b)增 加 了“数 据 共 享 交 换 方 式”（见 第 5 章）；c)增 加 了“共 享 平 台 接 入 方 式”（见 第 6 章）；d)增 加 了“数 据 交 换 接 口 参 数”（见 附 录 A）；e)增 加 了“错 误 码 信 息”（见 附 录 B）；f)增 加 了“消 息 体 格 式”（见 附 录 C）；g)删 除 了“组 成 要 素”（见 2 0 0 7 年 版 第 3 章）。本 文 件 由 深 圳 市 教 育 局 提 出 并 归 口。本 文 件 起 草 单 位：深 圳 市 教 育 信 息 技 术 中 心、华 中 师 范 大 学、深 圳 市 福 田 区 教 育 局。本 文 件 主 要 起 草 人：张 惠 敏、梁 为、吴 砥、黄 伟 龙、戴 俊 雄、吴 晨、曾 艳 锋、林 雪 芳、张 涛、徐 建、陈 梦、易 韵 涵、刘 韦 司、马 继 满。本 文 件 及 其 所 代 替 文 件 的 历 次 版 本 发 布 情 况 为：2 0 0 7 年 首 次 发 布 为 S Z D B/Z 6.2 2 0 0 7；本 次 为 第 一 次 修 订。D B 4 4 0 3/T 3 8 4.5 2 0 2 3I I I引 言2 0 0 7 年 发 布 的 S Z D B/Z 6 2 0 0 7 深 圳 市 基 础 教 育 管 理 信 息 化 技 术 规 范 有 效 提 升 了 深 圳 市 教 育 管理 信 息 化 建 设 水 平，极 大 促 进 了 深 圳 市 各 级 各 类 信 息 化 教 育 平 台 数 据 的 互 联 互 通。随 着 教 育 信 息 化 应 用场 景 的 不 断 拓 展 和 平 台 数 据 的 不 断 丰 富，且 随 着 2 0 1 7 年 G B/T 3 5 2 9 8 2 0 1 7 信 息 技 术 学 习、教 育 和培 训 教 育 管 理 基 础 信 息、G B/T 3 3 7 8 2 2 0 1 7 信 息 技 术 学 习、教 育 和 培 训 教 育 管 理 基 础 代 码 等 国 家 标 准 的 发 布，对 深 圳 市 基 础 教 育 管 理 信 息 化 技 术 规 范 的 更 新 和 修 订 提 出 了 需 要。为 提 高 标 准 的 适用 性 和 准 确 性，以 便 更 好 服 务 于 大 数 据 时 代 深 圳 市 教 育 管 理 信 息 化 建 设，起 草 组 围 绕 深 圳 市 教 育 大 数 据治 理 工 作 需 要，对 深 圳 市 基 础 教 育 管 理 信 息 化 技 术 规 范 的 系 列 标 准 内 容 进 行 了 内 容 修 订，拟 由 五 个部 分 构 成：第 1 部 分：数 据 结 构。目 的 在 于 规 范 基 础 教 育 管 理 信 息 的 分 类 信 息 和 数 据 集；第 2 部 分：数 据 代 码。目 的 在 于 规 范 学 校 管 理、学 生 管 理、教 学 管 理 和 教 职 工 管 理 等 类 型 数 据的 标 识 码 格 式、代 码 集 等 内 容；第 3 部 分：教 育 大 数 据 统 计 分 析。目 的 在 于 规 范 教 育 大 数 据 统 计 分 析 指 标；第 4 部 分：教 育 用 户 数 据。目 的 在 于 规 范 教 育 用 户 身 份 认 证 数 据、用 户 角 色 数 据 和 用 户 接 口 数据；第 5 部 分：数 据 交 换。目 的 在 于 规 范 教 育 管 理 数 据 共 享 交 换 基 本 要 求、交 换 方 式 及 共 享 平 台 接入 方 式。D B 4 4 0 3/T 3 8 4.5 2 0 2 31基 础 教 育 管 理 信 息 化 技 术 规 范第 5 部 分：数 据 交 换1 范 围本 文 件 规 定 了 教 育 管 理 数 据 共 享 交 换 基 本 要 求、交 换 方 式 及 共 享 平 台 接 入 方 式。本 文 件 适 用 于 深 圳 市 教 育 管 理 信 息 化 建 设 工 作。2 规 范 性 引 用 文 件本 文 件 没 有 规 范 性 引 用 文 件。3 术 语 和 定 义下 列 术 语 和 定 义 适 用 于 本 文 件。3.1数 据 交 换 d a t a i n t e r c h a n g e为 满 足 不 同 平 台 或 应 用 间 数 据 资 源 的 传 送 和 处 理 需 要，依 据 一 定 的 原 则，采 取 相 应 的 技 术，实 现 不同 平 台 和 应 用 间 数 据 资 源 流 动 过 程。来 源：G B/T 3 5 2 7 4 2 0 1 7，3.1 1 4 缩 略 语下 列 缩 略 语 适 用 于 本 文 件。H T T P：超 文 本 传 输 协 议（H y p e r t e x t T r a n s f e r P r o t o c o l)H T T P S：超 文 本 传 输 安 全 协 议（H y p e r t e x t T r a n s f e r P r o t o c o l S e c u r e）U R L：统 一 资 源 定 位 器（U n i f o r m R e s o u r c e L o c a t o r）X M L：可 扩 展 置 标 语 言（E x t e n s i b l e M a r k u p L a n g u a g e）J S O N：J a v a S c r i p t 对 象 表 示 法（J a v a S c r i p t O b j e c t N o t a t i o n）5 数 据 共 享 交 换 基 本 要 求5.1 数 据 共 享 交 换 遵 循“数 据 驱 动、应 用 牵 引、协 同 共 进”的 原 则。5.2 数 据 共 享 交 换 参 与 方 主 要 包 括：数 据 提 供 方、数 据 需 求 方 和 平 台 管 理 方。以 下 为 各 数 据 共 享 交 换参 与 方 的 主 要 职 责：数 据 提 供 方 应 保 障 所 提 供 教 育 数 据 的 完 整 性、准 确 性、时 效 性 和 可 用 性；D B 4 4 0 3/T 3 8 4.5 2 0 2 32 数 据 需 求 方 应 按 照 数 据 申 请 流 程 获 取 数 据，按 照 共 享 范 围 使 用 数 据；平 台 管 理 方 应 负 责 数 据 对 接/共 享 平 台 的 运 行 维 护 和 数 据 资 源 的 归 集、更 新 和 发 布。6 数 据 共 享 交 换 方 式6.1 基 于 数 据 库 的 交 换 方 式6.1.1 结 构 说 明基 于 数 据 库 的 交 换 方 式 结 构 图 见 图 1。图 1 基 于 数 据 库 的 交 换 方 式6.1.2 适 用 场 景基 于 数 据 库 的 数 据 交 换 方 式 适 用 于 实 时、周 期 性、大 数 据 包、小 数 据 包、结 构 化 数 据 场 景。6.1.3 数 据 库 接 入 参 数基 于 数 据 库 的 接 入 参 数 见 附 录 A 中 的 A.1。6.2 基 于 文 件 的 交 换 方 式6.2.1 结 构 说 明基 于 文 件 的 交 换 方 式 结 构 图 见 图 2。D B 4 4 0 3/T 3 8 4.5 2 0 2 33图 2 基 于 文 件 的 交 换 方 式6.2.2 适 用 场 景基 于 文 件 的 交 换 方 式 适 用 于 实 时、周 期 性、大 数 据 包、小 数 据 包、结 构 化 数 据、非 结 构 化 数 据、半结 构 化 数 据 场 景。6.2.3 文 件 上 传 下 载 接 口 说 明文 件 上 传 和 下 载 接 口 协 议 使 用 H T T P（H T T P S）协 议，通 过 提 供 访 问 的 U R L，用 户 使 用 H T T P P O S T 方法 发 送 请 求。文 件 上 传 下 载 接 口 参 数 见 附 录 A 中 的 A.2。6.3 基 于 服 务 接 口 的 交 换 方 式6.3.1 服 务 接 口 结 构 说 明基 于 服 务 接 口 的 数 据 交 换 方 式 见 图 3。图 3 基 于 服 务 接 口 的 交 换 方 式D B 4 4 0 3/T 3 8 4.5 2 0 2 346.3.2 适 用 场 景基 于 服 务 接 口 的 交 换 方 式 适 用 周 期 性、小 数 据 包、结 构 化 数 据、非 结 构 化 数 据、半 结 构 化 数 据 场 景。6.3.3 服 务 接 口 请 求 对 象 参 数服 务 接 口 请 求 对 象 参 数 见 附 录 A 中 的 A.3。7 共 享 平 台 接 入 方 式7.1 接 入 流 程共 享 平 台 的 接 入 流 程 主 要 包 含 以 下 四 个 步 骤：a)第 三 方 应 用 在 共 享 平 台 注 册，并 由 平 台 管 理 方 审 核：1)通 过 审 核 可 接 入 交 换 平 台；2)审 核 未 通 过 不 应 接 入 交 换 平 台。b)第 三 方 应 用 注 册 并 审 核 通 过 以 后，调 用 初 始 化 接 口 进 行 数 据 初 始 化；c)第 三 方 应 用 调 用 共 享 平 台 数 据 开 放 接 口 进 行 数 据 同 步；d)当 应 用 在 共 享 平 台 删 除 时，清 除 其 接 入 权 限。7.2 接 口 说 明7.2.1 接 口 均 需 连 接 共 享 平 台 校 验 t o k e n，客 户 端 在 调 用 接 口 之 前 需 先 向 共 享 平 台 申 请 t o k e n。7.2.2 接 口 返 回 的 校 验 信 息 包 含 错 误 码 和 错 误 信 息，默 认 为 x m l 格 式。7.2.3 错 误 码 信 息 见 附 录 B。7.3 消 息 确 认 模 式7.3.1 概 述6.3.1.1 消 息 确 认 模 式 包 括 同 步 响 应、异 步 回 调 和 轮 询 三 种 模 式。6.3.1.2 消 息 体 格 式 见 附 录 C。7.3.2 同 步 响 应 模 式接 收 方 收 到 消 息 后，通 过 发 送 方 发 送 消 息 的 消 息 传 送 连 接（如 H T T P 连 接）向 发 送 方 发 送 对 该 消 息的 确 认 消 息。7.3.3 异 步 回 调 模 式接 收 方 收 到 消 息 后，建 立 一 个 消 息 传 送 连 接，并 通 过 该 连 接 向 发 送 方 发 送 对 该 消 息 的 确 认 消 息。7.3.4 轮 询 模 式轮 询 模 式 可 分 为：a)同 步 轮 询 模 式：发 送 方 在 向 接 收 方 发 送 一 定 数 目 的 消 息 后，对 其 发 送 的 所 有 消 息 发 送 一 个 确 认请 求 消 息 给 接 收 方。接 收 方 接 收 到 这 个 确 认 请 求 后，查 询 已 经 收 到 的 消 息，查 找 其 中 是 否 有 满 足 确 认 请求 消 息 中 包 括 的 I D 值 的 消 息，并 在 这 个 确 认 请 求 消 息 所 在 的 连 接 上，返 回 查 询 的 确 认 结 果；b)异 步 轮 询 模 式：发 送 方 在 向 接 收 方 发 送 一 定 数 目 的 消 息 后，对 其 发 送 的 所 有 消 息 提 出 一 个 确 认请 求 消 息。接 收 方 接 收 到 这 个 确 认 请 求 后，轮 询 自 己 已 经 收 到 的 消 息，查 找 其 中 是 否 有 满 足 确 认 请 求 消D B 4 4 0 3/T 3 8 4.5 2 0 2 35息 中 包 括 的 I D 值 的 消 息，新 建 一 个 连 接，将 查 询 的 结 果 发 送 给 发 送 方。D B 4 4 0 3/T 3 8 4.5 2 0 2 36附 录 A（资 料 性）数 据 交 换 接 口 参 数A.1 数 据 库 接 入 规 范A.1.1 M y s q l 数 据 库 接 入 规 范M y s q l 数 据 库 接 入 规 范 见 表 A.1。表 A.1 M y s q l 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是数据库名 M y s q l 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是数据库表列表 数据库表列表 是数据库表结构 数据库表列表 是A.1.2 O R A C L E 数 据 库 接 入 规 范O R A C L E 数 据 库 接 入 规 范 见 表 A.2。表 A.2 O R A C L E 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是是否集群 如果是集群，提供信息为“是”，不是集群，提供信息为“否”是数据库名/S I D O r a c l e 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是数据库表列表 数据库表列表 是数据库表结构 数据库表列表 是A.1.3 G B a s e 8 a 数 据 库 接 入 规 范G B a s e 8 a 数 据 库 接 入 规 范 见 表 A.3。D B 4 4 0 3/T 3 8 4.5 2 0 2 37表 A.3 G B a s e 8 a 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是是否集群 如果是集群，提供信息为“是”，不是集群，提供信息为“否”是数据库名 G b a s e 8 a 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是数据库表列表 数据库表列表 是数据库表结构 数据库表列表 是A.1.4 S Q L S E R V E R 数 据 库 接 入 规 范S Q L S E R V E R 数 据 库 接 入 规 范 见 表 A.4。表 A.4 S Q L S E R V E R 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是数据库名 S Q L S E R V E R 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是数据库表列表 数据库表列表 是数据库表结构 数据库表列表 是A.1.5 L i b r A 数 据 库 接 入 规 范L i b r A 数 据 库 接 入 规 范 见 表 A.5。表 A.5 L i b r A 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是是否集群 如果是集群，提供信息为“是”，不是集群，提供信息为“否”是D B 4 4 0 3/T 3 8 4.5 2 0 2 38表 A.5 L i b r A 数 据 库 接 入 规 范 表（续）接入参数 说明 是否必填数据库名 L i b r A 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是数据库表列表 数据库表列表 是数据库表结构 数据库表列表 是A.1.6 P o s t g r e S Q L 数 据 库 接 入 规 范P o s t g r e S Q L 数 据 库 接 入 规 范 见 表 A.6。表 A.6 P o s t g r e S Q L 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是数据库名 P o s t g r e S Q L 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是数据库表列表 数据库表列表 是数据库表结构 数据库表列表 是A.1.7 D a m e n g 数 据 库 接 入 规 范D a m e n g 数 据 库 接 入 规 范 见 表 A.7。表 A.7 D a m e n g 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是数据库名 D a m e n g 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是数据库表列表 数据库表列表 是数据库表结构 数据库表列表 是D B 4 4 0 3/T 3 8 4.5 2 0 2 39A.1.8 D B 2 数 据 库 接 入 规 范D B 2 数 据 库 接 入 规 范 见 表 A.8。表 A.8 D B 2 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是数据库名 D B 2 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是数据库表列表 数据库表列表 是数据库表结构 数据库表列表 是A.1.9 G P 数 据 库 接 入 规 范G P 数 据 库 接 入 规 范 见 表 A.9。表 A.9 G P 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是数据库名 G P 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是数据库表列表 数据库表列表 是数据库表结构 数据库表列表 是A.1.1 0 H D F S 数 据 库 接 入 规 范H D F S 数 据 库 接 入 规 范 见 表 A.1 0。表 A.1 0 H D F S 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是N a m e S e r v i c e H D F S N a m e S e r v i c e 是D B 4 4 0 3/T 3 8 4.5 2 0 2 31 0表 A.1 0 H D F S 数 据 库 接 入 规 范 表（续）接入参数 说明 是否必填N a m e N o d e 列表 H D F S 的 N a m e N o d e 列表用逗号隔开 是开启 K e r b e r o s 认证如果是 K e r b e r o s 认证，提供信息为“是”，不是 K e r b e r o s 认证，提供信息为“否”是A.1.1 1 H b a s e 1 1 x 数 据 库 接 入 规 范H b a s e 1 1 x 数 据 库 接 入 规 范 见 表 A.1 1。表 A.1 1 H b a s e 1 1 x 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是Z K 地址Z K 服 务 的 I P：p o r t，如 果 是 集 群 用 逗 号 隔 开（I p 1:p o r t 1，I P 2:p o r t 2）是A.1.1 2 H i v e 数 据 库 接 入 规 范H i v e 数 据 库 接 入 规 范 见 表 A.1 2。表 A.1 2 H i v e 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是M e t a S t o r e 端口 M e t a S t o r e 端口 是数据库名 h i v e 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是Z K 地址Z K 服 务 的 I p:p o r t，如 果 是 集 群 用 逗 号 隔 开（I p 1:p o r t 1，I p 2:p o r t 2）是H i v e 命名空间 H i v e 命名空间 是配置文件目录 H i v e 配置文件目录 是开启 K e r b e r o s 认证如果需要开启 K e r b e r o s 认证，填写“是”；不需要开启 K e r b e r o s认证，填写“否”是A.1.1 3 K a f k a 数 据 库 接 入 规 范D B 4 4 0 3/T 3 8 4.5 2 0 2 31 1K a f k a 数 据 库 接 入 规 范 见 表 A.1 3。表 A.1 3 K a f k a 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是K a f k a 地址K a f k a 的 I P 和端口，集群用逗号隔开是开启 K e r b e r o s 认证如果需要开启 K e r b e r o s 认证，填写“是”；不需要开启 K e r b e r o s认证，填写“否”是T o p i c K a f k a 的主题名称 是主题数据 K a f k a 主题中的数据样例(注释)是A.1.1 4 R o c k e t M Q 数 据 库 接 入 规 范R o c k e t M Q 数 据 库 接 入 规 范 见 表 A.1 4。表 A.1 4 R o c k e t M Q 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是N a m e S e r v e r R o c k e t M Q 的 N a m e N e r v e r 地址 是T o p i c 主题名称 是主题数据 主题中的数据样例 是A.1.1 5 R a b b i t m q 数 据 库 接 入 规 范R a b b i t m q 数 据 库 接 入 规 范 见 表 A.1 5。表 A.1 5 R a b b i t m q 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是服务器地址 R a b b i t m q I P 地址 是端口 R a b b i t m q 端口 是用户名 R a b b i t m q 账号，必须提供有读取数据表权限的账号 是密码 R a b b i t m q 密码 是Q u e u e 名称 R a b b i t m q 队列的名称 是A.1.1 6 A c t i v e m q 数 据 库 接 入 规 范A c t i v e m q 数 据 库 接 入 规 范 见 表 A.1 6。D B 4 4 0 3/T 3 8 4.5 2 0 2 31 2表 A.1 6 A c t i v e m q 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是集群地址 I P 地址 是T o p i c 主题名称 是主题数据 主题中的数据样例 是A.1.1 7 E S 数 据 库 接 入 规 范E S 数 据 库 接 入 规 范 见 表 A.1 7。表 A.1 7 E S 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是E S 集群名 E S 集群名 是U R L E S I P：端口 是T r a n s p o r t E S 传输客户端 I P:端口 否V e r s i o n E S 的版本号 是索引名称 E S 索引名称 是索引 T y p e E S 索引所使用的 T y p e 是数据结构 数据结构，带注释 是A.1.1 8 M o n g o D B 数 据 库 接 入 规 范M o n g o D B 数 据 库 接 入 规 范 见 表 A.1 8。表 A.1 8 M o n g o D B 数 据 库 接 入 规 范 表接入参数 说明 是否必填数据源名称 自定义 是数据源描述 自定义 是数据库 I P 数据库 I P 地址 是J D B C 端口 数据库端口 是数据库名 M o n g o D B 数据库名称 是用户名 数据库账号，必须提供有读取数据表权限的账号 是密码 数据库密码 是数据库表列表 数据库表列表 是数据库表结构 数据库表列表 是D B 4 4 0 3/T 3 8 4.5 2 0 2 31 3A.2 文 件 上 传 下 载 接 口 说 明A.2.1 文 件 上 传 接 口 参 数 见 表 A.1 9。表 A.1 9 文 件 上 传 接 口 参 数 表接口参数 参数说明u p l o a d P a t h 文件上传路径f i l e N a m e 上传文件名称u s e r N a m e 账户名称p a s s W o r d 账户密码A.2.2 文 件 下 载 接 口 参 数 见 表 A.2 0。表 A.2 0 文 件 下 载 接 口 参 数 表接口参数 参数说明t a r g e t F i l e 文件下载路径u s e r N a m e 账户名称p a s s W o r d 账户密码A.2.3 服 务 端 返 回 调 用 状 态 码 见 表 A.2 1。表 A.2 1 服 务 端 返 回 调 用 状 态 码 表状态码 状态说明2 0 0 调用成功4 0 1 鉴权异常：用户不存在、用户密码错误4 0 0 参数为空4 1 7 下载文件不存在、上传时创建文件夹失败A.3 服 务 接 口 请 示 对 象 参 数A.3.1 服 务 接 口 请 求 对 象 的 X M L S c h e m a 格 式 为：D B 4 4 0 3/T 3 8 4.5 2 0 2 31 4A.3.2 服 务 接 口 请 求 对 象 的 参 数 说 明，见 表 A.2 2。表 A.2 2 服 务 接 口 请 求 对 象 参 数 表参数名称 参数类型 参数说明e s b _ s e r v i c e _ i d I n t e g e r 访问服务标识，关联以下 8 个属性：s e n d e r C o d e:数据请求发送方机构代码s e n d e r N a m e:数据请求发送方机构名称r e c e i v e r C o d e:数据请求接收方机构代码r e c e i v e r N a m e:数据请求接收方机构名称e s b _ s e r v i c e _ i d I n t e g e r r e s o u r c e I D:资源标识符（业务编码）r e s o u r c e N a m e:资源名称（业务名称）u s e r I D:用户标识符u s e r N a m e:用户名称e s b _ t o k e n S t r i n g 认证令牌D B 4 4 0 3/T 3 8 4.5 2 0 2 31 5附 录 B（资 料 性）错 误 码 信 息错 误 码 信 息 见 表 B.1。表 B.1 错 误 码 信 息 表状态码 状态说明2 0 0 成功4 0 0 未知的应用，即应用未注册4 0 1 应用冲突4 0 2 未激活队列4 0 3 队列冲突，即重复激活4 0 4 应用不能访问该区域的信息4 0 5 从共享平台校验 t o k e n 失败，t o k e n 无效；或者过期5 0 0 内部异常7 0 0 其他未知错误D B 4 4 0 3/T 3 8 4.5 2 0 2 31 6附 录 C（资 料 性）消 息 体 格 式C.1 X M L 格 式 u p d a t e c l a s s c o m m o n 2 0 0 0 0 0 0 0 0 1 0 0 0 6 9 9 9 0 9 0 2 a d m i n 2 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 2 2 0 1 5-0 9-0 7 T 1 3:2 9:5 2 1 1 2 3 0 6 1 1 2 8 1 1 2 4 t e s t 1 1 1 0 2 0 0 9 0 3 D B 4 4 0 3/T 3 8 4.5 2 0 2 31 7 1 0 0 0 0 1 2 0 1 5-0 7-2 0 T 1 6:2 9:5 0 C.2 J S O N 格 式 a c t i o n:u p d a t e,c o d e:c l a s s e n t i t y:F i e l d s:B H:,B J D I D:1 0 0 0 0 1,B J I D:2 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 2,B J K J K T S J:,B J M C:t e s t 1,B J X H:,B Z:,C J N F:2 0 0 9,C J S J:2 0 1 5-0 7-2 0 T 1 6:2 9:5 0,C J Z:a d m i n,D Z Y X:,J Y S C B J:0,S J:,S S C S I D:1 1 2 4,S S G J I D:1,S S N J:0 6,S S Q X I D:1 1 2 8,S S S F I D:1 1 2 3,S S X X I D:2 0 0 0 0 0 0 0 0 1 0 0 0 6 9 9 9 0 9,S S Y Y M C:c o m m o n,X D:0 3,X G S J:2 0 1 5-0 9-0 7 T 1 3:2 9:5 2,X G Z:,X Z:0 2 D B 4 4 0 3/T 3 8 4.5 2 0 2 31 8参 考 文 献 1 G B/T 3 5 2 7 4 2 0 1 7 信 息 案 例 技 术 大 数 据 服 务 安 全 能 力 要 求 2 W 3 C X M L S c h e m a D e f i n i t i o n L a n g u a g e(X S D)1.1 P a r t 1:S t r u c t u r e s E B/O L.(2 0 1 2-0 4-0 5)2 0 2 2-0 1-1 4.h t t p s:/w w w.w 3.o r g/T R/x m l s c h e m a 1 1-1/3 W 3 C X M L S c h e m a D e f i n i t i o n L a n g u a g e(X S D)1.1 P a r t 2:D a t a t y p e s E B/O L.(2 0 1 2-0 4-05)2 0 2 2-0 1-1 4.h t t p s:/w w w.w 3.o r g/T R/x m l s c h e m a 1 1-2/4 E x t e n s i b l e M a r k u p L a n g u a g e(X M L)E B/O L.(2 0 1 6-1 0-1 1)2 0 2 2-0 1-1 4.h t t p s:/w w w.w 3.o r g/X M L/5 N a m e s p a c e s i n X M L 1.0(T h i r d E d i t i o n)E B/O L.(2 0 0 9-1 2-0 8)2 0 2 2-0 1-1 4.h t t p s:/ww w.w 3.o r g/T R/x m l-n a m e s/6 T h e S Q L S t a n d a r d I S O/I E C 9 0 7 5:2 0 1 6(A N S I X 3.1 3 5)E B/O L.(2 0 1 8-1 0-0 5)2 0 2 2-0 1-1 4.h t t p s:/b l o g.a n s i.o r g/2 0 1 8/1 0/s q l-s t a n d a r d-i s o-i e c-9 0 7 5-2 0 1 6-a n s i-x 3-1 3 5/?_ g a=2.1 2 7 77 8 3 8 2.2 1 9 0 0 9 2 3 6.1 6 4 2 0 5 9 0 6 3-2 0 7 9 8 9 1 1 5 2.1 6 4 2 0 5 9 0 6 3 7 T h e a p p l i c a t i o n/j s o n M e d i a T y p e f o r J a v a S c r i p t O b j e c t N o t a t i o n(J S O N)E B/O L.(20
展开阅读全文