没有任何

没有任何

NDB 应用程序应该从创建单个Ndb_cluster_connection对象开始，并且通常使用单个 Ndb_cluster_connection. 当 connect() 调用此对象的方法时，应用程序连接到集群管理服务器。通过使用该 wait_until_ready() 方法，可以等待连接到达一个或多个数据节点。

的实例Ndb_cluster_connection用于创建Ndb 对象。在 NDB 7.3.8 之前，可以删除 Ndb_cluster_connection用于创建给定实例的，Ndb而无需先删除依赖Ndb对象。（漏洞#19999242）

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

此方法创建到 NDB Cluster 的连接，即到数据节点的集群。此方法返回的对象是实例化 Ndb对象所必需的。因此，每个 NDB API 应用程序都需要使用 Ndb_cluster_connection.

Ndb_cluster_connection有两个构造函数。其中第一个显示在这里：

Ndb_cluster_connection
    (
      const char* connection_string = 0
    )

除了连接字符串参数之外，第二个构造函数还采用节点 ID。它的签名和参数显示在这里：

Ndb_cluster_connection
    (
      const char* connection_string,
      int force_api_nodeid
    )

构造函数的第一个版本需要一个 connection_string参数，指向管理服务器的位置。

构造函数的第二个版本采用两个参数，a 和此 API 节点要使用connection_string的节点 ID ( )。force_api_nodeid此节点 ID 覆盖connection_string 参数中设置的任何节点 ID 值。

的实例Ndb_cluster_connection。

此方法连接到集群管理服务器。

int connect
    (
      int retries = 30,
      int delay   = 1,
      int verbose = 0
    )

此方法采用三个参数，所有参数都是可选的：

此方法返回一个int，它可以具有以下 3 个值之一：

此方法检索给定 的当前 AutoReconnect设置 Ndb_cluster_connection。有关更多详细信息，请参阅 Ndb_cluster_connection::set_auto_reconnect()。

int get_auto_reconnect
    (
      void
    )

没有。

整数值0或 1，对应 AutoReconnect于对此连接有效的当前设置。0 强制 API 节点使用到集群的新连接，同时1允许 API 节点重用现有连接。

此方法可用于确定 this 最近的 connect() 尝试 是否Ndb_cluster_connection 成功。如果连接成功， get_latest_error()返回 0；否则，它返回 1。如果连接尝试失败，则使用 Ndb_cluster_connection::get_latest_error_msg() 获取给出失败原因的错误消息。

int get_latest_error
    (
      void
    ) const

没有。

1或0。返回值1表示最近一次连接尝试失败；如果尝试成功， 0则返回 a。

如果此方法最近的连接尝试 Ndb_cluster_connection 失败（由调用 确定 get_latest_error()），此方法会提供一条错误消息，提供有关失败原因的信息。

const char* get_latest_error_msg
    (
      void
    ) const

没有。

包含描述失败的错误消息的字符串 Ndb_cluster_connection::connect()。如果最近的连接尝试成功，则返回一个空字符串。

获取在自适应发送机制强制发送所有未决信号之前允许流逝的最短时间（以毫秒为单位）。

Uint32 get_max_adaptive_send_time
    (

    )

没有。

以毫秒数表示的等待时间。这应该始终是 0 到 10 之间的值，包括 0 和 10。

此方法用于迭代一组 Ndb对象，一次检索一个对象。

const Ndb* get_next_ndb_object
    (
      const Ndb* p
    )

此方法采用单个参数，一个指向要 Ndb检索的最后一个对象的指针或NULL.

返回下一个Ndb 对象，或者NULL如果没有更多 Ndb对象可用。

获取接收线程的数量。

int get_num_recv_threads
    (
      void
    ) const

没有。

接收器线程的数量。

获取用于激活由 绑定的接收器线程的级别集 set_recv_thread_cpu()。

int get_recv_thread_activation_threshold
    (
      void
    ) const

没有。

整数阈值。有关解释此值的信息， 请参阅 Ndb_cluster_connection::set_recv_thread_activation_threshold() 。

从集群配置中获取系统名称。这是 Name集群 config.ini配置文件中设置的系统配置参数的值。

const char* get_system_name
    (
      void
    ) const

没有。

集群系统名称。如果未在集群配置文件中设置，则这是一个 以管理服务器启动时间 为形式 （例如， ）生成的值。MC_timestampMC_20170426182343

调用此方法可防止创建Ndb该类的新实例。必须在使用 迭代多个 Ndb对象 之前调用此方法get_next_ndb_object()。

void lock_ndb_objects
    (
      void
    ) const

此方法const从 NDB 7.3.15 和 7.4.13（缺陷 #23709232）开始。

有关详细信息，请参阅 Ndb_cluster_connection::get_next_ndb_object()。

没有。

没有。

与集群断开连接的 API 节点将被迫使用新的连接对象重新连接，除非通过AutoReconnect = 1在config.ini文件中设置或使用 1 作为输入值调用此方法来覆盖此行为。AutoReconnect 调用值为 0 的方法与将配置参数（也在那些 NDB Cluster 版本中引入）设置为 0 具有相同的效果；也就是说，API 节点被迫创建新的连接。

void set_auto_reconnect
    (
      int value
    )

0 或 1的 A value，它确定 API 节点重新连接行为。0 强制 API 节点使用新连接（Ndb_cluster_connection 对象）；1 允许 API 节点重新使用现有的集群连接。

没有。

设置连接的数据节点邻居，用于事务协调器的最佳放置。此方法在创建 之后 Ndb_cluster_connection但在启动任何查询线程之前使用。这是因为此方法可能会更改 Ndb_cluster_connection使用它的线程共享的内部状态。这种状态不是线程安全的；更改它会导致在更改时选择非最佳节点。

您可以使用 ndb_data_node_neighbour 服务器系统变量为 NDB Cluster SQL 节点设置数据节点邻居。

NDB 7.5 中添加了此方法。

void set_data_node_neighbour
    (
      Uint32 neighbour_node
    )

要用作邻居的节点的 ID。

没有。

设置在自适应发送机制强制发送所有未决信号之前允许流逝的最短时间（以毫秒为单位）。

void set_max_adaptive_send_time
    (
      Uint32 milliseconds
    )

等待时间（以毫秒为单位）。范围是 0-10，默认值为 10。

没有。

设置连接的名称。如果指定了名称，则会在集群日志中报告。

void set_name
    (
      const char* name
    )

name用作连接的标识符 。

没有。

设置绑定到 CPU（或多个 CPU）的接收器线程数，该 CPU set_recv_thread_cpu() 由 和 设置的阈值确定 set_recv_thread_activation_threshold()。

应在尝试连接到任何其他节点之前调用此方法。

int set_num_recv_threads
    (
      Uint32 num_recv_threads
    )

接收线程的数量。唯一支持的值是 1.

-1表示错误；任何其他值都表示成功。

此方法可用于覆盖该 connect()方法关于应首先连接到哪个节点的默认行为。

void set_optimized_node_selection
    (
      int value
    )

一个整数value。

没有。

设置激活由 绑定的接收线程的级别 set_recv_thread_cpu()。在这个级别以下，普通用户线程用于接收信号。

int set_recv_thread_activation_threshold
    (
      Uint32 threshold
    )

一个整threshold数值。16 或更高意味着接收线程从不用作接收器。0 表示接收线程始终处于活动状态，并保留轮询权供其独占使用，从而有效地阻止所有用户线程成为接收者。在这种情况下，应注意确保接收线程不会与用户线程竞争 CPU 资源；最好将其锁定到一个 CPU 以供其独占使用。默认值为 8。

-1表示错误；任何其他值都表示成功。

从 NDB 7.5.7 开始，此方法可用于创建一个 URI，用于在表service_URI 中应用程序行的列中 发布ndbinfo.processes。

如果在调用之前调用此方法 connect()，则服务 URI 会在连接后立即发布；否则，它会在最多延迟 HeartbeatIntervalDbApi 几毫秒后发布。

int set_service_uri
    (
      const char* scheme,
      const char* host,
      int port,
      const char* path
    )

此方法采用此处列出的参数：

0 表示成功，1 表示语法错误。

设置接收器线程应绑定到的 CPU 或 CPU。通过调用 设置激活接收器线程作为接收器的级别 set_recv_thread_activation_threshold()。通过调用取消设置此接收器线程的绑定 unset_recv_thread_cpu()。

int set_recv_thread_cpu
    (
      Uint16* cpuid_array,
      Uint32 array_len,
      Uint32 recv_thread_id = 0
    )

此方法采用三个参数，列于此处：

-1表示错误；任何其他值都表示成功。

用于设置连接超时，以限制我们在连接时可能阻塞的时间量。

该方法实际上是 MGM API 函数的包装器 ndb_mgm_set_timeout()。

int set_timeout
    (
      int timeout_ms
    )

超时的长度，以毫秒 ( timeout_ms) 为单位。目前，只接受 1000 的倍数。

0 成功；任何其他值表示失败。

此方法撤消该方法的效果 lock_ndb_objects() ，从而可以创建 的新实例 Ndb。 unlock_ndb_objects() 应在 Ndb使用该方法完成检索对象 后调用get_next_ndb_object() 。

void unlock_ndb_objects
    (
      void
    ) const

此方法const从 NDB 7.3.15 和 7.4.13（缺陷 #23709232）开始。

有关详细信息，请参阅 Ndb_cluster_connection::get_next_ndb_object()。

没有。

没有。

使用 取消设置接收器线程绑定到的一个或多个 CPU set_recv_thread_cpu()。

int unset_recv_thread_cpu
    (
      Uint32 recv_thread_id
    )

要解除绑定的接收方线程的线程 ID。

-1表示错误；任何其他值都表示成功。

需要此方法来建立与数据节点的连接。它一直等到与一个或多个数据节点的请求连接成功，或者直到满足超时条件。

int wait_until_ready
    (
      int timeoutBefore,
      int timeoutAfter
    )

这个方法有两个参数：

wait_until_ready()返回一个 int，其值解释如下：