feat: add explain options to query request (#225)

* feat: add verbose flag

* feat: use options for explain

* chore: generate codes

c++/greptime/v1/common.pb.cc

@@ -40,6 +40,7 @@ PROTOBUF_CONSTEXPR QueryContext::QueryContext(
   , /*decltype(_impl_.current_schema_)*/{&::_pbi::fixed_address_empty_string, ::_pbi::ConstantInitialized{}}
   , /*decltype(_impl_.timezone_)*/{&::_pbi::fixed_address_empty_string, ::_pbi::ConstantInitialized{}}
   , /*decltype(_impl_.snapshot_seqs_)*/nullptr
+  , /*decltype(_impl_.explain_)*/nullptr
   , /*decltype(_impl_.channel_)*/0u
   , /*decltype(_impl_._cached_size_)*/{}} {}
 struct QueryContextDefaultTypeInternal {
@@ -75,6 +76,19 @@ struct SnapshotSequencesDefaultTypeInternal {
   };
 };
 PROTOBUF_ATTRIBUTE_NO_DESTROY PROTOBUF_CONSTINIT PROTOBUF_ATTRIBUTE_INIT_PRIORITY1 SnapshotSequencesDefaultTypeInternal _SnapshotSequences_default_instance_;
+PROTOBUF_CONSTEXPR ExplainOptions::ExplainOptions(
+    ::_pbi::ConstantInitialized): _impl_{
+    /*decltype(_impl_.verbose_)*/false
+  , /*decltype(_impl_._cached_size_)*/{}} {}
+struct ExplainOptionsDefaultTypeInternal {
+  PROTOBUF_CONSTEXPR ExplainOptionsDefaultTypeInternal()
+      : _instance(::_pbi::ConstantInitialized{}) {}
+  ~ExplainOptionsDefaultTypeInternal() {}
+  union {
+    ExplainOptions _instance;
+  };
+};
+PROTOBUF_ATTRIBUTE_NO_DESTROY PROTOBUF_CONSTINIT PROTOBUF_ATTRIBUTE_INIT_PRIORITY1 ExplainOptionsDefaultTypeInternal _ExplainOptions_default_instance_;
 PROTOBUF_CONSTEXPR RequestHeader_TracingContextEntry_DoNotUse::RequestHeader_TracingContextEntry_DoNotUse(
     ::_pbi::ConstantInitialized) {}
 struct RequestHeader_TracingContextEntry_DoNotUseDefaultTypeInternal {
@@ -336,7 +350,7 @@ struct ColumnOptionsDefaultTypeInternal {
 PROTOBUF_ATTRIBUTE_NO_DESTROY PROTOBUF_CONSTINIT PROTOBUF_ATTRIBUTE_INIT_PRIORITY1 ColumnOptionsDefaultTypeInternal _ColumnOptions_default_instance_;
 }  // namespace v1
 }  // namespace greptime
-static ::_pb::Metadata file_level_metadata_greptime_2fv1_2fcommon_2eproto[23];
+static ::_pb::Metadata file_level_metadata_greptime_2fv1_2fcommon_2eproto[24];
 static const ::_pb::EnumDescriptor* file_level_enum_descriptors_greptime_2fv1_2fcommon_2eproto[3];
 static constexpr ::_pb::ServiceDescriptor const** file_level_service_descriptors_greptime_2fv1_2fcommon_2eproto = nullptr;
 
@@ -363,6 +377,7 @@ const uint32_t TableStruct_greptime_2fv1_2fcommon_2eproto::offsets[] PROTOBUF_SE
   PROTOBUF_FIELD_OFFSET(::greptime::v1::QueryContext, _impl_.extensions_),
   PROTOBUF_FIELD_OFFSET(::greptime::v1::QueryContext, _impl_.channel_),
   PROTOBUF_FIELD_OFFSET(::greptime::v1::QueryContext, _impl_.snapshot_seqs_),
+  PROTOBUF_FIELD_OFFSET(::greptime::v1::QueryContext, _impl_.explain_),
   PROTOBUF_FIELD_OFFSET(::greptime::v1::SnapshotSequences_SnapshotSeqsEntry_DoNotUse, _has_bits_),
   PROTOBUF_FIELD_OFFSET(::greptime::v1::SnapshotSequences_SnapshotSeqsEntry_DoNotUse, _internal_metadata_),
   ~0u,  // no _extensions_
@@ -380,6 +395,13 @@ const uint32_t TableStruct_greptime_2fv1_2fcommon_2eproto::offsets[] PROTOBUF_SE
   ~0u,  // no _weak_field_map_
   ~0u,  // no _inlined_string_donated_
   PROTOBUF_FIELD_OFFSET(::greptime::v1::SnapshotSequences, _impl_.snapshot_seqs_),
+  ~0u,  // no _has_bits_
+  PROTOBUF_FIELD_OFFSET(::greptime::v1::ExplainOptions, _internal_metadata_),
+  ~0u,  // no _extensions_
+  ~0u,  // no _oneof_case_
+  ~0u,  // no _weak_field_map_
+  ~0u,  // no _inlined_string_donated_
+  PROTOBUF_FIELD_OFFSET(::greptime::v1::ExplainOptions, _impl_.verbose_),
   PROTOBUF_FIELD_OFFSET(::greptime::v1::RequestHeader_TracingContextEntry_DoNotUse, _has_bits_),
   PROTOBUF_FIELD_OFFSET(::greptime::v1::RequestHeader_TracingContextEntry_DoNotUse, _internal_metadata_),
   ~0u,  // no _extensions_
@@ -542,27 +564,28 @@ const uint32_t TableStruct_greptime_2fv1_2fcommon_2eproto::offsets[] PROTOBUF_SE
 static const ::_pbi::MigrationSchema schemas[] PROTOBUF_SECTION_VARIABLE(protodesc_cold) = {
   { 0, 8, -1, sizeof(::greptime::v1::QueryContext_ExtensionsEntry_DoNotUse)},
   { 10, -1, -1, sizeof(::greptime::v1::QueryContext)},
-  { 22, 30, -1, sizeof(::greptime::v1::SnapshotSequences_SnapshotSeqsEntry_DoNotUse)},
-  { 32, -1, -1, sizeof(::greptime::v1::SnapshotSequences)},
-  { 39, 47, -1, sizeof(::greptime::v1::RequestHeader_TracingContextEntry_DoNotUse)},
-  { 49, -1, -1, sizeof(::greptime::v1::RequestHeader)},
-  { 61, -1, -1, sizeof(::greptime::v1::ResponseHeader)},
-  { 68, -1, -1, sizeof(::greptime::v1::Status)},
-  { 76, -1, -1, sizeof(::greptime::v1::AuthHeader)},
-  { 85, -1, -1, sizeof(::greptime::v1::Basic)},
-  { 93, -1, -1, sizeof(::greptime::v1::Token)},
-  { 100, -1, -1, sizeof(::greptime::v1::TableName)},
-  { 109, -1, -1, sizeof(::greptime::v1::AffectedRows)},
-  { 116, -1, -1, sizeof(::greptime::v1::Metrics)},
-  { 123, -1, -1, sizeof(::greptime::v1::ExpireAfter)},
-  { 130, -1, -1, sizeof(::greptime::v1::FlightMetadata)},
-  { 138, -1, -1, sizeof(::greptime::v1::IntervalMonthDayNano)},
-  { 147, -1, -1, sizeof(::greptime::v1::Decimal128)},
-  { 155, -1, -1, sizeof(::greptime::v1::ColumnDataTypeExtension)},
-  { 165, -1, -1, sizeof(::greptime::v1::DecimalTypeExtension)},
-  { 173, -1, -1, sizeof(::greptime::v1::VectorTypeExtension)},
-  { 180, 188, -1, sizeof(::greptime::v1::ColumnOptions_OptionsEntry_DoNotUse)},
-  { 190, -1, -1, sizeof(::greptime::v1::ColumnOptions)},
+  { 23, 31, -1, sizeof(::greptime::v1::SnapshotSequences_SnapshotSeqsEntry_DoNotUse)},
+  { 33, -1, -1, sizeof(::greptime::v1::SnapshotSequences)},
+  { 40, -1, -1, sizeof(::greptime::v1::ExplainOptions)},
+  { 47, 55, -1, sizeof(::greptime::v1::RequestHeader_TracingContextEntry_DoNotUse)},
+  { 57, -1, -1, sizeof(::greptime::v1::RequestHeader)},
+  { 69, -1, -1, sizeof(::greptime::v1::ResponseHeader)},
+  { 76, -1, -1, sizeof(::greptime::v1::Status)},
+  { 84, -1, -1, sizeof(::greptime::v1::AuthHeader)},
+  { 93, -1, -1, sizeof(::greptime::v1::Basic)},
+  { 101, -1, -1, sizeof(::greptime::v1::Token)},
+  { 108, -1, -1, sizeof(::greptime::v1::TableName)},
+  { 117, -1, -1, sizeof(::greptime::v1::AffectedRows)},
+  { 124, -1, -1, sizeof(::greptime::v1::Metrics)},
+  { 131, -1, -1, sizeof(::greptime::v1::ExpireAfter)},
+  { 138, -1, -1, sizeof(::greptime::v1::FlightMetadata)},
+  { 146, -1, -1, sizeof(::greptime::v1::IntervalMonthDayNano)},
+  { 155, -1, -1, sizeof(::greptime::v1::Decimal128)},
+  { 163, -1, -1, sizeof(::greptime::v1::ColumnDataTypeExtension)},
+  { 173, -1, -1, sizeof(::greptime::v1::DecimalTypeExtension)},
+  { 181, -1, -1, sizeof(::greptime::v1::VectorTypeExtension)},
+  { 188, 196, -1, sizeof(::greptime::v1::ColumnOptions_OptionsEntry_DoNotUse)},
+  { 198, -1, -1, sizeof(::greptime::v1::ColumnOptions)},
 };
 
 static const ::_pb::Message* const file_default_instances[] = {
@@ -570,6 +593,7 @@ static const ::_pb::Message* const file_default_instances[] = {
   &::greptime::v1::_QueryContext_default_instance_._instance,
   &::greptime::v1::_SnapshotSequences_SnapshotSeqsEntry_DoNotUse_default_instance_._instance,
   &::greptime::v1::_SnapshotSequences_default_instance_._instance,
+  &::greptime::v1::_ExplainOptions_default_instance_._instance,
   &::greptime::v1::_RequestHeader_TracingContextEntry_DoNotUse_default_instance_._instance,
   &::greptime::v1::_RequestHeader_default_instance_._instance,
   &::greptime::v1::_ResponseHeader_default_instance_._instance,
@@ -593,73 +617,75 @@ static const ::_pb::Message* const file_default_instances[] = {
 
 const char descriptor_table_protodef_greptime_2fv1_2fcommon_2eproto[] PROTOBUF_SECTION_VARIABLE(protodesc_cold) =
   "\n\030greptime/v1/common.proto\022\013greptime.v1\""
-  "\213\002\n\014QueryContext\022\027\n\017current_catalog\030\001 \001("
+  "\271\002\n\014QueryContext\022\027\n\017current_catalog\030\001 \001("
   "\t\022\026\n\016current_schema\030\002 \001(\t\022\020\n\010timezone\030\004 "
   "\001(\t\022=\n\nextensions\030\005 \003(\0132).greptime.v1.Qu"
   "eryContext.ExtensionsEntry\022\017\n\007channel\030\006 "
   "\001(\r\0225\n\rsnapshot_seqs\030\007 \001(\0132\036.greptime.v1"
-  ".SnapshotSequences\0321\n\017ExtensionsEntry\022\013\n"
-  "\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\"\221\001\n\021Snapsh"
-  "otSequences\022G\n\rsnapshot_seqs\030\007 \003(\01320.gre"
-  "ptime.v1.SnapshotSequences.SnapshotSeqsE"
-  "ntry\0323\n\021SnapshotSeqsEntry\022\013\n\003key\030\001 \001(\004\022\r"
-  "\n\005value\030\002 \001(\004:\0028\001\"\202\002\n\rRequestHeader\022\017\n\007c"
-  "atalog\030\001 \001(\t\022\016\n\006schema\030\002 \001(\t\022.\n\rauthoriz"
-  "ation\030\003 \001(\0132\027.greptime.v1.AuthHeader\022\016\n\006"
-  "dbname\030\004 \001(\t\022G\n\017tracing_context\030\005 \003(\0132.."
-  "greptime.v1.RequestHeader.TracingContext"
-  "Entry\022\020\n\010timezone\030\006 \001(\t\0325\n\023TracingContex"
-  "tEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\"5"
-  "\n\016ResponseHeader\022#\n\006status\030\001 \001(\0132\023.grept"
-  "ime.v1.Status\".\n\006Status\022\023\n\013status_code\030\001"
-  " \001(\r\022\017\n\007err_msg\030\002 \001(\t\"e\n\nAuthHeader\022#\n\005b"
-  "asic\030\001 \001(\0132\022.greptime.v1.BasicH\000\022#\n\005toke"
-  "n\030\002 \001(\0132\022.greptime.v1.TokenH\000B\r\n\013auth_sc"
-  "heme\"+\n\005Basic\022\020\n\010username\030\001 \001(\t\022\020\n\010passw"
-  "ord\030\002 \001(\t\"\026\n\005Token\022\r\n\005token\030\001 \001(\t\"J\n\tTab"
-  "leName\022\024\n\014catalog_name\030\001 \001(\t\022\023\n\013schema_n"
-  "ame\030\002 \001(\t\022\022\n\ntable_name\030\003 \001(\t\"\035\n\014Affecte"
-  "dRows\022\r\n\005value\030\001 \001(\r\"\032\n\007Metrics\022\017\n\007metri"
-  "cs\030\001 \001(\014\"\034\n\013ExpireAfter\022\r\n\005value\030\001 \001(\003\"i"
-  "\n\016FlightMetadata\0220\n\raffected_rows\030\001 \001(\0132"
-  "\031.greptime.v1.AffectedRows\022%\n\007metrics\030\002 "
-  "\001(\0132\024.greptime.v1.Metrics\"I\n\024IntervalMon"
-  "thDayNano\022\016\n\006months\030\001 \001(\005\022\014\n\004days\030\002 \001(\005\022"
-  "\023\n\013nanoseconds\030\003 \001(\003\"$\n\nDecimal128\022\n\n\002hi"
-  "\030\001 \001(\003\022\n\n\002lo\030\002 \001(\003\"\316\001\n\027ColumnDataTypeExt"
-  "ension\0229\n\014decimal_type\030\001 \001(\0132!.greptime."
-  "v1.DecimalTypeExtensionH\000\0223\n\tjson_type\030\002"
-  " \001(\0162\036.greptime.v1.JsonTypeExtensionH\000\0227"
-  "\n\013vector_type\030\003 \001(\0132 .greptime.v1.Vector"
-  "TypeExtensionH\000B\n\n\010type_ext\"8\n\024DecimalTy"
-  "peExtension\022\021\n\tprecision\030\001 \001(\005\022\r\n\005scale\030"
-  "\002 \001(\005\"\"\n\023VectorTypeExtension\022\013\n\003dim\030\001 \001("
-  "\r\"y\n\rColumnOptions\0228\n\007options\030\001 \003(\0132\'.gr"
-  "eptime.v1.ColumnOptions.OptionsEntry\032.\n\014"
-  "OptionsEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t"
-  ":\0028\001*1\n\014SemanticType\022\007\n\003TAG\020\000\022\t\n\005FIELD\020\001"
-  "\022\r\n\tTIMESTAMP\020\002*\354\003\n\016ColumnDataType\022\013\n\007BO"
-  "OLEAN\020\000\022\010\n\004INT8\020\001\022\t\n\005INT16\020\002\022\t\n\005INT32\020\003\022"
-  "\t\n\005INT64\020\004\022\t\n\005UINT8\020\005\022\n\n\006UINT16\020\006\022\n\n\006UIN"
-  "T32\020\007\022\n\n\006UINT64\020\010\022\013\n\007FLOAT32\020\t\022\013\n\007FLOAT6"
-  "4\020\n\022\n\n\006BINARY\020\013\022\n\n\006STRING\020\014\022\010\n\004DATE\020\r\022\014\n"
-  "\010DATETIME\020\016\022\024\n\020TIMESTAMP_SECOND\020\017\022\031\n\025TIM"
-  "ESTAMP_MILLISECOND\020\020\022\031\n\025TIMESTAMP_MICROS"
-  "ECOND\020\021\022\030\n\024TIMESTAMP_NANOSECOND\020\022\022\017\n\013TIM"
-  "E_SECOND\020\023\022\024\n\020TIME_MILLISECOND\020\024\022\024\n\020TIME"
-  "_MICROSECOND\020\025\022\023\n\017TIME_NANOSECOND\020\026\022\027\n\023I"
-  "NTERVAL_YEAR_MONTH\020\027\022\025\n\021INTERVAL_DAY_TIM"
-  "E\020\030\022\033\n\027INTERVAL_MONTH_DAY_NANO\020\031\022\016\n\nDECI"
-  "MAL128\020\036\022\010\n\004JSON\020\037\022\n\n\006VECTOR\020 *$\n\021JsonTy"
-  "peExtension\022\017\n\013JSON_BINARY\020\000BO\n\016io.grept"
-  "ime.v1B\006CommonZ5github.com/GreptimeTeam/"
-  "greptime-proto/go/greptime/v1b\006proto3"
+  ".SnapshotSequences\022,\n\007explain\030\010 \001(\0132\033.gr"
+  "eptime.v1.ExplainOptions\0321\n\017ExtensionsEn"
+  "try\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\"\221\001\n\021"
+  "SnapshotSequences\022G\n\rsnapshot_seqs\030\007 \003(\013"
+  "20.greptime.v1.SnapshotSequences.Snapsho"
+  "tSeqsEntry\0323\n\021SnapshotSeqsEntry\022\013\n\003key\030\001"
+  " \001(\004\022\r\n\005value\030\002 \001(\004:\0028\001\"!\n\016ExplainOption"
+  "s\022\017\n\007verbose\030\001 \001(\010\"\202\002\n\rRequestHeader\022\017\n\007"
+  "catalog\030\001 \001(\t\022\016\n\006schema\030\002 \001(\t\022.\n\rauthori"
+  "zation\030\003 \001(\0132\027.greptime.v1.AuthHeader\022\016\n"
+  "\006dbname\030\004 \001(\t\022G\n\017tracing_context\030\005 \003(\0132."
+  ".greptime.v1.RequestHeader.TracingContex"
+  "tEntry\022\020\n\010timezone\030\006 \001(\t\0325\n\023TracingConte"
+  "xtEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\""
+  "5\n\016ResponseHeader\022#\n\006status\030\001 \001(\0132\023.grep"
+  "time.v1.Status\".\n\006Status\022\023\n\013status_code\030"
+  "\001 \001(\r\022\017\n\007err_msg\030\002 \001(\t\"e\n\nAuthHeader\022#\n\005"
+  "basic\030\001 \001(\0132\022.greptime.v1.BasicH\000\022#\n\005tok"
+  "en\030\002 \001(\0132\022.greptime.v1.TokenH\000B\r\n\013auth_s"
+  "cheme\"+\n\005Basic\022\020\n\010username\030\001 \001(\t\022\020\n\010pass"
+  "word\030\002 \001(\t\"\026\n\005Token\022\r\n\005token\030\001 \001(\t\"J\n\tTa"
+  "bleName\022\024\n\014catalog_name\030\001 \001(\t\022\023\n\013schema_"
+  "name\030\002 \001(\t\022\022\n\ntable_name\030\003 \001(\t\"\035\n\014Affect"
+  "edRows\022\r\n\005value\030\001 \001(\r\"\032\n\007Metrics\022\017\n\007metr"
+  "ics\030\001 \001(\014\"\034\n\013ExpireAfter\022\r\n\005value\030\001 \001(\003\""
+  "i\n\016FlightMetadata\0220\n\raffected_rows\030\001 \001(\013"
+  "2\031.greptime.v1.AffectedRows\022%\n\007metrics\030\002"
+  " \001(\0132\024.greptime.v1.Metrics\"I\n\024IntervalMo"
+  "nthDayNano\022\016\n\006months\030\001 \001(\005\022\014\n\004days\030\002 \001(\005"
+  "\022\023\n\013nanoseconds\030\003 \001(\003\"$\n\nDecimal128\022\n\n\002h"
+  "i\030\001 \001(\003\022\n\n\002lo\030\002 \001(\003\"\316\001\n\027ColumnDataTypeEx"
+  "tension\0229\n\014decimal_type\030\001 \001(\0132!.greptime"
+  ".v1.DecimalTypeExtensionH\000\0223\n\tjson_type\030"
+  "\002 \001(\0162\036.greptime.v1.JsonTypeExtensionH\000\022"
+  "7\n\013vector_type\030\003 \001(\0132 .greptime.v1.Vecto"
+  "rTypeExtensionH\000B\n\n\010type_ext\"8\n\024DecimalT"
+  "ypeExtension\022\021\n\tprecision\030\001 \001(\005\022\r\n\005scale"
+  "\030\002 \001(\005\"\"\n\023VectorTypeExtension\022\013\n\003dim\030\001 \001"
+  "(\r\"y\n\rColumnOptions\0228\n\007options\030\001 \003(\0132\'.g"
+  "reptime.v1.ColumnOptions.OptionsEntry\032.\n"
+  "\014OptionsEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001("
+  "\t:\0028\001*1\n\014SemanticType\022\007\n\003TAG\020\000\022\t\n\005FIELD\020"
+  "\001\022\r\n\tTIMESTAMP\020\002*\354\003\n\016ColumnDataType\022\013\n\007B"
+  "OOLEAN\020\000\022\010\n\004INT8\020\001\022\t\n\005INT16\020\002\022\t\n\005INT32\020\003"
+  "\022\t\n\005INT64\020\004\022\t\n\005UINT8\020\005\022\n\n\006UINT16\020\006\022\n\n\006UI"
+  "NT32\020\007\022\n\n\006UINT64\020\010\022\013\n\007FLOAT32\020\t\022\013\n\007FLOAT"
+  "64\020\n\022\n\n\006BINARY\020\013\022\n\n\006STRING\020\014\022\010\n\004DATE\020\r\022\014"
+  "\n\010DATETIME\020\016\022\024\n\020TIMESTAMP_SECOND\020\017\022\031\n\025TI"
+  "MESTAMP_MILLISECOND\020\020\022\031\n\025TIMESTAMP_MICRO"
+  "SECOND\020\021\022\030\n\024TIMESTAMP_NANOSECOND\020\022\022\017\n\013TI"
+  "ME_SECOND\020\023\022\024\n\020TIME_MILLISECOND\020\024\022\024\n\020TIM"
+  "E_MICROSECOND\020\025\022\023\n\017TIME_NANOSECOND\020\026\022\027\n\023"
+  "INTERVAL_YEAR_MONTH\020\027\022\025\n\021INTERVAL_DAY_TI"
+  "ME\020\030\022\033\n\027INTERVAL_MONTH_DAY_NANO\020\031\022\016\n\nDEC"
+  "IMAL128\020\036\022\010\n\004JSON\020\037\022\n\n\006VECTOR\020 *$\n\021JsonT"
+  "ypeExtension\022\017\n\013JSON_BINARY\020\000BO\n\016io.grep"
+  "time.v1B\006CommonZ5github.com/GreptimeTeam"
+  "/greptime-proto/go/greptime/v1b\006proto3"
   ;
 static ::_pbi::once_flag descriptor_table_greptime_2fv1_2fcommon_2eproto_once;
 const ::_pbi::DescriptorTable descriptor_table_greptime_2fv1_2fcommon_2eproto = {
-    false, false, 2477, descriptor_table_protodef_greptime_2fv1_2fcommon_2eproto,
+    false, false, 2558, descriptor_table_protodef_greptime_2fv1_2fcommon_2eproto,
     "greptime/v1/common.proto",
-    &descriptor_table_greptime_2fv1_2fcommon_2eproto_once, nullptr, 0, 23,
+    &descriptor_table_greptime_2fv1_2fcommon_2eproto_once, nullptr, 0, 24,
     schemas, file_default_instances, TableStruct_greptime_2fv1_2fcommon_2eproto::offsets,
     file_level_metadata_greptime_2fv1_2fcommon_2eproto, file_level_enum_descriptors_greptime_2fv1_2fcommon_2eproto,
     file_level_service_descriptors_greptime_2fv1_2fcommon_2eproto,
@@ -761,12 +787,17 @@ void QueryContext_ExtensionsEntry_DoNotUse::MergeFrom(const QueryContext_Extensi
 class QueryContext::_Internal {
  public:
   static const ::greptime::v1::SnapshotSequences& snapshot_seqs(const QueryContext* msg);
+  static const ::greptime::v1::ExplainOptions& explain(const QueryContext* msg);
 };
 
 const ::greptime::v1::SnapshotSequences&
 QueryContext::_Internal::snapshot_seqs(const QueryContext* msg) {
   return *msg->_impl_.snapshot_seqs_;
 }
+const ::greptime::v1::ExplainOptions&
+QueryContext::_Internal::explain(const QueryContext* msg) {
+  return *msg->_impl_.explain_;
+}
 QueryContext::QueryContext(::PROTOBUF_NAMESPACE_ID::Arena* arena,
                          bool is_message_owned)
   : ::PROTOBUF_NAMESPACE_ID::Message(arena, is_message_owned) {
@@ -785,6 +816,7 @@ QueryContext::QueryContext(const QueryContext& from)
     , decltype(_impl_.current_schema_){}
     , decltype(_impl_.timezone_){}
     , decltype(_impl_.snapshot_seqs_){nullptr}
+    , decltype(_impl_.explain_){nullptr}
     , decltype(_impl_.channel_){}
     , /*decltype(_impl_._cached_size_)*/{}};
 
@@ -817,6 +849,9 @@ QueryContext::QueryContext(const QueryContext& from)
   if (from._internal_has_snapshot_seqs()) {
     _this->_impl_.snapshot_seqs_ = new ::greptime::v1::SnapshotSequences(*from._impl_.snapshot_seqs_);
   }
+  if (from._internal_has_explain()) {
+    _this->_impl_.explain_ = new ::greptime::v1::ExplainOptions(*from._impl_.explain_);
+  }
   _this->_impl_.channel_ = from._impl_.channel_;
   // @@protoc_insertion_point(copy_constructor:greptime.v1.QueryContext)
 }
@@ -831,6 +866,7 @@ inline void QueryContext::SharedCtor(
     , decltype(_impl_.current_schema_){}
     , decltype(_impl_.timezone_){}
     , decltype(_impl_.snapshot_seqs_){nullptr}
+    , decltype(_impl_.explain_){nullptr}
     , decltype(_impl_.channel_){0u}
     , /*decltype(_impl_._cached_size_)*/{}
   };
@@ -866,6 +902,7 @@ inline void QueryContext::SharedDtor() {
   _impl_.current_schema_.Destroy();
   _impl_.timezone_.Destroy();
   if (this != internal_default_instance()) delete _impl_.snapshot_seqs_;
+  if (this != internal_default_instance()) delete _impl_.explain_;
 }
 
 void QueryContext::ArenaDtor(void* object) {
@@ -890,6 +927,10 @@ void QueryContext::Clear() {
     delete _impl_.snapshot_seqs_;
   }
   _impl_.snapshot_seqs_ = nullptr;
+  if (GetArenaForAllocation() == nullptr && _impl_.explain_ != nullptr) {
+    delete _impl_.explain_;
+  }
+  _impl_.explain_ = nullptr;
   _impl_.channel_ = 0u;
   _internal_metadata_.Clear<::PROTOBUF_NAMESPACE_ID::UnknownFieldSet>();
 }
@@ -959,6 +1000,14 @@ const char* QueryContext::_InternalParse(const char* ptr, ::_pbi::ParseContext*
         } else
           goto handle_unusual;
         continue;
+      // .greptime.v1.ExplainOptions explain = 8;
+      case 8:
+        if (PROTOBUF_PREDICT_TRUE(static_cast<uint8_t>(tag) == 66)) {
+          ptr = ctx->ParseMessage(_internal_mutable_explain(), ptr);
+          CHK_(ptr);
+        } else
+          goto handle_unusual;
+        continue;
       default:
         goto handle_unusual;
     }  // switch
@@ -1061,6 +1110,13 @@ uint8_t* QueryContext::_InternalSerialize(
         _Internal::snapshot_seqs(this).GetCachedSize(), target, stream);
   }
 
+  // .greptime.v1.ExplainOptions explain = 8;
+  if (this->_internal_has_explain()) {
+    target = ::PROTOBUF_NAMESPACE_ID::internal::WireFormatLite::
+      InternalWriteMessage(8, _Internal::explain(this),
+        _Internal::explain(this).GetCachedSize(), target, stream);
+  }
+
   if (PROTOBUF_PREDICT_FALSE(_internal_metadata_.have_unknown_fields())) {
     target = ::_pbi::WireFormat::InternalSerializeUnknownFieldsToArray(
         _internal_metadata_.unknown_fields<::PROTOBUF_NAMESPACE_ID::UnknownFieldSet>(::PROTOBUF_NAMESPACE_ID::UnknownFieldSet::default_instance), target, stream);
@@ -1114,6 +1170,13 @@ size_t QueryContext::ByteSizeLong() const {
         *_impl_.snapshot_seqs_);
   }
 
+  // .greptime.v1.ExplainOptions explain = 8;
+  if (this->_internal_has_explain()) {
+    total_size += 1 +
+      ::PROTOBUF_NAMESPACE_ID::internal::WireFormatLite::MessageSize(
+        *_impl_.explain_);
+  }
+
   // uint32 channel = 6;
   if (this->_internal_channel() != 0) {
     total_size += ::_pbi::WireFormatLite::UInt32SizePlusOne(this->_internal_channel());
@@ -1151,6 +1214,10 @@ void QueryContext::MergeImpl(::PROTOBUF_NAMESPACE_ID::Message& to_msg, const ::P
     _this->_internal_mutable_snapshot_seqs()->::greptime::v1::SnapshotSequences::MergeFrom(
         from._internal_snapshot_seqs());
   }
+  if (from._internal_has_explain()) {
+    _this->_internal_mutable_explain()->::greptime::v1::ExplainOptions::MergeFrom(
+        from._internal_explain());
+  }
   if (from._internal_channel() != 0) {
     _this->_internal_set_channel(from._internal_channel());
   }
@@ -1422,6 +1489,184 @@ void SnapshotSequences::InternalSwap(SnapshotSequences* other) {
 
 // ===================================================================
 
+class ExplainOptions::_Internal {
+ public:
+};
+
+ExplainOptions::ExplainOptions(::PROTOBUF_NAMESPACE_ID::Arena* arena,
+                         bool is_message_owned)
+  : ::PROTOBUF_NAMESPACE_ID::Message(arena, is_message_owned) {
+  SharedCtor(arena, is_message_owned);
+  // @@protoc_insertion_point(arena_constructor:greptime.v1.ExplainOptions)
+}
+ExplainOptions::ExplainOptions(const ExplainOptions& from)
+  : ::PROTOBUF_NAMESPACE_ID::Message() {
+  ExplainOptions* const _this = this; (void)_this;
+  new (&_impl_) Impl_{
+      decltype(_impl_.verbose_){}
+    , /*decltype(_impl_._cached_size_)*/{}};
+
+  _internal_metadata_.MergeFrom<::PROTOBUF_NAMESPACE_ID::UnknownFieldSet>(from._internal_metadata_);
+  _this->_impl_.verbose_ = from._impl_.verbose_;
+  // @@protoc_insertion_point(copy_constructor:greptime.v1.ExplainOptions)
+}
+
+inline void ExplainOptions::SharedCtor(
+    ::_pb::Arena* arena, bool is_message_owned) {
+  (void)arena;
+  (void)is_message_owned;
+  new (&_impl_) Impl_{
+      decltype(_impl_.verbose_){false}
+    , /*decltype(_impl_._cached_size_)*/{}
+  };
+}
+
+ExplainOptions::~ExplainOptions() {
+  // @@protoc_insertion_point(destructor:greptime.v1.ExplainOptions)
+  if (auto *arena = _internal_metadata_.DeleteReturnArena<::PROTOBUF_NAMESPACE_ID::UnknownFieldSet>()) {
+  (void)arena;
+    return;
+  }
+  SharedDtor();
+}
+
+inline void ExplainOptions::SharedDtor() {
+  GOOGLE_DCHECK(GetArenaForAllocation() == nullptr);
+}
+
+void ExplainOptions::SetCachedSize(int size) const {
+  _impl_._cached_size_.Set(size);
+}
+
+void ExplainOptions::Clear() {
+// @@protoc_insertion_point(message_clear_start:greptime.v1.ExplainOptions)
+  uint32_t cached_has_bits = 0;
+  // Prevent compiler warnings about cached_has_bits being unused
+  (void) cached_has_bits;
+
+  _impl_.verbose_ = false;
+  _internal_metadata_.Clear<::PROTOBUF_NAMESPACE_ID::UnknownFieldSet>();
+}
+
+const char* ExplainOptions::_InternalParse(const char* ptr, ::_pbi::ParseContext* ctx) {
+#define CHK_(x) if (PROTOBUF_PREDICT_FALSE(!(x))) goto failure
+  while (!ctx->Done(&ptr)) {
+    uint32_t tag;
+    ptr = ::_pbi::ReadTag(ptr, &tag);
+    switch (tag >> 3) {
+      // bool verbose = 1;
+      case 1:
+        if (PROTOBUF_PREDICT_TRUE(static_cast<uint8_t>(tag) == 8)) {
+          _impl_.verbose_ = ::PROTOBUF_NAMESPACE_ID::internal::ReadVarint64(&ptr);
+          CHK_(ptr);
+        } else
+          goto handle_unusual;
+        continue;
+      default:
+        goto handle_unusual;
+    }  // switch
+  handle_unusual:
+    if ((tag == 0) || ((tag & 7) == 4)) {
+      CHK_(ptr);
+      ctx->SetLastTag(tag);
+      goto message_done;
+    }
+    ptr = UnknownFieldParse(
+        tag,
+        _internal_metadata_.mutable_unknown_fields<::PROTOBUF_NAMESPACE_ID::UnknownFieldSet>(),
+        ptr, ctx);
+    CHK_(ptr != nullptr);
+  }  // while
+message_done:
+  return ptr;
+failure:
+  ptr = nullptr;
+  goto message_done;
+#undef CHK_
+}
+
+uint8_t* ExplainOptions::_InternalSerialize(
+    uint8_t* target, ::PROTOBUF_NAMESPACE_ID::io::EpsCopyOutputStream* stream) const {
+  // @@protoc_insertion_point(serialize_to_array_start:greptime.v1.ExplainOptions)
+  uint32_t cached_has_bits = 0;
+  (void) cached_has_bits;
+
+  // bool verbose = 1;
+  if (this->_internal_verbose() != 0) {
+    target = stream->EnsureSpace(target);
+    target = ::_pbi::WireFormatLite::WriteBoolToArray(1, this->_internal_verbose(), target);
+  }
+
+  if (PROTOBUF_PREDICT_FALSE(_internal_metadata_.have_unknown_fields())) {
+    target = ::_pbi::WireFormat::InternalSerializeUnknownFieldsToArray(
+        _internal_metadata_.unknown_fields<::PROTOBUF_NAMESPACE_ID::UnknownFieldSet>(::PROTOBUF_NAMESPACE_ID::UnknownFieldSet::default_instance), target, stream);
+  }
+  // @@protoc_insertion_point(serialize_to_array_end:greptime.v1.ExplainOptions)
+  return target;
+}
+
+size_t ExplainOptions::ByteSizeLong() const {
+// @@protoc_insertion_point(message_byte_size_start:greptime.v1.ExplainOptions)
+  size_t total_size = 0;
+
+  uint32_t cached_has_bits = 0;
+  // Prevent compiler warnings about cached_has_bits being unused
+  (void) cached_has_bits;
+
+  // bool verbose = 1;
+  if (this->_internal_verbose() != 0) {
+    total_size += 1 + 1;
+  }
+
+  return MaybeComputeUnknownFieldsSize(total_size, &_impl_._cached_size_);
+}
+
+const ::PROTOBUF_NAMESPACE_ID::Message::ClassData ExplainOptions::_class_data_ = {
+    ::PROTOBUF_NAMESPACE_ID::Message::CopyWithSourceCheck,
+    ExplainOptions::MergeImpl
+};
+const ::PROTOBUF_NAMESPACE_ID::Message::ClassData*ExplainOptions::GetClassData() const { return &_class_data_; }
+
+
+void ExplainOptions::MergeImpl(::PROTOBUF_NAMESPACE_ID::Message& to_msg, const ::PROTOBUF_NAMESPACE_ID::Message& from_msg) {
+  auto* const _this = static_cast<ExplainOptions*>(&to_msg);
+  auto& from = static_cast<const ExplainOptions&>(from_msg);
+  // @@protoc_insertion_point(class_specific_merge_from_start:greptime.v1.ExplainOptions)
+  GOOGLE_DCHECK_NE(&from, _this);
+  uint32_t cached_has_bits = 0;
+  (void) cached_has_bits;
+
+  if (from._internal_verbose() != 0) {
+    _this->_internal_set_verbose(from._internal_verbose());
+  }
+  _this->_internal_metadata_.MergeFrom<::PROTOBUF_NAMESPACE_ID::UnknownFieldSet>(from._internal_metadata_);
+}
+
+void ExplainOptions::CopyFrom(const ExplainOptions& from) {
+// @@protoc_insertion_point(class_specific_copy_from_start:greptime.v1.ExplainOptions)
+  if (&from == this) return;
+  Clear();
+  MergeFrom(from);
+}
+
+bool ExplainOptions::IsInitialized() const {
+  return true;
+}
+
+void ExplainOptions::InternalSwap(ExplainOptions* other) {
+  using std::swap;
+  _internal_metadata_.InternalSwap(&other->_internal_metadata_);
+  swap(_impl_.verbose_, other->_impl_.verbose_);
+}
+
+::PROTOBUF_NAMESPACE_ID::Metadata ExplainOptions::GetMetadata() const {
+  return ::_pbi::AssignDescriptors(
+      &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[4]);
+}
+
+// ===================================================================
+
 RequestHeader_TracingContextEntry_DoNotUse::RequestHeader_TracingContextEntry_DoNotUse() {}
 RequestHeader_TracingContextEntry_DoNotUse::RequestHeader_TracingContextEntry_DoNotUse(::PROTOBUF_NAMESPACE_ID::Arena* arena)
     : SuperType(arena) {}
@@ -1431,7 +1676,7 @@ void RequestHeader_TracingContextEntry_DoNotUse::MergeFrom(const RequestHeader_T
 ::PROTOBUF_NAMESPACE_ID::Metadata RequestHeader_TracingContextEntry_DoNotUse::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[4]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[5]);
 }
 
 // ===================================================================
@@ -1894,7 +2139,7 @@ void RequestHeader::InternalSwap(RequestHeader* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata RequestHeader::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[5]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[6]);
 }
 
 // ===================================================================
@@ -2087,7 +2332,7 @@ void ResponseHeader::InternalSwap(ResponseHeader* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata ResponseHeader::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[6]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[7]);
 }
 
 // ===================================================================
@@ -2317,7 +2562,7 @@ void Status::InternalSwap(Status* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata Status::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[7]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[8]);
 }
 
 // ===================================================================
@@ -2622,7 +2867,7 @@ void AuthHeader::InternalSwap(AuthHeader* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata AuthHeader::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[8]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[9]);
 }
 
 // ===================================================================
@@ -2875,7 +3120,7 @@ void Basic::InternalSwap(Basic* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata Basic::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[9]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[10]);
 }
 
 // ===================================================================
@@ -3078,7 +3323,7 @@ void Token::InternalSwap(Token* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata Token::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[10]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[11]);
 }
 
 // ===================================================================
@@ -3381,7 +3626,7 @@ void TableName::InternalSwap(TableName* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata TableName::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[11]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[12]);
 }
 
 // ===================================================================
@@ -3559,7 +3804,7 @@ void AffectedRows::InternalSwap(AffectedRows* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata AffectedRows::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[12]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[13]);
 }
 
 // ===================================================================
@@ -3757,7 +4002,7 @@ void Metrics::InternalSwap(Metrics* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata Metrics::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[13]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[14]);
 }
 
 // ===================================================================
@@ -3935,7 +4180,7 @@ void ExpireAfter::InternalSwap(ExpireAfter* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata ExpireAfter::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[14]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[15]);
 }
 
 // ===================================================================
@@ -4174,7 +4419,7 @@ void FlightMetadata::InternalSwap(FlightMetadata* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata FlightMetadata::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[15]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[16]);
 }
 
 // ===================================================================
@@ -4409,7 +4654,7 @@ void IntervalMonthDayNano::InternalSwap(IntervalMonthDayNano* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata IntervalMonthDayNano::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[16]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[17]);
 }
 
 // ===================================================================
@@ -4620,7 +4865,7 @@ void Decimal128::InternalSwap(Decimal128* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata Decimal128::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[17]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[18]);
 }
 
 // ===================================================================
@@ -4959,7 +5204,7 @@ void ColumnDataTypeExtension::InternalSwap(ColumnDataTypeExtension* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata ColumnDataTypeExtension::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[18]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[19]);
 }
 
 // ===================================================================
@@ -5170,7 +5415,7 @@ void DecimalTypeExtension::InternalSwap(DecimalTypeExtension* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata DecimalTypeExtension::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[19]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[20]);
 }
 
 // ===================================================================
@@ -5348,7 +5593,7 @@ void VectorTypeExtension::InternalSwap(VectorTypeExtension* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata VectorTypeExtension::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[20]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[21]);
 }
 
 // ===================================================================
@@ -5362,7 +5607,7 @@ void ColumnOptions_OptionsEntry_DoNotUse::MergeFrom(const ColumnOptions_OptionsE
 ::PROTOBUF_NAMESPACE_ID::Metadata ColumnOptions_OptionsEntry_DoNotUse::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[21]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[22]);
 }
 
 // ===================================================================
@@ -5581,7 +5826,7 @@ void ColumnOptions::InternalSwap(ColumnOptions* other) {
 ::PROTOBUF_NAMESPACE_ID::Metadata ColumnOptions::GetMetadata() const {
   return ::_pbi::AssignDescriptors(
       &descriptor_table_greptime_2fv1_2fcommon_2eproto_getter, &descriptor_table_greptime_2fv1_2fcommon_2eproto_once,
-      file_level_metadata_greptime_2fv1_2fcommon_2eproto[22]);
+      file_level_metadata_greptime_2fv1_2fcommon_2eproto[23]);
 }
 
 // @@protoc_insertion_point(namespace_scope)
@@ -5604,6 +5849,10 @@ template<> PROTOBUF_NOINLINE ::greptime::v1::SnapshotSequences*
 Arena::CreateMaybeMessage< ::greptime::v1::SnapshotSequences >(Arena* arena) {
   return Arena::CreateMessageInternal< ::greptime::v1::SnapshotSequences >(arena);
 }
+template<> PROTOBUF_NOINLINE ::greptime::v1::ExplainOptions*
+Arena::CreateMaybeMessage< ::greptime::v1::ExplainOptions >(Arena* arena) {
+  return Arena::CreateMessageInternal< ::greptime::v1::ExplainOptions >(arena);
+}
 template<> PROTOBUF_NOINLINE ::greptime::v1::RequestHeader_TracingContextEntry_DoNotUse*
 Arena::CreateMaybeMessage< ::greptime::v1::RequestHeader_TracingContextEntry_DoNotUse >(Arena* arena) {
   return Arena::CreateMessageInternal< ::greptime::v1::RequestHeader_TracingContextEntry_DoNotUse >(arena);

c++/greptime/v1/common.pb.h

@@ -77,6 +77,9 @@ extern DecimalTypeExtensionDefaultTypeInternal _DecimalTypeExtension_default_ins
 class ExpireAfter;
 struct ExpireAfterDefaultTypeInternal;
 extern ExpireAfterDefaultTypeInternal _ExpireAfter_default_instance_;
+class ExplainOptions;
+struct ExplainOptionsDefaultTypeInternal;
+extern ExplainOptionsDefaultTypeInternal _ExplainOptions_default_instance_;
 class FlightMetadata;
 struct FlightMetadataDefaultTypeInternal;
 extern FlightMetadataDefaultTypeInternal _FlightMetadata_default_instance_;
@@ -131,6 +134,7 @@ template<> ::greptime::v1::ColumnOptions_OptionsEntry_DoNotUse* Arena::CreateMay
 template<> ::greptime::v1::Decimal128* Arena::CreateMaybeMessage<::greptime::v1::Decimal128>(Arena*);
 template<> ::greptime::v1::DecimalTypeExtension* Arena::CreateMaybeMessage<::greptime::v1::DecimalTypeExtension>(Arena*);
 template<> ::greptime::v1::ExpireAfter* Arena::CreateMaybeMessage<::greptime::v1::ExpireAfter>(Arena*);
+template<> ::greptime::v1::ExplainOptions* Arena::CreateMaybeMessage<::greptime::v1::ExplainOptions>(Arena*);
 template<> ::greptime::v1::FlightMetadata* Arena::CreateMaybeMessage<::greptime::v1::FlightMetadata>(Arena*);
 template<> ::greptime::v1::IntervalMonthDayNano* Arena::CreateMaybeMessage<::greptime::v1::IntervalMonthDayNano>(Arena*);
 template<> ::greptime::v1::Metrics* Arena::CreateMaybeMessage<::greptime::v1::Metrics>(Arena*);
@@ -410,6 +414,7 @@ class QueryContext final :
     kCurrentSchemaFieldNumber = 2,
     kTimezoneFieldNumber = 4,
     kSnapshotSeqsFieldNumber = 7,
+    kExplainFieldNumber = 8,
     kChannelFieldNumber = 6,
   };
   // map<string, string> extensions = 5;
@@ -489,6 +494,24 @@ class QueryContext final :
       ::greptime::v1::SnapshotSequences* snapshot_seqs);
   ::greptime::v1::SnapshotSequences* unsafe_arena_release_snapshot_seqs();
 
+  // .greptime.v1.ExplainOptions explain = 8;
+  bool has_explain() const;
+  private:
+  bool _internal_has_explain() const;
+  public:
+  void clear_explain();
+  const ::greptime::v1::ExplainOptions& explain() const;
+  PROTOBUF_NODISCARD ::greptime::v1::ExplainOptions* release_explain();
+  ::greptime::v1::ExplainOptions* mutable_explain();
+  void set_allocated_explain(::greptime::v1::ExplainOptions* explain);
+  private:
+  const ::greptime::v1::ExplainOptions& _internal_explain() const;
+  ::greptime::v1::ExplainOptions* _internal_mutable_explain();
+  public:
+  void unsafe_arena_set_allocated_explain(
+      ::greptime::v1::ExplainOptions* explain);
+  ::greptime::v1::ExplainOptions* unsafe_arena_release_explain();
+
   // uint32 channel = 6;
   void clear_channel();
   uint32_t channel() const;
@@ -515,6 +538,7 @@ class QueryContext final :
     ::PROTOBUF_NAMESPACE_ID::internal::ArenaStringPtr current_schema_;
     ::PROTOBUF_NAMESPACE_ID::internal::ArenaStringPtr timezone_;
     ::greptime::v1::SnapshotSequences* snapshot_seqs_;
+    ::greptime::v1::ExplainOptions* explain_;
     uint32_t channel_;
     mutable ::PROTOBUF_NAMESPACE_ID::internal::CachedSize _cached_size_;
   };
@@ -710,6 +734,154 @@ class SnapshotSequences final :
 };
 // -------------------------------------------------------------------
 
+class ExplainOptions final :
+    public ::PROTOBUF_NAMESPACE_ID::Message /* @@protoc_insertion_point(class_definition:greptime.v1.ExplainOptions) */ {
+ public:
+  inline ExplainOptions() : ExplainOptions(nullptr) {}
+  ~ExplainOptions() override;
+  explicit PROTOBUF_CONSTEXPR ExplainOptions(::PROTOBUF_NAMESPACE_ID::internal::ConstantInitialized);
+
+  ExplainOptions(const ExplainOptions& from);
+  ExplainOptions(ExplainOptions&& from) noexcept
+    : ExplainOptions() {
+    *this = ::std::move(from);
+  }
+
+  inline ExplainOptions& operator=(const ExplainOptions& from) {
+    CopyFrom(from);
+    return *this;
+  }
+  inline ExplainOptions& operator=(ExplainOptions&& from) noexcept {
+    if (this == &from) return *this;
+    if (GetOwningArena() == from.GetOwningArena()
+  #ifdef PROTOBUF_FORCE_COPY_IN_MOVE
+        && GetOwningArena() != nullptr
+  #endif  // !PROTOBUF_FORCE_COPY_IN_MOVE
+    ) {
+      InternalSwap(&from);
+    } else {
+      CopyFrom(from);
+    }
+    return *this;
+  }
+
+  static const ::PROTOBUF_NAMESPACE_ID::Descriptor* descriptor() {
+    return GetDescriptor();
+  }
+  static const ::PROTOBUF_NAMESPACE_ID::Descriptor* GetDescriptor() {
+    return default_instance().GetMetadata().descriptor;
+  }
+  static const ::PROTOBUF_NAMESPACE_ID::Reflection* GetReflection() {
+    return default_instance().GetMetadata().reflection;
+  }
+  static const ExplainOptions& default_instance() {
+    return *internal_default_instance();
+  }
+  static inline const ExplainOptions* internal_default_instance() {
+    return reinterpret_cast<const ExplainOptions*>(
+               &_ExplainOptions_default_instance_);
+  }
+  static constexpr int kIndexInFileMessages =
+    4;
+
+  friend void swap(ExplainOptions& a, ExplainOptions& b) {
+    a.Swap(&b);
+  }
+  inline void Swap(ExplainOptions* other) {
+    if (other == this) return;
+  #ifdef PROTOBUF_FORCE_COPY_IN_SWAP
+    if (GetOwningArena() != nullptr &&
+        GetOwningArena() == other->GetOwningArena()) {
+   #else  // PROTOBUF_FORCE_COPY_IN_SWAP
+    if (GetOwningArena() == other->GetOwningArena()) {
+  #endif  // !PROTOBUF_FORCE_COPY_IN_SWAP
+      InternalSwap(other);
+    } else {
+      ::PROTOBUF_NAMESPACE_ID::internal::GenericSwap(this, other);
+    }
+  }
+  void UnsafeArenaSwap(ExplainOptions* other) {
+    if (other == this) return;
+    GOOGLE_DCHECK(GetOwningArena() == other->GetOwningArena());
+    InternalSwap(other);
+  }
+
+  // implements Message ----------------------------------------------
+
+  ExplainOptions* New(::PROTOBUF_NAMESPACE_ID::Arena* arena = nullptr) const final {
+    return CreateMaybeMessage<ExplainOptions>(arena);
+  }
+  using ::PROTOBUF_NAMESPACE_ID::Message::CopyFrom;
+  void CopyFrom(const ExplainOptions& from);
+  using ::PROTOBUF_NAMESPACE_ID::Message::MergeFrom;
+  void MergeFrom( const ExplainOptions& from) {
+    ExplainOptions::MergeImpl(*this, from);
+  }
+  private:
+  static void MergeImpl(::PROTOBUF_NAMESPACE_ID::Message& to_msg, const ::PROTOBUF_NAMESPACE_ID::Message& from_msg);
+  public:
+  PROTOBUF_ATTRIBUTE_REINITIALIZES void Clear() final;
+  bool IsInitialized() const final;
+
+  size_t ByteSizeLong() const final;
+  const char* _InternalParse(const char* ptr, ::PROTOBUF_NAMESPACE_ID::internal::ParseContext* ctx) final;
+  uint8_t* _InternalSerialize(
+      uint8_t* target, ::PROTOBUF_NAMESPACE_ID::io::EpsCopyOutputStream* stream) const final;
+  int GetCachedSize() const final { return _impl_._cached_size_.Get(); }
+
+  private:
+  void SharedCtor(::PROTOBUF_NAMESPACE_ID::Arena* arena, bool is_message_owned);
+  void SharedDtor();
+  void SetCachedSize(int size) const final;
+  void InternalSwap(ExplainOptions* other);
+
+  private:
+  friend class ::PROTOBUF_NAMESPACE_ID::internal::AnyMetadata;
+  static ::PROTOBUF_NAMESPACE_ID::StringPiece FullMessageName() {
+    return "greptime.v1.ExplainOptions";
+  }
+  protected:
+  explicit ExplainOptions(::PROTOBUF_NAMESPACE_ID::Arena* arena,
+                       bool is_message_owned = false);
+  public:
+
+  static const ClassData _class_data_;
+  const ::PROTOBUF_NAMESPACE_ID::Message::ClassData*GetClassData() const final;
+
+  ::PROTOBUF_NAMESPACE_ID::Metadata GetMetadata() const final;
+
+  // nested types ----------------------------------------------------
+
+  // accessors -------------------------------------------------------
+
+  enum : int {
+    kVerboseFieldNumber = 1,
+  };
+  // bool verbose = 1;
+  void clear_verbose();
+  bool verbose() const;
+  void set_verbose(bool value);
+  private:
+  bool _internal_verbose() const;
+  void _internal_set_verbose(bool value);
+  public:
+
+  // @@protoc_insertion_point(class_scope:greptime.v1.ExplainOptions)
+ private:
+  class _Internal;
+
+  template <typename T> friend class ::PROTOBUF_NAMESPACE_ID::Arena::InternalHelper;
+  typedef void InternalArenaConstructable_;
+  typedef void DestructorSkippable_;
+  struct Impl_ {
+    bool verbose_;
+    mutable ::PROTOBUF_NAMESPACE_ID::internal::CachedSize _cached_size_;
+  };
+  union { Impl_ _impl_; };
+  friend struct ::TableStruct_greptime_2fv1_2fcommon_2eproto;
+};
+// -------------------------------------------------------------------
+
 class RequestHeader_TracingContextEntry_DoNotUse : public ::PROTOBUF_NAMESPACE_ID::internal::MapEntry<RequestHeader_TracingContextEntry_DoNotUse, 
     std::string, std::string,
     ::PROTOBUF_NAMESPACE_ID::internal::WireFormatLite::TYPE_STRING,
@@ -786,7 +958,7 @@ class RequestHeader final :
                &_RequestHeader_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    5;
+    6;
 
   friend void swap(RequestHeader& a, RequestHeader& b) {
     a.Swap(&b);
@@ -1033,7 +1205,7 @@ class ResponseHeader final :
                &_ResponseHeader_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    6;
+    7;
 
   friend void swap(ResponseHeader& a, ResponseHeader& b) {
     a.Swap(&b);
@@ -1190,7 +1362,7 @@ class Status final :
                &_Status_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    7;
+    8;
 
   friend void swap(Status& a, Status& b) {
     a.Swap(&b);
@@ -1360,7 +1532,7 @@ class AuthHeader final :
                &_AuthHeader_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    8;
+    9;
 
   friend void swap(AuthHeader& a, AuthHeader& b) {
     a.Swap(&b);
@@ -1550,7 +1722,7 @@ class Basic final :
                &_Basic_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    9;
+    10;
 
   friend void swap(Basic& a, Basic& b) {
     a.Swap(&b);
@@ -1719,7 +1891,7 @@ class Token final :
                &_Token_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    10;
+    11;
 
   friend void swap(Token& a, Token& b) {
     a.Swap(&b);
@@ -1872,7 +2044,7 @@ class TableName final :
                &_TableName_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    11;
+    12;
 
   friend void swap(TableName& a, TableName& b) {
     a.Swap(&b);
@@ -2057,7 +2229,7 @@ class AffectedRows final :
                &_AffectedRows_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    12;
+    13;
 
   friend void swap(AffectedRows& a, AffectedRows& b) {
     a.Swap(&b);
@@ -2205,7 +2377,7 @@ class Metrics final :
                &_Metrics_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    13;
+    14;
 
   friend void swap(Metrics& a, Metrics& b) {
     a.Swap(&b);
@@ -2358,7 +2530,7 @@ class ExpireAfter final :
                &_ExpireAfter_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    14;
+    15;
 
   friend void swap(ExpireAfter& a, ExpireAfter& b) {
     a.Swap(&b);
@@ -2506,7 +2678,7 @@ class FlightMetadata final :
                &_FlightMetadata_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    15;
+    16;
 
   friend void swap(FlightMetadata& a, FlightMetadata& b) {
     a.Swap(&b);
@@ -2683,7 +2855,7 @@ class IntervalMonthDayNano final :
                &_IntervalMonthDayNano_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    16;
+    17;
 
   friend void swap(IntervalMonthDayNano& a, IntervalMonthDayNano& b) {
     a.Swap(&b);
@@ -2853,7 +3025,7 @@ class Decimal128 final :
                &_Decimal128_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    17;
+    18;
 
   friend void swap(Decimal128& a, Decimal128& b) {
     a.Swap(&b);
@@ -3019,7 +3191,7 @@ class ColumnDataTypeExtension final :
                &_ColumnDataTypeExtension_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    18;
+    19;
 
   friend void swap(ColumnDataTypeExtension& a, ColumnDataTypeExtension& b) {
     a.Swap(&b);
@@ -3225,7 +3397,7 @@ class DecimalTypeExtension final :
                &_DecimalTypeExtension_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    19;
+    20;
 
   friend void swap(DecimalTypeExtension& a, DecimalTypeExtension& b) {
     a.Swap(&b);
@@ -3384,7 +3556,7 @@ class VectorTypeExtension final :
                &_VectorTypeExtension_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    20;
+    21;
 
   friend void swap(VectorTypeExtension& a, VectorTypeExtension& b) {
     a.Swap(&b);
@@ -3560,7 +3732,7 @@ class ColumnOptions final :
                &_ColumnOptions_default_instance_);
   }
   static constexpr int kIndexInFileMessages =
-    22;
+    23;
 
   friend void swap(ColumnOptions& a, ColumnOptions& b) {
     a.Swap(&b);
@@ -3975,6 +4147,96 @@ inline void QueryContext::set_allocated_snapshot_seqs(::greptime::v1::SnapshotSe
   // @@protoc_insertion_point(field_set_allocated:greptime.v1.QueryContext.snapshot_seqs)
 }
 
+// .greptime.v1.ExplainOptions explain = 8;
+inline bool QueryContext::_internal_has_explain() const {
+  return this != internal_default_instance() && _impl_.explain_ != nullptr;
+}
+inline bool QueryContext::has_explain() const {
+  return _internal_has_explain();
+}
+inline void QueryContext::clear_explain() {
+  if (GetArenaForAllocation() == nullptr && _impl_.explain_ != nullptr) {
+    delete _impl_.explain_;
+  }
+  _impl_.explain_ = nullptr;
+}
+inline const ::greptime::v1::ExplainOptions& QueryContext::_internal_explain() const {
+  const ::greptime::v1::ExplainOptions* p = _impl_.explain_;
+  return p != nullptr ? *p : reinterpret_cast<const ::greptime::v1::ExplainOptions&>(
+      ::greptime::v1::_ExplainOptions_default_instance_);
+}
+inline const ::greptime::v1::ExplainOptions& QueryContext::explain() const {
+  // @@protoc_insertion_point(field_get:greptime.v1.QueryContext.explain)
+  return _internal_explain();
+}
+inline void QueryContext::unsafe_arena_set_allocated_explain(
+    ::greptime::v1::ExplainOptions* explain) {
+  if (GetArenaForAllocation() == nullptr) {
+    delete reinterpret_cast<::PROTOBUF_NAMESPACE_ID::MessageLite*>(_impl_.explain_);
+  }
+  _impl_.explain_ = explain;
+  if (explain) {
+    
+  } else {
+    
+  }
+  // @@protoc_insertion_point(field_unsafe_arena_set_allocated:greptime.v1.QueryContext.explain)
+}
+inline ::greptime::v1::ExplainOptions* QueryContext::release_explain() {
+  
+  ::greptime::v1::ExplainOptions* temp = _impl_.explain_;
+  _impl_.explain_ = nullptr;
+#ifdef PROTOBUF_FORCE_COPY_IN_RELEASE
+  auto* old =  reinterpret_cast<::PROTOBUF_NAMESPACE_ID::MessageLite*>(temp);
+  temp = ::PROTOBUF_NAMESPACE_ID::internal::DuplicateIfNonNull(temp);
+  if (GetArenaForAllocation() == nullptr) { delete old; }
+#else  // PROTOBUF_FORCE_COPY_IN_RELEASE
+  if (GetArenaForAllocation() != nullptr) {
+    temp = ::PROTOBUF_NAMESPACE_ID::internal::DuplicateIfNonNull(temp);
+  }
+#endif  // !PROTOBUF_FORCE_COPY_IN_RELEASE
+  return temp;
+}
+inline ::greptime::v1::ExplainOptions* QueryContext::unsafe_arena_release_explain() {
+  // @@protoc_insertion_point(field_release:greptime.v1.QueryContext.explain)
+  
+  ::greptime::v1::ExplainOptions* temp = _impl_.explain_;
+  _impl_.explain_ = nullptr;
+  return temp;
+}
+inline ::greptime::v1::ExplainOptions* QueryContext::_internal_mutable_explain() {
+  
+  if (_impl_.explain_ == nullptr) {
+    auto* p = CreateMaybeMessage<::greptime::v1::ExplainOptions>(GetArenaForAllocation());
+    _impl_.explain_ = p;
+  }
+  return _impl_.explain_;
+}
+inline ::greptime::v1::ExplainOptions* QueryContext::mutable_explain() {
+  ::greptime::v1::ExplainOptions* _msg = _internal_mutable_explain();
+  // @@protoc_insertion_point(field_mutable:greptime.v1.QueryContext.explain)
+  return _msg;
+}
+inline void QueryContext::set_allocated_explain(::greptime::v1::ExplainOptions* explain) {
+  ::PROTOBUF_NAMESPACE_ID::Arena* message_arena = GetArenaForAllocation();
+  if (message_arena == nullptr) {
+    delete _impl_.explain_;
+  }
+  if (explain) {
+    ::PROTOBUF_NAMESPACE_ID::Arena* submessage_arena =
+        ::PROTOBUF_NAMESPACE_ID::Arena::InternalGetOwningArena(explain);
+    if (message_arena != submessage_arena) {
+      explain = ::PROTOBUF_NAMESPACE_ID::internal::GetOwnedMessage(
+          message_arena, explain, submessage_arena);
+    }
+    
+  } else {
+    
+  }
+  _impl_.explain_ = explain;
+  // @@protoc_insertion_point(field_set_allocated:greptime.v1.QueryContext.explain)
+}
+
 // -------------------------------------------------------------------
 
 // -------------------------------------------------------------------
@@ -4012,6 +4274,30 @@ SnapshotSequences::mutable_snapshot_seqs() {
 
 // -------------------------------------------------------------------
 
+// ExplainOptions
+
+// bool verbose = 1;
+inline void ExplainOptions::clear_verbose() {
+  _impl_.verbose_ = false;
+}
+inline bool ExplainOptions::_internal_verbose() const {
+  return _impl_.verbose_;
+}
+inline bool ExplainOptions::verbose() const {
+  // @@protoc_insertion_point(field_get:greptime.v1.ExplainOptions.verbose)
+  return _internal_verbose();
+}
+inline void ExplainOptions::_internal_set_verbose(bool value) {
+  
+  _impl_.verbose_ = value;
+}
+inline void ExplainOptions::set_verbose(bool value) {
+  _internal_set_verbose(value);
+  // @@protoc_insertion_point(field_set:greptime.v1.ExplainOptions.verbose)
+}
+
+// -------------------------------------------------------------------
+
 // -------------------------------------------------------------------
 
 // RequestHeader
@@ -5719,6 +6005,8 @@ ColumnOptions::mutable_options() {
 
 // -------------------------------------------------------------------
 
+// -------------------------------------------------------------------
+
 
 // @@protoc_insertion_point(namespace_scope)
 

proto/greptime/v1/common.proto

@@ -27,6 +27,8 @@ message QueryContext {
   map<string, string> extensions = 5;
   uint32 channel = 6;
   SnapshotSequences snapshot_seqs = 7;
+  // Explain options for the query.
+  ExplainOptions explain = 8;
 }
 
 message SnapshotSequences {
@@ -36,6 +38,11 @@ message SnapshotSequences {
   map<uint64, uint64> snapshot_seqs = 7;
 }
 
+message ExplainOptions {
+  // Whether to enable verbose explain output.
+  bool verbose = 1;
+}
+
 message RequestHeader {
   // The `catalog` that is selected to be used in this request.
   string catalog = 1;