ndb_mgm 管理用戶端程序實際上不是執行叢集所必需的。它的價值在於提供一組命令來檢查叢集的狀態、啟動備份以及執行其他管理功能。管理用戶端使用 C API 存取管理伺服器。進階使用者也可以使用此 API 來編寫專用的管理程序,以執行類似於 ndb_mgm 所執行的工作。
若要啟動管理用戶端,必須提供管理伺服器的 Hostname 和 Port Number
$> ndb_mgm [host_name [port_num]]
例如
$> ndb_mgm ndb_mgmd.mysql.com 1186
預設 Hostname 和 Port Number 分別是 localhost
和 1186。
以下表格顯示所有可與 ndb_mgm 搭配使用的選項。其他描述請見表格後方。
--backup-password-from-stdin[=TRUE|FALSE]
命令列格式 --backup-password-from-stdin
當使用
--execute "START BACKUP"
或類似命令來建立備份時,此選項可從系統 Shell (stdin
) 輸入備份密碼。使用此選項需要同時使用--execute
。-
命令列格式 --character-sets-dir=路徑
包含字元集的目錄。
-
命令列格式 --connect-retries=#
類型 數值 預設值 3
最小值 0
最大值 4294967295
此選項指定在放棄之前,於第一次嘗試後重試連線的次數 (用戶端至少會嘗試連線一次)。每次嘗試的等待時間長度會使用
--connect-retry-delay
來設定。此選項與
--try-reconnect
選項同義,但現在已棄用。 -
命令列格式 --connect-retry-delay=#
類型 整數 預設值 5
最小值 0
最大值 5
嘗試連線管理伺服器之間等待的秒數。
-
命令列格式 --connect-string=連線字串
類型 字串 預設值 [無]
與
--ndb-connectstring
相同。 -
命令列格式 --core-file
發生錯誤時寫入核心檔案;用於偵錯。
-
命令列格式 --defaults-extra-file=路徑
類型 字串 預設值 [無]
在讀取全域檔案後,讀取指定的檔案。
-
命令列格式 --defaults-file=路徑
類型 字串 預設值 [無]
僅從指定的檔案讀取預設選項。
-
命令列格式 --defaults-group-suffix=字串
類型 字串 預設值 [無]
也讀取 concat(群組, 字尾) 的群組。
-
命令列格式 --encrypt-backup
使用時,此選項會導致所有備份都被加密。若要在執行 ndb_mgm 時執行此操作,請將此選項放入
my.cnf
檔案的[ndb_mgm]
區段。 --execute=
、命令
-e
命令
命令列格式 --execute=命令
可以使用此選項從系統 Shell 將命令傳送至 NDB Cluster 管理用戶端。例如,下列任何一項都相當於在管理用戶端中執行
SHOW
$> ndb_mgm -e "SHOW" $> ndb_mgm --execute="SHOW"
這類似於
--execute
或-e
選項搭配 mysql 命令列用戶端的方式。請參閱第 6.2.2.1 節「在命令列上使用選項」。注意如果要使用此選項傳遞的管理用戶端命令包含任何空格字元,則該命令必須以引號括住。可以使用單引號或雙引號。如果管理用戶端命令不包含空格字元,則引號是選用的。
-
命令列格式 --help
顯示說明文字並結束。
-
命令列格式 --login-path=路徑
類型 字串 預設值 [無]
從登入檔讀取指定的路徑。
-
命令列格式 --no-login-paths
略過從登入路徑檔案讀取選項。
-
命令列格式 --ndb-connectstring=連線字串
類型 字串 預設值 [無]
設定連線字串,以連線到 ndb_mgmd。語法:[
nodeid=
][id
;host=
]
[hostname
:
]。覆寫port
NDB_CONNECTSTRING
和my.cnf
中的項目。 -
命令列格式 --ndb-nodeid=#
類型 整數 預設值 [無]
設定此節點的節點 ID,覆寫
--ndb-connectstring
所設定的任何 ID。 -
命令列格式 --ndb-mgm-tls=層級
類型 列舉 預設值 寬鬆
有效值 寬鬆
嚴格
設定連線至管理伺服器所需的 TLS 支援層級;
寬鬆
或嚴格
其中之一。寬鬆
(預設值) 表示會嘗試建立 TLS 連線,但成功並非必要;嚴格
表示必須使用 TLS 才能連線。 -
命令列格式 --ndb-mgmd-host=連線字串
類型 字串 預設值 [無]
與
--ndb-connectstring
相同。 --ndb-optimized-node-selection
命令列格式 --ndb-optimized-node-selection
啟用選擇交易節點的最佳化。預設為啟用;使用
--skip-ndb-optimized-node-selection
停用。-
命令列格式 --ndb-tls-search-path=清單
類型 路徑名稱 預設值 (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-defaults
不從登入檔以外的任何選項檔讀取預設選項。
-
命令列格式 --print-defaults
列印程式引數清單並結束。
-
命令列格式 --test-tls
使用 TLS 連線,然後結束。如果成功,輸出結果會類似於這裡顯示的內容
>$ ndb_mgm --test-tls Connected to Management Server at: sakila:1186 >$
如需更多資訊,請參閱 第 25.6.15 節「NDB Cluster 的 TLS 連結加密」。
-
命令列格式 --try-reconnect=#
已棄用 是 類型 數值 類型 整數 預設值 12
預設值 3
最小值 0
最大值 4294967295
如果與管理伺服器的連線中斷,節點會每 5 秒嘗試重新連線,直到成功為止。透過使用此選項,可以限制嘗試次數為
number
,之後放棄並回報錯誤。此選項已棄用,並會在未來的版本中移除。請改用
--connect-retries
。 -
命令列格式 --usage
顯示說明文字並結束;與
--help
相同。 -
命令列格式 --version
顯示版本資訊並結束。
關於使用 ndb_mgm 的其他資訊,請參閱 第 25.6.1 節「NDB Cluster 管理用戶端中的命令」。