@zilliz/milvus2-sdk-node 2.3.5 → 2.4.0

package/dist/proto/proto/common.proto

@@ -108,6 +108,7 @@ message Status {
     int32 code = 3;
     bool retriable = 4;
     string detail = 5;
+    map<string, string> extra_info = 6;
 }
 
 message KeyValuePair {
@@ -130,6 +131,7 @@ enum PlaceholderType {
     FloatVector = 101;
     Float16Vector = 102;
     BFloat16Vector = 103;
+    SparseFloatVector = 104;
     Int64 = 5;
     VarChar = 21;
 }
@@ -137,7 +139,9 @@ enum PlaceholderType {
 message PlaceholderValue {
     string tag = 1;
     PlaceholderType type = 2;
-    // values is a 2d-array, every array contains a vector
+    // values is a 2d-array of nq rows, every row contains a query vector.
+    // for dense vector, all rows are of the same length; for sparse vector,
+    // the length of each row may vary depending on their number of non-zeros.
     repeated bytes values = 3;
 }
 
@@ -195,6 +199,7 @@ enum MsgType {
     DescribeIndex = 301;
     DropIndex = 302;
     GetIndexStatistics = 303;
+    AlterIndex = 304;
 
     /* MANIPULATION REQUESTS */
     Insert = 400;
@@ -271,6 +276,7 @@ enum MsgType {
     DescribeResourceGroup = 1703;
     TransferNode = 1704;
     TransferReplica = 1705;
+    UpdateResourceGroups = 1706;
 
     /* Database group */
     CreateDatabase = 1801;
@@ -381,6 +387,18 @@ enum ObjectPrivilege {
     PrivilegeDropDatabase = 36;
     PrivilegeListDatabases = 37;
     PrivilegeFlushAll = 38;
+
+    PrivilegeCreatePartition = 39;
+    PrivilegeDropPartition = 40;
+    PrivilegeShowPartitions = 41;
+    PrivilegeHasPartition = 42;
+    PrivilegeGetFlushState = 43;
+    PrivilegeCreateAlias = 44;
+    PrivilegeDropAlias = 45;
+    PrivilegeDescribeAlias = 46;
+    PrivilegeListAliases = 47;
+
+    PrivilegeUpdateResourceGroups = 48;
 }
 
 message PrivilegeExt {
@@ -435,3 +453,10 @@ message ServerInfo {
     // reserved for newly-added feature if necessary.
     map<string, string> reserved = 6;
 }
+
+// NodeInfo is used to describe the node information.
+message NodeInfo {
+    int64 node_id = 1;
+    string address = 2;
+    string hostname = 3;
+}

package/dist/proto/proto/google/protobuf/descriptor.proto

@@ -62,6 +62,10 @@ enum Edition {
   // A placeholder for an unknown edition value.
   EDITION_UNKNOWN = 0;
 
+  // A placeholder edition for specifying default behaviors *before* a feature
+  // was first introduced.  This is effectively an "infinite past".
+  EDITION_LEGACY = 900;
+
   // Legacy syntax "editions".  These pre-date editions, but behave much like
   // distinct editions.  These can't be used to specify the edition of proto
   // files, but feature definitions must supply proto2/proto3 defaults for
@@ -73,6 +77,7 @@ enum Edition {
   // should not be depended on, but they will always be time-ordered for easy
   // comparison.
   EDITION_2023 = 1000;
+  EDITION_2024 = 1001;
 
   // Placeholder editions for testing feature resolution.  These should not be
   // used or relyed on outside of tests.
@@ -81,6 +86,11 @@ enum Edition {
   EDITION_99997_TEST_ONLY = 99997;
   EDITION_99998_TEST_ONLY = 99998;
   EDITION_99999_TEST_ONLY = 99999;
+
+  // Placeholder for specifying unbounded edition support.  This should only
+  // ever be used by plugins that can expect to never require any changes to
+  // support a new edition.
+  EDITION_MAX = 0x7FFFFFFF;
 }
 
 // Describes a complete .proto file.
@@ -202,7 +212,8 @@ message ExtensionRangeOptions {
   // The verification state of the range.
   // TODO: flip the default to DECLARATION once all empty ranges
   // are marked as UNVERIFIED.
-  optional VerificationState verification = 3 [default = UNVERIFIED];
+  optional VerificationState verification = 3
+      [default = UNVERIFIED, retention = RETENTION_SOURCE];
 
   // Clients can define custom options in extensions of this message. See above.
   extensions 1000 to max;
@@ -441,12 +452,16 @@ message FileOptions {
   // This option does nothing.
   optional bool java_generate_equals_and_hash = 20 [deprecated=true];
 
-  // If set true, then the Java2 code generator will generate code that
-  // throws an exception whenever an attempt is made to assign a non-UTF-8
-  // byte sequence to a string field.
-  // Message reflection will do the same.
-  // However, an extension field still accepts non-UTF-8 byte sequences.
-  // This option has no effect on when used with the lite runtime.
+  // A proto2 file can set this to true to opt in to UTF-8 checking for Java,
+  // which will throw an exception if invalid UTF-8 is parsed from the wire or
+  // assigned to a string field.
+  //
+  // TODO: clarify exactly what kinds of field types this option
+  // applies to, and update these docs accordingly.
+  //
+  // Proto3 files already perform these checks. Setting the option explicitly to
+  // false has no effect: it cannot be used to opt proto3 files out of UTF-8
+  // checks.
   optional bool java_string_check_utf8 = 27 [default = false];
 
   // Generated classes can be optimized for speed or code size.
@@ -478,7 +493,7 @@ message FileOptions {
   optional bool cc_generic_services = 16 [default = false];
   optional bool java_generic_services = 17 [default = false];
   optional bool py_generic_services = 18 [default = false];
-  optional bool php_generic_services = 42 [default = false];
+  reserved 42;  // removed php_generic_services
 
   // Is this file deprecated?
   // Depending on the target platform, this can emit Deprecated annotations
@@ -570,10 +585,6 @@ message MessageOptions {
 
   reserved 4, 5, 6;
 
-  // NOTE: Do not set the option in .proto files. Always use the maps syntax
-  // instead. The option should only be implicitly set by the proto compiler
-  // parser.
-  //
   // Whether the message is an automatically generated map entry type for the
   // maps field.
   //
@@ -591,6 +602,10 @@ message MessageOptions {
   // use a native map in the target language to hold the keys and values.
   // The reflection APIs in such implementations still need to work as
   // if the field is a repeated message field.
+  //
+  // NOTE: Do not set the option in .proto files. Always use the maps syntax
+  // instead. The option should only be implicitly set by the proto compiler
+  // parser.
   optional bool map_entry = 7;
 
   reserved 8;  // javalite_serializable
@@ -689,19 +704,11 @@ message FieldOptions {
   // call from multiple threads concurrently, while non-const methods continue
   // to require exclusive access.
   //
-  // Note that implementations may choose not to check required fields within
-  // a lazy sub-message.  That is, calling IsInitialized() on the outer message
-  // may return true even if the inner message has missing required fields.
-  // This is necessary because otherwise the inner message would have to be
-  // parsed in order to perform the check, defeating the purpose of lazy
-  // parsing.  An implementation which chooses not to check required fields
-  // must be consistent about it.  That is, for any particular sub-message, the
-  // implementation must either *always* check its required fields, or *never*
-  // check its required fields, regardless of whether or not the message has
-  // been parsed.
-  //
-  // As of May 2022, lazy verifies the contents of the byte stream during
-  // parsing.  An invalid byte stream will cause the overall parsing to fail.
+  // Note that lazy message fields are still eagerly verified to check
+  // ill-formed wireformat or missing required fields. Calling IsInitialized()
+  // on the outer message would fail if the inner message has missing required
+  // fields. Failed verification would result in parsing failure (except when
+  // uninitialized messages are acceptable).
   optional bool lazy = 5 [default = false];
 
   // unverified_lazy does no correctness checks on the byte stream. This should
@@ -761,6 +768,28 @@ message FieldOptions {
   // Any features defined in the specific edition.
   optional FeatureSet features = 21;
 
+  // Information about the support window of a feature.
+  message FeatureSupport {
+    // The edition that this feature was first available in.  In editions
+    // earlier than this one, the default assigned to EDITION_LEGACY will be
+    // used, and proto files will not be able to override it.
+    optional Edition edition_introduced = 1;
+
+    // The edition this feature becomes deprecated in.  Using this after this
+    // edition may trigger warnings.
+    optional Edition edition_deprecated = 2;
+
+    // The deprecation warning text if this feature is used after the edition it
+    // was marked deprecated in.
+    optional string deprecation_warning = 3;
+
+    // The edition this feature is no longer available in.  In editions after
+    // this one, the last default assigned will be used, and proto files will
+    // not be able to override it.
+    optional Edition edition_removed = 4;
+  }
+  optional FeatureSupport feature_support = 22;
+
   // The parser stores options it doesn't recognize here. See above.
   repeated UninterpretedOption uninterpreted_option = 999;
 
@@ -941,6 +970,10 @@ message FeatureSet {
     retention = RETENTION_RUNTIME,
     targets = TARGET_TYPE_FIELD,
     targets = TARGET_TYPE_FILE,
+    // TODO Enable this in google3 once protoc rolls out.
+    feature_support = {
+      edition_introduced: EDITION_2023,
+    },
     edition_defaults = { edition: EDITION_PROTO2, value: "EXPLICIT" },
     edition_defaults = { edition: EDITION_PROTO3, value: "IMPLICIT" },
     edition_defaults = { edition: EDITION_2023, value: "EXPLICIT" }
@@ -955,6 +988,10 @@ message FeatureSet {
     retention = RETENTION_RUNTIME,
     targets = TARGET_TYPE_ENUM,
     targets = TARGET_TYPE_FILE,
+    // TODO Enable this in google3 once protoc rolls out.
+    feature_support = {
+      edition_introduced: EDITION_2023,
+    },
     edition_defaults = { edition: EDITION_PROTO2, value: "CLOSED" },
     edition_defaults = { edition: EDITION_PROTO3, value: "OPEN" }
   ];
@@ -968,19 +1005,27 @@ message FeatureSet {
     retention = RETENTION_RUNTIME,
     targets = TARGET_TYPE_FIELD,
     targets = TARGET_TYPE_FILE,
+    // TODO Enable this in google3 once protoc rolls out.
+    feature_support = {
+      edition_introduced: EDITION_2023,
+    },
     edition_defaults = { edition: EDITION_PROTO2, value: "EXPANDED" },
     edition_defaults = { edition: EDITION_PROTO3, value: "PACKED" }
   ];
 
   enum Utf8Validation {
     UTF8_VALIDATION_UNKNOWN = 0;
-    NONE = 1;
     VERIFY = 2;
+    NONE = 3;
   }
   optional Utf8Validation utf8_validation = 4 [
     retention = RETENTION_RUNTIME,
     targets = TARGET_TYPE_FIELD,
     targets = TARGET_TYPE_FILE,
+    // TODO Enable this in google3 once protoc rolls out.
+    feature_support = {
+      edition_introduced: EDITION_2023,
+    },
     edition_defaults = { edition: EDITION_PROTO2, value: "NONE" },
     edition_defaults = { edition: EDITION_PROTO3, value: "VERIFY" }
   ];
@@ -994,6 +1039,10 @@ message FeatureSet {
     retention = RETENTION_RUNTIME,
     targets = TARGET_TYPE_FIELD,
     targets = TARGET_TYPE_FILE,
+    // TODO Enable this in google3 once protoc rolls out.
+    feature_support = {
+      edition_introduced: EDITION_2023,
+    },
     edition_defaults = { edition: EDITION_PROTO2, value: "LENGTH_PREFIXED" }
   ];
 
@@ -1007,6 +1056,10 @@ message FeatureSet {
     targets = TARGET_TYPE_MESSAGE,
     targets = TARGET_TYPE_ENUM,
     targets = TARGET_TYPE_FILE,
+    // TODO Enable this in google3 once protoc rolls out.
+    feature_support = {
+      edition_introduced: EDITION_2023,
+    },
     edition_defaults = { edition: EDITION_PROTO2, value: "LEGACY_BEST_EFFORT" },
     edition_defaults = { edition: EDITION_PROTO3, value: "ALLOW" }
   ];
@@ -1015,8 +1068,12 @@ message FeatureSet {
 
   extensions 1000;  // for Protobuf C++
   extensions 1001;  // for Protobuf Java
+  extensions 1002;  // for Protobuf Go
+
+  extensions 9990;  // for deprecated Java Proto1
 
   extensions 9995 to 9999;  // For internal testing
+  extensions 10000;         // for https://github.com/bufbuild/protobuf-es
 }
 
 // A compiled specification for the defaults of a set of features.  These
@@ -1030,7 +1087,12 @@ message FeatureSetDefaults {
   // be used.  This field must be in strict ascending order by edition.
   message FeatureSetEditionDefault {
     optional Edition edition = 3;
-    optional FeatureSet features = 2;
+
+    // Defaults of features that can be overridden in this edition.
+    optional FeatureSet overridable_features = 4;
+
+    // Defaults of features that can't be overridden in this edition.
+    optional FeatureSet fixed_features = 5;
   }
   repeated FeatureSetEditionDefault defaults = 1;
 
@@ -1098,7 +1160,7 @@ message SourceCodeInfo {
     // location.
     //
     // Each element is a field number or an index.  They form a path from
-    // the root FileDescriptorProto to the place where the definition occurs.
+    // the root FileDescriptorProto to the place where the definition appears.
     // For example, this path:
     //   [ 4, 3, 2, 7, 1 ]
     // refers to:

package/dist/proto/proto/milvus.proto

@@ -11,6 +11,7 @@ option java_generate_equals_and_hash = true;
 option csharp_namespace = "Milvus.Client.Grpc";
 
 import "common.proto";
+import "rg.proto";
 import "schema.proto";
 import "feder.proto";
 import "msg.proto";
@@ -45,6 +46,7 @@ service MilvusService {
   rpc ListAliases(ListAliasesRequest) returns (ListAliasesResponse) {}
 
   rpc CreateIndex(CreateIndexRequest) returns (common.Status) {}
+  rpc AlterIndex(AlterIndexRequest) returns (common.Status) {}
   rpc DescribeIndex(DescribeIndexRequest) returns (DescribeIndexResponse) {}
   rpc GetIndexStatistics(GetIndexStatisticsRequest) returns (GetIndexStatisticsResponse) {}
   // Deprecated: use DescribeIndex instead
@@ -61,6 +63,7 @@ service MilvusService {
   rpc Delete(DeleteRequest) returns (MutationResult) {}
   rpc Upsert(UpsertRequest) returns (MutationResult) {}
   rpc Search(SearchRequest) returns (SearchResults) {}
+  rpc HybridSearch(HybridSearchRequest) returns (SearchResults) {}
   rpc Flush(FlushRequest) returns (FlushResponse) {}
   rpc Query(QueryRequest) returns (QueryResults) {}
   rpc CalcDistance(CalcDistanceRequest) returns (CalcDistanceResults) {}
@@ -111,6 +114,7 @@ service MilvusService {
 
   rpc CreateResourceGroup(CreateResourceGroupRequest) returns (common.Status) {}
   rpc DropResourceGroup(DropResourceGroupRequest) returns (common.Status) {}
+  rpc UpdateResourceGroups(UpdateResourceGroupsRequest) returns (common.Status) {}
   rpc TransferNode(TransferNodeRequest) returns (common.Status) {}
   rpc TransferReplica(TransferReplicaRequest) returns (common.Status) {}
   rpc ListResourceGroups(ListResourceGroupsRequest) returns (ListResourceGroupsResponse) {}
@@ -133,6 +137,12 @@ service MilvusService {
 }
 
 message CreateAliasRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Global
+    object_privilege: PrivilegeCreateAlias
+    object_name_index: -1
+  };
+
   common.MsgBase base = 1;
   string db_name = 2;
   string collection_name = 3;
@@ -140,12 +150,24 @@ message CreateAliasRequest {
 }
 
 message DropAliasRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Global
+    object_privilege: PrivilegeDropAlias
+    object_name_index: -1
+  };
+
   common.MsgBase base = 1;
   string db_name = 2;
   string alias = 3;
 }
 
 message AlterAliasRequest{
+  option (common.privilege_ext_obj) = {
+    object_type: Global
+    object_privilege: PrivilegeCreateAlias
+    object_name_index: -1
+  };
+
   common.MsgBase base = 1;
   string db_name = 2;
   string collection_name = 3;
@@ -153,6 +175,12 @@ message AlterAliasRequest{
 }
 
 message DescribeAliasRequest{
+  option (common.privilege_ext_obj) = {
+    object_type: Global
+    object_privilege: PrivilegeDescribeAlias
+    object_name_index: -1
+  };
+
   common.MsgBase base = 1;
   string db_name = 2;
   string alias = 3;
@@ -170,6 +198,12 @@ message DescribeAliasResponse {
 }
 
 message ListAliasesRequest{
+  option (common.privilege_ext_obj) = {
+    object_type: Global
+    object_privilege: PrivilegeListAliases
+    object_name_index: -1
+  };
+
   common.MsgBase base = 1;
   string db_name = 2;
   string collection_name = 3;
@@ -320,6 +354,7 @@ message DescribeCollectionResponse {
   repeated common.KeyValuePair properties = 13;
   string db_name = 14;
   int64 num_partitions = 15;
+  int64 db_id = 16;
 }
 
 /**
@@ -476,6 +511,11 @@ message ShowCollectionsResponse {
 * Create partition in created collection.
 */
 message CreatePartitionRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeCreatePartition
+    object_name_index: 3
+  };
   // Not useful for now
   common.MsgBase base = 1;
   string db_name = 2;
@@ -489,6 +529,11 @@ message CreatePartitionRequest {
 * Drop partition in created collection.
 */
 message DropPartitionRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeDropPartition
+    object_name_index: 3
+  };
   // Not useful for now
   common.MsgBase base = 1;
   string db_name = 2;
@@ -502,6 +547,11 @@ message DropPartitionRequest {
 * Check if partition exist in collection or not.
 */
 message HasPartitionRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeHasPartition
+    object_name_index: 3
+  };
   // Not useful for now
   common.MsgBase base = 1;
   string db_name = 2;
@@ -516,6 +566,11 @@ message HasPartitionRequest {
 * Then you can get these data as result when you do vector search on this collection.
 */
 message LoadPartitionsRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeLoad
+    object_name_index: 3
+  };
   // Not useful for now
   common.MsgBase base = 1;
   string db_name = 2;
@@ -536,6 +591,11 @@ message LoadPartitionsRequest {
 * Then you can not get these data as result when you do vector search on this collection.
 */
 message ReleasePartitionsRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeRelease
+    object_name_index: 3
+  };
   // Not useful for now
   common.MsgBase base = 1;
   string db_name = 2;
@@ -567,6 +627,11 @@ message GetPartitionStatisticsResponse {
 * List all partitions for particular collection
 */
 message ShowPartitionsRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeShowPartitions
+    object_name_index: 3
+  };
   // Not useful for now
   common.MsgBase base = 1;
   string db_name = 2;
@@ -648,6 +713,23 @@ message CreateIndexRequest {
   string index_name = 6;
 }
 
+/*
+* Alter index
+*/
+message AlterIndexRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeCreateIndex
+    object_name_index: 3
+  };
+
+  common.MsgBase base = 1;
+  string db_name = 2;
+  string collection_name = 3;
+  string index_name = 4;
+  repeated common.KeyValuePair extra_params = 5;
+}
+
 /*
 * Get created index information.
 * Current release of Milvus only supports showing latest built index.
@@ -814,6 +896,17 @@ message DeleteRequest {
   string partition_name = 4;
   string expr = 5;
   repeated uint32 hash_keys = 6;
+  common.ConsistencyLevel consistency_level = 7;
+}
+
+
+message SubSearchRequest {
+  string dsl = 1; // must
+  // serialized `PlaceholderGroup`
+  bytes placeholder_group = 2; // must
+  common.DslType dsl_type = 3; // must
+  repeated common.KeyValuePair search_params = 4; // must
+  int64  nq = 5;
 }
 
 
@@ -840,6 +933,7 @@ message SearchRequest {
   common.ConsistencyLevel consistency_level = 14;
   bool use_default_consistency = 15;
   bool search_by_primary_keys = 16;
+  repeated SubSearchRequest sub_reqs = 17;
 }
 
 message Hits {
@@ -854,6 +948,26 @@ message SearchResults {
   string collection_name = 3;
 }
 
+message HybridSearchRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeSearch
+    object_name_index: 3
+  };
+  common.MsgBase base = 1; // must
+  string db_name = 2;
+  string collection_name = 3; // must
+  repeated string partition_names = 4; // must
+  repeated SearchRequest requests = 5;
+  repeated common.KeyValuePair rank_params = 6; // must
+  uint64 travel_timestamp = 7;
+  uint64 guarantee_timestamp = 8; // guarantee_timestamp
+  bool not_return_all_meta = 9;
+  repeated string output_fields = 10;
+  common.ConsistencyLevel consistency_level = 11;
+  bool use_default_consistency = 12;
+}
+
 message FlushRequest {
   option (common.privilege_ext_obj) = {
     object_type: Collection
@@ -1058,6 +1172,7 @@ message ManualCompactionRequest {
   };
   int64 collectionID = 1;
   uint64 timetravel = 2;
+  bool majorCompaction = 3;
 }
 
 message ManualCompactionResponse {
@@ -1095,6 +1210,11 @@ message CompactionMergeInfo {
 }
 
 message GetFlushStateRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeGetFlushState
+    object_name_index: 4
+  };
   repeated int64 segmentIDs = 1;
   uint64 flush_ts = 2;
   string db_name = 3;
@@ -1129,7 +1249,8 @@ message ImportRequest {
   bool row_based = 4;                        // the file is row-based or column-based
   repeated string files = 5;                 // file paths to be imported
   repeated common.KeyValuePair options = 6;  // import options, bucket, etc.
-  string db_name = 7;
+  string db_name = 7;                        // target database
+  bytes clustering_info = 8;                 // serialized `schema.ClusteringInfo`
 }
 
 message ImportResponse {
@@ -1523,6 +1644,17 @@ message CreateResourceGroupRequest {
   };
   common.MsgBase base = 1;
   string resource_group = 2;
+  rg.ResourceGroupConfig config = 3;
+}
+
+message UpdateResourceGroupsRequest {
+  option (common.privilege_ext_obj) = {
+    object_type: Global
+    object_privilege: PrivilegeUpdateResourceGroups
+    object_name_index: -1
+  };
+  common.MsgBase base = 1;
+  map<string, rg.ResourceGroupConfig> resource_groups = 2;
 }
 
 message DropResourceGroupRequest {
@@ -1600,8 +1732,12 @@ message ResourceGroup {
   map<string, int32> num_loaded_replica = 4;
   // collection name -> accessed other rg's node num
   map<string, int32> num_outgoing_node = 5;
-   // collection name -> be accessed node num by other rg
+  // collection name -> be accessed node num by other rg
   map<string, int32> num_incoming_node = 6;
+  // resource group configuration.
+  rg.ResourceGroupConfig config = 7;
+  // query node belong to this resource group now.
+  repeated common.NodeInfo nodes = 8;
 }
 
 message RenameCollectionRequest {
@@ -1715,3 +1851,33 @@ message ReplicateMessageResponse {
   common.Status status = 1;
   string position = 2;
 }
+
+message ImportAuthPlaceholder {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeImport
+    object_name_index: 1
+  };
+  string db_name = 1;
+  string collection_name = 2;
+  string partition_name = 3;
+}
+
+message GetImportProgressAuthPlaceholder {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeImport
+    object_name_index: 1
+  };
+  string db_name = 1;
+}
+
+message ListImportsAuthPlaceholder {
+  option (common.privilege_ext_obj) = {
+    object_type: Collection
+    object_privilege: PrivilegeImport
+    object_name_index: 1
+  };
+  string db_name = 3;
+  string collection_name = 1;
+}

package/dist/proto/proto/rg.proto

@@ -0,0 +1,28 @@
+syntax = "proto3";
+package milvus.proto.rg;
+
+option go_package = "github.com/milvus-io/milvus-proto/go-api/v2/rgpb";
+
+option java_multiple_files = true;
+option java_package = "io.milvus.grpc";
+option java_outer_classname = "ResourceGroupProto";
+option java_generate_equals_and_hash = true;
+
+option csharp_namespace = "Milvus.Client.Grpc";
+
+message ResourceGroupLimit {
+  int32 node_num = 1;
+  // preserve for other limit.
+}
+  
+message ResourceGroupTransfer {
+  string resource_group = 1; // resource groups can be transfered with current resource group.
+  // preserve for other option, such as weight, priority or affinity setup.
+}
+  
+message ResourceGroupConfig {
+  ResourceGroupLimit requests = 1; // requests node num in resource group, if node num is less than requests.nodeNum, it will be transfer from other resource group.
+  ResourceGroupLimit limits = 2; // limited node num in resource group, if node num is more than limits.nodeNum, it will be transfer to other resource group.
+  repeated ResourceGroupTransfer transfer_from = 3; // missing node should be transfer from given resource group at high priority in repeated list.
+  repeated ResourceGroupTransfer transfer_to = 4; // redundant node should be transfer to given resource group at high priority in repeated list.
+}