跳到主要内容

使用对象存储进行部署

引入或更新：v1.2.168

本主题介绍如何使用对象存储部署 Databend。有关支持的对象存储解决方案的列表，请参见 了解部署模式。

开始之前​

在部署 Databend 之前，请确保您已成功设置对象存储并下载了最新版本的 Databend。

1

设置对象存储​

  1. 创建一个名为 my_bucket 的存储桶或容器。
  2. 获取用于连接到您创建的存储桶或容器的端点 URL。
  3. 获取您账户的访问密钥 ID 和秘密访问密钥。

有关如何管理云对象存储的存储桶和访问密钥的信息，请参阅解决方案提供商的用户手册。以下是一些可能有用的链接：

2

下载 Databend​

  1. 在 /usr/local 目录中创建一个名为 databend 的文件夹。
  2. 从 GitHub Release 页面下载适用于您的平台（Linux aarch64 或 x86_64）的最新 Databend 版本。
  3. 将下载的软件包解压到 /usr/local/databend。

步骤 1：部署 Meta 节点​

按照以下说明部署 Meta 节点：

1

启动 Meta 节点​

  1. 打开一个终端窗口，然后导航到文件夹 /usr/local/databend/bin。
  2. 运行以下命令以启动 Meta 节点：
./databend-meta -c ../configs/databend-meta.toml > meta.log 2>&1 &
2

检查 Meta 节点​

运行以下命令以检查 Meta 节点是否已成功启动：

curl -I  http://127.0.0.1:28002/v1/health

步骤 2：部署 Query 节点​

按照以下说明部署 Query 节点：

1

配置 Query 节点​

  1. 在文件夹 /usr/local/databend/configs 中找到文件 databend-query.toml。
  2. 在文件 databend-query.toml 中，设置 [storage] 块中的参数 type，并配置用于连接到对象存储的访问凭据和端点 URL。

要配置存储设置，请通过在每行开头添加 # 来注释掉 [storage.fs] 部分。然后，通过删除 # 符号来取消注释对象存储提供商的相关部分，并填写您的值。

databend-query.toml
[storage]
# s3
type = "s3"

[storage.s3]
# https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html
bucket = "my_bucket"
endpoint_url = "https://s3.amazonaws.com"

# How to get access_key_id and secret_access_key:
# https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html
access_key_id = "<your-key-id>"
secret_access_key = "<your-access-key>"
  1. 使用 [query.users] 部分配置管理员用户。有关更多信息，请参阅 配置管理员用户。要继续使用默认的 root 用户和 "no_password" 身份验证类型，请确保删除文件 databend-query.toml 中以下行之前的 '#' 字符：
警告

在本教程中使用 "no_password" 身份验证 root 用户只是一个示例，由于潜在的安全风险，不建议在生产环境中使用。

databend-query.toml
...
[[query.users]]
name = "root"
auth_type = "no_password"
...
2

启动 Query 节点​

  1. 打开一个终端窗口，导航到文件夹 /usr/local/databend/bin。
  2. 运行以下命令以启动 Query 节点：
./databend-query -c ../configs/databend-query.toml > query.log 2>&1 &
3

检查 Query 节点​

运行以下命令以检查 Query 节点是否已成功启动：

curl -I  http://127.0.0.1:8080/v1/health

步骤 3：验证部署​

在此步骤中，您将使用 BendSQL 针对 Databend 运行一个简单的查询，以验证部署。

1

安装 BendSQL​

按照 安装 BendSQL 在您的机器上安装 BendSQL。

2

连接到 Databend​

启动 BendSQL 并检索当前时间以进行验证。

➜  ~ bendsql
Welcome to BendSQL 0.24.7-ff9563a(2024-12-27T03:23:17.723492000Z).
Connecting to localhost:8000 as user root.
Connected to Databend Query v1.2.714-nightly-59a3e4bd20(rust-1.85.0-nightly-2025-03-30T09:36:19.609323900Z)
Loaded 1406 auto complete keywords from server.
Started web server at 127.0.0.1:8080

root@localhost:8000/default> SELECT NOW();

SELECT NOW()

┌────────────────────────────┐
│            now()           │
│          Timestamp         │
├────────────────────────────┤
│ 2025-04-11 02:36:18.343596 │
└────────────────────────────┘
1 row read in 0.004 sec. Processed 1 row, 1 B (250 rows/s, 250 B/s)

root@localhost:8000/default>

后续步骤​

部署 Databend 后，您可能需要了解以下主题：

指出文档中的错误或问题，我们将会赠予您专属纪念 T 恤一件！
问题反馈
加入我们的社区
GitHub
🌟 8.5K Stars
知乎
bilibili
开源中国
微信
销售电话
185 1688 8139