文件首頁
MySQL 9.0 參考手冊
相關文件 下載本手冊
PDF (US Ltr) - 40.0Mb
PDF (A4) - 40.1Mb
Man Pages (TGZ) - 258.2Kb
Man Pages (Zip) - 365.3Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 9.0 參考手冊  /  ...  /  定義NDB叢集管理伺服器

25.4.3.5 定義NDB叢集管理伺服器

[ndb_mgmd]區段用於配置管理伺服器的行為。如果使用多個管理伺服器,您可以在[ndb_mgmd default]區段中指定所有伺服器通用的參數。[mgm][mgm default]是這些的舊別名,支援向後相容性。

以下清單中的所有參數都是選用的,如果省略則採用其預設值。

注意

如果既沒有ExecuteOnComputer參數也沒有HostName參數,則預設值localhost將同時用於這兩者。

  • Id

    版本 (或更新版本) NDB
    類型或單位 無號
    預設 [...]
    範圍 1 - 255
    重新啟動類型

    初始系統重新啟動:需要完全關閉叢集、清除並從備份還原叢集檔案系統,然後重新啟動叢集。

    叢集中的每個節點都有唯一的識別碼。對於管理節點,這由範圍為1到255(含)的整數值表示。此ID由所有內部叢集訊息用於尋址節點,因此對於每個NDB叢集節點都必須是唯一的,無論節點的類型如何。

    注意

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

    使用Id參數來識別管理節點的做法已被棄用,取而代之的是NodeId。儘管為了向後相容性繼續支援Id,但現在它會產生警告,並且可能會在未來的NDB叢集版本中移除。

  • NodeId

    版本 (或更新版本) NDB
    類型或單位 無號
    預設 [...]
    範圍 1 - 255
    重新啟動類型

    初始系統重新啟動:需要完全關閉叢集、清除並從備份還原叢集檔案系統,然後重新啟動叢集。

    叢集中的每個節點都有唯一的識別碼。對於管理節點,這由範圍為1到255(含)的整數值表示。此ID由所有內部叢集訊息用於尋址節點,因此對於每個NDB叢集節點都必須是唯一的,無論節點的類型如何。

    注意

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

    NodeId是識別管理節點時的首選參數名稱。儘管較舊的Id為了向後相容性繼續受到支援,但現在已棄用,並且在使用時會產生警告;它也可能會在未來的NDB叢集版本中移除。

  • ExecuteOnComputer

    版本 (或更新版本) NDB
    類型或單位 名稱
    預設 [...]
    範圍 ...
    已棄用 是 (在 NDB 7.5 中)
    重新啟動類型

    系統重新啟動:需要完全關閉並重新啟動叢集。

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

    重要

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

  • PortNumber

    版本 (或更新版本) NDB
    類型或單位 無號
    預設 1186
    範圍 0 - 64K
    重新啟動類型

    系統重新啟動:需要完全關閉並重新啟動叢集。

    這是管理伺服器監聽配置請求和管理命令的埠號。

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

  • HostName

    版本 (或更新版本) NDB
    類型或單位 名稱或IP位址
    預設 [...]
    範圍 ...
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

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

  • LocationDomainId

    版本 (或更新版本) NDB
    類型或單位 整數
    預設 0
    範圍 0 - 16
    重新啟動類型

    系統重新啟動:需要完全關閉並重新啟動叢集。

    將管理節點指派到雲端內特定的可用性網域(也稱為可用性區域)。藉由告知NDB哪些節點位於哪個可用性網域中,可以在雲端環境中透過以下方式來提高效能

    • 如果要求資料在同一個節點上找不到,則讀取可以導向到同一個可用性網域中的另一個節點。

    • 不同可用性網域中節點之間的通訊保證會使用NDB傳輸器的WAN支援,而無需任何進一步的人工干預。

    • 傳輸器的群組號碼可以根據使用的可用性網域而定,以便SQL和其他API節點也可以盡可能與同一個可用性網域中的本機資料節點通訊。

    • 可以從沒有資料節點的可用性網域中選擇仲裁者,或者如果找不到此類可用性網域,則從第三個可用性網域中選擇。

    LocationDomainId接受介於0到16(含)之間的整數值,其中0為預設值;使用0與未設定參數相同。

  • LogDestination

    版本 (或更新版本) NDB
    類型或單位 {CONSOLE|SYSLOG|FILE}
    預設 FILE:filename=ndb_nodeid_cluster.log,maxsize=1000000,maxfiles=6
    範圍 ...
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

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

    • CONSOLE將記錄輸出到stdout

      CONSOLE
    • SYSLOG將記錄傳送到syslog設施,可能的值是authauthprivcrondaemonftpkernlprmailnewssysloguseruucplocal0local1local2local3local4local5local6local7其中之一。

      注意

      並非每個作業系統都一定支援所有設施。

      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
    類型或單位 0-2
    預設 1
    範圍 0 - 2
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

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

    • 0:節點永遠不會用作仲裁者。

    • 1:節點具有高優先權;也就是說,它比低優先權節點更適合作為仲裁者。

    • 2:表示低優先權節點,僅當沒有更高優先權的節點可用於該用途時,才會用作仲裁者。

    通常,應將管理伺服器配置為仲裁者,方法是將其ArbitrationRank設定為1(管理節點的預設值),而所有SQL節點的ArbitrationRank設定為0(SQL節點的預設值)。

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

  • ArbitrationDelay

    版本 (或更新版本) NDB
    類型或單位 毫秒
    預設 0
    範圍 0 - 4294967039 (0xFFFFFEFF)
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

    此整數值會導致管理伺服器延遲該毫秒數來回應仲裁請求。預設情況下,此值為 0;通常不需要變更它。

  • DataDir

    版本 (或更新版本) NDB
    類型或單位 路徑
    預設 .
    範圍 ...
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

    這指定放置管理伺服器輸出檔案的目錄。這些檔案包含叢集記錄檔、程序輸出檔案和精靈的程序 ID (PID) 檔案。(對於記錄檔,此位置可以透過設定 LogDestinationFILE 參數來覆寫,如本節先前所討論的。)

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

  • PortNumberStats

    版本 (或更新版本) NDB
    類型或單位 無號
    預設 [...]
    範圍 0 - 64K
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

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

  • Wan

    版本 (或更新版本) NDB
    類型或單位 布林值
    預設 false
    範圍 true, false
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

    將 WAN TCP 設定設為預設值。

  • HeartbeatThreadPriority

    版本 (或更新版本) NDB
    類型或單位 字串
    預設 [...]
    範圍 ...
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

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

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

    HeartbeatThreadPriority = policy[, priority]
    
    policy:
      {FIFO | RR}

    設定此參數時,您必須指定原則。這是 FIFO(先進先出)或 RR(循環配置)之一。原則值後面可以選擇性地加上優先順序(整數)。

  • ExtraSendBufferMemory

    版本 (或更新版本) NDB
    類型或單位 位元組
    預設 0
    範圍 0 - 32G
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

    此參數指定除了使用 TotalSendBufferMemorySendBufferMemory 或兩者設定的任何傳輸程式傳送緩衝區記憶體量之外,還要配置的額外記憶體量。

  • RequireTls

    版本 (或更新版本) NDB
    類型或單位 布林值
    預設 false
    範圍 ...
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

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

  • TotalSendBufferMemory

    版本 (或更新版本) NDB
    類型或單位 位元組
    預設 0
    範圍 256K - 4294967039 (0xFFFFFEFF)
    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

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

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

  • HeartbeatIntervalMgmdMgmd

    重新啟動類型

    節點重新啟動:需要對叢集進行滾動重新啟動

    指定用於判斷另一個管理節點是否與此節點連線的心跳訊息間隔。管理節點在 3 個間隔後等待宣告連線已中斷;因此,預設設定為 1500 毫秒會導致管理節點等待約 1600 毫秒後逾時。

注意

在管理節點的組態中進行變更後,必須執行叢集的滾動重新啟動,才能使新組態生效。

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

重新啟動類型。 本節中的參數說明所使用的重新啟動類型相關資訊如下表所示

表 25.8 NDB 叢集重新啟動類型

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