proto: add FindRange, FindSpace and UpdateRanges

This patch adds three new internal RPCs:
1. FindSpace looks up a space in the space cache and returns its
   definition if the space is found.
2. FindRange looks up a range in the range cache and returns its
   description if the range is found.
3. UpdateCache updates the space and range caches on the server.

Needed for tarantool/aeon#313

Author: ImeevMA

aeon_internal.proto

@@ -2,13 +2,20 @@ syntax = "proto3";
 
 import "aeon_error.proto";
 import "aeon_value.proto";
+import "aeon_schema.proto";
 
 package aeon;
 
 // Internal API to Aeon - a distributed database based on Tarantool.
 service InternalService {
   // Get the gRPC server sideservice configuration.
   rpc GetConfig(GetConfigRequest) returns (GetConfigResponse) {}
+  // Find space by name in space cache.
+  rpc FindSpace(FindSpaceRequest) returns (FindSpaceResponse) {}
+  // Find range by space name and a key in range cache.
+  rpc FindRange(FindRangeRequest) returns (FindRangeResponse) {}
+  // Update space cache.
+  rpc UpdateCache(UpdateCacheRequest) returns (UpdateCacheResponse) {}
 }
 
 // Get the gRPC server sideservice configuration.
@@ -44,3 +51,68 @@ message GetConfigResponse {
   // The gRPC server sideservice configuration.
   Config config = 2;
 }
+
+// Find space by name in space cache.
+
+message FindSpaceRequest {
+  // Name of the space to find.
+  string name = 1;
+}
+
+message FindSpaceResponse {
+  // Error information. Set only on failure.
+  Error error = 1;
+  // Definition of the found space.
+  SpaceDef space = 2;
+}
+
+// Find range by space name and a key in range cache.
+
+// Description of a range.
+message Range {
+  // The range ID.
+  string id = 1;
+  // The shard where the range is located.
+  string shard = 2;
+  // The space to which the range belongs.
+  string space = 3;
+  // Raw format of the space.
+  Value format = 4;
+  // Raw key definition of the space.
+  Value key_def = 5;
+  // Minimum key of the range.
+  Tuple begin = 6;
+  // Supremum key of the range, not included into the range.
+  Tuple end = 7;
+  // The state of the range.
+  string state = 8;
+  // The epoch of the range.
+  uint64 epoch = 9;
+  // The timestamp of the last change to the range.
+  uint64 timestamp = 10;
+  // The context of the range.
+  Value context = 11;
+}
+
+message FindRangeRequest {
+  // The name of the space in which to search for the range.
+  string space = 1;
+  // Key from the range.
+  Tuple key = 2;
+}
+
+message FindRangeResponse {
+  // Error information. Set only on failure.
+  Error error = 1;
+  // Description of the found range.
+  Range range = 2;
+}
+
+// Update space and range caches.
+
+message UpdateCacheRequest {}
+
+message UpdateCacheResponse {
+  // Error information. Set only on failure.
+  Error error = 1;
+}

aeon_schema.proto

@@ -84,3 +84,13 @@ message KeyPartDef {
   // Sorting order: ascending (default) or descending.
   KeyPartSortOrder sort_order = 4;
 }
+
+// Space definition.
+message SpaceDef {
+  // Name of the space.
+  string name = 1;
+  // Format of the space.
+  repeated FieldDef format = 2;
+  // Key definition of the space.
+  repeated KeyPartDef key_def = 3;
+}