NdbDictionary

没有任何

此类表示 NDB Cluster 中的数据库事件。

下表列出了 Event该类的公共方法以及每个方法的用途或用途：

改进的事件 API（NDB 7.4 及更高版本）。  NDB 7.4 引入了一个时代驱动的事件 API，它取代了早期基于 GCI 的模型。新版本的 API 还简化了错误检测和处理。这些更改是在 NDB API 中实现的，方法是为 Ndb和 实现许多新方法NdbEventOperation，弃用这两个类的其他几种方法，并向 TableEvent.

一些新方法直接替换或替代已弃用的方法，但并非所有已弃用的方法都映射到新方法，其中一些是全新的。下表第一列显示了旧的（已弃用的）方法，第二列显示了新方法；新方法对应的旧方法显示在同一行中。

使用新 API 的错误处理是通过检查从返回的值来完成的 getEventType2()，并且不再使用方法 hasError() 和 来处理clearError()，这些方法现在已弃用，并且在未来的 NDB Cluster 版本中将被删除。为了支持这一变化，可能 TableEvent类型的范围已经扩大到此处列出的那些：

这些更改的结果是，在 NDB 7.4 及更高版本中，您可以在检查表事件的类型时检查错误，如下所示：

NdbDictionary::Event::TableEvent* error_type = 0;
NdbEventOperation* pOp = nextEvent2();

if (pOp->isErrorEpoch(error_type)
{
  switch (error_type)
  {
    case TE_INCONSISTENT :
      // Handle error/inconsistent epoch...
      break;

    case TE_OUT_OF_MEMORY :
      // Handle error/inconsistent data...
      break;

    //  ...
  }
}

有关详细信息，请参阅前面表格中显示的 Ndb和 NdbEventOperation方法以及 Event::TableEvent的详细说明。

这些是Event 该类的公共类型：

此方法用于添加应在其上检测事件的列。该列可以通过其 ID 或名称来指示。

Dictionary::createEvent() 您必须在检测到任何错误之前 调用 。参见 Dictionary::createEvent()。

如果您知道多个列的名称，则可以使用 一次对所有列启用事件检测 addEventColumns()。请参阅 Event::addEventColumns()。

可以通过以下任一方式调用此方法：

此方法采用单个参数，可以是以下之一：

没有。

此方法用于同时在多个列上启用事件检测。您必须使用列的名称。

与 一样，您必须 在检测到任何错误之前addEventColumn()调用 。Dictionary::createEvent()参见 Dictionary::createEvent()。

void addEventColumns
    (
      int          n,
      const char** columnNames
    )

此方法需要此处列出的两个参数：

没有。

此方法用于添加应检测的事件类型。

void addTableEvent
    (
      const TableEvent te
    )

此方法需要一个 TableEvent值。

没有。

构造函数创建一个具有给定名称的Event新实例，并可选择与表关联。

您应该记住 NDB API 不跟踪分配的事件对象，这意味着用户必须Event 在不再使用后明确删除这样创建的对象。

可以通过两种方式之一调用此方法，第一种方式仅通过名称调用，如下所示：

Event
    (
      const char* name
    )

或者，您可以使用事件名称和关联的表，如下所示：

Event
    (
      const char*                  name,
      const NdbDictionary::Table& table
    )

至少，name事件需要一个（作为常量字符指针）。可选地，一个事件也可以与一个表相关联；这个参数，当存在时，是对 Table对象的引用（参见 第 2.3.27 节，“表类”）。

的新实例Event。

此类型的值用于描述事件的生命周期或持久性及其范围。

下表显示了可能的值以及说明：

此类型的值用于指定表事件的报告选项。

下表显示了可能的值以及说明：

此方法获取事件的生命周期和范围（即它的 EventDurability）。

EventDurability getDurability
    (
      void
    ) const

没有。

一个EventDurability 值。

此方法用于从定义了事件的列中获取特定列。

const Column* getEventColumn
    (
      unsigned no
    ) const

列的编号 ( no)，使用getNoOfColumns()（请参阅 Event::getNoOfEventColumns()）获得。

指向Column 对应的指针no。

此方法获取事件的名称。

const char* getName
    (
      void
    ) const

没有。

事件的名称，作为字符指针。

此方法获取定义事件的列数。

int getNoOfEventColumns
    (
      void
    ) const

没有。

列数（作为整数），或者 -1在出现错误的情况下。

此方法获取事件的对象状态。

virtual Object::Status getObjectStatus
    (
      void
    ) const

没有。

事件的对象状态。有关可能的值，请参阅 Object::Status。

此方法获取事件的对象版本（请参阅 NDB Schema Object Versions）。

virtual int getObjectVersion
    (
      void
    ) const

没有。

事件的对象版本，作为整数。

此方法检索事件的对象 ID。

virtual int getObjectId
    (
      void
    ) const

没有。

事件的对象 ID，作为整数。

此方法用于获取对此事件有效的报告选项。

EventReport getReport
    (
      void
    ) const

没有。

Event::EventReport 中指定的报告选项 之一。

此方法用于查找与事件关联的表。它返回对相应 Table对象的引用。您也可以直接使用 获取表的名称 getTableName()。

const NdbDictionary::Table* getTable
    (
      void
    ) const

没有。

与事件关联的表（如果有的话）作为指向 Table对象的指针；否则，此方法返回NULL。（参见 第 2.3.27 节，“表类”。）

此方法用于检查是否将检测到给定的表事件。

bool getTableEvent
    (
      const TableEvent te
    ) const

此方法采用单个参数，即表事件的类型，即一个 TableEvent值。

如果将检测到类型 true的事件，则 此方法返回。否则，返回值为。 TableEventtefalse

此方法获取与事件关联的表的名称，并且可以作为 的方便替代方法getTable()。（请参阅 事件::getTable()。）

const char* getTableName
    (
      void
    ) const

没有。

与此事件关联的表的名称，作为字符指针。

该方法用于设置 合并事件标志，false默认情况下。将其设置为 true意味着事件合并如下：

void mergeEvents
    (
      bool flag
    )

一个布尔flag值。

没有。

此方法设置事件的持久性，即它的生命周期和范围。

void setDurability(EventDurability ed)

此方法需要单个 EventDurability值作为参数。

没有。

此方法用于为事件设置报告选项。可能的选项值可以在 Event::EventReport中找到。

您必须setReport()使用该 EventReport值 进行调用ER_DDL（在相同的 NDB Cluster 版本中添加）。

例如，要在 Event名为 的对象 上启用 DDL 事件报告myEvent，您必须调用此方法，如下所示：

myEvent.setReport(NdbDictionary::Event::ER_DDL);

void setReport
    (
      EventReport er
    )

期权EventReport价值。

没有。

此方法用于设置事件的名称。该名称在当前应用程序可见的所有事件中必须是唯一的（请参阅Event::getDurability()）。

您还可以在首次创建事件时设置事件名称。请参阅事件构造函数。

void setName
    (
      const char* name
    )

将name被赋予事件（作为常量字符指针）。

没有。

此方法定义了一个表，在该表上要检测事件。

默认情况下，事件检测发生在表中的所有列上。用于addEventColumn()覆盖此行为。有关详细信息，请参阅 Event::addEventColumn()。

void setTable
    (
      const NdbDictionary::Table& table
    )

NDB 7.3.3 和更高版本的 NDB Cluster 版本支持将指针与此方法一起使用，如下所示：

void setTable
    (
      const NdbDictionary::Table*; table
    )

如此使用时，setTable() 如果表指针为 ，则此版本的返回 -1 NULL。（漏洞 #16329082）

此方法需要一个参数，即对要在其上检测事件的表（请参阅第 2.3.27 节，“表类” ）的引用。NDB 7.3.3 及更高版本：可以使用对表的引用或指针。

没有。NDB 7.3.3 及更高版本：-1，如果使用空表指针。

TableEvent用于对可能与 NDB API 中的表关联的事件类型进行分类。

下表显示了可能的值以及说明：

TE_EMPTY, TE_INCONSISTENT, 和 TE_OUT_OF_MEMORY是在 NDB 7.4 中添加的。