跳转到主要内容

发送 & 接收 gRPC 元数据

Databend Meta 集群可以通过命令行接口（CLI）发送和接收 gRPC （gRPC 远程过程通话） 元数据（键值对，key-value pairs）。

更新或创建一个键值对​

如果指定的 Key 已经存在，此命令更新现有的键值对；如果指定的 Key 不存在，则创建新的键值对：

./databend-meta --grpc-api-address "<grpc-api-address>" --cmd kvapi::upsert --key <key> --value <value>

示例：​

./databend-meta --grpc-api-address "127.0.0.1:9191" --cmd kvapi::upsert --key 1:key1 --value value1
./databend-meta --grpc-api-address "127.0.0.1:9191" --cmd kvapi::upsert --key 1:key2 --value value2
./databend-meta --grpc-api-address "127.0.0.1:9191" --cmd kvapi::upsert --key 1:key3 --value value3
./databend-meta --grpc-api-address "127.0.0.1:9191" --cmd kvapi::upsert --key 2:key1 --value value1
./databend-meta --grpc-api-address "127.0.0.1:9191" --cmd kvapi::upsert --key 2:key2 --value value2

通过 Key 获取 Value​

此命令可获取指定 Key 的 Value：

./databend-meta --grpc-api-address "<grpc-api-address>" --cmd kvapi::get --key <key>

示例：​

./databend-meta --grpc-api-address "127.0.0.1:9191" --cmd kvapi::get --key 1:key1
./databend-meta --grpc-api-address "127.0.0.1:9191" --cmd kvapi::get --key 2:key2

获取多个 Key 的 Value​

此命令可获取多个指定 Key 的 Value：

./databend-meta --grpc-api-address "<grpc-api-address>" --cmd kvapi::mget --key <key1> <key2> ...

示例：​

./databend-meta --grpc-api-address "127.0.0.1:9191" --cmd kvapi::mget --key 1:key1 2:key2

通过前缀列出键值对​

此命令可根据给出的 Key 前缀，列出了匹配的键值对：

./databend-meta --grpc-api-address "<grpc-api-address>" --cmd kvapi::list --prefix <prefix>

示例：​

./databend-meta --grpc-api-address "127.0.0.1:9191" --cmd kvapi::list --prefix 1:
./databend-meta --grpc-api-address "127.0.0.1:9191" --cmd kvapi::list --prefix 2: