文件首頁
MySQL 9.0 參考手冊
相關文件 下載本手冊
PDF (美式信紙) - 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_waiter — 等待 NDB Cluster 達到指定狀態

25.5.31 ndb_waiter — 等待 NDB Cluster 達到指定狀態

ndb_waiter 會重複 (每 100 毫秒) 列印出所有叢集資料節點的狀態,直到叢集達到指定狀態或超過 --timeout 限制,然後結束。依預設,它會等待叢集達到 STARTED 狀態,在此狀態下,所有節點都已啟動並連線到叢集。這可以使用 --no-contact--not-started 選項來覆寫。

此公用程式報告的節點狀態如下

  • NO_CONTACT:無法連線到節點。

  • UNKNOWN:可以連線到節點,但其狀態尚不清楚。通常,這表示節點已從管理伺服器收到 STARTRESTART 命令,但尚未執行此命令。

  • NOT_STARTED:節點已停止,但仍與叢集保持連線。當使用管理用戶端的 RESTART 命令重新啟動節點時,會看到此狀態。

  • STARTING:節點的 ndbd 程序已啟動,但節點尚未加入叢集。

  • STARTED:節點正在運作,且已加入叢集。

  • SHUTTING_DOWN:節點正在關閉。

  • SINGLE USER MODE:當叢集處於單一使用者模式時,所有叢集資料節點都會顯示此狀態。

下表顯示可用於 ndb_waiter 的選項。其他說明位於表格之後。

用法

ndb_waiter [-c connection_string]

其他選項

  • --character-sets-dir

    命令列格式 --character-sets-dir=path

    包含字元集的目錄。

  • --connect-retries

    命令列格式 --connect-retries=#
    類型 整數
    預設值 12
    最小值 0
    最大值 12

    放棄前重試連線的次數。

  • --connect-retry-delay

    命令列格式 --connect-retry-delay=#
    類型 整數
    預設值 5
    最小值 0
    最大值 5

    嘗試連線管理伺服器時要等待的秒數。

  • --connect-string

    命令列格式 --connect-string=connection_string
    類型 字串
    預設值 [無]

    --ndb-connectstring 相同。

  • --core-file

    命令列格式 --core-file

    發生錯誤時寫入核心檔案;用於偵錯。

  • --defaults-extra-file

    命令列格式 --defaults-extra-file=path
    類型 字串
    預設值 [無]

    在讀取全域檔案之後讀取指定的檔案。

  • --defaults-file

    命令列格式 --defaults-file=path
    類型 字串
    預設值 [無]

    僅從指定檔案讀取預設選項。

  • --defaults-group-suffix

    命令列格式 --defaults-group-suffix=string
    類型 字串
    預設值 [無]

    也讀取 concat(group, suffix) 的群組。

  • --login-path

    命令列格式 --login-path=path
    類型 字串
    預設值 [無]

    從登入檔案讀取指定的路徑。

  • --no-login-paths

    命令列格式 --no-login-paths

    略過從登入路徑檔案讀取選項。

  • --help

    命令列格式 --help

    顯示說明文字並結束。

  • --ndb-connectstring

    命令列格式 --ndb-connectstring=connection_string
    類型 字串
    預設值 [無]

    設定連線字串,以連線至 ndb_mgmd。語法:[nodeid=id;][host=]hostname[:port]。覆寫 NDB_CONNECTSTRINGmy.cnf 中的項目。

  • --ndb-mgm-tls

    命令列格式 --ndb-mgm-tls=level
    類型 列舉
    預設值 寬鬆
    有效值

    寬鬆

    嚴格

    設定連線至管理伺服器所需的 TLS 支援層級;為 寬鬆嚴格 其中之一。寬鬆 (預設值) 表示會嘗試 TLS 連線,但並非必要;嚴格 表示需要 TLS 才能連線。

  • --ndb-mgmd-host

    命令列格式 --ndb-mgmd-host=connection_string
    類型 字串
    預設值 [無]

    與 --ndb-connectstring 相同。

  • --ndb-nodeid

    命令列格式 --ndb-nodeid=#
    類型 整數
    預設值 [無]

    設定此節點的節點 ID,覆寫 --ndb-connectstring 所設定的任何 ID。

  • --ndb-optimized-node-selection

    命令列格式 --ndb-optimized-node-selection

    啟用交易節點選取的最佳化。依預設啟用;使用 --skip-ndb-optimized-node-selection 來停用。

  • --ndb-tls-search-path

    命令列格式 --ndb-tls-search-path=list
    類型 路徑名稱
    預設值 (Unix) $HOME/ndb-tls
    預設值 (Windows) $HOMEDIR/ndb-tls

    指定要搜尋 CA 檔案的目錄清單。在 Unix 平台上,目錄名稱以冒號 (:) 分隔;在 Windows 系統上,分號字元 (;) 用作分隔符號。目錄參考可以是相對或絕對的;它可以包含一個或多個環境變數,每個環境變數都以字首錢幣符號 ($) 表示,並在使用前展開。

    搜尋會從最左側的具名目錄開始,並從左到右進行,直到找到檔案為止。空字串表示空的搜尋路徑,這會導致所有搜尋失敗。由單一點號 (.) 組成的字串表示搜尋路徑限制為目前的工作目錄。

    如果未提供搜尋路徑,則會使用編譯時的預設值。此值取決於使用的平台:在 Windows 上,這是 \ndb-tls;在其他平台 (包括 Linux) 上,這是 $HOME/ndb-tls。這可以使用 -DWITH_NDB_TLS_SEARCH_PATH 來編譯 NDB Cluster 來覆寫。

  • --no-contact-n

    不等待 STARTED 狀態,ndb_waiter 會持續執行,直到叢集達到 NO_CONTACT 狀態才會結束。

  • --no-defaults

    命令列格式 --no-defaults

    不要從任何選項檔案讀取預設選項,登入檔案除外。

  • --not-started

    此選項不會等待 STARTED 狀態,而是讓 ndb_waiter 持續執行,直到叢集達到 NOT_STARTED 狀態才結束。

  • --nowait-nodes=list

    使用此選項時,ndb_waiter 不會等待所列出的節點 ID。列表以逗號分隔;範圍可以用破折號表示,如下所示:

    $> ndb_waiter --nowait-nodes=1,3,7-9
    重要

    不要將此選項與 --wait-nodes 選項一起使用。

  • --print-defaults

    命令列格式 --print-defaults

    列印程式引數列表並結束。

  • --timeout=seconds, -t seconds

    等待時間。如果在指定秒數內未達到所需狀態,程式將會結束。預設值為 120 秒 (1200 次回報週期)。

  • --single-user

    程式將等待叢集進入單一使用者模式。

  • --usage

    命令列格式 --usage

    顯示說明文字並結束;與 --help 相同。

  • --verbose

    命令列格式 --verbose=#
    類型 整數
    預設值 2
    最小值 0
    最大值 2

    控制列印的詳細程度。可能的層級及其影響如下所示:

    • 0:不列印 (僅返回結束代碼;請參閱後續的結束代碼)。

    • 1:僅列印最終連線狀態。

    • 2:每次檢查時都列印狀態。

      這與 NDB Cluster 8.4 之前的版本行為相同。

    ndb_waiter 返回的結束代碼及其含義如下:

    • 0:成功。

    • 1:等待逾時。

    • 2:參數錯誤,例如無效的節點 ID。

    • 3:無法連線到管理伺服器。

  • --version

    命令列格式 --version

    顯示版本資訊並結束。

  • --wait-nodes=list, -w list

    使用此選項時,ndb_waiter 只會等待所列出的節點 ID。列表以逗號分隔;範圍可以用破折號表示,如下所示:

    $> ndb_waiter --wait-nodes=2,4-6,10
    重要

    不要將此選項與 --nowait-nodes 選項一起使用。

範例輸出。 此處顯示的是針對 4 節點叢集執行 ndb_waiter 的輸出,其中兩個節點已關閉,然後再次手動啟動。重複的報告(以 ... 表示)已省略。

$> ./ndb_waiter -c localhost

Connecting to mgmsrv at (localhost)
State node 1 STARTED
State node 2 NO_CONTACT
State node 3 STARTED
State node 4 NO_CONTACT
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 UNKNOWN
State node 3 STARTED
State node 4 NO_CONTACT
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTING
State node 3 STARTED
State node 4 NO_CONTACT
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTING
State node 3 STARTED
State node 4 UNKNOWN
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTING
State node 3 STARTED
State node 4 STARTING
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTED
State node 3 STARTED
State node 4 STARTING
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTED
State node 3 STARTED
State node 4 STARTED
Waiting for cluster enter state STARTED
注意

如果未指定連線字串,則 ndb_waiter 會嘗試連線到 localhost 上的管理伺服器,並回報 Connecting to mgmsrv at (null)