This class represents all data dictionary table like mysql.tables, mysql.columns and more. More...

#include <object_table.h>

Inheritance diagram for dd::Object_table:

Public Member Functions
virtual const String_type &	name () const =0
	Get the table name used by the target definition for the dictionary table. More...

virtual Object_table_definition *	target_table_definition ()=0
	Get the target definition for the dictionary table. More...

virtual const Object_table_definition *	target_table_definition () const =0

virtual void	set_abandoned (uint last_dd_version) const =0
	Mark the target definition for the dictionary table as abandoned. More...

virtual bool	is_abandoned () const =0
	Check if the dictionary table is abandoned. More...

virtual const Object_table_definition *	actual_table_definition () const =0
	Get the actual definition for the dictionary table. More...

virtual bool	set_actual_table_definition (const Properties &table_def_properties) const =0
	Set the actual definition for the dictionary table. More...

virtual int	field_number (const String_type &field_label) const =0
	Get the field ordinal position in the object table. More...

virtual bool	populate (THD *thd) const =0
	Execute low level code for populating the table. More...

virtual bool	is_hidden () const =0
	Check if the table should be hidden. More...

virtual void	set_hidden (bool hidden)=0
	Mark the dictionary table as hidden or visible. More...

virtual	~Object_table ()=default

Static Public Member Functions
static Object_table *	create_object_table ()
	Allocate a new Object_table instance on the heap. More...

Detailed Description

This class represents all data dictionary table like mysql.tables, mysql.columns and more.

This is the base class of all the classes defined in sql/dd/impl/tables/ headers. This class is also the base class of tables requested by the DDSE and by plugins.

The server code should contain a Object_table subclass for each DD table which is a target table for at least one of the supported DD versions (i.e., the DD versions from which this server can upgrade). So even if a previous DD version stops using a DD table, the later servers which can upgrade need to keep the Object_table subclass for that table. The motivation for that is to be able to recognize the table, and to be able to remove it.

Instances of this class will contain one or two table definitions, depending on the context:

The actual table definition reflects the persistently stored DD table, i.e., what is reflected in the persistently stored mete data.
The target table definition reflects the DD table which the server is using during normal operation.

If the actual DD version is different from the target DD version, upgrade is required. The actual table definition is used only in situations where we have an upgrade or downgrade.

Note: This class may be inherited along different paths for some subclasses due to the diamond shaped inheritance hierarchy; thus, direct subclasses must inherit this class virtually.

Constructor & Destructor Documentation

◆ ~Object_table()

virtual dd::Object_table::~Object_table ( )

virtualdefault

Member Function Documentation

◆ actual_table_definition()

virtual const Object_table_definition * dd::Object_table::actual_table_definition ( ) const

pure virtual

Get the actual definition for the dictionary table.

The actual definition is the definition which is used by a DD table which is stored persistently. Normally, for an ordinary running server, the actual table definitions are equal to the target table definitions. In an upgrade context, they may differ.

Returns: Pointer to the definition of the table.

Implemented in dd::Entity_object_table_impl, and dd::Object_table_impl.

◆ create_object_table()

Object_table * dd::Object_table::create_object_table ( )

static

Allocate a new Object_table instance on the heap.

The new instance has the predefined options that all DD tables share:

ENGINE=INNODB DEFAULT CHARSET=utf8mb3 COLLATE=utf8mb3_bin ROW_FORMAT=DYNAMIC STATS_PERSISTENT=0 TABLESPACE=mysql

Note: The object is owned by the caller.

Returns: pointer to new Object_table instance.

◆ field_number()

virtual int dd::Object_table::field_number ( const String_type & field_label ) const

pure virtual

Get the field ordinal position in the object table.

Returns: Integer ordinal position.

Implemented in dd::Entity_object_table_impl, and dd::Object_table_impl.

◆ is_abandoned()

virtual bool dd::Object_table::is_abandoned ( ) const

pure virtual

Check if the dictionary table is abandoned.

Returns: true if the table is abandoned.

Implemented in dd::Entity_object_table_impl, and dd::Object_table_impl.

◆ is_hidden()

virtual bool dd::Object_table::is_hidden ( ) const

pure virtual

Check if the table should be hidden.

Most of Object tables (alias DD tables) are hidden from users, but some of them are expected to be visible (not hidden) to user and be able to update them, e.g., innodb_index_stats/innodb_table_stats.

Returns: true if the table should be hidden.

Implemented in dd::Entity_object_table_impl, and dd::Object_table_impl.

◆ name()

virtual const String_type & dd::Object_table::name ( ) const

pure virtual

Get the table name used by the target definition for the dictionary table.

Returns: table name.

Implemented in dd::Entity_object_table_impl, and dd::Object_table_impl.

◆ populate()

virtual bool dd::Object_table::populate ( THD * thd ) const

pure virtual

Execute low level code for populating the table.

Returns: Boolean operation outcome, false if success.

Implemented in dd::Object_table_impl, dd::tables::Character_sets, dd::tables::Collations, and dd::Entity_object_table_impl.

◆ set_abandoned()

virtual void dd::Object_table::set_abandoned ( uint last_dd_version ) const

pure virtual

Mark the target definition for the dictionary table as abandoned.

Parameters

last_dd_version Last version where this object table was used.

Implemented in dd::Entity_object_table_impl, and dd::Object_table_impl.

◆ set_actual_table_definition()

virtual bool dd::Object_table::set_actual_table_definition ( const Properties & table_def_properties ) const

pure virtual

Set the actual definition for the dictionary table.

Parameters

table_def_properties Actual table definition represented as a set of properties.

Returns: false if no error.

Implemented in dd::Entity_object_table_impl, and dd::Object_table_impl.

◆ set_hidden()

virtual void dd::Object_table::set_hidden ( bool hidden )

pure virtual

Mark the dictionary table as hidden or visible.

Parameters

hidden Set to 'true' if the table should be hidden.

Implemented in dd::Entity_object_table_impl, and dd::Object_table_impl.

◆ target_table_definition() [1/2]

virtual const Object_table_definition * dd::Object_table::target_table_definition ( ) const

pure virtual

Implemented in dd::Entity_object_table_impl, and dd::Object_table_impl.

◆ target_table_definition() [2/2]

virtual Object_table_definition * dd::Object_table::target_table_definition ( )

pure virtual

Get the target definition for the dictionary table.

Note: There are const and non-const variants.

Returns: Pointer to the definition of the table.

Implemented in dd::Entity_object_table_impl, and dd::Object_table_impl.

The documentation for this class was generated from the following files:

sql/dd/types/object_table.h
sql/dd/impl/types/object_table_impl.cc

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~Object_table()

Member Function Documentation

◆ actual_table_definition()

◆ create_object_table()

◆ field_number()

◆ is_abandoned()

◆ is_hidden()

◆ name()

◆ populate()

◆ set_abandoned()

◆ set_actual_table_definition()

◆ set_hidden()

◆ target_table_definition() [1/2]

◆ target_table_definition() [2/2]