由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名

项目介绍 快速开始 学习路径 项目截图 2 贡献者 237 增长趋势 Commit 历史 代码统计 生态关系 项目时间线 项目竞品 上榜历史

Apache Cloudberry 5分钟快速开始

通过Docker容器快速体验Cloudberry MPP数据库

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Docker 20.10+ 必需
Docker Compose 2.0+ 必需

所需工具

Git

克隆项目代码

必需

操作步骤

1

克隆项目仓库

获取Cloudberry项目代码

克隆主仓库 
git clone https://github.com/apache/cloudberry.git
进入项目目录 
cd cloudberry

预期结果：：仓库克隆完成，进入cloudberry目录

确保网络连接正常

2

启动Docker沙箱环境

使用Docker快速部署Cloudberry数据库

进入沙箱目录 
cd docker/sandbox
启动Docker容器 
docker-compose up -d

预期结果：：容器启动成功，显示'Creating network...'和'Creating ... done'

首次启动可能需要下载镜像，请耐心等待

3

连接数据库并执行查询

使用psql客户端连接并测试数据库

连接到Cloudberry数据库 
docker exec -it cloudberry-sandbox psql -U gpadmin -d gpadmin
查看数据库版本 
SELECT version();
创建测试表 
CREATE TABLE test_table (id int, name text);
插入测试数据 
INSERT INTO test_table VALUES (1, 'Hello Cloudberry');
查询测试数据 
SELECT * FROM test_table;

预期结果：：成功连接到数据库，版本显示为PostgreSQL 14.x，查询返回测试数据

默认用户名密码为gpadmin/gpadmin

验证Cloudberry运行成功

确认数据库服务正常运行并可执行基本操作

docker ps显示容器状态为'Up'
能成功连接到数据库
能执行SQL查询并返回结果
版本信息包含Cloudberry标识

快速提示

调试

使用docker-compose logs -f查看容器日志

资源管理

容器停止后使用docker-compose down清理资源

连接配置

可以通过端口5432连接到数据库

常见问题

1

Docker容器启动失败

检查Docker服务是否运行，确保有足够的磁盘空间和内存

2

连接数据库时提示认证失败

检查用户名密码是否正确，确保容器已完全启动

3

SQL执行报错

检查SQL语法，确保表名和列名正确

下一步

探索官方文档

访问cloudberry.apache.org/docs了解高级功能

尝试数据加载

学习如何导入CSV等格式的数据

了解集群部署

研究如何部署多节点集群环境

参与社区

加入Slack或GitHub讨论区交流

相关项目推荐

Genymobile

Genymobile/scrcpy

显示并控制您的安卓设备

153k C
microsoft

microsoft/PowerToys

Windows系统实用工具集，助力生产力最大化

140k C
ventoy

ventoy/Ventoy

一种新的可启动USB解决方案。

80k C
obsproject

obsproject/obs-studio

OBS Studio - 用于直播和屏幕录制的免费开源软件

78k C
redis

redis/redis

对于构建实时数据驱动应用的开发者而言，Redis是首选且最快、功能最丰富的缓存系统、数据结构服务器、文档与向量查询引擎。

77k C
colbymchenry

colbymchenry/codegraph

为Claude Code预索引的代码知识图谱——更少的token、更少的工具调用、100%本地化

75k C
助手