Documentation ¶
Index ¶
- Constants
- Variables
- func BindDomain(ctx sessionctx.Context, domain *Domain)
- type Domain
- func (do *Domain) Close()
- func (do *Domain) CreateStatsHandle(ctx sessionctx.Context)
- func (do *Domain) DDL() ddl.DDL
- func (do *Domain) GetGlobalVarsCache() *GlobalVariableCache
- func (do *Domain) GetScope(status string) variable.ScopeFlag
- func (do *Domain) GetSnapshotInfoSchema(snapshotTS uint64) (infoschema.InfoSchema, error)
- func (do *Domain) InfoSchema() infoschema.InfoSchema
- func (do *Domain) InfoSyncer() *InfoSyncer
- func (do *Domain) Init(ddlLease time.Duration, sysFactory func(*Domain) (pools.Resource, error)) error
- func (do *Domain) LoadPrivilegeLoop(ctx sessionctx.Context) error
- func (do *Domain) LogSlowQuery(query *SlowQueryInfo)
- func (do *Domain) NotifyUpdatePrivilege(ctx sessionctx.Context)
- func (do *Domain) PrivilegeHandle() *privileges.Handle
- func (do *Domain) Reload() error
- func (do *Domain) ResetHandle(store kv.Storage)
- func (do *Domain) SetStatsUpdating(val bool)
- func (do *Domain) ShowSlowQuery(showSlow *ast.ShowSlow) []*SlowQueryInfo
- func (do *Domain) StatsHandle() *statistics.Handle
- func (do *Domain) StatsUpdating() bool
- func (do *Domain) Store() kv.Storage
- func (do *Domain) SysSessionPool() *pools.ResourcePool
- func (do *Domain) UpdateTableStatsLoop(ctx sessionctx.Context) error
- type EtcdBackend
- type GlobalVariableCache
- type InfoSyncer
- func (is InfoSyncer) Done() <-chan struct{}
- func (is *InfoSyncer) GetAllServerInfo(ctx context.Context) (map[string]*ServerInfo, error)
- func (is *InfoSyncer) GetServerInfo() *ServerInfo
- func (is *InfoSyncer) GetServerInfoByID(ctx context.Context, id string) (*ServerInfo, error)
- func (is *InfoSyncer) Init(ctx context.Context) error
- func (is *InfoSyncer) RemoveServerInfo()
- func (is *InfoSyncer) Restart(ctx context.Context) error
- type MockFailure
- type SchemaChecker
- type SchemaValidator
- type ServerInfo
- type ServerVersionInfo
- type SlowQueryInfo
Constants ¶
const ( // ResultSucc means schemaValidator's check is passing. ResultSucc checkResult = iota // ResultFail means schemaValidator's check is fail. ResultFail // ResultUnknown means schemaValidator doesn't know the check would be success or fail. ResultUnknown )
const (
// ServerInformationPath store server information such as IP, port and so on.
ServerInformationPath = "/tidb/server/info"
)
Variables ¶
var ( // ErrInfoSchemaExpired returns the error that information schema is out of date. ErrInfoSchemaExpired = terror.ClassDomain.New(codeInfoSchemaExpired, "Information schema is out of date.") // ErrInfoSchemaChanged returns the error that information schema is changed. ErrInfoSchemaChanged = terror.ClassDomain.New(codeInfoSchemaChanged, "Information schema is changed.") )
var ( // SchemaOutOfDateRetryInterval is the backoff time before retrying. SchemaOutOfDateRetryInterval = int64(500 * time.Millisecond) // SchemaOutOfDateRetryTimes is the max retry count when the schema is out of date. SchemaOutOfDateRetryTimes = int32(10) )
var InfoSessionTTL = 1 * 60
InfoSessionTTL is the etcd session's TTL in seconds. It's exported for testing.
var RunAutoAnalyze = true
RunAutoAnalyze indicates if this TiDB server starts auto analyze worker and can run auto analyze job.
Functions ¶
func BindDomain ¶
func BindDomain(ctx sessionctx.Context, domain *Domain)
BindDomain binds domain to context.
Types ¶
type Domain ¶
type Domain struct { SchemaValidator SchemaValidator MockReloadFailed MockFailure // It mocks reload failed. // contains filtered or unexported fields }
Domain represents a storage space. Different domains can use the same database name. Multiple domains can be used in parallel without synchronization.
func NewDomain ¶
func NewDomain(store kv.Storage, ddlLease time.Duration, statsLease time.Duration, factory pools.Factory) *Domain
NewDomain creates a new domain. Should not create multiple domains for the same store.
func (*Domain) CreateStatsHandle ¶
func (do *Domain) CreateStatsHandle(ctx sessionctx.Context)
CreateStatsHandle is used only for test.
func (*Domain) GetGlobalVarsCache ¶
func (do *Domain) GetGlobalVarsCache() *GlobalVariableCache
GetGlobalVarsCache gets the global variable cache.
func (*Domain) GetScope ¶
GetScope gets the status variables scope.
func (*Domain) GetSnapshotInfoSchema ¶
func (do *Domain) GetSnapshotInfoSchema(snapshotTS uint64) (infoschema.InfoSchema, error)
GetSnapshotInfoSchema gets a snapshot information schema.
func (*Domain) InfoSchema ¶
func (do *Domain) InfoSchema() infoschema.InfoSchema
InfoSchema gets information schema from domain.
func (*Domain) InfoSyncer ¶
func (do *Domain) InfoSyncer() *InfoSyncer
InfoSyncer gets infoSyncer from domain.
func (*Domain) Init ¶
func (do *Domain) Init(ddlLease time.Duration, sysFactory func(*Domain) (pools.Resource, error)) error
Init initializes a domain.
func (*Domain) LoadPrivilegeLoop ¶
func (do *Domain) LoadPrivilegeLoop(ctx sessionctx.Context) error
LoadPrivilegeLoop create a goroutine loads privilege tables in a loop, it should be called only once in BootstrapSession.
func (*Domain) LogSlowQuery ¶
func (do *Domain) LogSlowQuery(query *SlowQueryInfo)
LogSlowQuery keeps topN recent slow queries in domain.
func (*Domain) NotifyUpdatePrivilege ¶
func (do *Domain) NotifyUpdatePrivilege(ctx sessionctx.Context)
NotifyUpdatePrivilege updates privilege key in etcd, TiDB client that watches the key will get notification.
func (*Domain) PrivilegeHandle ¶
func (do *Domain) PrivilegeHandle() *privileges.Handle
PrivilegeHandle returns the MySQLPrivilege.
func (*Domain) Reload ¶
Reload reloads InfoSchema. It's public in order to do the test.
func (*Domain) ResetHandle ¶
ResetHandle resets the domain's infoschema handle. It is used for testing.
func (*Domain) SetStatsUpdating ¶
SetStatsUpdating sets the value of stats updating.
func (*Domain) ShowSlowQuery ¶
func (do *Domain) ShowSlowQuery(showSlow *ast.ShowSlow) []*SlowQueryInfo
ShowSlowQuery returns the slow queries.
func (*Domain) StatsHandle ¶
func (do *Domain) StatsHandle() *statistics.Handle
StatsHandle returns the statistic handle.
func (*Domain) StatsUpdating ¶
StatsUpdating checks if the stats worker is updating.
func (*Domain) SysSessionPool ¶
func (do *Domain) SysSessionPool() *pools.ResourcePool
SysSessionPool returns the system session pool.
func (*Domain) UpdateTableStatsLoop ¶
func (do *Domain) UpdateTableStatsLoop(ctx sessionctx.Context) error
UpdateTableStatsLoop creates a goroutine loads stats info and updates stats info in a loop. It will also start a goroutine to analyze tables automatically. It should be called only once in BootstrapSession.
type EtcdBackend ¶
EtcdBackend is used for judging a storage is a real TiKV.
type GlobalVariableCache ¶
GlobalVariableCache caches global variables.
func (*GlobalVariableCache) Get ¶
func (gvc *GlobalVariableCache) Get() (succ bool, rows []chunk.Row, fields []*ast.ResultField)
Get gets the global variables from cache.
func (*GlobalVariableCache) Update ¶
func (gvc *GlobalVariableCache) Update(rows []chunk.Row, fields []*ast.ResultField)
Update updates the global variable cache.
type InfoSyncer ¶
type InfoSyncer struct {
// contains filtered or unexported fields
}
InfoSyncer stores server info to etcd when the tidb-server starts and delete when tidb-server shuts down.
func NewInfoSyncer ¶
func NewInfoSyncer(id string, etcdCli *clientv3.Client) *InfoSyncer
NewInfoSyncer return new InfoSyncer. It is exported for testing.
func (InfoSyncer) Done ¶
func (is InfoSyncer) Done() <-chan struct{}
Done returns a channel that closes when the info syncer is no longer being refreshed.
func (*InfoSyncer) GetAllServerInfo ¶
func (is *InfoSyncer) GetAllServerInfo(ctx context.Context) (map[string]*ServerInfo, error)
GetAllServerInfo gets all servers static information from etcd.
func (*InfoSyncer) GetServerInfo ¶
func (is *InfoSyncer) GetServerInfo() *ServerInfo
GetServerInfo gets self server static information.
func (*InfoSyncer) GetServerInfoByID ¶
func (is *InfoSyncer) GetServerInfoByID(ctx context.Context, id string) (*ServerInfo, error)
GetServerInfoByID gets server static information from etcd.
func (*InfoSyncer) Init ¶
func (is *InfoSyncer) Init(ctx context.Context) error
Init creates a new etcd session and stores server info to etcd.
func (*InfoSyncer) RemoveServerInfo ¶
func (is *InfoSyncer) RemoveServerInfo()
RemoveServerInfo remove self server static information from etcd.
func (*InfoSyncer) Restart ¶
func (is *InfoSyncer) Restart(ctx context.Context) error
Restart restart the info syncer with new session leaseID and store server info to etcd again.
type MockFailure ¶
MockFailure mocks reload failed. It's used for fixing data race in tests.
func (*MockFailure) SetValue ¶
func (m *MockFailure) SetValue(isFailed bool)
SetValue sets whether we need to mock reload failed.
type SchemaChecker ¶
type SchemaChecker struct { SchemaValidator // contains filtered or unexported fields }
SchemaChecker is used for checking schema-validity.
func NewSchemaChecker ¶
func NewSchemaChecker(do *Domain, schemaVer int64, relatedTableIDs []int64) *SchemaChecker
NewSchemaChecker creates a new schema checker.
func (*SchemaChecker) Check ¶
func (s *SchemaChecker) Check(txnTS uint64) error
Check checks the validity of the schema version.
type SchemaValidator ¶
type SchemaValidator interface { // Update the schema validator, add a new item, delete the expired deltaSchemaInfos. // The latest schemaVer is valid within leaseGrantTime plus lease duration. // Add the changed table IDs to the new schema information, // which is produced when the oldSchemaVer is updated to the newSchemaVer. Update(leaseGrantTime uint64, oldSchemaVer, newSchemaVer int64, changedTableIDs []int64) // Check is it valid for a transaction to use schemaVer and related tables, at timestamp txnTS. Check(txnTS uint64, schemaVer int64, relatedTableIDs []int64) checkResult // Stop stops checking the valid of transaction. Stop() // Restart restarts the schema validator after it is stopped. Restart() // Reset resets SchemaValidator to initial state. Reset() }
SchemaValidator is the interface for checking the validity of schema version.
func NewSchemaValidator ¶
func NewSchemaValidator(lease time.Duration) SchemaValidator
NewSchemaValidator returns a SchemaValidator structure.
type ServerInfo ¶
type ServerInfo struct { ServerVersionInfo ID string `json:"ddl_id"` IP string `json:"ip"` Port uint `json:"listening_port"` StatusPort uint `json:"status_port"` Lease string `json:"lease"` }
ServerInfo is server static information. It will not be updated when tidb-server running. So please only put static information in ServerInfo struct.
type ServerVersionInfo ¶
ServerVersionInfo is the server version and git_hash.