obd.shを使用してmysqltestを実行する|V4.4.2|OceanBaseデータベース|ドキュメント|OceanBaseマニュアル

パラメータ	必須	説明
servers	必須	各マシンについて `- name: マシン識別子 (改行)ip: マシンIP` の形式で指定する必要があります。複数のマシンがある場合は、それぞれ指定します。マシン識別子は重複してはなりません。マシンIPが重複しない場合、`- <ip> (改行) - <ip>` の形式でも指定できます。この場合、`- <ip>` の形式は `- name: マシンIP(改行)ip: マシンIP` と同義です。
mysql_port	必須	SQLサービスプロトコルのポート番号を設定します。
rpc_port	必須	リモートアクセスプロトコルのポート番号を設定します。これは、observerプロセスと他のノードプロセス間のRPC通信ポートです。
home_path	必須	コンポーネントのインストールパス。
production_mode	必須	本番モードパラメータです。有効にすると、サーバーリソースが本番環境での使用に適しているかどうかチェックされます。テストシナリオでは無効にした方が良いでしょう。無効の場合、デプロイが失敗する可能性があります。
devname	オプション	`servers` で指定されたIPに対応するNICです。`ip addr` コマンドでIPとNICの対応関係を確認できます。
listen_port	必須	ODPのリスニングポート。
prometheus_listen_port	必須	ODP prometheusのリスニングポート。

パラメータ名	必須	データ型	デフォルト値	説明
-n	はい	string	デフォルトは空文字列	テストを実行するクラスタ名。
--component	いいえ	string	デフォルトは空文字列	テスト対象のコンポーネント名。候補はobproxy、obproxy-ce、oceanbase、oceanbase-ceです。空の場合、obproxy、obproxy-ce、oceanbase、oceanbase-ceの順でチェックされます。コンポーネントが存在することが検出された場合、以降のイテレーションは行われず、ヒットしたコンポーネントを使用して後続のテストが実行されます。
--test-server	いいえ	string	デフォルトは指定されたコンポーネントのサーバー内の最初のノード	テスト対象のマシン。yamlファイル内のserversに対応するname値を設定できます。serversの後にname値が設定されていない場合は、ip値が使用されます。指定されたコンポーネントのノード名である必要があります。
--user	いいえ	string	admin	テストを実行するユーザー名。通常は変更不要です。
--password	いいえ	string	admin	テストを実行するユーザーのパスワード。
--database	いいえ	string	test	テストを実行するデータベース。
--mysqltest-bin	いいえ	string	/u01/obclient/bin/mysqltest	mysqltestバイナリファイルのパス。
--obclient-bin	いいえ	string	obclient	OBClientバイナリファイルのパス。
--test-dir	いいえ	string	./mysql_test/t	mysqltestに必要なtest-fileを格納するディレクトリ。testファイルが見つからない場合、obdの組み込みで検索を試みます。
--test-file-suffix	いいえ	string	.test	mysqltestに必要なtest-fileの拡張子。
--result-dir	いいえ	string	./mysql_test/r	mysqltestに必要なresult-fileを格納するディレクトリ。resultファイルが見つからない場合、obdの組み込みで検索を試みます。
--result-file-suffix	いいえ	string	.result	mysqltestに必要なresult-fileの拡張子。
--record	いいえ	bool	false	mysqltestの実行結果のみをrecord-fileとして記録します。
--record-dir	いいえ	string	./record	mysqltestの実行結果を記録するディレクトリ。
--record-file-suffix	いいえ	string	.record	mysqltestの実行結果の拡張子。
--tmp-dir	いいえ	string	./tmp	mysqltestの一時ディレクトリ。テスト実行中に生成される一時ファイルを格納します。
--var-dir	いいえ	string	./var	このディレクトリ配下にlogディレクトリを作成し、logディレクトリを`--log-dir`パラメータとしてmysqltestに渡します。
--test-set	いいえ	string	なし	test caseの配列。複数のcaseは半角カンマ（`,`）で区切ります。
--exclude	いいえ	string	なし	除外するtest caseの配列。複数のcaseは半角カンマ（`,`）で区切ります。
--test-pattern	いいえ	string	なし	testファイル名に一致する正規表現。すべての一致するパターンのcaseはtest-setオプションを上書きします。
--suite	いいえ	string	なし	suiteの配列。1つのsuiteには複数のtestが含まれ、半角カンマ（`,`）で区切ることができます。
--suite-dir	いいえ	string	./mysql_test/test_suite	suiteディレクトリを格納するディレクトリ。suiteディレクトリが見つからない場合、obdの組み込みで検索を試みます。
--all	いいえ	bool	false	`--suite-dir`配下のすべてのcaseを実行します。`--suite-dir`パラメータはsuiteディレクトリを格納するディレクトリです。
--need-init	いいえ	bool	false	init sqlファイルを実行します。新しいクラスタでmysqltestを実行する前に、caseの作成に必要なアカウントやテナントなどの初期化ファイルを実行する必要がある場合があります。デフォルトでは有効ではありません。
--init-sql-dir	いいえ	string	./	init sqlファイルがあるディレクトリ。sqlファイルが見つからない場合、obdの組み込みで検索を試みます。
--init-sql-files	いいえ	string	デフォルトは空文字列	initが必要な場合に実行するinit sqlファイルの配列。半角カンマ（`,`）で区切ります。指定しない場合、initが必要な場合、obdはクラスタ設定に基づいて組み込みのinitを実行します。
--auto-retry	いいえ	bool	false	失敗した場合、自動的にクラスタを再デプロイしてリトライします。
--psmall	いいえ	bool	false	psmallモードのcaseを実行します。
--slices	いいえ	int	デフォルトは空文字列	実行するcaseを分割するグループ数。
--slice-idx	いいえ	int	デフォルトは空文字列	現在のグループidを指定します。
--slb-host	いいえ	string	デフォルトは空文字列	ソフトロードバランシングセンターを指定します。
--exec-id	いいえ	string	デフォルトは空文字列	実行idを指定します。
--case-filter	いいえ	string	./mysql_test/filter.py	filter.pyファイルは、フィルタリングが必要なcaseを管理します。
--reboot-timeout	いいえ	int	0	リブートのタイムアウト時間。
--reboot-retries	いいえ	int	5	リブート失敗時のリトライ回数。
--collect-all	いいえ	bool	false	コンポーネントログを収集するかどうか。
--log-dir	いいえ	string	デフォルトは$--var-dir/log	mysqltestのログ保存先パス。
--log-pattern	いいえ	string	*.log	収集するログファイル名に一致する正規表現。一致するファイルが収集されます。
--case-timeout	いいえ	int	3600	mysqltest単一テストのタイムアウト時間。
--disable-reboot	いいえ	bool	false	テスト実行中はリブートしません。
--collect-components	いいえ	string	デフォルトは空文字列	ログ収集を行うコンポーネントを指定するために使用します。複数のコンポーネントは半角カンマ（`,`）で区切ります。
--init-only	いいえ	bool	false	trueの場合、init SQLのみを実行します。

-n

はい

string

デフォルトは空文字列

テストを実行するクラスタ名。

--component

いいえ

string

デフォルトは空文字列

テスト対象のコンポーネント名。候補はobproxy、obproxy-ce、oceanbase、oceanbase-ceです。空の場合、obproxy、obproxy-ce、oceanbase、oceanbase-ceの順でチェックされます。コンポーネントが存在することが検出された場合、以降のイテレーションは行われず、ヒットしたコンポーネントを使用して後続のテストが実行されます。

--test-server

いいえ

string

デフォルトは指定されたコンポーネントのサーバー内の最初のノード

テスト対象のマシン。yamlファイル内のserversに対応するname値を設定できます。serversの後にname値が設定されていない場合は、ip値が使用されます。指定されたコンポーネントのノード名である必要があります。

--user

いいえ

string

admin

テストを実行するユーザー名。通常は変更不要です。

--password

いいえ

string

admin

テストを実行するユーザーのパスワード。

--database

いいえ

string

test

テストを実行するデータベース。

--mysqltest-bin

いいえ

string

/u01/obclient/bin/mysqltest

mysqltestバイナリファイルのパス。

--obclient-bin

いいえ

string

obclient

OBClientバイナリファイルのパス。

--test-dir

いいえ

string

./mysql_test/t

mysqltestに必要なtest-fileを格納するディレクトリ。testファイルが見つからない場合、obdの組み込みで検索を試みます。

--test-file-suffix

いいえ

string

.test

mysqltestに必要なtest-fileの拡張子。

--result-dir

いいえ

string

./mysql_test/r

mysqltestに必要なresult-fileを格納するディレクトリ。resultファイルが見つからない場合、obdの組み込みで検索を試みます。

--result-file-suffix

いいえ

string

.result

mysqltestに必要なresult-fileの拡張子。

--record

いいえ

bool

false

mysqltestの実行結果のみをrecord-fileとして記録します。

--record-dir

いいえ

string

./record

mysqltestの実行結果を記録するディレクトリ。

--record-file-suffix

いいえ

string

.record

mysqltestの実行結果の拡張子。

--tmp-dir

いいえ

string

./tmp

mysqltestの一時ディレクトリ。テスト実行中に生成される一時ファイルを格納します。

--var-dir

いいえ

string

./var

このディレクトリ配下にlogディレクトリを作成し、logディレクトリを--log-dirパラメータとしてmysqltestに渡します。

--test-set

いいえ

string

なし

test caseの配列。複数のcaseは半角カンマ（,）で区切ります。

--exclude

いいえ

string

なし

除外するtest caseの配列。複数のcaseは半角カンマ（,）で区切ります。

--test-pattern

いいえ

string

なし

testファイル名に一致する正規表現。すべての一致するパターンのcaseはtest-setオプションを上書きします。

--suite

いいえ

string

なし

suiteの配列。1つのsuiteには複数のtestが含まれ、半角カンマ（,）で区切ることができます。

--suite-dir

いいえ

string

./mysql_test/test_suite

suiteディレクトリを格納するディレクトリ。suiteディレクトリが見つからない場合、obdの組み込みで検索を試みます。

--all

いいえ

bool

false

--suite-dir配下のすべてのcaseを実行します。--suite-dirパラメータはsuiteディレクトリを格納するディレクトリです。

--need-init

いいえ

bool

false

init sqlファイルを実行します。新しいクラスタでmysqltestを実行する前に、caseの作成に必要なアカウントやテナントなどの初期化ファイルを実行する必要がある場合があります。デフォルトでは有効ではありません。

--init-sql-dir

いいえ

string

./

init sqlファイルがあるディレクトリ。sqlファイルが見つからない場合、obdの組み込みで検索を試みます。

--init-sql-files

いいえ

string

デフォルトは空文字列

initが必要な場合に実行するinit sqlファイルの配列。半角カンマ（,）で区切ります。指定しない場合、initが必要な場合、obdはクラスタ設定に基づいて組み込みのinitを実行します。

--auto-retry

いいえ

bool

false

失敗した場合、自動的にクラスタを再デプロイしてリトライします。

--psmall

いいえ

bool

false

psmallモードのcaseを実行します。

--slices

いいえ

int

デフォルトは空文字列

実行するcaseを分割するグループ数。

--slice-idx

いいえ

int

デフォルトは空文字列

現在のグループidを指定します。

--slb-host

いいえ

string

デフォルトは空文字列

ソフトロードバランシングセンターを指定します。

--exec-id

いいえ

string

デフォルトは空文字列

実行idを指定します。

--case-filter

いいえ

string

./mysql_test/filter.py

filter.pyファイルは、フィルタリングが必要なcaseを管理します。

--reboot-timeout

いいえ

int

0

リブートのタイムアウト時間。

--reboot-retries

いいえ

int

5

リブート失敗時のリトライ回数。

--collect-all

いいえ

bool

false

コンポーネントログを収集するかどうか。

--log-dir

いいえ

string

デフォルトは$--var-dir/log

mysqltestのログ保存先パス。

--log-pattern

いいえ

string

*.log

収集するログファイル名に一致する正規表現。一致するファイルが収集されます。

--case-timeout

いいえ

int

3600

mysqltest単一テストのタイムアウト時間。

--disable-reboot

いいえ

bool

false

テスト実行中はリブートしません。

--collect-components

いいえ

string

デフォルトは空文字列

ログ収集を行うコンポーネントを指定するために使用します。複数のコンポーネントは半角カンマ（,）で区切ります。

--init-only

いいえ

bool

false

trueの場合、init SQLのみを実行します。

obd.shを使用してmysqltestを実行する

背景

概念

説明

手順

ステップ１：OceanBaseデータベースのソースコードをコンパイルする

ステップ２：コンパイル済みのOceanBaseファイルをデプロイする

説明

ステップ3：mysqltestテストの実行

付録