没有一个

没有一个

任何非平凡NDB API程序利用至少一个的实例Ndb。通过使用几个Ndb对象,可以实现多线程应用程序。你应该记住,一个Ndb对象不能共享的线程之间;然而,它是可能的一个线程使用多个Ndb对象。一个应用程序过程最多可以支持4711Ndb对象。

下表列出了这个类的公共方法,每个方法的目的或使用:

的Ndb类没有定义任何公共typesbut定义三个数据结构,这是列在这里:

这将创建一个实例Ndb代表的连接NDB集群。所有NDB API的应用程序应该从建立至少一个开始Ndb对象。这需要创建至少一个的实例Ndb_cluster_connection,作为一个容器集群连接字符串。

Ndb (Ndb_cluster_connection *ndb_cluster_connection,const char *catalogName= " ",const char *schemaName=“def”)

的Ndb类构造函数需要三个参数,其中只有第一个是必需的:

一个Ndb对象。

的析构函数Ndb类应该被称为为了终止的一个实例Ndb。它不需要理由,也没有任何特殊处理。

这是两种NDB API方法提供关闭事务(另一个是NdbTransaction: close ())。你必须调用这两个方法来关闭交易一旦完成,交易是否成功。

如果事务尚未提交,它将终止时,调用此方法。看到Ndb: startTransaction ()。

空白closeTransaction (NdbTransaction *事务)

这个方法需要一个参数,一个指针NdbTransaction被关闭。

没有一个(无效)。

这种方法可以用来计算一个分布散列值,给定一个表和它的键。

哈希()只能用于表使用本机NDB分区。

静态int哈希(Uint32 *hashvalueptr表*,const NdbDictionary::表,const struct Key_part_ptr *keyData,void *xfrmbuf= 0,Uint32xfrmbuflen= 0)

这个方法接受以下参数:

0成功;如果执行失败,将返回一个错误代码。如果方法调用成功,通过计算哈希值hashvalueptr。

这个方法创建了一个订阅数据库事件。

NDB API事件订阅后一个NDB集群已经恢复使用ndb_restore;在这种情况下,必须重新创建明确的所有订阅。

NdbEventOperation * createEventOperation (const char *eventName)

这种方法需要一个参数,独一无二的eventName确定你希望订阅的事件。

一个指针指向一个NdbEventOperation对象(或零在失败的事件)。看到2.3.16部分,“NdbEventOperation类”。

这种方法滴订阅数据库事件由一个表示NdbEventOperation对象。

内存使用的事件操作已下降才释放事件缓冲区已经完全阅读。这意味着你必须继续打电话pollEvents ()和nextEvent ()在这种情况下,直到这些方法返回0和零分别为了这个内存被释放。

int dropEventOperation (NdbEventOperation *eventOp)

这个方法需要一个输入参数,指针的一个实例NdbEventOperation。

0在成功;任何其他结果表明失败。

Ndb

这种结构在NDB 7.4.3添加处理事件缓冲区内存使用统计数据。使用它作为参数Ndb: get_event_buffer_memory_usage ()。

EventBufferMemoryUsage下表所示的属性:

该方法用于获取一个对象检索或操纵数据库模式信息。这字典对象包含了集群中的所有表的元信息。

该方法返回的字典是独立运营的任何事务。看到2.3.3节,“Dictionary类”为更多的信息。

NdbDictionary:字典* getDictionary(空白)常量

没有一个。

的一个实例字典类。

这种方法可以用来获取当前数据库的名称。

const char * getDatabaseName(空白)

一个也没有。

当前数据库的名称。

该方法可用于获取当前数据库模式名。

const char * getDatabaseSchemaName(空白)

没有一个。

当前的数据库模式的名称。

遍历不同的事件操作当前GCI的一部分,成为有效后调用nextEvent ()。您可以使用这个方法来获得时代的摘要信息(如所有表的列表)前处理事件数据。

在NDB 7.4.3弃用此方法,在将来发布的版本中移除。在NDB 7.4.3,之后,您应该使用getNextEventOpInEpoch2 ()代替。

const NdbEventOperation * getGCIEventOperations (Uint32 *iter,Uint32 *event_types)

迭代器和一个事件类型的面具。集*iter= 0开始。

下一个事件操作;返回零当没有更多的事件操作。如果event_types不是零,然后在调用该方法包含事件类型的位掩码。。

得到了最大内存字节,可用于事件缓冲区。这是一样的阅读的价值ndb_eventbuffer_max_alloc系统变量的MySQL服务器。

该方法在NDB 7.3.3补充道。

无符号get_eventbuf_max_alloc(空白)

没有一个。

mamximum内存用于事件缓冲区,以字节为单位。

得到ndb_eventbuffer_free_percent,也就是事件缓冲区内存的百分比应该缓冲简历之前,可用一次ndb_eventbuffer_max_alloc已经达到了。这个值计算使用* 100 /ndb_eventbuffer_max_alloc,在那里使用实际使用事件缓冲区内存的数量,在字节。

该方法在NDB 7.4.3补充道。

无符号get_eventbuffer_free_percent(空白)

(百分比pct)的事件缓冲存储器,必须存在。有效范围是1到99场。

没有一个。

得到事件缓冲区使用的比例ndb_eventbuffer_max_alloc。不像get_eventbuffer_free_percent (),这种方法使完整的使用信息的形式EventBufferMemoryUsage数据结构。

该方法在NDB 7.4.3补充道。

空白get_event_buffer_memory_usage (EventBufferMemoryUsage&)

的引用EventBufferMemoryUsage结构,使用接收数据。

没有一个。

NDB 7.4.3补充说,这种方法取代getLatestGCI ()现在已经弃用,去除在未来NDB集群中释放。

NDB 7.4.7之前,此方法返回时代数量最高的事件队列。在NDB 7.4.7,后来,它返回后发现数量最高的时代使命pollEvents2 ()(错误# 20700220)。

Uint64 getHighestQueuedEpoch(空白)

没有一个。

最近的时代,一个整数。

全球指数最近的检查点。

在NDB 7.4.3弃用此方法,在将来发布的版本中移除。在NDB 7.4.3,之后,您应该使用getHighestQueuedEpoch ()代替。

Uint64 getLatestGCI(空白)

没有一个。

最近快一个整数。

该方法为你提供了两种不同的方式来获取一个NdbError对象代表一个错误条件。更详细的信息关于错误处理的NDB API,明白了NDB集群API错误。

的getNdbError ()方法实际上有两个变种。

第一个简单的得到最新的错误发生:

const NdbError& getNdbError(空白)

第二个变量返回对应于给定的错误代码的错误:

const NdbError& getNdbError (int错误代码)

无论使用哪个版本的方法,NdbError对象返回继续直到下一次NDB API方法被调用。

获得最新的错误,简单地调用getNdbError ()没有任何参数。获取匹配一个特定的错误错误代码,调用该方法通过代码(一个int)作为参数。NDB API错误代码的清单和相应的错误消息,明白了2.4节,“NDB API的错误和错误处理”。

一个NdbError对象包含关于错误的信息,包括它的类型和适用,上下文信息是如何出现的错误。看到2.3.15节,“NdbError结构”的细节。

这种方法提供了一种简便的和安全的方式访问任何额外的一个错误的信息。而不是阅读这些额外的细节NdbError对象的细节属性(现在弃用的getNdbErrorDetail ()见错误# 48851)。这种方法使存储这些细节的用户提供的缓冲区,返回一个指向这个缓冲区的开始。如果字符串包含细节超过缓冲区的长度,是截断。

getErrorDetail ()提供了一个错误的来源形式的一个字符串。唯一约束的情况下违反(错误893),这个字符串供应的完全限定名称索引问题的发源地,在格式数据库名称/模式名/表名/索引名,(NdbError.details,另一方面,仅有一个索引ID,它通常不是显而易见这个索引表所属)。不管错误的类型和细节关于这个错误,检索的字符串getErrorDetail ()总是以null结尾。

的getNdbErrorDetail ()方法有以下签名:

const char * getNdbErrorDetail (const NdbError&错误,char *缓冲,Uint32bufferLength)常量

得到一个错误的详细信息,电话getNdbErrorDetail ()与相应的参考NdbError对象,缓冲,这个缓冲区的长度(表示为一个32位无符号整数)。

当额外的细节错误可用,该方法返回一个指针的开始吗缓冲供应。如前所述,如果字符串包含长于细节bufferLength字符串被截断,健康。如果没有添加更多细节,getNdbErrorDetail ()返回零。

如果成立的一个名字Ndb对象初始化之前,您可以使用此方法检索它。用于调试。

该方法在NDB 7.3.6补充道。(错误# 18419907)

const char * getNdbObjectName(空白)常量

没有一个。

的Ndb对象名称,如果一个人一直使用setNdbObjectName ()。否则,该方法将返回0。

遍历单项业务占当前全球检查站。使用以下nextEvent2 ()获得时代的摘要信息,如所有表的清单,之前处理事件数据。

特殊时代没有任何事件操作。

const NdbEventOperation * getNextEventOpInEpoch2 (Uint32 *iter,Uint32 *event_types)

集iter最初为0;这是零当没有更多的事件在这个时代。如果event_types不是零,它接收到的事件类型的位掩码。

一个指针NdbEventOperation,如果有一个。

遍历单项业务占当前全球检查站。使用以下nextEvent2 ()获得时代的摘要信息,如所有表的清单,之前处理事件数据。是一样的getNextEventOpInEpoch3 ()但随着添加第三个参数拥有所有AnyValues收到的合并,显示哪些位设置为所有操作在一个给定的表。

特殊时代没有任何事件操作。

这个方法添加NDB 7.3.20 7.4.18, 7.5.9, 7.6.4。(错误# 26333981)

const NdbEventOperation * getNextEventOpInEpoch2 (Uint32 *iter,Uint32 *event_typesUint32 *cumulative_any_value)

集iter最初为0;这是零当没有更多的事件在这个时代。如果event_types不是零,它接收到的事件类型的位掩码。如果cumulative_any_value不是零,它拥有的合并所有AnyValues收到。

一个指针NdbEventOperation,如果有一个。

该方法可用于获得给定的一个参考Ndb对象。这是返回相同的值对于一个给定的操作对应于该对象的输出转储2350。

Uint32 getReference(空白)

没有一个。

一个32位无符号整数。

该方法用于初始化Ndb对象。

int init (intmaxNoOfTransactions= 4)

的init ()方法接受一个参数maxNoOfTransactions类型的整数。该参数指定的最大数量平行NdbTransaction对象,可以由这个实例Ndb。最大允许的值maxNoOfTransactions是1024;如果没有指定,默认为4。

每个扫描或索引操作使用一个额外的NdbTransaction对象。

这个方法返回一个int,可以是以下两个值:

检查是否所有事件是一致的。如果一个节点故障发生在资源耗尽,事件可能会丢失,因此交付的事件数据可能是不完整的。这种方法可以确定是这种情况。

在NDB 7.4.3弃用此方法,在将来发布的版本中移除。在NDB 7.4.3,之后,您应该使用NdbEventOperation: getEventType2 ()确定事件的类型,这种情况下,事件的类型TE_INCONSISTENT。看到事件:TableEvent。

bool isConsistent (Uint64&快)

参考全球检查点指数。这是第一个不一致的GCI发现,如果任何。

真正的如果所有事件都是一致的。

如果一个节点故障发生在资源耗尽,事件可能会丢失,因此交付的事件数据可能是不完整的。这种方法可以确定是这种情况通过检查是否所有事件在一个给定的GCI是一致的。

在NDB 7.4.3弃用此方法,在将来发布的版本中移除。在NDB 7.4.3,之后,您应该使用NdbEventOperation: getEventType2 ()确定事件的类型,这种情况下,事件的类型TE_INCONSISTENT。看到事件:TableEvent。

bool isConsistentGCI (Uint64快)

一个全球检查点指数。

真正的如果这个GCI是一致的;假表明GCI可能会不一致。

检查是否更高排队时代已经被调用Ndb: pollEvents2 (),还是一个TE_CLUSTER_FAILURE事件被发现。

是可能的,在一个集群故障被检测到,最高的排队返回的时代pollEvents2 ()不再增加。在这种情况下,而不是轮询更多的事件时,您应该使用事件nextEvent ()直到它检测到一个TE_CLUSTER_FAILURE检测到,然后重新连接到集群时可用了。

这种方法增加了NDB 7.3.10, 7.4.7(错误# 18753887)。

bool isExpectingHigherQueuedEpochs(空白)

没有一个。

真的如果排队时代看到的最后一个pollEvents2 ()打电话或集群失败的事件。

Ndb

Key_part_ptr提供了一种方便的方法来定义关键部分数据在开始交易和计算散列值,通过传入指针分配键值。主要分布有多个部件时,应作为一个数组,传递指针设置等于最后一部分零。看到Ndb: startTransaction (),Ndb:哈希(),关于如何使用这个结构的更多信息。

一个Key_part_ptr下表所示的属性:

返回下一个事件从订阅队列操作数据。

从NDB 7.3.6开始,此方法清除不一致数据事件从事件队列在处理他们。为了能够清除所有此类事件在这些后来的版本中,即使在情况下,应用程序必须调用这个方法pollEvents ()已经返回0。(错误# 18716991)

在NDB 7.4.3弃用此方法,在将来发布的版本中移除。在NDB 7.4.3,之后,您应该使用nextEvent2 ()代替。

NdbEventOperation * nextEvent(空白)

一个也没有。

这个方法返回一个NdbEventOperation订阅队列对象代表下一个事件,如果有这样的一个事件。如果没有事件队列,它返回零代替。

返回与数据相关联的事件操作列中移除从事件队列。这应该是后反复调用pollEvents2 ()填充队列,直到事件队列是空的。

NDB 7.4.3补充说,这种方法取代nextEvent ()现在已经弃用,去除在未来NDB集群中释放。

调用该方法之后,使用NdbEventOperation: getEpoch ()确定时代,然后检查返回的事件数据使用的类型NdbEventOperation: getEventType2 ()。所有异常处理必须提供TableEvent类型,包括TE_EMPTY,TE_INCONSISTENT,TE_OUT_OF_MEMORY(也介绍了NDB 7.4.3)。没有其他的NdbEventOperation比两个命名方法应该呼吁一个非凡的时代。返回空时代(TE_EMPTY当数据节点空闲)可能洪水应用程序。如果这是不可取的,应用程序应该过滤掉任何空的时代。

NdbEventOperation * nextEvent2(空白)

一个也没有。

这个方法返回一个NdbEventOperation对象代表下一个事件在一个事件队列,如果有这样的一个事件。如果没有事件队列,它返回零代替。

Ndb

一个PartitionSpec用于描述表分区使用任何以下条件之一:

一个PartitionSpec有两个属性,一个SpecType和一个规范这是一个数据结构对应SpecType,见下表:

该方法等待GCP完成。它是用来确定任何事件订阅队列中可用。

该方法等待下一个时代,而不是下一个质量。看到2.3.16部分,“NdbEventOperation类”为更多的信息。

在NDB 7.4.3,后来,这个方法弃用,如去除在未来NDB集群释放;使用pollEvents2 ()代替。

NDB 7.4.7之前,pollEvents ()不兼容的特殊TableEvent类型中添加NDB 7.4.3(错误# 20646496);在NDB 7.4.7,之后,pollEvents ()这些事件类型兼容,如以后在这一节中所述。

int pollEvents (intmaxTimeToWait,Uint64 *latestGCI= 0)

这里列出的这个方法接受两个参数:

pollEvents ()返回值的类型int,这可能是解释如下:

在NDB 7.4.7,后来,当pollEvents ()发现异常事件的事件队列,该方法返回1,否则表现如下:

等待一个事件发生。尽快返回任何事件数据是可用的。这种方法也移动时代的完整事件数据到事件队列。

NDB 7.4.3补充说,这种方法取代pollEvents ()现在已经弃用,去除在未来NDB集群中释放。

int pollEvents2 (intaMillisecondNumber,Uint64 *highestQueuedEpoch= 0)

这里列出的这个方法接受两个参数:

pollEvents2 ()返回一个整数,其价值可以解释如下:

该方法用于设置当前数据库的名称。

空白setDatabaseName (const char *数据库名)

setDatabaseName ()需要一个,所需参数,新数据库的名称设置为当前数据库。

没有一个。

该方法集当前数据库模式的名称。

空白setDatabaseSchemaName (const char *databaseSchemaName)

数据库模式的名称。

没有一个。

排队的空时代默认情况下是禁用的。这个方法可以用来支持这样排队,在这种情况下,任何新的空时代进入事件缓冲区方法调用后排队。

当启用队列空时代时,nextEvent ()同事一个空时代的一个且只有一个订阅(事件操作)连接到订阅Ndb对象。这意味着可以有不超过一个空每订阅时代,尽管用户可能有很多订阅相关的相同Ndb对象。

setEventBufferQueueEmptyEpoch ()没有相关的getter方法。这是故意的,是由于setter适用于排队新时代,而队列本身可能仍然反映了之前的状态,它们调用setter。因此,在过渡时期,一个空的队列中发现的时代可能即使排队是关闭的。

setEventBufferQueueEmptyEpoch ()添加在NDB 7.4.11, NDB是7.5.2。

空白setEventBufferQueueEmptyEpoch (boolqueue_empty_epoch)

这个方法接受一个输入参数,一个布尔值。调用的方法真正的使排队的空事件;通过假方法禁用这种排队。

没有一个。

设置最大内存字节,可用于事件缓冲区。这同样的效果,设置的值ndb_eventbuffer_max_alloc系统变量的MySQL服务器。

该方法在NDB 7.3.3补充道。

空白set_eventbuf_max_alloc(无符号大小)

所需的最大大小事件缓冲区的字节。

没有一个。

集ndb_eventbuffer_free_percent,也就是事件缓冲区内存的百分比应该缓冲简历之前,可用一次ndb_eventbuffer_max_alloc已经达到了。

该方法在NDB 7.4.3补充道。

int set_eventbuffer_free_percent(无符号pct)

(百分比pct)的事件缓冲存储器,必须存在。有效范围是1到99场。

值集。

从NDB 7.3.6开始,你可以设置任意的、人类可读名称来标识一个Ndb对象用于调试目的。这个名字可以检索使用getNdbObjectName ()。(错误# 18419907)这个调用之前必须完成init ()这个对象;试图设置一个名字初始化失败后一个错误。

你可以设置一个名称为给定的只有一次Ndb对象;随后尝试这个名字已经设置失败后一个错误。

int setNdbObjectName (const char *的名字)

一个的名字这是人类可读的。

0的成功。

该方法用于开始一个新事务。有三个变种,最简单的使用一个表和一个分区键或分区ID指定事务协调员(TC)。第三个变量可以让您指定的TC通过指针指向数据的关键。

当事务完成它必须关闭NdbTransaction: close ()或Ndb: closeTransaction ()。否则中止交易。必须这样做不管事务的最终结果,即使不能由于一个错误。

看到Ndb: closeTransaction (),NdbTransaction: close ()为更多的信息。

NdbTransaction表* * startTransaction (const NdbDictionary::表= 0,const char *keyData= 0,Uint32 *keyLen= 0)

该方法以以下三个参数:

NdbTransaction表* * startTransaction (const NdbDictionary::表,const struct Key_part_ptr *keyData,void *xfrmbuf= 0,Uint32xfrmbuflen= 0)

当指定事务协调员,该方法以这里列出的四个参数:

成功,一个NdbTransaction对象。如果失败,零返回。

假设是一个单一的表的分区键长整型数字列。然后你将宣布分布键数组如下所示:

Key_part_ptr distkey [2];

分布键的值将被定义如下所示:

无符号长长的distkeyValue = 23;

分布键数组的指针将设置如下:

distkey [0] .ptr = (const void *) &distkeyValue;

这个指针的长度将会设置:

distkey [0]。len= sizeof(distkeyValue);

分布键数组必须终止零元素。这是必要的,以避免产生额外的参数提供的数量分布键列:

distkey [1] .ptr =零;distkey [1]。len =零;

设置缓冲零许可证startTransaction ()自动分配和释放内存:

xfrmbuf =零;xfrmbuflen = 0;

现在,当你开始交易时,您可以直接访问节点包含所需的信息。

另一个distribution-aware版本的这个方法可以让您指定一个表和分区(使用分区ID)的提示选择事务协调员,和定义如下所示:

NdbTransaction表* * startTransaction (const NdbDictionary::表,Uint32partitionId)

如果集群有相同数量的数据节点,因为它有片段副本,指定事务协调员收益没有改善性能,因为每个数据节点包含整个数据库。然而,数据节点的数量大于片段复制的数量(例如,NoOfReplicas等于2设置在一个集群中有四个数据节点),您应该看到一个显著改善性能通过使用distribution-aware版本的这个方法。

仍然可以使用这种方法,不指定事务协调员。在这两种情况下,您必须显式地关闭交易,是否调用startTransaction ()是成功的。