Gravitino 快速安装上手指南10 分钟跑通统一元数据湖【免费下载链接】gravitinoWorlds most powerful open data catalog for building a high-performance, geo-distributed and federated metadata lake.项目地址: https://gitcode.com/GitHub_Trending/gra/gravitino做数据平台的都知道这个场景表元数据散落在 Hive、MySQL、Iceberg 和云存储里每个查询引擎都各查各的没人说得清数据到底在哪。Apache Gravitino 干的事就是把不同来源的元数据汇聚到一个入口做成一个统一的元数据湖让 Spark、Trino、Flink 这些引擎共用同一张地图。这篇文章带你走一遍环境准备、安装配置、启动验证的完整过程。先做准备核对环境清单动手之前先确认三件事Gravitino 只支持 Linux 和 macOSWindows 暂不支持x86_64 和 ARM64 架构都能跑JDK 17服务端运行和构建都依赖它JAVA_HOME必须配置正确构建工具走源码路线需要 Gradle不用单独装仓库自带gradlew会自动拉取Python 3.10–3.12只在需要构建 Python 客户端时才用得上在终端执行java -version输出里带 17 就没问题。这一步最容易被忽略装错 Java 版本后面的构建会莫名报错。推荐主线三步从源码到可运行包想改配置、看行为的建议走源码构建。整条路径就三件事克隆、打包、解压。第一步克隆仓库git clone https://gitcode.com/GitHub_Trending/gra/gravitino cd gravitino第二步用 Gradle 打出分发包./gradlew assembleDistribution -x test完成后distribution目录下会生成gravitino-version-bin.tar.gz如果想要包含catalogs-contrib里的全部 catalog可以用同目录下的-bin-all包。第三步解压到你的部署目录tar -zxf distribution/gravitino-version-bin.tar.gz -C /path/to/target cd /path/to/target/gravitino-version解压后的目录很直观bin/放启动脚本conf/放配置文件logs/是日志首次启动后自动创建data/是默认的元数据存储位置。启动前只需要动两个配置文件不改任何配置也能直接启动但有两个文件值得认识一下conf/gravitino.conf服务端主配置高频项就两个——监听地址gravitino.server.webserver.host和 HTTP 端口gravitino.server.webserver.httpPort默认 8090。换端口只改这里。conf/gravitino-env.sh环境变量文件JAVA_HOME、GRAVITINO_HOME和调试参数都写在这里。默认元数据存在本地data/目录里不需要先准备 MySQL 或 PostgreSQL。如果生产环境要换关系型存储先导入scripts/mysql/或scripts/postgresql/下对应版本的建表 SQL再改配置即可方法见关系型后端存储说明。一切就绪启动服务器./bin/gravitino.sh start停掉服务用./bin/gravitino.sh stop改完配置想立即生效就用restart。冒烟测试确认服务真的跑起来了 ✅启动后不用翻日志直接敲版本接口curl -v -X GET -H Accept: application/vnd.gravitino.v1json http://localhost:8090/api/version返回带版本号的 JSON说明服务已经起来了。再打开浏览器访问http://localhost:8090能看到 Web UI 就算彻底跑通。进去先建一个 metalake最顶层的容器然后给它挂上第一个 catalog把真实数据源接进来如果页面打不开优先核对gravitino.conf里的端口是否改过——浏览器地址必须跟新端口保持一致这是最常见的假失败。图省事的备选Docker 一行命令如果只是快速体验、不关心内部配置拉个容器镜像最快docker run -d -i -p 8090:8090 apache/gravitino:version curl -v -X GET -H Accept: application/vnd.gravitino.v1json http://localhost:8090/api/version第一条命令拉起服务第二条做同样的冒烟测试。生产环境如果要上 Kubernetes直接用仓库里打包好的 Helm Chart 部署可配置项较多详见 Chart 部署文档。常见坑 FAQQ页面 404 或者完全连不上九成是端口没对上。改过httpPort的话浏览器和 curl 都得用新端口其次确认启动进程还活着看logs/目录里的输出。QWindows 上能跑吗官方暂不支持。用 Linux、macOS或者在虚拟机 / WSL 里跑 Linux。Q内置存储不够用生产上怎么切数据库换 MySQL、PostgreSQL 或 H2 作为关系型后端。步骤是先导入scripts/下对应版本的 SQL再修改gravitino.conf里的存储配置完整做法在官方说明里。Q想换回老版 UI在conf/gravitino-env.sh里设置GRAVITINO_USE_WEB_V2false然后./bin/gravitino.sh restart生效。下一步往哪走服务跑通之后建议按这个顺序深入先读官方文档首页搞懂 metalake、catalog、schema 这套模型接着建一个真实数据源的 catalog在 Web UI 里把表浏览出来最后按自己的引擎选一条路接入——比如 Spark 用户看 Spark 连接器指南程序化操作的可以看 Python 客户端文档docs/how-to-use-python-client.md。有问题就发邮件到 devgravitino.apache.org或者直接在仓库提 Issue。【免费下载链接】gravitinoWorlds most powerful open data catalog for building a high-performance, geo-distributed and federated metadata lake.项目地址: https://gitcode.com/GitHub_Trending/gra/gravitino创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/20 1:42:20 · 阅读 1.2k Gravitino 快速安装上手指南：10 分钟跑通统一元数据湖
Gravitino 快速安装上手指南10 分钟跑通统一元数据湖【免费下载链接】gravitinoWorlds most powerful open data catalog for building a high-performance, geo-distributed and federated metadata lake.项目地址: https://gitcode.com/GitHub_Trending/gra/gravitino做数据平台的都知道这个场景表元数据散落在 Hive、MySQL、Iceberg 和云存储里每个查询引擎都各查各的没人说得清数据到底在哪。Apache Gravitino 干的事就是把不同来源的元数据汇聚到一个入口做成一个统一的元数据湖让 Spark、Trino、Flink 这些引擎共用同一张地图。这篇文章带你走一遍环境准备、安装配置、启动验证的完整过程。先做准备核对环境清单动手之前先确认三件事Gravitino 只支持 Linux 和 macOSWindows 暂不支持x86_64 和 ARM64 架构都能跑JDK 17服务端运行和构建都依赖它JAVA_HOME必须配置正确构建工具走源码路线需要 Gradle不用单独装仓库自带gradlew会自动拉取Python 3.10–3.12只在需要构建 Python 客户端时才用得上在终端执行java -version输出里带 17 就没问题。这一步最容易被忽略装错 Java 版本后面的构建会莫名报错。推荐主线三步从源码到可运行包想改配置、看行为的建议走源码构建。整条路径就三件事克隆、打包、解压。第一步克隆仓库git clone https://gitcode.com/GitHub_Trending/gra/gravitino cd gravitino第二步用 Gradle 打出分发包./gradlew assembleDistribution -x test完成后distribution目录下会生成gravitino-version-bin.tar.gz如果想要包含catalogs-contrib里的全部 catalog可以用同目录下的-bin-all包。第三步解压到你的部署目录tar -zxf distribution/gravitino-version-bin.tar.gz -C /path/to/target cd /path/to/target/gravitino-version解压后的目录很直观bin/放启动脚本conf/放配置文件logs/是日志首次启动后自动创建data/是默认的元数据存储位置。启动前只需要动两个配置文件不改任何配置也能直接启动但有两个文件值得认识一下conf/gravitino.conf服务端主配置高频项就两个——监听地址gravitino.server.webserver.host和 HTTP 端口gravitino.server.webserver.httpPort默认 8090。换端口只改这里。conf/gravitino-env.sh环境变量文件JAVA_HOME、GRAVITINO_HOME和调试参数都写在这里。默认元数据存在本地data/目录里不需要先准备 MySQL 或 PostgreSQL。如果生产环境要换关系型存储先导入scripts/mysql/或scripts/postgresql/下对应版本的建表 SQL再改配置即可方法见关系型后端存储说明。一切就绪启动服务器./bin/gravitino.sh start停掉服务用./bin/gravitino.sh stop改完配置想立即生效就用restart。冒烟测试确认服务真的跑起来了 ✅启动后不用翻日志直接敲版本接口curl -v -X GET -H Accept: application/vnd.gravitino.v1json http://localhost:8090/api/version返回带版本号的 JSON说明服务已经起来了。再打开浏览器访问http://localhost:8090能看到 Web UI 就算彻底跑通。进去先建一个 metalake最顶层的容器然后给它挂上第一个 catalog把真实数据源接进来如果页面打不开优先核对gravitino.conf里的端口是否改过——浏览器地址必须跟新端口保持一致这是最常见的假失败。图省事的备选Docker 一行命令如果只是快速体验、不关心内部配置拉个容器镜像最快docker run -d -i -p 8090:8090 apache/gravitino:version curl -v -X GET -H Accept: application/vnd.gravitino.v1json http://localhost:8090/api/version第一条命令拉起服务第二条做同样的冒烟测试。生产环境如果要上 Kubernetes直接用仓库里打包好的 Helm Chart 部署可配置项较多详见 Chart 部署文档。常见坑 FAQQ页面 404 或者完全连不上九成是端口没对上。改过httpPort的话浏览器和 curl 都得用新端口其次确认启动进程还活着看logs/目录里的输出。QWindows 上能跑吗官方暂不支持。用 Linux、macOS或者在虚拟机 / WSL 里跑 Linux。Q内置存储不够用生产上怎么切数据库换 MySQL、PostgreSQL 或 H2 作为关系型后端。步骤是先导入scripts/下对应版本的 SQL再修改gravitino.conf里的存储配置完整做法在官方说明里。Q想换回老版 UI在conf/gravitino-env.sh里设置GRAVITINO_USE_WEB_V2false然后./bin/gravitino.sh restart生效。下一步往哪走服务跑通之后建议按这个顺序深入先读官方文档首页搞懂 metalake、catalog、schema 这套模型接着建一个真实数据源的 catalog在 Web UI 里把表浏览出来最后按自己的引擎选一条路接入——比如 Spark 用户看 Spark 连接器指南程序化操作的可以看 Python 客户端文档docs/how-to-use-python-client.md。有问题就发邮件到 devgravitino.apache.org或者直接在仓库提 Issue。【免费下载链接】gravitinoWorlds most powerful open data catalog for building a high-performance, geo-distributed and federated metadata lake.项目地址: https://gitcode.com/GitHub_Trending/gra/gravitino创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考