DataHub 版本升级指南基于官方升级文档解析 Breaking Changes、ZDU 升级路径与 datahub-upgrade 机制【免费下载链接】datahubThe Context Platform for your Data and AI Stack项目地址: https://gitcode.com/GitHub_Trending/da/datahubDataHub 的 升级文档 是官方记录各版本之间不兼容变更、升级前置要求和迁移步骤的单一权威来源。本文以该文档为主体逐版本解析其 Breaking Changes、Deprecations 与 Potential Downtime 的组织方式重点讲解 v1.6.0 → v1.7.0 的零停机升级ZDU路径、最新Next待发布版本中的关键破坏性变更与新增环境变量并结合 datahub-upgrade 模块源码 说明升级任务SystemUpdate / RestoreIndices 等的实际执行机制帮助你在升级前完成配置核对、权限修复与停机窗口规划。文档定位与阅读方法updating-datahub.md 开篇即声明其用途This file documents any backwards-incompatible changes in DataHub and assists people when migrating to a new version.本文件记录 DataHub 中所有向后不兼容的变更帮助人们迁移到新版本。文档采用统一的五段式结构组织每个版本小节小节含义升级时如何处理Breaking Changes破坏性变更配置、URN、API、依赖版本等不向后兼容的改动逐条执行条目中的Action项Known Issues该版本已知问题评估是否影响你的部署形态Potential Downtime升级可能带来的停机/变慢窗口规划维护窗口Deprecations弃用项仍可用但将在未来版本移除制定迁移计划Other Notable Changes其他值得关注的新特性与行为变化选择性跟进每条 Breaking Change 通常标注了 PR 编号如#18886、影响面标签如(GMS / Auth)、(Ingestion / Snowflake)以及明确的Action:行动项。文档顶部还保留了撰写新条目的模板HTML 注释块要求后续版本条目按## v1.7.1或## v1.8.0这样的版本化标题发布。文档还定义了每个版本的Requirements配套 CLI/Python SDK 版本与 Helm Chart 版本例如 v1.7.0.1 要求 CLI/SDK 1.7.0.9 与 Helm Chart 1.1.0——这是判断服务端与客户端组件版本矩阵的基准。最新待发布版本Next的关键破坏性变更文档最上层的## Next小节是当前 master 上已合入、尚未随版本发布的草稿发布说明。以下按影响面归纳其中最重要的条目完整细节请以 updating-datahub.md 原文为准。搜索与索引Search V3 文档 ID 改为 URN 的 SHA-256 哈希V3 索引的 Elasticsearch/OpenSearch 文档_id从 URL-encoded URN 改为 URN 的 SHA-256 hex完整 URN 仍保留在urn字段中V2 索引不变。若环境中已按 URL-encoded_id写过 V3 文档哈希 ID 不是原地重写——需要用 RestoreIndices 的-a clean或重建全新索引重写并清除旧文档不 clean 的 fill/reindex 会保留旧_id导致更新时产生重复文档。参见 索引恢复指南。结构化属性搜索索引实体索引中的structuredProperties对象改为dynamic: false创建属性定义时立即为每个声明的实体类型写入显式字段映射避免动态映射锁死错误的text类型。若你曾设置ENABLE_STRUCTURED_PROPERTIES_HOOKfalse新索引上的结构化属性值将完全不可搜索——需重新启用 hook 并重新保存属性定义或以ENABLE_STRUCTURED_PROPERTIES_SYSTEM_UPDATEtrue运行 SystemUpdate 重建映射。OpenSearch 3.x 成为受支持的搜索后端与 OpenSearch 2.x、Elasticsearch 7/8/9 并列引擎版本自动探测、无需改配置。两个注意点3.x 拒绝新建使用nmslibkNN 引擎的索引semanticSearch.models.*.knnEngine需切换为faiss或lucene否则 GMS 启动报错3.x 对 bulk 写入强制 512 字节文档 ID 上限新部署应设置ELASTICSEARCH_INDEX_DOC_IDS_SCHEMA_FIELD_HASH_ID_ENABLEDtrue。配置项移除与替换升级前必查pgQueue 空轮询退避#19673空闲 pgQueue 消费者改为指数退避1s 翻倍至 5s。DATAHUB_PGQUEUE_EMPTY_POLL_SLEEP_MS与DATAHUB_PGQUEUE_MCL_EMPTY_POLL_SLEEP_MSYAMLpostgres.pgQueue.consumerPoll.emptyPollSleepMillis/mclEmptyPollSleepMillis已移除且不作为别名读取应改用共享下限DATAHUB_PGQUEUE_EMPTY_POLL_SLEEP_MIN_MS加各 topic 上限DATAHUB_PGQUEUE_MAE_USAGE_EMPTY_POLL_SLEEP_MS、..._MAE_MCL_...、..._MCE_MCP_...、..._PE_...。Python actions 的 pgQueue 事件源移除poll_interval_seconds改用empty_poll_sleep_min_millis/empty_poll_sleep_max_millis。pgQueue 维护 cron#19673postgres.pgQueue.maintenance.intervalSeconds必须映射为合法的 pg_cron 周期——能整除 60 的分钟数、能整除 24 的小时数或恰好 86400。合法取值1/2/3/4/5/6/10/12/15/20/30 分钟1/2/3/4/6/8/12 小时或 1 天其余值会导致 SqlSetup 失败。Kafka 队列时间分位数#19549KAFKA_CONSUMER_PERCENTILES移除messaging_queue_time_seconds的quantile序列不再导出。仪表盘/告警需改用histogram_quantile()基于messaging_queue_time_seconds_bucket计算或使用 SLO bucket 速率。参见 监控文档。GMS 启动保护#19295当 GMS 正在消费 MCLMAE_CONSUMER_ENABLED或MCL_CONSUMER_ENABLED且两条 UI 索引路径全关PRE_PROCESS_HOOKS_UI_ENABLEDfalse且PRE_PROCESS_HOOKS_REPROCESS_ENABLED未设/为 false时 GMS 拒绝启动防止实体已写入但搜索文档缺失的静默状态。Helm 用户在 v1.7 默认走 ZDU可完全跳过 scale-down 流程。授权模型收紧这一组变更是升级后 API 客户端报 403 的最常见原因时序数据读取授权Dataset profile/usage/operations 时序及 dashboard 用量统计现在在 Rest.li、OpenAPI 和 GraphQL 上都需要View Dataset Profile / Usage / Operations权限专用时序 APIgetTimeseriesAspectValues、OpenAPI 时序 scroll、带 URN 过滤的getTimeseriesStats在启用 REST 授权时还要求Get Timeseries Aspect API。缺少权限时单 aspect GET/HEAD 返回 403组装的实体 GET 会静默省略该 aspect。角色/组成员写入#19360 系给 user/group 加角色roleMembership需要Manage Policies把用户加入组groupMembership/nativeGroupMembership需要Edit Group Members自加时需要Manage Users Groups。此前仅凭对 user 实体的Edit Entity就能授予 Admin 角色的漏洞已被PrivilegeGrantAuthorizationValidator关闭。UI 之外的自动化摄取配方、脚本、MCP 直写需重新授权。可通过metadataChangeProposal.validation.aspectAuthorization.privilegeGrant.enabled默认true切换。Analytics APIPOST /openapi/v2/analytics/datahub_usage_events/_search现要求Analytics API accessGET_ANALYTICS_PRIVILEGE或Manage System Operations不再接受人人默认可得的View Analytics。合规表单分配 / 资产摘要设置 / Access TokenbatchAssignForm、batchRemoveForm、createDynamicFormAssignment需要Manage Compliance FormsupdateAssetSettings与assetSettings写入需要Edit Entity或Manage Asset Summary。访问令牌默认禁止无过期期创建允许的有限时长由ACCESS_TOKEN_ALLOWED_DURATIONS默认PT1H,P1D,P7D,P30D,P90D,P180D,P365DISO-8601 逗号分隔列表控制需重新允许无过期期时设ACCESS_TOKEN_ALLOW_NO_EXPIRYtrue。已签发的令牌含永不过期的不受影响。摄取侧变更节选结构化属性两步删除硬删除 active 的结构化属性被拒绝此前硬删会在搜索索引映射中留下不可复用的 qualifiedName。自动化需先datahub delete --urn urn:li:structuredProperty:id --soft再--hard被旧硬删烧掉的名字可用ELASTICSEARCH_INDEX_BUILDER_MAPPINGS_REINDEXtrue运行 SystemUpdate 清理映射。SQL Server 视为三级平台Kafka Connect 中mssql现为database.schema.tableJDBC sink 未设schema.name时默认dbosink URN 从database.table变为database.dbo.tableOracle JDBC sink 改为输出schema.table。acryl-datahub[elasticsearch]要求opensearch-py3.x自行固定版本的用户应写3.0.0,4.0.0。SQL Profiling遗留 Great Expectations SQL profiler 已彻底移除SQLAlchemy profilerv1.1.0 起默认成为唯一 SQL profilerprofiling.method配置与acryl-datahub[profiling-ge]extra 不复存在这与独立的 Great Expectations 验证结果摄取集成无关。连接器支持等级改名SupportStatus.CERTIFIED/INCUBATING/TESTING分别硬替换为GA/BETA/ALPHA旧枚举名直接移除而非别名引用旧名的自定义 source 会在导入期抛AttributeError。日志行格式datahub-frontend、datahub-upgrade、GMS 的默认日志模式去掉行号%logger{36} - %msg%n基于logger:lineNumber的日志解析规则需更新。v1.7.0升级路径与 ZDU 前置条件文档对 v1.7.0 给出了明确的路径约束这是整篇文档中最关键的操作性信息必须先升级到 v1.6.0不能跳过 1.6.0。用 Helm chart1.0.3部署 v1.6.0 并等待 system-update 完成再用 Helm chart1.1.0升级到 v1.7.0。Elasticsearch/OpenSearch 的 ZDUglobal.datahub.systemUpdate.zdu应在后续搜索引擎版本升级时用1.1.0chart 开启而不是在 v1.6.0 安装期间。v1.7.0 的主要破坏性变更包括Spring Boot 4 大版本跃迁GMS 从 Spring Boot 3.5.6 升至4.0.5后续补丁 4.0.6、Spring Framework 7.0、Spring Kafka 4.0。自研 GMS 插件、SpringConfiguration扩展、Kafka listener 定制需针对 Spring Boot 4 重新编译测试。V1 UI 彻底移除THEME_V2_ENABLED/THEME_V2_DEFAULT成为必需项无回退路径。Frontend 升级 Play 3 Apache Pekkosession/flash cookie 改用 Play 3 的 JWT 签名DATAHUB_SECRET绑定到play.http.secret.key未设置、仍为changeme或短于 32 字节都会导致datahub-frontend启动失败。升级前建议用openssl rand -base64 32生成。默认剖析器切为 SQLAlchemy#17465SQL 连接器默认profiling.method: sqlalchemy继续用 GE profiler 需pip install acryl-datahub[profiling-ge]并显式配置method: geUnity Catalog 同理#17563。Airflow 插件只支持 Airflow 3.xapache-airflow下限提到3.0.0[airflow2]extra 移除[airflow3]保留为兼容空操作仍用 Airflow 2.7–2.10 的用户需固定acryl-datahub-airflow-plugin 1.6.0。SECRET_SERVICE_CALLER_GUARD_MODE默认ENFORCE浏览器会话与用户 PAT 不再能通过getSecretValues读取明文 secret依赖此路径的自动化应迁移到 datahub-actions 并使用系统客户端凭证。关系边签名唯一性#18845同一条有向关系边签名(源类型, 目标类型, 关系名)现在只能由源实体上的一个aspect 产生自定义/插件实体注册表中违反此规则会导致 GMS 启动失败。检索/搜索默认实体类型可配置化elasticsearch.search.*EntityTypesvalue/add/remove与SEARCH_*_ENTITY_TYPES{,_ADD,_REMOVE}环境变量取代硬编码列表。v1.7.0 的 Known Issues 与 Potential Downtime 同样不可忽视例如 schemaField 的 domain/ownership 镜像子开关切换不会立即重写历史字段由schemaFieldsFromSchemaMetadatasystem-update 步骤回填ENABLE_STRUCTURED_PROPERTIES_TYPE_MISMATCH_REINDEX生效时首次升级的 BuildIndices 会因字段类型错位而触发实体索引重建系统更新耗时会明显拉长。v1.6.0ZDU 基础设施版本v1.6.0 在文档中被标记为启用 Elasticsearch/OpenSearch ZDU 前必须安装的版本它提供了服务端 ZDU 基础设施、schema version 索引、aspect 迁移扫描保护和 Helm values 基础。配套要求 CLI/SDK 1.6.0、Helm Chart 1.0.3。其他值得注意的破坏性变更datahub.s3迁移到datahub.objectStorageYAML 路径迁移环境变量不变Quickstart 默认本地file://存储不支持预签名 URL。Ebean 事务重试冲突语义可重试数据库事务冲突SQLState40001/40P01、MySQL vendor code1213耗尽重试后OpenAPI/Rest.li 返回 HTTP 503 code: DATABASE_TRANSACTION_CONFLICT、retryable: true与Retry-After头GraphQL 返回code: 503/type: SERVICE_UNAVAILABLE扩展。客户端应把这类错误当作可重试。结构化属性写入校验StructuredPropertiesValidator在validateProposed阶段处理structuredProperties写入默认STRUCTURED_PROPERTIES_DROP_MISSING_PROPERTY_VALUES_WITH_WARNINGtrue下缺失定义的赋值被剥离写全孤儿赋值则整体拒绝。检索过滤条件PegasusCriterion与 GraphQLFacetFilterInput不再暴露单数value字段统一使用values字符串数组。Bootstrap 步骤迁入 system-update实体类型摄取等步骤从 GMS 启动移到 system-update首次升级会有额外系统更新工作。Kafka Actions 提交策略Actions 默认 Kafka offset 提交从同步改为异步async_commit_enabled: true高吞吐场景提升约 25 倍崩溃时最多重投async_commit_interval默认 10 秒内的事件。Docker 镜像构建参数Java 服务镜像统一使用默认基础镜像与 apk 风格包可用 DockerBASE_IMAGE/ Gradle-PdockerBaseImage覆盖JMX Prometheus Java agent 升至 1.0.1scrape 路径改为/metrics4318 端口部分 JVM 指标名随 OpenMetrics 规范变化。v1.6.0 的 Known Issues 值得单列Elasticsearch 8 部署在每次 Helm 升级时可能触发不必要的 mapping reindexES8 持久化 mapping 与 DataHub 声明差异导致误判漂移。官方给出的临时规避让安装/升级后的第一次system-update 完成索引创建然后在后续 Helm 升级前把datahub-gms与datahub-upgrade的ELASTICSEARCH_INDEX_BUILDER_MAPPINGS_REINDEX设为false。升级如何执行datahub-upgrade 机制updating-datahub.md 中大量条目提到 run SystemUpdate、system-update 步骤、Helm pre-install hook这些操作都由datahub-upgrade服务承载。结合仓库源码可以看清其执行链路升级任务注册与选择datahub-upgrade.sh 是本地 compose 部署的入口拉取acryldata/datahub-upgrade:$DATAHUB_VERSION镜像后透传参数。容器入口 start.sh 会先等待 Elasticsearch、Ebean 数据库或 Cassandra、以及仅在GRAPH_SERVICE_IMPL neo4j时的 Neo4j 就绪再启动datahub-upgrade.jar。CLI 层由 UpgradeCli.java 定义-u/--upgrade-id指定升级任务名-a/--arg可多次传namevalue参数-n/--nonblocking-classname可在SystemUpdateNonBlocking中只运行指定的非阻塞步骤。启动时按 Spring Bean 可用性注册各升级实现RestoreIndices、RestoreBackup、SqlSetup、LoadIndices、SystemUpdate、SystemUpdateBlocking、SystemUpdateNonBlocking、SystemUpdateCron、ReindexDebug、Cleanup等执行结果FAILED时进程以非零码退出——这使升级在 CI/Helm hook 中可以被可靠判定。datahub-upgrade README 列出的任务集与文档条目一一对应SystemUpdate执行版本升级所需的全部任务新索引配置、默认设置摄取等完成后向DataHubUpgradeHistory_v1Kafka topic 发消息通知其他 pod 可以启动版本 ID 由内嵌 git tag 加DATAHUB_REVISION组合生成Helm 用它保证每次部署都执行升级。SystemUpdateBlocking / SystemUpdateNonBlocking前者是必须阻塞后续启动的步骤如索引重建、SqlSetup后者如BackfillBrowsePathsV2、GenerateSchemaFieldsFromSchemaMetadata、BackfillDatasetAliases、MigrateAspects在 GMS 启动后后台运行、不延迟服务。RestoreIndices拉取每个 aspect 的最新版本并重放 MetadataChangeLog 事件重建索引支持batchSize默认 1000、batchDelayMs默认 250、aspectName、urn/urnLike过滤、urnBasedPagination等参数。文档中运行 RestoreIndices 加-a clean的指令正是通过-a传参实现的。RestoreBackup从本地 Parquet 备份恢复主存储BACKUP_READERLOCAL_PARQUETBACKUP_FILE_PATH不恢复二级索引/图/搜索——之后需运行 RestoreIndices。EvaluateTests批量执行元数据测试默认每日 CronJob。Cleanupv1.6.0 新增Helm pre-delete hook 用拆除 DataHub 名下的 ES 索引、Kafka topic、SQL 库与用户可用CLEANUP_ELASTICSEARCH_ENABLED等独立关闭。SystemUpdate 的步骤编排SystemUpdate.java 揭示了任务编排顺序先运行ScaleDownEvaluationStep评估阻塞升级是否需要 Kubernetes scale-down由 KubernetesScaleDown 实现状态存于 ConfigMap再依次执行阻塞升级步骤、阻塞 BootstrapMCP 步骤、DataHubStartupStep向升级历史 topic 发消息解锁其他组件、非阻塞 BootstrapMCP最后是非阻塞升级。每个升级实现均实现 Upgrade 接口通过DataHubUpgradeResult实体记录 SUCCEEDED/FAILED 状态——这正是文档中切换回已 SUCCEEDED 的指纹不会重跑需用..._REPROCESStrue或清除对应dataHubUpgradeResult这一语义的底层来源。文档中大量以SYSTEM_UPDATE_*环境变量调优迁移的说明如SYSTEM_UPDATE_ASSERTION_NOTE_MIGRATION_ENABLED、SYSTEM_UPDATE_DATASET_ALIASES_*、MCP_SIDE_EFFECTS_DATA_PRODUCT_ASSETS_*、ZDU_STAGE_20等都作用于该步骤框架完整清单见 Environment Variables。非本地部署的运行方式按 datahub-upgrade README非本地部署需自备.env文件提供EBEAN_DATASOURCE_*数据库、KAFKA_BOOTSTRAP_SERVER/KAFKA_SCHEMAREGISTRY_URL、ELASTICSEARCH_HOST/ELASTICSEARCH_PORT、可选的NEO4J_*、DATAHUB_GMS_HOST/DATAHUB_GMS_PORT以及DATAHUB_MAE_CONSUMER_HOST/PORT然后docker pull acryldata/datahub-upgrade:quickstart \ docker run --env-file path-to-custom-env-file.env \ acryldata/datahub-upgrade:quickstart -u UpgradeJobName -a argvalue例如恢复索引并限定 aspectdocker run --env-file env-file.env acryldata/datahub-upgrade:quickstart \ -u RestoreIndices -a batchSize500 -a batchDelayMs1000Docker 镜像标签变更与 quickstart 用法文档中一条对本地/集群部署都关键的 Breaking Change 是浮动标签:head的取消因为各服务镜像在不同时间打标签:head曾指向混杂的提交集合。新的标签策略本地 Compose/quickstart 使用DATAHUB_VERSIONquickstart或datahub docker quickstart --version head经版本清单解析到quickstart标签:quickstart只在完整镜像矩阵通过冒烟测试后更新保证各服务版本同步。集群部署应固定不可变标签releasev*或提交标签sha-7位短SHA如sha-38960ae裸短 SHA 标签现在带sha-前缀。旧版 CLI 的--version head在加载更新后的 quickstart_version_mapping.yamlhead键下docker_tag: quickstart后仍可用。同一版本还移除了遗留的根级 Docker Compose 文件与脚本docker/quickstart.sh、docker/dev*.sh、docker/nuke.sh及旧 quickstart 捆绑官方建议CLI 安装用datahub docker quickstart贡献者用./gradlew quickstartDebug或scripts/dev/datahub-dev.sh start拆除用datahub docker nuke、./gradlew quickstartDebugNuke或scripts/dev/datahub-dev.sh nuke定制安装基于 docker-compose.quickstart-profile.yml 与 docker/profiles 下的 profile。历史版本速览文档按时间倒序完整保留了从 v0.8.x 到 v1.7.0.1 的全部版本记录升级跨越多个大版本时应按从旧到新顺序逐版本核对。各版本中最具全局影响的节点版本关键不兼容点v1.5.0Java 17 运行时成为必需编译到 Java 17 字节码include_metastore默认关闭导致 Databricks URN 层级变化SQL 解析 view query ID 改为 SHA-256 哈希旧 URL-encoded query 实体需有状态摄取清理多客户端搜索引擎 shimES 7.17/8.x、OpenSearch 2.x 统一接口1.4.0Python 3.9 停止支持要求 3.10Airflow 插件按 Airflow 2.x/3.x 区分安装 extra[airflow2]/[airflow3]LDAP 源默认tls_verify: truepydantic v2 成为硬要求acryl-datahub1.3.0 起1.3.0Airflow 插件支持 3.xCDC 模式CDC_MCL_PROCESSING_ENABLEDtrue基于 Debezium 的有序 MCLquery 实体索引需升级时重建1.2.0Python 3.9 全面要求Airflow 插件移除 v1 插件sql-queries 源default_dialect改名override_dialect0.15.0元数据服务认证与 REST API 授权默认开启DatahubClientConfig的 server 不再默认http://localhost:8080datahub-gc 自动清理软删实体Criterion单数value参数移除0.13.xstateful ingestion 在有pipeline_name时默认开启Unity Cataloginclude_metastore默认关闭Redshifttable_lineage_mode默认 MIXED0.11.0搜索改进要求重建索引system-update 置索引只读并克隆约每 230 万实体 1 小时的量级估计MAE 事件停发0.10.0Kafka topic 环境变量后缀统一为_TOPIC_NAMERedshift 源重构旧版更名redshift-legacyv0.9.4/0.9.5Apache Ranger 授权器从 GMS 核心移为插件application.yaml中的插件配置迁移v0.8.45All Users - All Platform Privileges默认策略移除MANAGE_POLICIES防止所有用户默认可当超级用户补丁版本如 v1.6.0.1/.2、v1.5.0.x、v1.7.0.1主要承担安全加固v1.7.0.1 移除了硬编码的systemClientSecret默认值升级前必须在 GMS、MAE/MCE/PE、frontend 与 Actions 上设置DATAHUB_SYSTEM_CLIENT_SECRET否则服务认证失败并把自建自己对自己的内置策略收敛到VIEW_ENTITY_PAGEGET_ENTITY。升级操作清单综合文档内容与仓库实现一次大版本升级的核对清单如下定位当前与目标版本在 updating-datahub.md 中按从旧到新的顺序通读每个跨越版本的五段式条目把所有Action项收集为工单。核对组件版本矩阵每个版本的 Requirements 给出 CLI/Python SDK 与 Helm Chart 要求客户端CLI、SDK、Airflow/Dagster/Prefect/GX 插件与服务端须满足各自的最低版本约束文档中多处明确此版本连接器不兼容旧 GMS。预置必填密钥DATAHUB_SYSTEM_CLIENT_SECRET、DATAHUB_SECRET≥32 字符、DATAHUB_TOKEN_SERVICE_SIGNING_KEY/DATAHUB_TOKEN_SERVICE_SALT默认值已在 v1.5.0 移除旧 PAT 会失效需重新生成。权限修复为写入roleMembership、时序读取、assetSettings、表单分配、analytics 原始检索等 API 的服务账号/脚本按授权模型收紧小节补充权限避免升级后 403。移除已废弃配置键KAFKA_CONSUMER_PERCENTILES、pgQueue 旧空轮询变量、profiling.method、max_requests_per_minute、enable_lazy_schema_loading、SECRET_SERVICE_CALLER_GUARD_MODE过渡期设置等。规划停机窗口重点核对跨越版本的 Potential Downtime索引重建、aspect schema 扫描、MySQL collation 修复可能锁全表、ES8 误判 reindex 规避跨版本 URN 变更Snowflake 大小写、dbt 小写化、存储过程 URN、Fivetran 多目标路由等优先启用 stateful ingestion 的 stale-entity 清理否则用datahub delete --platform x --soft手动清理。按 ZDU 路径执行v1.6.0Helm 1.0.3→ 等待 system-update 完成 → v1.7.0Helm 1.1.0搜索引擎版本升级在后续用 1.1.0 chart 开启global.datahub.systemUpdate.zdu。集群部署固定sha-*/v*不可变标签。验证升级后确认GET /openapi/v1/rate-limits/config等管理端点、GMS 日志中的升级步骤记录DataHubUpgradeResult实体可查询各步骤状态并按条目要求重跑受影响数据源的摄取以刷新 URN 与 browse path。对于需要重建搜索索引的特定场景Search V3 哈希 ID 迁移、结构化属性映射修复、Glossary 新体验等完整参数与注意事项见 索引恢复指南涉及环境变量的条目统一在 Environment Variables 中登记默认值与适用范围建议作为升级前 diff 的对照表使用。【免费下载链接】datahubThe Context Platform for your Data and AI Stack项目地址: https://gitcode.com/GitHub_Trending/da/datahub创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
