planctx

type BuildPBContext struct {
	ExprCtx exprctx.BuildContext
	Client  kv.Client

	TiFlashFastScan                    bool
	TiFlashFineGrainedShuffleBatchSize uint64

	// the following fields are used to build `expression.PushDownContext`.
	// TODO: it'd be better to embed `expression.PushDownContext` in `BuildPBContext`. But `expression` already
	// depends on this package, so we need to move `expression.PushDownContext` to a standalone package first.
	GroupConcatMaxLen uint64
	InExplainStmt     bool
	WarnHandler       contextutil.WarnAppender
	ExtraWarnghandler contextutil.WarnAppender
}

type Common interface {
	contextutil.ValueStoreContext
	// GetStore returns the store of session.
	GetStore() kv.Storage
	GetSessionVars() *variable.SessionVars
	// Deprecated: the semantics of session.GetInfoSchema() is ambiguous
	// If you want to get the infoschema of the current transaction in SQL layer,
	// use sessiontxn.GetTxnManager(ctx).GetTxnInfoSchema().
	// If you want to get the latest infoschema use `GetLatestInfoSchema`
	GetInfoSchema() infoschema.MetaOnlyInfoSchema
	// GetLatestInfoSchema returns the latest information schema.
	// except schema of physical schema objects, the information schema returned
	// also includes the temporary table definitions stored in session.
	GetLatestInfoSchema() infoschema.MetaOnlyInfoSchema
	// GetLatestISWithoutSessExt is same as GetLatestInfoSchema, except that it
	// does NOT include the temporary table definitions stored in session.
	GetLatestISWithoutSessExt() infoschema.MetaOnlyInfoSchema
	// GetClient gets a kv.Client.
	GetClient() kv.Client
	// GetMPPClient gets a kv.MPPClient.
	GetMPPClient() kv.MPPClient
	GetSessionManager() sessmgr.Manager
	// GetSQLExecutor returns the sqlexec.SQLExecutor.
	GetSQLExecutor() sqlexec.SQLExecutor
	// GetRestrictedSQLExecutor returns the sqlexec.RestrictedSQLExecutor.
	GetRestrictedSQLExecutor() sqlexec.RestrictedSQLExecutor
	// GetExprCtx returns the expression context of the session.
	GetExprCtx() exprctx.ExprContext
	// GetRangerCtx returns the context used in `ranger` related functions
	GetRangerCtx() *rangerctx.RangerContext
	// GetBuildPBCtx gets the ctx used in `ToPB` of the current session
	GetBuildPBCtx() *BuildPBContext
	IsCrossKS() bool
	// UpdateColStatsUsage updates the column stats usage.
	UpdateColStatsUsage(predicateColumns iter.Seq[model.TableItemID])
	// Txn returns the current transaction which is created before executing a statement.
	// The returned kv.Transaction is not nil, but it maybe pending or invalid.
	// If the active parameter is true, call this function will wait for the pending txn
	// to become valid.
	Txn(active bool) (kv.Transaction, error)
	// HasDirtyContent checks whether there's dirty update on the given table.
	HasDirtyContent(tid int64) bool
	// BuiltinFunctionUsageInc increase the counting of each builtin function usage
	// Notice that this is a thread safe function
	BuiltinFunctionUsageInc(scalarFuncSigName string)
}

type EmptyPlanContextExtended struct{}

type PlanContext interface {
	Common
	tablelock.TableLockReadContext
	// GetNullRejectCheckExprCtx gets the expression context with null rejected check.
	GetNullRejectCheckExprCtx() exprctx.ExprContext
	// AdviseTxnWarmup advises the txn to warm up.
	AdviseTxnWarmup() error
	// SetReadonlyUserVarMap sets the readonly user variable map.
	SetReadonlyUserVarMap(readonlyUserVars map[string]struct{})
	// GetReadonlyUserVarMap gets the readonly user variable map.
	GetReadonlyUserVarMap() map[string]struct{}
	// Reset reset the local context.
	Reset()
}