#include "univ.i"
#include "mtr0types.h"
#include "row0types.h"
#include "rem0types.h"
#include "data0types.h"
#include "dict0types.h"
#include "trx0types.h"
#include "que0types.h"
#include "row0log.ic"

Include dependency graph for row0log.h:

Functions
UNIV_INTERN bool	row_log_allocate (dict_index_t index, dict_table_t table, bool same_pk, const dtuple_t add_cols, const ulint col_map)
UNIV_INTERN void	row_log_free (row_log_t *&log))
UNIV_INLINE void	row_log_abort_sec (dict_index_t *index))
UNIV_INLINE bool	row_log_online_op_try (dict_index_t index, const dtuple_t tuple, trx_id_t trx_id))
UNIV_INTERN void	row_log_online_op (dict_index_t index, const dtuple_t tuple, trx_id_t trx_id) UNIV_COLD)
UNIV_INTERN dberr_t	row_log_table_get_error (const dict_index_t *index))
UNIV_INTERN void	row_log_table_delete (const rec_t rec, dict_index_t index, const ulint offsets, const byte sys) UNIV_COLD))
UNIV_INTERN void	row_log_table_update (const rec_t rec, dict_index_t index, const ulint offsets, const dtuple_t old_pk) UNIV_COLD))
UNIV_INTERN const dtuple_t *	row_log_table_get_pk (const rec_t rec, dict_index_t index, const ulint offsets, byte sys, mem_heap_t **heap) UNIV_COLD
UNIV_INTERN void	row_log_table_insert (const rec_t rec, dict_index_t index, const ulint *offsets) UNIV_COLD)
UNIV_INTERN void	row_log_table_blob_free (dict_index_t *index, ulint page_no) UNIV_COLD)
UNIV_INTERN void	row_log_table_blob_alloc (dict_index_t *index, ulint page_no) UNIV_COLD)
UNIV_INTERN dberr_t	row_log_table_apply (que_thr_t thr, dict_table_t old_table, struct TABLE *table))
UNIV_INTERN trx_id_t	row_log_get_max_trx (dict_index_t *index))
UNIV_INTERN dberr_t	row_log_apply (trx_t trx, dict_index_t index, struct TABLE *table))

Variables
UNIV_INTERN bool	warn_unused_result

Detailed Description

Modification log for online index creation and online table rebuild

Created 2011-05-26 Marko Makela

Function Documentation

UNIV_INLINE void row_log_abort_sec ( dict_index_t * index )

Free the row log for an index on which online creation was aborted.

Parameters

index in/out: index (x-latched)

UNIV_INTERN bool row_log_allocate	(	dict_index_t *	index,
		dict_table_t *	table,
		bool	same_pk,
		const dtuple_t *	add_cols,
		const ulint *	col_map
	)

Allocate the row log for an index and flag the index for online creation.

Return values

true	if success, false if not

Parameters

index	in/out: index
table	in/out: new table being rebuilt, or NULL when creating a secondary index
same_pk	in: whether the definition of the PRIMARY KEY has remained the same
add_cols	in: default values of added columns, or NULL
col_map	in: mapping of old column numbers to new ones, or NULL if !table

UNIV_INTERN dberr_t row_log_apply	(	trx_t *	trx,
		dict_index_t *	index,
		struct TABLE *	table
	)

Merge the row log to the index upon completing index creation.

Returns: DB_SUCCESS, or error code on failure

Parameters

trx	in: transaction (for checking if the operation was interrupted)
index	in/out: secondary index
table	in/out: MySQL table (for reporting duplicates)

UNIV_INTERN void row_log_free ( row_log_t *& log )

Free the row log for an index that was being created online.

Parameters

log	in,own: row log

UNIV_INTERN trx_id_t row_log_get_max_trx ( dict_index_t * index )

Get the latest transaction ID that has invoked row_log_online_op() during online creation.

Returns: latest transaction ID, or 0 if nothing was logged

Parameters

index in: index, must be locked

UNIV_INTERN void row_log_online_op	(	dict_index_t *	index,
		const dtuple_t *	tuple,
		trx_id_t	trx_id
	)

Logs an operation to a secondary index that is (or was) being created.

Parameters

index	in/out: index, S or X latched
tuple	in: index tuple
trx_id	in: transaction ID for insert, or 0 for delete

UNIV_INLINE bool row_log_online_op_try	(	dict_index_t *	index,
		const dtuple_t *	tuple,
		trx_id_t	trx_id
	)

Try to log an operation to a secondary index that is (or was) being created.

Return values

true	if the operation was logged or can be ignored
false	if online index creation is not taking place

Parameters

index	in/out: index, S or X latched
tuple	in: index tuple
trx_id	in: transaction ID for insert, or 0 for delete

UNIV_INTERN dberr_t row_log_table_apply	(	que_thr_t *	thr,
		dict_table_t *	old_table,
		struct TABLE *	table
	)

Apply the row_log_table log to a table upon completing rebuild.

Returns: DB_SUCCESS, or error code on failure

Parameters

thr	in: query graph
old_table	in: old table
table	in/out: MySQL table (for reporting duplicates)

UNIV_INTERN void row_log_table_blob_alloc	(	dict_index_t *	index,
		ulint	page_no
	)

Notes that a BLOB is being allocated during online ALTER TABLE.

Parameters

index	in/out: clustered index, X-latched
page_no	in: starting page number of the BLOB

UNIV_INTERN void row_log_table_blob_free	(	dict_index_t *	index,
		ulint	page_no
	)

Notes that a BLOB is being freed during online ALTER TABLE.

Parameters

index	in/out: clustered index, X-latched
page_no	in: starting page number of the BLOB

UNIV_INTERN void row_log_table_delete	(	const rec_t *	rec,
		dict_index_t *	index,
		const ulint *	offsets,
		const byte *	sys
	)

Logs a delete operation to a table that is being rebuilt. This will be merged in row_log_table_apply_delete().

Parameters

rec	in: clustered index leaf page record, page X-latched
index	in/out: clustered index, S-latched or X-latched
offsets	in: rec_get_offsets(rec,index)
sys	in: DB_TRX_ID,DB_ROLL_PTR that should be logged, or NULL to use those in rec

UNIV_INTERN dberr_t row_log_table_get_error ( const dict_index_t * index )

Gets the error status of the online index rebuild log.

Returns: DB_SUCCESS or error code

Parameters

index in: clustered index of a table that is being rebuilt online

UNIV_INTERN const dtuple_t* row_log_table_get_pk	(	const rec_t *	rec,
		dict_index_t *	index,
		const ulint *	offsets,
		byte *	sys,
		mem_heap_t **	heap
	)

Constructs the old PRIMARY KEY and DB_TRX_ID,DB_ROLL_PTR of a table that is being rebuilt.

Returns: tuple of PRIMARY KEY,DB_TRX_ID,DB_ROLL_PTR in the rebuilt table, or NULL if the PRIMARY KEY definition does not change

Parameters

rec	in: clustered index leaf page record, page X-latched
index	in/out: clustered index, S-latched or X-latched
offsets	in: rec_get_offsets(rec,index), or NULL
sys	out: DB_TRX_ID,DB_ROLL_PTR for row_log_table_delete(), or NULL
heap	in/out: memory heap where allocated

UNIV_INTERN void row_log_table_insert	(	const rec_t *	rec,
		dict_index_t *	index,
		const ulint *	offsets
	)

Logs an insert to a table that is being rebuilt. This will be merged in row_log_table_apply_insert().

Parameters

rec	in: clustered index leaf page record, page X-latched
index	in/out: clustered index, S-latched or X-latched
offsets	in: rec_get_offsets(rec,index)

UNIV_INTERN void row_log_table_update	(	const rec_t *	rec,
		dict_index_t *	index,
		const ulint *	offsets,
		const dtuple_t *	old_pk
	)

Logs an update operation to a table that is being rebuilt. This will be merged in row_log_table_apply_update().

Parameters

rec	in: clustered index leaf page record, page X-latched
index	in/out: clustered index, S-latched or X-latched
offsets	in: rec_get_offsets(rec,index)
old_pk	in: row_log_table_get_pk() before the update

Functions

Variables

Detailed Description

Function Documentation