MySQL :: MySQL 8.4 參考手冊 :: 25.4.3.5 定義 NDB Cluster 管理伺服器

版本 8.4

8.0 日文

MySQL 8.4 參考手冊 / ... / 定義 NDB Cluster 管理伺服器

25.4.3.5 定義 NDB Cluster 管理伺服器

[ndb_mgmd] 區段用於設定管理伺服器的行為。如果使用多個管理伺服器，您可以在 [ndb_mgmd default] 區段中指定所有伺服器通用的參數。[mgm] 和 [mgm default] 是較舊的別名，為了回溯相容性而支援。

以下列表中的所有參數都是選用的，如果省略則會採用預設值。

注意

如果 ExecuteOnComputer 和 HostName 參數皆不存在，則兩者都會採用預設值 localhost。

Id

版本（或更新版本）	NDB 8.4.0
類型或單位	無號數
預設	[...]
範圍	1 - 255
重新啟動類型	初始系統重新啟動：需要完全關閉叢集，從備份中清除並還原叢集檔案系統，然後重新啟動叢集。(NDB 8.4.0)

叢集中的每個節點都有一個唯一的識別碼。對於管理節點，這以介於 1 到 255 (含) 之間的整數值表示。所有內部叢集訊息都使用此 ID 來定址節點，因此對於每個 NDB Cluster 節點來說，無論節點類型為何，都必須是唯一的。

注意

資料節點 ID 必須小於 145。如果您計劃部署大量的資料節點，最好將管理節點（和 API 節點）的節點 ID 限制為大於 144 的值。

使用 Id 參數來識別管理節點的做法已被棄用，建議改用 NodeId。雖然為了回溯相容性而繼續支援 Id，但現在會產生警告，並且在未來版本的 NDB Cluster 中可能會移除。

NodeId

版本（或更新版本）	NDB 8.4.0
類型或單位	無號數
預設	[...]
範圍	1 - 255
重新啟動類型	初始系統重新啟動：需要完全關閉叢集，從備份中清除並還原叢集檔案系統，然後重新啟動叢集。(NDB 8.4.0)

注意

資料節點 ID 必須小於 145。如果您計劃部署大量的資料節點，最好將管理節點（和 API 節點）的節點 ID 限制為大於 144 的值。

NodeId 是識別管理節點時建議使用的參數名稱。雖然為了回溯相容性而繼續支援較舊的 Id，但現在已不建議使用，而且使用時會產生警告；它也可能會在未來 NDB Cluster 版本中移除。

ExecuteOnComputer

版本（或更新版本）	NDB 8.4.0
類型或單位	名稱
預設	[...]
範圍	...
已棄用	是（在 NDB 7.5 中）
重新啟動類型	系統重新啟動：需要完全關閉並重新啟動叢集。(NDB 8.4.0)

這指的是在 config.ini 檔案的 [computer] 區段中為其中一台電腦設定的 Id。

重要

此參數已棄用，並可能在未來版本中移除。請改用 HostName 參數。

PortNumber

版本（或更新版本）	NDB 8.4.0
類型或單位	無號數
預設	1186
範圍	0 - 64K
重新啟動類型	系統重新啟動：需要完全關閉並重新啟動叢集。(NDB 8.4.0)

這是管理伺服器接聽設定要求和管理命令的連接埠號碼。

此節點的節點 ID 只能發給明確要求它的連線。要求「任何」節點 ID 的管理伺服器無法使用此 ID。在同一主機上執行多個管理伺服器時，可以使用此參數，且 HostName 不足以區分不同處理程序。適用於測試用途。

HostName

版本（或更新版本）	NDB 8.4.0
類型或單位	名稱或 IP 位址
預設	[...]
範圍	...
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

指定此參數可定義管理節點所在的電腦主機名稱。使用 HostName 可指定 localhost 以外的主機名稱。

LocationDomainId

版本（或更新版本）	NDB 8.4.0
類型或單位	整數
預設	0
範圍	0 - 16
重新啟動類型	系統重新啟動：需要完全關閉並重新啟動叢集。(NDB 8.4.0)

將管理節點指派給雲端中特定的可用性網域（也稱為可用性區域）。透過告知 NDB 哪些節點位於哪些可用性網域中，可以在雲端環境中透過以下方式改善效能

如果要求的資料在同一節點上找不到，讀取可以導向至同一可用性網域中的另一個節點。
不同可用性網域中節點之間的通訊保證會使用 NDB 傳輸器的 WAN 支援，而無需任何進一步的人工干預。
傳輸器的群組號碼可以根據使用的可用性網域來決定，以便 SQL 和其他 API 節點也能盡可能與同一可用性網域中的本機資料節點通訊。
仲裁者可以從沒有資料節點的可用性網域中選取，如果找不到此類可用性網域，則從第三個可用性網域中選取。

LocationDomainId 接受 0 到 16 (含) 之間的整數值，其中 0 為預設值；使用 0 與不設定參數的效果相同。

LogDestination

版本（或更新版本）	NDB 8.4.0
類型或單位	{CONSOLE\|SYSLOG\|FILE}
預設	FILE: filename=ndb_nodeid_cluster.log, maxsize=1000000, maxfiles=6
範圍	...
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

此參數指定將叢集記錄資訊傳送到何處。這方面有三個選項—CONSOLE、SYSLOG 和 FILE，其中 FILE 為預設值

CONSOLE 會將記錄輸出至 stdout
```
CONSOLE
```
SYSLOG 會將記錄傳送到 syslog 設施，可能的值為 auth、authpriv、cron、daemon、ftp、kern、lpr、mail、news、syslog、user、uucp、local0、local1、local2、local3、local4、local5、local6 或 local7 的其中一個。

注意

並非每個作業系統都一定支援所有設施。
```
SYSLOG:facility=syslog
```
FILE 會將叢集記錄輸出導向至同一部機器上的常規檔案。可以指定以下值
- filename：記錄檔的名稱。
  在此類情況下使用的預設記錄檔名稱為 ndb_nodeid_cluster.log。
- maxsize：檔案在記錄捲動到新檔案之前可以成長的最大大小（以位元組為單位）。發生這種情況時，舊的記錄檔會透過將 .N 附加到檔案名稱來重新命名，其中 N 是此名稱尚未使用的下一個數字。
- maxfiles：記錄檔的最大數量。
```
FILE:filename=cluster.log,maxsize=1000000,maxfiles=6
```
FILE 參數的預設值為 FILE:filename=ndb_node_id_cluster.log,maxsize=1000000,maxfiles=6，其中 node_id 是節點的 ID。

可以指定以分號分隔的多個記錄目的地，如下所示

CONSOLE;SYSLOG:facility=local0;FILE:filename=/var/log/mgmd

ArbitrationRank

版本（或更新版本）	NDB 8.4.0
類型或單位	0-2
預設	1
範圍	0 - 2
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

此參數用於定義哪些節點可以作為仲裁者。只有管理節點和 SQL 節點可以作為仲裁者。ArbitrationRank 可以採用下列其中一個值

0：節點永遠不會用作仲裁者。
1：節點具有高優先順序；也就是說，它比低優先順序節點更適合作為仲裁者。
2：表示低優先順序節點，只有在沒有更高優先順序的節點可用於此目的時才會用作仲裁者。

通常，管理伺服器應設定為仲裁者，方法是將其 ArbitrationRank 設定為 1（管理節點的預設值），並將所有 SQL 節點的 ArbitrationRank 設定為 0（SQL 節點的預設值）。

您可以完全停用仲裁，方法是在所有管理和 SQL 節點上將 ArbitrationRank 設定為 0，或是在 config.ini 全域設定檔的 [ndbd default] 區段中設定 Arbitration 參數。設定 Arbitration 會導致忽略 ArbitrationRank 的任何設定。

ArbitrationDelay

版本（或更新版本）	NDB 8.4.0
類型或單位	毫秒
預設	0
範圍	0 - 4294967039 (0xFFFFFEFF)
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

整數值，會導致管理伺服器對仲裁要求的回應延遲指定的毫秒數。預設情況下，此值為 0；通常不需要變更它。

DataDir

版本（或更新版本）	NDB 8.4.0
類型或單位	路徑
預設	.
範圍	...
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

這會指定放置管理伺服器輸出檔案的目錄。這些檔案包括叢集記錄檔、處理程序輸出檔案和守護程式的處理程序 ID (PID) 檔案。（對於記錄檔，此位置可以透過設定 LogDestination 的 FILE 參數來覆寫，如本節先前所述。）

此參數的預設值是 ndb_mgmd 所在的目錄。

PortNumberStats

版本（或更新版本）	NDB 8.4.0
類型或單位	無號數
預設	[...]
範圍	0 - 64K
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

此參數指定用於從 NDB Cluster 管理伺服器取得統計資訊的連接埠號碼。它沒有預設值。

Wan

版本（或更新版本）	NDB 8.4.0
類型或單位	布林值
預設	false
範圍	true, false
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

使用 WAN TCP 設定作為預設值。

HeartbeatThreadPriority

版本（或更新版本）	NDB 8.4.0
類型或單位	字串 (string)
預設	[...]
範圍	...
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

設定管理節點和 API 節點的心跳執行緒排程策略和優先順序。

設定此參數的語法如下所示

HeartbeatThreadPriority = policy[, priority]

policy:
  {FIFO | RR}

設定此參數時，您必須指定一個策略。策略可以是 FIFO (先進先出) 或 RR (循環配置)。策略值之後可選擇性加上優先順序 (整數)。

ExtraSendBufferMemory

版本（或更新版本）	NDB 8.4.0
類型或單位	位元組 (bytes)
預設	0
範圍	0 - 32G
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

此參數指定額外配置的傳輸器傳送緩衝區記憶體大小，除了使用 TotalSendBufferMemory、 SendBufferMemory 或兩者設定的記憶體之外。

RequireTls

版本（或更新版本）	NDB 8.4.0
類型或單位	布林值
預設	false
範圍	...
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

如果此參數設定為 true，則用戶端一旦連線到此管理節點，必須先使用 TLS 進行驗證，才能將連線用於其他任何用途。

TotalSendBufferMemory

版本（或更新版本）	NDB 8.4.0
類型或單位	位元組 (bytes)
預設	0
範圍	256K - 4294967039 (0xFFFFFEFF)
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

此參數用於決定在此節點上為所有已設定的傳輸器配置的共用傳送緩衝區記憶體總量。

如果設定此參數，其允許的最小值為 256KB；0 表示未設定此參數。如需更多詳細資訊，請參閱第 25.4.3.14 節，「設定 NDB 叢集傳送緩衝區參數」。

HeartbeatIntervalMgmdMgmd

版本（或更新版本）	NDB 8.4.0
類型或單位	毫秒
預設	1500
範圍	100 - 4294967039 (0xFFFFFEFF)
重新啟動類型	節點重新啟動：需要對叢集執行滾動式重新啟動。(NDB 8.4.0)

指定心跳訊息之間的時間間隔，用於判斷另一個管理節點是否與此節點保持連線。管理節點會在 3 個此間隔後等待，以宣告連線已失效；因此，預設設定的 1500 毫秒會使管理節點等待約 1600 毫秒才逾時。

注意

在變更管理節點的設定後，必須執行叢集的滾動重新啟動，新的設定才會生效。

若要將新的管理伺服器新增至執行中的 NDB 叢集，在修改任何現有的 config.ini 檔案之後，也必須執行所有叢集節點的滾動重新啟動。如需有關使用多個管理節點時出現的問題的詳細資訊，請參閱第 25.2.7.10 節，「與多個 NDB 叢集節點相關的限制」。

重新啟動類型. 本節參數描述中使用的重新啟動類型相關資訊如下表所示

表 25.8 NDB 叢集重新啟動類型

符號	重新啟動類型	描述
N	節點 (Node)	可以使用滾動重新啟動來更新參數 (請參閱第 25.6.5 節，「執行 NDB 叢集的滾動重新啟動」)
S	系統 (System)	必須完全關閉所有叢集節點，然後重新啟動，才能生效此參數的變更
I	初始 (Initial)	必須使用 `--initial` 選項重新啟動資料節點