文件首頁
MySQL 8.4 參考手冊
相關文件 下載本手冊
PDF (US Ltr) - 39.9Mb
PDF (A4) - 40.0Mb
Man Pages (TGZ) - 258.5Kb
Man Pages (Zip) - 365.5Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 參考手冊  /  ...  /  ndb_mgm — NDB叢集管理客戶端

25.5.5 ndb_mgm — NDB叢集管理客戶端

ndb_mgm 管理用戶端程序實際上並非執行叢集所必需。它的價值在於提供一組用於檢查叢集狀態、啟動備份,以及執行其他管理功能的命令。管理用戶端使用 C API 來存取管理伺服器。進階使用者也可以使用此 API 來編寫專用管理程序,以執行與 ndb_mgm 執行的任務類似的任務。

若要啟動管理用戶端,必須提供管理伺服器的主機名稱和連接埠號碼

$> ndb_mgm [host_name [port_num]]

例如

$> ndb_mgm ndb_mgmd.mysql.com 1186

預設的主機名稱和連接埠號碼分別為 localhost 和 1186。

下列表格顯示所有可與 ndb_mgm 搭配使用的選項。表格後面會提供其他說明。

  • --backup-password-from-stdin[=TRUE|FALSE]

    命令列格式 --backup-password-from-stdin

    此選項啟用在搭配使用 --execute "START BACKUP" 或類似命令建立備份時,從系統 Shell (stdin) 輸入備份密碼。使用此選項也必須同時使用 --execute

  • --character-sets-dir

    命令列格式 --character-sets-dir=路徑

    包含字元集的目錄。

  • --connect-retries=#

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

    此選項指定在第一次嘗試之後,放棄之前重試連線的次數 (用戶端一律至少嘗試連線一次)。每次嘗試的等待時間長度,是使用 --connect-retry-delay 來設定。

    此選項與現已過時的 --try-reconnect 選項同義。

  • --connect-retry-delay

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

    嘗試連絡管理伺服器之間要等待的秒數。

  • --connect-string

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

    --ndb-connectstring 相同。

  • --core-file

    命令列格式 --core-file

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

  • --defaults-extra-file

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

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

  • --defaults-file

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

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

  • --defaults-group-suffix

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

    也讀取 concat(群組, 尾碼) 的群組。

  • --encrypt-backup

    命令列格式 --encrypt-backup

    使用時,此選項會導致所有備份都經過加密。若要讓此動作在每次執行 ndb_mgm 時都發生,請將此選項放在 my.cnf 檔案的 [ndb_mgm] 區段中。

  • --execute=命令-e 命令

    命令列格式 --execute=命令

    此選項可用於從系統 Shell 將命令傳送至 NDB 叢集管理用戶端。例如,下列任何一個都相當於在管理用戶端中執行 SHOW

    $> ndb_mgm -e "SHOW"
    
    $> ndb_mgm --execute="SHOW"

    這與 --execute-e 選項在 mysql 命令列用戶端中的運作方式類似。請參閱 第 6.2.2.1 節,「在命令列上使用選項」

    注意

    如果要使用此選項傳遞的管理用戶端命令包含任何空格字元,則 必須 將該命令括在引號中。可以使用單引號或雙引號。如果管理用戶端命令不包含任何空格字元,則引號為選用項目。

  • --help

    命令列格式 --help

    顯示說明文字並結束。

  • --login-path

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

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

  • --no-login-paths

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

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

  • --ndb-connectstring

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

    設定用於連線至 ndb_mgmd 的連線字串。語法:[nodeid=id;][host=]主機名稱[:連接埠]。覆寫 NDB_CONNECTSTRINGmy.cnf 中的項目。

  • --ndb-nodeid

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

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

  • --ndb-mgm-tls

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

    寬鬆

    嚴格

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

  • --ndb-mgmd-host

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

    --ndb-connectstring 相同。

  • --ndb-optimized-node-selection

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

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

  • --ndb-tls-search-path

    命令列格式 --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

    命令列格式 --no-defaults

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

  • --print-defaults

    命令列格式 --print-defaults

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

  • --test-tls

    命令列格式 --test-tls

    使用 TLS 連線,然後結束。如果成功,輸出會類似於這裡顯示的內容。

    >$ ndb_mgm --test-tls
    Connected to Management Server at: sakila:1186
    >$

    如需更多資訊,請參閱第 25.6.15 節「NDB Cluster 的 TLS 連結加密」

  • --try-reconnect=number

    命令列格式 --try-reconnect=#
    已棄用
    類型 數值
    類型 整數
    預設值 12
    預設值 3
    最小值 0
    最大值 4294967295

    如果與管理伺服器的連線中斷,節點會每 5 秒嘗試重新連線,直到成功為止。透過使用此選項,可以限制在放棄並報告錯誤之前嘗試的次數為 number 次。

    此選項已棄用,並會在未來的版本中移除。請改用 --connect-retries

  • --usage

    命令列格式 --usage

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

  • --version

    命令列格式 --version

    顯示版本資訊並結束。

有關使用 ndb_mgm 的其他資訊,請參閱第 25.6.1 節「NDB Cluster 管理用戶端的命令」