feat: define region server related messages (#79)

* feat: define region server related messages

Signed-off-by: Ruihang Xia <waynestxia@gmail.com>

* finalise

Signed-off-by: Ruihang Xia <waynestxia@gmail.com>

* generate language code

Signed-off-by: Ruihang Xia <waynestxia@gmail.com>

* add missing field

Signed-off-by: Ruihang Xia <waynestxia@gmail.com>

* push region id down

Signed-off-by: Ruihang Xia <waynestxia@gmail.com>

* remove type alias for region id and column id

Signed-off-by: Ruihang Xia <waynestxia@gmail.com>

* define query request

Signed-off-by: Ruihang Xia <waynestxia@gmail.com>

* remove old java file

Signed-off-by: Ruihang Xia <waynestxia@gmail.com>

* remove go code

Signed-off-by: Ruihang Xia <waynestxia@gmail.com>

---------

Signed-off-by: Ruihang Xia <waynestxia@gmail.com>

build.rs

@@ -38,6 +38,7 @@ fn main() {
                 "proto/greptime/v1/meta/store.proto",
                 "proto/greptime/v1/meta/lock.proto",
                 "proto/greptime/v1/meta/cluster.proto",
+                "proto/greptime/v1/region/server.proto",
                 "proto/prometheus/remote/remote.proto",
                 "proto/substrait_extension/promql_plan.proto",
             ],

c++/greptime/v1/region/server.grpc.pb.cc

@@ -0,0 +1,90 @@
+// Generated by the gRPC C++ plugin.
+// If you make any local change, they will be lost.
+// source: greptime/v1/region/server.proto
+
+#include "greptime/v1/region/server.pb.h"
+#include "greptime/v1/region/server.grpc.pb.h"
+
+#include <functional>
+#include <grpcpp/support/async_stream.h>
+#include <grpcpp/support/async_unary_call.h>
+#include <grpcpp/impl/channel_interface.h>
+#include <grpcpp/impl/client_unary_call.h>
+#include <grpcpp/support/client_callback.h>
+#include <grpcpp/support/message_allocator.h>
+#include <grpcpp/support/method_handler.h>
+#include <grpcpp/impl/rpc_service_method.h>
+#include <grpcpp/support/server_callback.h>
+#include <grpcpp/impl/codegen/server_callback_handlers.h>
+#include <grpcpp/server_context.h>
+#include <grpcpp/impl/service_type.h>
+#include <grpcpp/support/sync_stream.h>
+namespace greptime {
+namespace v1 {
+namespace region {
+
+static const char* RegionServer_method_names[] = {
+  "/greptime.v1.region.RegionServer/Handle",
+};
+
+std::unique_ptr< RegionServer::Stub> RegionServer::NewStub(const std::shared_ptr< ::grpc::ChannelInterface>& channel, const ::grpc::StubOptions& options) {
+  (void)options;
+  std::unique_ptr< RegionServer::Stub> stub(new RegionServer::Stub(channel, options));
+  return stub;
+}
+
+RegionServer::Stub::Stub(const std::shared_ptr< ::grpc::ChannelInterface>& channel, const ::grpc::StubOptions& options)
+  : channel_(channel), rpcmethod_Handle_(RegionServer_method_names[0], options.suffix_for_stats(),::grpc::internal::RpcMethod::NORMAL_RPC, channel)
+  {}
+
+::grpc::Status RegionServer::Stub::Handle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::greptime::v1::region::RegionResponse* response) {
+  return ::grpc::internal::BlockingUnaryCall< ::greptime::v1::region::RegionRequest, ::greptime::v1::region::RegionResponse, ::grpc::protobuf::MessageLite, ::grpc::protobuf::MessageLite>(channel_.get(), rpcmethod_Handle_, context, request, response);
+}
+
+void RegionServer::Stub::async::Handle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest* request, ::greptime::v1::region::RegionResponse* response, std::function<void(::grpc::Status)> f) {
+  ::grpc::internal::CallbackUnaryCall< ::greptime::v1::region::RegionRequest, ::greptime::v1::region::RegionResponse, ::grpc::protobuf::MessageLite, ::grpc::protobuf::MessageLite>(stub_->channel_.get(), stub_->rpcmethod_Handle_, context, request, response, std::move(f));
+}
+
+void RegionServer::Stub::async::Handle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest* request, ::greptime::v1::region::RegionResponse* response, ::grpc::ClientUnaryReactor* reactor) {
+  ::grpc::internal::ClientCallbackUnaryFactory::Create< ::grpc::protobuf::MessageLite, ::grpc::protobuf::MessageLite>(stub_->channel_.get(), stub_->rpcmethod_Handle_, context, request, response, reactor);
+}
+
+::grpc::ClientAsyncResponseReader< ::greptime::v1::region::RegionResponse>* RegionServer::Stub::PrepareAsyncHandleRaw(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::grpc::CompletionQueue* cq) {
+  return ::grpc::internal::ClientAsyncResponseReaderHelper::Create< ::greptime::v1::region::RegionResponse, ::greptime::v1::region::RegionRequest, ::grpc::protobuf::MessageLite, ::grpc::protobuf::MessageLite>(channel_.get(), cq, rpcmethod_Handle_, context, request);
+}
+
+::grpc::ClientAsyncResponseReader< ::greptime::v1::region::RegionResponse>* RegionServer::Stub::AsyncHandleRaw(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::grpc::CompletionQueue* cq) {
+  auto* result =
+    this->PrepareAsyncHandleRaw(context, request, cq);
+  result->StartCall();
+  return result;
+}
+
+RegionServer::Service::Service() {
+  AddMethod(new ::grpc::internal::RpcServiceMethod(
+      RegionServer_method_names[0],
+      ::grpc::internal::RpcMethod::NORMAL_RPC,
+      new ::grpc::internal::RpcMethodHandler< RegionServer::Service, ::greptime::v1::region::RegionRequest, ::greptime::v1::region::RegionResponse, ::grpc::protobuf::MessageLite, ::grpc::protobuf::MessageLite>(
+          [](RegionServer::Service* service,
+             ::grpc::ServerContext* ctx,
+             const ::greptime::v1::region::RegionRequest* req,
+             ::greptime::v1::region::RegionResponse* resp) {
+               return service->Handle(ctx, req, resp);
+             }, this)));
+}
+
+RegionServer::Service::~Service() {
+}
+
+::grpc::Status RegionServer::Service::Handle(::grpc::ServerContext* context, const ::greptime::v1::region::RegionRequest* request, ::greptime::v1::region::RegionResponse* response) {
+  (void) context;
+  (void) request;
+  (void) response;
+  return ::grpc::Status(::grpc::StatusCode::UNIMPLEMENTED, "");
+}
+
+
+}  // namespace greptime
+}  // namespace v1
+}  // namespace region
+

c++/greptime/v1/region/server.grpc.pb.h

@@ -0,0 +1,262 @@
+// Generated by the gRPC C++ plugin.
+// If you make any local change, they will be lost.
+// source: greptime/v1/region/server.proto
+// Original file comments:
+// Copyright 2023 Greptime Team
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+#ifndef GRPC_greptime_2fv1_2fregion_2fserver_2eproto__INCLUDED
+#define GRPC_greptime_2fv1_2fregion_2fserver_2eproto__INCLUDED
+
+#include "greptime/v1/region/server.pb.h"
+
+#include <functional>
+#include <grpcpp/generic/async_generic_service.h>
+#include <grpcpp/support/async_stream.h>
+#include <grpcpp/support/async_unary_call.h>
+#include <grpcpp/support/client_callback.h>
+#include <grpcpp/client_context.h>
+#include <grpcpp/completion_queue.h>
+#include <grpcpp/support/message_allocator.h>
+#include <grpcpp/support/method_handler.h>
+#include <grpcpp/impl/codegen/proto_utils.h>
+#include <grpcpp/impl/rpc_method.h>
+#include <grpcpp/support/server_callback.h>
+#include <grpcpp/impl/codegen/server_callback_handlers.h>
+#include <grpcpp/server_context.h>
+#include <grpcpp/impl/service_type.h>
+#include <grpcpp/impl/codegen/status.h>
+#include <grpcpp/support/stub_options.h>
+#include <grpcpp/support/sync_stream.h>
+
+namespace greptime {
+namespace v1 {
+namespace region {
+
+class RegionServer final {
+ public:
+  static constexpr char const* service_full_name() {
+    return "greptime.v1.region.RegionServer";
+  }
+  class StubInterface {
+   public:
+    virtual ~StubInterface() {}
+    virtual ::grpc::Status Handle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::greptime::v1::region::RegionResponse* response) = 0;
+    std::unique_ptr< ::grpc::ClientAsyncResponseReaderInterface< ::greptime::v1::region::RegionResponse>> AsyncHandle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::grpc::CompletionQueue* cq) {
+      return std::unique_ptr< ::grpc::ClientAsyncResponseReaderInterface< ::greptime::v1::region::RegionResponse>>(AsyncHandleRaw(context, request, cq));
+    }
+    std::unique_ptr< ::grpc::ClientAsyncResponseReaderInterface< ::greptime::v1::region::RegionResponse>> PrepareAsyncHandle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::grpc::CompletionQueue* cq) {
+      return std::unique_ptr< ::grpc::ClientAsyncResponseReaderInterface< ::greptime::v1::region::RegionResponse>>(PrepareAsyncHandleRaw(context, request, cq));
+    }
+    // TODO: add stream API
+    class async_interface {
+     public:
+      virtual ~async_interface() {}
+      virtual void Handle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest* request, ::greptime::v1::region::RegionResponse* response, std::function<void(::grpc::Status)>) = 0;
+      virtual void Handle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest* request, ::greptime::v1::region::RegionResponse* response, ::grpc::ClientUnaryReactor* reactor) = 0;
+      // TODO: add stream API
+    };
+    typedef class async_interface experimental_async_interface;
+    virtual class async_interface* async() { return nullptr; }
+    class async_interface* experimental_async() { return async(); }
+   private:
+    virtual ::grpc::ClientAsyncResponseReaderInterface< ::greptime::v1::region::RegionResponse>* AsyncHandleRaw(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::grpc::CompletionQueue* cq) = 0;
+    virtual ::grpc::ClientAsyncResponseReaderInterface< ::greptime::v1::region::RegionResponse>* PrepareAsyncHandleRaw(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::grpc::CompletionQueue* cq) = 0;
+  };
+  class Stub final : public StubInterface {
+   public:
+    Stub(const std::shared_ptr< ::grpc::ChannelInterface>& channel, const ::grpc::StubOptions& options = ::grpc::StubOptions());
+    ::grpc::Status Handle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::greptime::v1::region::RegionResponse* response) override;
+    std::unique_ptr< ::grpc::ClientAsyncResponseReader< ::greptime::v1::region::RegionResponse>> AsyncHandle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::grpc::CompletionQueue* cq) {
+      return std::unique_ptr< ::grpc::ClientAsyncResponseReader< ::greptime::v1::region::RegionResponse>>(AsyncHandleRaw(context, request, cq));
+    }
+    std::unique_ptr< ::grpc::ClientAsyncResponseReader< ::greptime::v1::region::RegionResponse>> PrepareAsyncHandle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::grpc::CompletionQueue* cq) {
+      return std::unique_ptr< ::grpc::ClientAsyncResponseReader< ::greptime::v1::region::RegionResponse>>(PrepareAsyncHandleRaw(context, request, cq));
+    }
+    class async final :
+      public StubInterface::async_interface {
+     public:
+      void Handle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest* request, ::greptime::v1::region::RegionResponse* response, std::function<void(::grpc::Status)>) override;
+      void Handle(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest* request, ::greptime::v1::region::RegionResponse* response, ::grpc::ClientUnaryReactor* reactor) override;
+     private:
+      friend class Stub;
+      explicit async(Stub* stub): stub_(stub) { }
+      Stub* stub() { return stub_; }
+      Stub* stub_;
+    };
+    class async* async() override { return &async_stub_; }
+
+   private:
+    std::shared_ptr< ::grpc::ChannelInterface> channel_;
+    class async async_stub_{this};
+    ::grpc::ClientAsyncResponseReader< ::greptime::v1::region::RegionResponse>* AsyncHandleRaw(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::grpc::CompletionQueue* cq) override;
+    ::grpc::ClientAsyncResponseReader< ::greptime::v1::region::RegionResponse>* PrepareAsyncHandleRaw(::grpc::ClientContext* context, const ::greptime::v1::region::RegionRequest& request, ::grpc::CompletionQueue* cq) override;
+    const ::grpc::internal::RpcMethod rpcmethod_Handle_;
+  };
+  static std::unique_ptr<Stub> NewStub(const std::shared_ptr< ::grpc::ChannelInterface>& channel, const ::grpc::StubOptions& options = ::grpc::StubOptions());
+
+  class Service : public ::grpc::Service {
+   public:
+    Service();
+    virtual ~Service();
+    virtual ::grpc::Status Handle(::grpc::ServerContext* context, const ::greptime::v1::region::RegionRequest* request, ::greptime::v1::region::RegionResponse* response);
+    // TODO: add stream API
+  };
+  template <class BaseClass>
+  class WithAsyncMethod_Handle : public BaseClass {
+   private:
+    void BaseClassMustBeDerivedFromService(const Service* /*service*/) {}
+   public:
+    WithAsyncMethod_Handle() {
+      ::grpc::Service::MarkMethodAsync(0);
+    }
+    ~WithAsyncMethod_Handle() override {
+      BaseClassMustBeDerivedFromService(this);
+    }
+    // disable synchronous version of this method
+    ::grpc::Status Handle(::grpc::ServerContext* /*context*/, const ::greptime::v1::region::RegionRequest* /*request*/, ::greptime::v1::region::RegionResponse* /*response*/) override {
+      abort();
+      return ::grpc::Status(::grpc::StatusCode::UNIMPLEMENTED, "");
+    }
+    void RequestHandle(::grpc::ServerContext* context, ::greptime::v1::region::RegionRequest* request, ::grpc::ServerAsyncResponseWriter< ::greptime::v1::region::RegionResponse>* response, ::grpc::CompletionQueue* new_call_cq, ::grpc::ServerCompletionQueue* notification_cq, void *tag) {
+      ::grpc::Service::RequestAsyncUnary(0, context, request, response, new_call_cq, notification_cq, tag);
+    }
+  };
+  typedef WithAsyncMethod_Handle<Service > AsyncService;
+  template <class BaseClass>
+  class WithCallbackMethod_Handle : public BaseClass {
+   private:
+    void BaseClassMustBeDerivedFromService(const Service* /*service*/) {}
+   public:
+    WithCallbackMethod_Handle() {
+      ::grpc::Service::MarkMethodCallback(0,
+          new ::grpc::internal::CallbackUnaryHandler< ::greptime::v1::region::RegionRequest, ::greptime::v1::region::RegionResponse>(
+            [this](
+                   ::grpc::CallbackServerContext* context, const ::greptime::v1::region::RegionRequest* request, ::greptime::v1::region::RegionResponse* response) { return this->Handle(context, request, response); }));}
+    void SetMessageAllocatorFor_Handle(
+        ::grpc::MessageAllocator< ::greptime::v1::region::RegionRequest, ::greptime::v1::region::RegionResponse>* allocator) {
+      ::grpc::internal::MethodHandler* const handler = ::grpc::Service::GetHandler(0);
+      static_cast<::grpc::internal::CallbackUnaryHandler< ::greptime::v1::region::RegionRequest, ::greptime::v1::region::RegionResponse>*>(handler)
+              ->SetMessageAllocator(allocator);
+    }
+    ~WithCallbackMethod_Handle() override {
+      BaseClassMustBeDerivedFromService(this);
+    }
+    // disable synchronous version of this method
+    ::grpc::Status Handle(::grpc::ServerContext* /*context*/, const ::greptime::v1::region::RegionRequest* /*request*/, ::greptime::v1::region::RegionResponse* /*response*/) override {
+      abort();
+      return ::grpc::Status(::grpc::StatusCode::UNIMPLEMENTED, "");
+    }
+    virtual ::grpc::ServerUnaryReactor* Handle(
+      ::grpc::CallbackServerContext* /*context*/, const ::greptime::v1::region::RegionRequest* /*request*/, ::greptime::v1::region::RegionResponse* /*response*/)  { return nullptr; }
+  };
+  typedef WithCallbackMethod_Handle<Service > CallbackService;
+  typedef CallbackService ExperimentalCallbackService;
+  template <class BaseClass>
+  class WithGenericMethod_Handle : public BaseClass {
+   private:
+    void BaseClassMustBeDerivedFromService(const Service* /*service*/) {}
+   public:
+    WithGenericMethod_Handle() {
+      ::grpc::Service::MarkMethodGeneric(0);
+    }
+    ~WithGenericMethod_Handle() override {
+      BaseClassMustBeDerivedFromService(this);
+    }
+    // disable synchronous version of this method
+    ::grpc::Status Handle(::grpc::ServerContext* /*context*/, const ::greptime::v1::region::RegionRequest* /*request*/, ::greptime::v1::region::RegionResponse* /*response*/) override {
+      abort();
+      return ::grpc::Status(::grpc::StatusCode::UNIMPLEMENTED, "");
+    }
+  };
+  template <class BaseClass>
+  class WithRawMethod_Handle : public BaseClass {
+   private:
+    void BaseClassMustBeDerivedFromService(const Service* /*service*/) {}
+   public:
+    WithRawMethod_Handle() {
+      ::grpc::Service::MarkMethodRaw(0);
+    }
+    ~WithRawMethod_Handle() override {
+      BaseClassMustBeDerivedFromService(this);
+    }
+    // disable synchronous version of this method
+    ::grpc::Status Handle(::grpc::ServerContext* /*context*/, const ::greptime::v1::region::RegionRequest* /*request*/, ::greptime::v1::region::RegionResponse* /*response*/) override {
+      abort();
+      return ::grpc::Status(::grpc::StatusCode::UNIMPLEMENTED, "");
+    }
+    void RequestHandle(::grpc::ServerContext* context, ::grpc::ByteBuffer* request, ::grpc::ServerAsyncResponseWriter< ::grpc::ByteBuffer>* response, ::grpc::CompletionQueue* new_call_cq, ::grpc::ServerCompletionQueue* notification_cq, void *tag) {
+      ::grpc::Service::RequestAsyncUnary(0, context, request, response, new_call_cq, notification_cq, tag);
+    }
+  };
+  template <class BaseClass>
+  class WithRawCallbackMethod_Handle : public BaseClass {
+   private:
+    void BaseClassMustBeDerivedFromService(const Service* /*service*/) {}
+   public:
+    WithRawCallbackMethod_Handle() {
+      ::grpc::Service::MarkMethodRawCallback(0,
+          new ::grpc::internal::CallbackUnaryHandler< ::grpc::ByteBuffer, ::grpc::ByteBuffer>(
+            [this](
+                   ::grpc::CallbackServerContext* context, const ::grpc::ByteBuffer* request, ::grpc::ByteBuffer* response) { return this->Handle(context, request, response); }));
+    }
+    ~WithRawCallbackMethod_Handle() override {
+      BaseClassMustBeDerivedFromService(this);
+    }
+    // disable synchronous version of this method
+    ::grpc::Status Handle(::grpc::ServerContext* /*context*/, const ::greptime::v1::region::RegionRequest* /*request*/, ::greptime::v1::region::RegionResponse* /*response*/) override {
+      abort();
+      return ::grpc::Status(::grpc::StatusCode::UNIMPLEMENTED, "");
+    }
+    virtual ::grpc::ServerUnaryReactor* Handle(
+      ::grpc::CallbackServerContext* /*context*/, const ::grpc::ByteBuffer* /*request*/, ::grpc::ByteBuffer* /*response*/)  { return nullptr; }
+  };
+  template <class BaseClass>
+  class WithStreamedUnaryMethod_Handle : public BaseClass {
+   private:
+    void BaseClassMustBeDerivedFromService(const Service* /*service*/) {}
+   public:
+    WithStreamedUnaryMethod_Handle() {
+      ::grpc::Service::MarkMethodStreamed(0,
+        new ::grpc::internal::StreamedUnaryHandler<
+          ::greptime::v1::region::RegionRequest, ::greptime::v1::region::RegionResponse>(
+            [this](::grpc::ServerContext* context,
+                   ::grpc::ServerUnaryStreamer<
+                     ::greptime::v1::region::RegionRequest, ::greptime::v1::region::RegionResponse>* streamer) {
+                       return this->StreamedHandle(context,
+                         streamer);
+                  }));
+    }
+    ~WithStreamedUnaryMethod_Handle() override {
+      BaseClassMustBeDerivedFromService(this);
+    }
+    // disable regular version of this method
+    ::grpc::Status Handle(::grpc::ServerContext* /*context*/, const ::greptime::v1::region::RegionRequest* /*request*/, ::greptime::v1::region::RegionResponse* /*response*/) override {
+      abort();
+      return ::grpc::Status(::grpc::StatusCode::UNIMPLEMENTED, "");
+    }
+    // replace default version of method with streamed unary
+    virtual ::grpc::Status StreamedHandle(::grpc::ServerContext* context, ::grpc::ServerUnaryStreamer< ::greptime::v1::region::RegionRequest,::greptime::v1::region::RegionResponse>* server_unary_streamer) = 0;
+  };
+  typedef WithStreamedUnaryMethod_Handle<Service > StreamedUnaryService;
+  typedef Service SplitStreamedService;
+  typedef WithStreamedUnaryMethod_Handle<Service > StreamedService;
+};
+
+}  // namespace region
+}  // namespace v1
+}  // namespace greptime
+
+
+#endif  // GRPC_greptime_2fv1_2fregion_2fserver_2eproto__INCLUDED

go/greptime/v1/common.pb.go

@@ -674,6 +674,7 @@ func (x *FlightMetadata) GetAffectedRows() *AffectedRows {
 	return nil
 }
 
+// TODO: deprecate this, and use the `ColumnDef` in region_server.proto instead
 type ColumnDef struct {
 	state         protoimpl.MessageState
 	sizeCache     protoimpl.SizeCache

java/src/main/java/io/greptime/v1/Common.java

@@ -6643,6 +6643,10 @@ public final class Common {
     com.google.protobuf.ByteString getDefaultConstraint();
   }
   /**
+   * <pre>
+   * TODO: deprecate this, and use the `ColumnDef` in region_server.proto instead
+   * </pre>
+   *
    * Protobuf type {@code greptime.v1.ColumnDef}
    */
   public static final class ColumnDef extends
@@ -7013,6 +7017,10 @@ public final class Common {
       return builder;
     }
     /**
+     * <pre>
+     * TODO: deprecate this, and use the `ColumnDef` in region_server.proto instead
+     * </pre>
+     *
      * Protobuf type {@code greptime.v1.ColumnDef}
      */
     public static final class Builder extends

proto/greptime/v1/common.proto

@@ -35,9 +35,7 @@ message RequestHeader {
   optional uint64 span_id = 6;
 }
 
-message ResponseHeader {
+message ResponseHeader { Status status = 1; }
-  Status status = 1;
-}
 
 message Status {
   // Corresponding to the `StatusCode` definition of GreptimeDB
@@ -69,6 +67,7 @@ enum SemanticType {
   TIMESTAMP = 2;
 }
 
+// TODO: deprecate this, and use the `ColumnDef` in region_server.proto instead
 message ColumnDef {
   string name = 1;
   ColumnDataType datatype = 2;
@@ -104,4 +103,3 @@ enum ColumnDataType {
   INTERVAL_DAY_TIME = 24;
   INTERVAL_MONTH_DAY_NANO = 25;
 }
-

proto/greptime/v1/region/server.proto

@@ -0,0 +1,118 @@
+// Copyright 2023 Greptime Team
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package greptime.v1.region;
+
+option java_package = "io.greptime.v1.region";
+option java_outer_classname = "Server";
+option go_package = "github.com/GreptimeTeam/greptime-proto/go/greptime/v1/region";
+
+import "greptime/v1/common.proto";
+import "greptime/v1/row.proto";
+
+service RegionServer {
+  rpc Handle(RegionRequest) returns (RegionResponse);
+  // TODO: add stream API
+}
+
+message RegionRequest {
+  RequestHeader header = 1;
+  // query request is handled in flight services.
+  oneof request {
+    InsertRequests inserts = 3;
+    DeleteRequests deletes = 4;
+    CreateRequest create = 5;
+    DropRequest drop = 6;
+    OpenRequest open = 7;
+    CloseRequest close = 8;
+    AlterRequest alter = 9;
+    FlushRequest flush = 10;
+    CompactRequest compact = 11;
+  }
+}
+
+message RegionResponse {
+  ResponseHeader header = 1;
+  uint64 affacted_rows = 2;
+}
+
+message InsertRequests { repeated InsertRequest requests = 1; }
+
+message DeleteRequests { repeated DeleteRequest requests = 1; }
+
+message InsertRequest {
+  uint64 region_id = 1;
+  repeated Row rows = 2;
+}
+
+message DeleteRequest {
+  uint64 region_id = 1;
+  repeated Row rows = 2;
+}
+
+message QueryRequest {
+  uint64 region_id = 1;
+  // substrait plan to query
+  bytes plan = 2;
+}
+
+message CreateRequest {
+  uint64 region_id = 1;
+  // Region engine name
+  string engine = 2;
+  // Columns in this region.
+  repeated ColumnDef column_defs = 3;
+  // Columns in the primary key.
+  repeated uint32 primary_key = 4;
+  // Create region if not exists.
+  bool create_if_not_exists = 5;
+  // Directory for region's data home. Usually is composed by catalog and table
+  // id
+  string region_dir = 6;
+  // Options of the created region.
+  map<string, string> options = 7;
+  // TODO: add partition def
+}
+
+message DropRequest { uint64 region_id = 1; }
+
+message OpenRequest {
+  uint64 region_id = 1;
+  // Region engine name
+  string engine = 2;
+  // Data directory of the region.
+  string region_dir = 3;
+  // Options of the opened region.
+  map<string, string> options = 4;
+}
+
+message CloseRequest { uint64 region_id = 1; }
+
+// TODO: implement alter request
+message AlterRequest { uint64 region_id = 1; }
+
+message FlushRequest { uint64 region_id = 1; }
+
+message CompactRequest { uint64 region_id = 1; }
+
+message ColumnDef {
+  string name = 1;
+  uint32 column_id = 2;
+  ColumnDataType datatype = 3;
+  bool is_nullable = 4;
+  bytes default_constraint = 5;
+  SemanticType semantic_type = 6;
+}

src/v1/region.rs

@@ -0,0 +1,15 @@
+// Copyright 2023 Greptime Team
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+tonic::include_proto!("greptime.v1.region");