net.wicp.tams.common.binlog.parser.event

类 TableMapLogEvent

java.lang.Object

net.wicp.tams.common.binlog.parser.LogEvent

net.wicp.tams.common.binlog.parser.event.TableMapLogEvent

public final class TableMapLogEvent
extends LogEvent

In row-based mode, every row operation event is preceded by a Table_map_log_event which maps a table definition to a number. The table definition consists of database name, table name, and column definitions. The Post-Header has the following components:

Post-Header for Table_map_log_event

Name	Format	Description
table_id	6 bytes unsigned integer	The number that identifies the table.
flags	2 byte bitfield	Reserved for future use; currently always 0.

The Body has the following components:

Body for Table_map_log_event

Name	Format	Description
database_name	one byte string length, followed by null-terminated string	The name of the database in which the table resides. The name is represented as a one byte unsigned integer representing the number of bytes in the name, followed by length bytes containing the database name, followed by a terminating 0 byte. (Note the redundancy in the representation of the length.)
table_name	one byte string length, followed by null-terminated string	The name of the table, encoded the same way as the database name above.
column_count	packed_integer "Packed Integer"	The number of columns in the table, represented as a packed variable-length integer.
column_type	List of column_count 1 byte enumeration values	The type of each column in the table, listed from left to right. Each byte is mapped to a column type according to the enumeration type enum_field_types defined in mysql_com.h. The mapping of types to numbers is listed in the table Table_table_map_log_event_column_types "below" (along with description of the associated metadata field).
metadata_length	packed_integer "Packed Integer"	The length of the following metadata block
metadata	list of metadata for each column	For each column from left to right, a chunk of data who's length and semantics depends on the type of the column. The length and semantics for the metadata for each column are listed in the table Table_table_map_log_event_column_types "below".
null_bits	column_count bits, rounded up to nearest byte	For each column, a bit indicating whether data in the column can be NULL or not. The number of bytes needed for this is int((column_count+7)/8). The flag for the first column from the left is in the least-significant bit of the first byte, the second is in the second least significant bit of the first byte, the ninth is in the least significant bit of the second byte, and so on.

The table below lists all column types, along with the numerical identifier for it and the size and interpretation of meta-data used to describe the type.

Table_map_log_event column types: numerical identifier and metadata

Name	Identifier	Size of metadata in bytes	Description of metadata
MYSQL_TYPE_DECIMAL	0	0	No column metadata.
MYSQL_TYPE_TINY	1	0	No column metadata.
MYSQL_TYPE_SHORT	2	0	No column metadata.
MYSQL_TYPE_LONG	3	0	No column metadata.
MYSQL_TYPE_FLOAT	4	1 byte	1 byte unsigned integer, representing the "pack_length", which is equal to sizeof(float) on the server from which the event originates.
MYSQL_TYPE_DOUBLE	5	1 byte	1 byte unsigned integer, representing the "pack_length", which is equal to sizeof(double) on the server from which the event originates.
MYSQL_TYPE_NULL	6	0	No column metadata.
MYSQL_TYPE_TIMESTAMP	7	0	No column metadata.
MYSQL_TYPE_LONGLONG	8	0	No column metadata.
MYSQL_TYPE_INT24	9	0	No column metadata.
MYSQL_TYPE_DATE	10	0	No column metadata.
MYSQL_TYPE_TIME	11	0	No column metadata.
MYSQL_TYPE_DATETIME	12	0	No column metadata.
MYSQL_TYPE_YEAR	13	0	No column metadata.
MYSQL_TYPE_NEWDATE	14	–	This enumeration value is only used internally and cannot exist in a binlog.
MYSQL_TYPE_VARCHAR	15	2 bytes	2 byte unsigned integer representing the maximum length of the string.
MYSQL_TYPE_BIT	16	2 bytes	A 1 byte unsigned int representing the length in bits of the bitfield (0 to 64), followed by a 1 byte unsigned int representing the number of bytes occupied by the bitfield. The number of bytes is either int((length+7)/8) or int(length/8).
MYSQL_TYPE_NEWDECIMAL	246	2 bytes	A 1 byte unsigned int representing the precision, followed by a 1 byte unsigned int representing the number of decimals.
MYSQL_TYPE_ENUM	247	–	This enumeration value is only used internally and cannot exist in a binlog.
MYSQL_TYPE_SET	248	–	This enumeration value is only used internally and cannot exist in a binlog.
MYSQL_TYPE_TINY_BLOB	249	–	This enumeration value is only used internally and cannot exist in a binlog.
MYSQL_TYPE_MEDIUM_BLOB	250	–	This enumeration value is only used internally and cannot exist in a binlog.
MYSQL_TYPE_LONG_BLOB	251	–	This enumeration value is only used internally and cannot exist in a binlog.
MYSQL_TYPE_BLOB	252	1 byte	The pack length, i.e., the number of bytes needed to represent the length of the blob: 1, 2, 3, or 4.
MYSQL_TYPE_VAR_STRING	253	2 bytes	This is used to store both strings and enumeration values. The first byte is a enumeration value storing the real type, which may be either MYSQL_TYPE_VAR_STRING or MYSQL_TYPE_ENUM. The second byte is a 1 byte unsigned integer representing the field size, i.e., the number of bytes needed to store the length of the string.
MYSQL_TYPE_STRING	254	2 bytes	The first byte is always MYSQL_TYPE_VAR_STRING (i.e., 253). The second byte is the field size, i.e., the number of bytes in the representation of size of the string: 3 or 4.
MYSQL_TYPE_GEOMETRY	255	1 byte	The pack length, i.e., the number of bytes needed to represent the length of the geometry: 1, 2, 3, or 4.

版本:

1.0

作者:

Changyuan.lh

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	TableMapLogEvent.ColumnInfo Holding mysql column information.

字段概要

字段

限定符和类型	字段和说明
protected int	columnCnt
protected TableMapLogEvent.ColumnInfo[]	columnInfo
protected String	dbname Fixed data part: 6 bytes.
protected BitSet	nullBits
protected long	tableId
protected String	tblname
static int	TM_FLAGS_OFFSET
static int	TM_MAPID_OFFSET TM = "Table Map"

从类继承的字段 net.wicp.tams.common.binlog.parser.LogEvent

ANNOTATE_ROWS_EVENT, ANONYMOUS_GTID_LOG_EVENT, APPEND_BLOCK_EVENT, BEGIN_LOAD_QUERY_EVENT, BINLOG_CHECKPOINT_EVENT, BINLOG_CHECKSUM_ALG_CRC32, BINLOG_CHECKSUM_ALG_DESC_LEN, BINLOG_CHECKSUM_ALG_ENUM_END, BINLOG_CHECKSUM_ALG_OFF, BINLOG_CHECKSUM_ALG_UNDEF, BINLOG_CHECKSUM_LEN, BINLOG_VERSION, CHECKSUM_CRC32_SIGNATURE_LEN, CREATE_FILE_EVENT, DELETE_FILE_EVENT, DELETE_ROWS_EVENT, DELETE_ROWS_EVENT_V1, ENUM_END_EVENT, EVENT_LEN_OFFSET, EVENT_TYPE_OFFSET, EXEC_LOAD_EVENT, EXECUTE_LOAD_QUERY_EVENT, EXTRA_ROW_INFO_FORMAT_OFFSET, EXTRA_ROW_INFO_HDR_BYTES, EXTRA_ROW_INFO_LEN_OFFSET, EXTRA_ROW_INFO_MAX_PAYLOAD, FLAGS_OFFSET, FORMAT_DESCRIPTION_EVENT, GTID_EVENT, GTID_LIST_EVENT, GTID_LOG_EVENT, header, HEARTBEAT_LOG_EVENT, IGNORABLE_LOG_EVENT, INCIDENT_EVENT, INTVAR_EVENT, LOAD_EVENT, LOG_EVENT_IGNORABLE_F, LOG_POS_OFFSET, logger, MARIA_EVENTS_BEGIN, MARIA_SLAVE_CAPABILITY_ANNOTATE, MARIA_SLAVE_CAPABILITY_BINLOG_CHECKPOINT, MARIA_SLAVE_CAPABILITY_GTID, MARIA_SLAVE_CAPABILITY_MINE, MARIA_SLAVE_CAPABILITY_TOLERATE_HOLES, MARIA_SLAVE_CAPABILITY_UNKNOWN, MYSQL_EVENTS_END, MYSQL_TYPE_BIT, MYSQL_TYPE_BLOB, MYSQL_TYPE_DATE, MYSQL_TYPE_DATETIME, MYSQL_TYPE_DATETIME2, MYSQL_TYPE_DECIMAL, MYSQL_TYPE_DOUBLE, MYSQL_TYPE_ENUM, MYSQL_TYPE_FLOAT, MYSQL_TYPE_GEOMETRY, MYSQL_TYPE_INT24, MYSQL_TYPE_JSON, MYSQL_TYPE_LONG, MYSQL_TYPE_LONG_BLOB, MYSQL_TYPE_LONGLONG, MYSQL_TYPE_MEDIUM_BLOB, MYSQL_TYPE_NEWDATE, MYSQL_TYPE_NEWDECIMAL, MYSQL_TYPE_NULL, MYSQL_TYPE_SET, MYSQL_TYPE_SHORT, MYSQL_TYPE_STRING, MYSQL_TYPE_TIME, MYSQL_TYPE_TIME2, MYSQL_TYPE_TIMESTAMP, MYSQL_TYPE_TIMESTAMP2, MYSQL_TYPE_TINY, MYSQL_TYPE_TINY_BLOB, MYSQL_TYPE_VAR_STRING, MYSQL_TYPE_VARCHAR, MYSQL_TYPE_YEAR, NEW_LOAD_EVENT, PRE_GA_DELETE_ROWS_EVENT, PRE_GA_UPDATE_ROWS_EVENT, PRE_GA_WRITE_ROWS_EVENT, PREVIOUS_GTIDS_LOG_EVENT, QUERY_EVENT, QUERY_HEADER_LEN, QUERY_HEADER_MINIMAL_LEN, RAND_EVENT, ROTATE_EVENT, ROWS_QUERY_LOG_EVENT, SERVER_ID_OFFSET, SERVER_VERSION, SLAVE_EVENT, START_EVENT_V3, STOP_EVENT, TABLE_MAP_EVENT, UNKNOWN_EVENT, UPDATE_ROWS_EVENT, UPDATE_ROWS_EVENT_V1, USER_VAR_EVENT, WRITE_ROWS_EVENT, WRITE_ROWS_EVENT_V1, XID_EVENT

构造器概要

构造器

构造器和说明
TableMapLogEvent(LogHeader header, LogBuffer buffer, FormatDescriptionLogEvent descriptionEvent) Constructor used by slave to read the event from the binary log.

方法概要

方法

限定符和类型	方法和说明
int	getColumnCnt()
TableMapLogEvent.ColumnInfo[]	getColumnInfo()
String	getDbName()
long	getTableId()
String	getTableName()

从类继承的方法 net.wicp.tams.common.binlog.parser.LogEvent

getEventLen, getHeader, getLogPos, getServerId, getTypeName, getWhen

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

dbname

protected final String dbname

Fixed data part:

• 6 bytes. The table ID.
• 2 bytes. Reserved for future use.

Variable data part:

• 1 byte. The length of the database name.
• Variable-sized. The database name (null-terminated).
• 1 byte. The length of the table name.
• Variable-sized. The table name (null-terminated).
• Packed integer. The number of columns in the table.
• Variable-sized. An array of column types, one byte per column.
• Packed integer. The length of the metadata block.
• Variable-sized. The metadata block; see log_event.h for contents and format.
• Variable-sized. Bit-field indicating whether each column can be NULL, one bit per column. For this field, the amount of storage required for N columns is INT((N+7)/8) bytes.

Source : http://forge.mysql.com/wiki/MySQL_Internals_Binary_Log

tblname

protected final String tblname

columnCnt

protected final int columnCnt

columnInfo

protected final TableMapLogEvent.ColumnInfo[] columnInfo

tableId

protected final long tableId

nullBits

protected BitSet nullBits

TM_MAPID_OFFSET

public static final int TM_MAPID_OFFSET

TM = "Table Map"

另请参阅:

常量字段值

TM_FLAGS_OFFSET

public static final int TM_FLAGS_OFFSET

另请参阅:

常量字段值

构造器详细资料

TableMapLogEvent

public TableMapLogEvent(LogHeader header,
                LogBuffer buffer,
                FormatDescriptionLogEvent descriptionEvent)

Constructor used by slave to read the event from the binary log.

方法详细资料

getDbName

public final String getDbName()

getTableName

public final String getTableName()

getColumnCnt

public final int getColumnCnt()

getColumnInfo

public final TableMapLogEvent.ColumnInfo[] getColumnInfo()

getTableId

public final long getTableId()