package topodata

Get desktop application:
View/edit binary Protocol Buffers messages

CellInfo contains information about a cell. CellInfo objects are stored in the global topology server, and describe how to reach local topology servers.

• string server_address = 1

  ServerAddress contains the address of the server for the cell. The syntax of this field is topology implementation specific. For instance, for Zookeeper, it is a comma-separated list of server addresses.

• string root = 2

  Root is the path to store data in. It is only used when talking to server_address.

CellsAlias

• repeated string cells = 2

  Cells that map to this alias

KeyRange describes a range of sharding keys, when range-based sharding is used.

Used in: binlogdata.BinlogSource, binlogdata.StreamKeyRangeRequest, Shard, Shard.SourceShard, ShardReference, ShardTabletControl, Tablet

• bytes start = 1

• bytes end = 2

A Keyspace contains data about a keyspace.

• string sharding_column_name = 1

  name of the column used for sharding empty if the keyspace is not sharded

• KeyspaceIdType sharding_column_type = 2

  type of the column used for sharding UNSET if the keyspace is not sharded

• repeated Keyspace.ServedFrom served_froms = 4

  ServedFrom will redirect the appropriate traffic to another keyspace.

• KeyspaceType keyspace_type = 5

  keyspace_type will determine how this keyspace is treated by vtgate / vschema. Normal keyspaces are routable by any query. Snapshot keyspaces are only accessible by explicit addresssing or by calling "use keyspace" first

• string base_keyspace = 6

  base_keyspace is the base keyspace from which a snapshot keyspace is created. empty for normal keyspaces

• optional vttime.Time snapshot_time = 7

  snapshot_time (in UTC) is a property of snapshot keyspaces which tells us what point in time the snapshot is of

ServedFrom indicates a relationship between a TabletType and the keyspace name that's serving it.

Used in: Keyspace

• TabletType tablet_type = 1

  the tablet type (key for the map)

• repeated string cells = 2

  the cells to limit this to

• string keyspace = 3

  the keyspace name that's serving it

KeyspaceIdType describes the type of the sharding key for a range-based sharded keyspace.

Used in: Keyspace, SrvKeyspace

• UNSET = 0

  UNSET is the default value, when range-based sharding is not used.

• UINT64 = 1

  UINT64 is when uint64 value is used. This is represented as 'unsigned bigint' in mysql

• BYTES = 2

  BYTES is when an array of bytes is used. This is represented as 'varbinary' in mysql

KeyspaceType describes the type of the keyspace

Used in: Keyspace

• NORMAL = 0

  NORMAL is the default value

• SNAPSHOT = 1

  SNAPSHOT is when we are creating a snapshot keyspace

A Shard contains data about a subset of the data whithin a keyspace.

• optional TabletAlias master_alias = 1

  master_alias is the tablet alias of the master for the shard. If it is unset, then there is no master in this shard yet. No lock is necessary to update this field, when for instance TabletExternallyReparented updates this. However, we lock the shard for reparenting operations (InitShardMaster, PlannedReparentShard,EmergencyReparentShard), to guarantee exclusive operation.

• optional vttime.Time master_term_start_time = 8

  master_term_start_time is the time (in UTC) at which the current term of the master specified in master_alias began. A new master term begins any time an authoritative decision is communicated about which tablet should be the master, such as via Vitess replication-management commands like PlannedReparentShard, EmergencyReparentShard, and TabletExternallyReparented. The master_alias should only ever be changed if the new master's term began at a later time than this. Note that a new term can start for the tablet that is already the master. In that case, the master_term_start_time would be increased without changing the master_alias.

• optional KeyRange key_range = 2

  key_range is the KeyRange for this shard. It can be unset if: - we are not using range-based sharding in this shard. - the shard covers the entire keyrange. This must match the shard name based on our other conventions, but helpful to have it decomposed here. Once set at creation time, it is never changed.

• repeated Shard.ServedType served_types = 3

  served_types has at most one entry per TabletType This field is in the process of being deprecated in favor of is_master_serving. Keeping for backwards compatibility purposes.

• repeated Shard.SourceShard source_shards = 4

  SourceShards is the list of shards we're replicating from, using filtered replication. The keyspace lock is always taken when changing this.

• repeated Shard.TabletControl tablet_controls = 6

  tablet_controls has at most one entry per TabletType. The keyspace lock is always taken when changing this.

• bool is_master_serving = 7

  is_master_serving sets whether this shard master is serving traffic or not. The keyspace lock is always taken when changing this.

ServedType is an entry in the served_types

Used in: Shard

• TabletType tablet_type = 1

• repeated string cells = 2

SourceShard represents a data source for filtered replication across shards. When this is used in a destination shard, the master of that shard will run filtered replication.

Used in: Shard

• uint32 uid = 1

  Uid is the unique ID for this SourceShard object.

• string keyspace = 2

  the source keyspace

• string shard = 3

  the source shard

• optional KeyRange key_range = 4

  the source shard keyrange

• repeated string tables = 5

  the source table list to replicate

TabletControl controls tablet's behavior

Used in: Shard

• TabletType tablet_type = 1

  which tablet type is affected

• repeated string cells = 2

• repeated string blacklisted_tables = 4

• bool frozen = 5

  frozen is set if we've started failing over traffic for the master. If set, this record should not be removed.

ShardReference is used as a pointer from a SrvKeyspace to a Shard

Used in: SrvKeyspace.KeyspacePartition

• string name = 1

  Copied from Shard.

• optional KeyRange key_range = 2

  Disable query serving in this shard

ShardReplication describes the MySQL replication relationships whithin a cell.

• repeated ShardReplication.Node nodes = 1

  Note there can be only one Node in this array for a given tablet.

Node describes a tablet instance within the cell

Used in: ShardReplication

• optional TabletAlias tablet_alias = 1

ShardTabletControl is used as a pointer from a SrvKeyspace to a Shard

Used in: SrvKeyspace.KeyspacePartition

• string name = 1

  Copied from Shard.

• optional KeyRange key_range = 2

• bool query_service_disabled = 3

  Disable query serving in this shard

SrvKeyspace is a rollup node for the keyspace itself.

• repeated SrvKeyspace.KeyspacePartition partitions = 1

  The partitions this keyspace is serving, per tablet type.

• string sharding_column_name = 2

  copied from Keyspace

• KeyspaceIdType sharding_column_type = 3

• repeated SrvKeyspace.ServedFrom served_from = 4

Used in: SrvKeyspace

• TabletType served_type = 1

  The type this partition applies to.

• repeated ShardReference shard_references = 2

  List of non-overlapping continuous shards sorted by range.

• repeated ShardTabletControl shard_tablet_controls = 3

  List of shard tablet controls

ServedFrom indicates a relationship between a TabletType and the keyspace name that's serving it.

Used in: SrvKeyspace

• TabletType tablet_type = 1

  the tablet type

• string keyspace = 2

  the keyspace name that's serving it

Tablet represents information about a running instance of vttablet.

• optional TabletAlias alias = 1

  alias is the unique name of the tablet.

• string hostname = 2

  Fully qualified domain name of the host.

• map<string, int32> port_map = 4

  Map of named ports. Normally this should include vt and grpc. Going forward, the mysql port will be stored in mysql_port instead of here. For accessing mysql port, use topoproto.MysqlPort to fetch, and topoproto.SetMysqlPort to set. These wrappers will ensure legacy behavior is supported.

• string keyspace = 5

  Keyspace name.

• string shard = 6

  Shard name. If range based sharding is used, it should match key_range.

• optional KeyRange key_range = 7

  If range based sharding is used, range for the tablet's shard.

• TabletType type = 8

  type is the current type of the tablet.

• string db_name_override = 9

  It this is set, it is used as the database name instead of the normal "vt_" + keyspace.

• map<string, string> tags = 10

  tablet tags

• string mysql_hostname = 12

  MySQL hostname.

• int32 mysql_port = 13

  MySQL port. Use topoproto.MysqlPort and topoproto.SetMysqlPort to access this variable. The functions provide support for legacy behavior.

• optional vttime.Time master_term_start_time = 14

  master_term_start_time is the time (in UTC) at which the current term of the current tablet began as master. If this tablet is not currently the master, this value is ignored. A new master term begins any time an authoritative decision is communicated about which tablet should be the master, such as via Vitess replication-management commands like PlannedReparentShard, EmergencyReparentShard, and TabletExternallyReparented.

TabletAlias is a globally unique tablet identifier.

Used in: query.BeginExecuteBatchResponse, query.BeginExecuteResponse, query.BeginResponse, query.ReserveBeginExecuteResponse, query.ReserveExecuteResponse, query.StreamHealthResponse, tabletmanagerdata.InitReplicaRequest, tabletmanagerdata.InitSlaveRequest, tabletmanagerdata.PopulateReparentJournalRequest, tabletmanagerdata.ReplicaWasRestartedRequest, tabletmanagerdata.SetMasterRequest, tabletmanagerdata.SlaveWasRestartedRequest, Shard, ShardReplication.Node, Tablet, vtgate.Session.ShardSession

• string cell = 1

  cell is the cell (or datacenter) the tablet is in

• uint64 uid = 2

  uid is a unique id for this tablet within the shard (this is the MySQL server id as well).

TabletType represents the type of a given tablet.

Used in: binlogdata.BinlogSource, query.Target, tabletmanagerdata.ChangeTypeRequest, Keyspace.ServedFrom, Shard.ServedType, Shard.TabletControl, SrvKeyspace.KeyspacePartition, SrvKeyspace.ServedFrom, Tablet, vtgate.ExecuteBatchRequest, vtgate.ExecuteRequest, vtgate.StreamExecuteRequest, vtgate.VStreamRequest

• UNKNOWN = 0

  UNKNOWN is not a valid value.

• MASTER = 1

  MASTER is the master server for the shard. Only MASTER allows DMLs.

• REPLICA = 2

  REPLICA replicates from master. It is used to serve live traffic. A REPLICA can be promoted to MASTER. A demoted MASTER will go to REPLICA.

• RDONLY = 3

  RDONLY (old name) / BATCH (new name) is used to serve traffic for long-running jobs. It is a separate type from REPLICA so long-running queries don't affect web-like traffic.

• BATCH = 3

• SPARE = 4

  SPARE is a type of servers that cannot serve queries, but is available in case an extra server is needed.

• EXPERIMENTAL = 5

  EXPERIMENTAL is like SPARE, except it can serve queries. This type can be used for usages not planned by Vitess, like online export to another storage engine.

• BACKUP = 6

  BACKUP is the type a server goes to when taking a backup. No queries can be served in BACKUP mode.

• RESTORE = 7

  RESTORE is the type a server uses when restoring a backup, at startup time. No queries can be served in RESTORE mode.

• DRAINED = 8

  DRAINED is the type a server goes into when used by Vitess tools to perform an offline action. It is a serving type (as the tools processes may need to run queries), but it's not used to route queries from Vitess users. In this state, this tablet is dedicated to the process that uses it.