5 分钟跑通 OpenMetadata 元数据管理：数据治理入门指南-港品优选

5 分钟跑通 OpenMetadata 元数据管理：数据治理入门指南

【免费下载链接】OpenMetadataThe Open Context Layer for Data and AI , OpenMetadata is the open platform for building trusted data context and business semantics for humans, AI assistants, and agents.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMetadata

表散在 MySQL、MaxCompute、BigQuery 里，血缘靠口口相传，想治理又找不到抓手——这就是很多团队的日常。OpenMetadata 是一个开源的元数据管理平台，把各数据源的表、列、血缘、质量测试集中到一处，让你先"看得到数据长什么样、从哪来、谁在管"，再谈治理。

5 分钟跑起来 🚀

环境只要求三样：装好 Docker 和 Docker Compose，机器有 8GB 以上可用内存，端口 8585 空闲。Java 环境不用操心，服务都跑在容器里。

git clone https://gitcode.com/GitHub_Trending/op/OpenMetadata cd OpenMetadata/docker/docker-compose-quickstart docker-compose up -d

⚠️ 首次启动会先执行数据库迁移，等几分钟再刷浏览器，别急着下"起不来"的结论。

浏览器打开http://localhost:8585，用 admin / admin 登录（官方文档对账号的说明为准）。启动后的服务与端口如下：

服务	端口	说明
OpenMetadata Server	8585	Web 界面 + REST API 入口
OpenMetadata Admin	8586	管理端口，健康探测用
MySQL	3306	元数据落库
Elasticsearch	9200	全文检索与索引
Ingestion（Airflow）	8080	ingestion 摄取框架的运行环境，调度元数据采集

三个场景看懂它能干什么

场景一：新同事接手一张表。在 Explore 页搜表名，表详情页直接给出列定义、数据类型、描述，以及这张表的上游来源和下游消费者。以前要翻半天文档再找人问的"这列到底存了什么"，现在页面上就有答案。

场景二：上游数据变了，下游怎么第一时间知道？把一张表加进数据质量测试——比如"主键不能为空"——测试失败会生成事件并出现在表的活动记录里。配合列级血缘图，你能沿着边看到哪些下游表、管道被波及，而不是等报表错了才倒查。

场景三：给数据贴上治理标签。在 Data Products 或 Domain（数据域）下把表归到业务域，指定 Owner，再打上"敏感""已认证"这类标签，术语表（Glossary）里的业务口径也可以直接挂到列上。治理不再是 PPT 概念，而是落在每个实体页面上的动作。

最常改的 3 个配置项 🔧

quickstart 全部默认值都能跑通，真要动配置时，90% 的情况只碰下面几项（都在 docker-compose-quickstart 的环境变量里）：

配置	默认值	什么时候改
`DB_HOST`/`DB_PORT`/`OM_DATABASE`	mysql / 3306 / openmetadata_db	想用自带 PostgreSQL 时，改跑同目录的`docker-compose-postgres.yml`，驱动、端口会自动切换
`AUTHENTICATION_PROVIDER`	basic	接企业账号时换成 google（OIDC）、saml、ldap，对应的 OIDC_CLIENT_ID、SAML_、AUTHENTICATION_LDAP_一整套变量在同文件里都有注释模板
`OPENMETADATA_HEAP_OPTS`	-Xmx1G -Xms1G	元数据量上万张表后，按机器内存调大

其余搜索集群地址、JWT 密钥、SMTP 等选项 compose 文件里都有默认值，用到再查。

用起来之后的事

服务是否活着、日志在哪、启动失败先查什么，一张表说清：

你想知道	怎么做
服务活着吗	`curl http://localhost:8585/api/v1/health`，返回 OK 即存活（生产环境建议用 8586 管理口的`/healthcheck`）
日志在哪	`docker logs openmetadata_server`，容器日志即全部运行日志
起不来先查哪	端口 8585/3306/9200 是否被占；MySQL、Elasticsearch 容器是否 healthy；`execute_migrate_all`迁移容器是否成功退出
页面能开但搜不到数据	Elasticsearch 索引还在写入，稍等后重试搜索

⚠️ 迁移容器execute_migrate_all没跑完之前，Server 是不会起来的，看日志前先确认它状态为 Exited (0)。

下一步探索

跑通只是入口，按兴趣挑一条深入：

接入自己的数据源：写一条 YAML 配置把 MySQL 或 PostgreSQL 的库表同步进来，模板在 ingestion/examples，摄取框架本身在 ingestion/src/metadata/ingestion
质量测试与血缘进阶：仓库里的数据质量示例给了从建服务到跑测试的完整样例
深入架构：openmetadata-service 是服务端核心，docs/ 下有 API 参考与实体索引，遇到问题再翻源码不迟

先让数据被看见，治理才有对象。把 quickstart 跑起来，接进你自己的第一个库，剩下的路会在用中自然展开。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析