付録

mtactlを使用したMTA extprocの管理

マルチスレッド・エージェント制御ユーティリティ(mtactl)を使用すると、Oracle Big Data SQLのユーザーは、Oracle Clusterware Ready Service (CRS)環境と非CRS Oracle Database環境の両方で、MTA (マルチスレッド・エージェント) extprocの起動、停止および構成が可能になります。

注意:

非CRS環境では、MTA extprocを起動するためにmtactlを実行する必要があります。

使用方法

この使用方法の説明では、mta_sidは特定のマルチスレッドextprocエージェント・サービスのSIDです。

mtactl {start|restart|stop|status|delete|show|bdsql} <mta_sid>
mtactl unset <parameter> <mta_sid>
mtactl set <parameter> <parameter_value> <mta_sid>
mtactl -help
mtactl <command> -help

マルチスレッド・エージェント制御ユーティリティのコマンド

表7 mtactlコマンド

コマンド	完全な構文	説明
start	mtactl start <mta_sid>	リポジトリに保存してある初期化パラメータの値を使用して、このSIDに対応するMTA extprocを起動します。リポジトリが存在しない場合は、デフォルト値を使用します。 注意: Oracle Big Data SQL 3.1を使用していた場合、現在はrestartとstartの動作が3.1の動作と逆になっている点に注意してください。startでは、リポジトリからの初期値が使用されるようになりました(この値が使用可能な場合)。restartは常にデフォルト値が使用されます。
restart	mtactl start <mta_sid>	リポジトリをクリーン・アップし、デフォルト値を使用してSIDに対応するMTA extprocエージェントを再起動します。
stop	mtactl stop <mta_sid>	指定のSIDにサービスを提供するMTA extprocエージェントを停止します。
status	mtactl status <mta_sid>	指定のSIDにサービスを提供するMTA extprocのステータスを表示します。
delete	mtactl delete <mta_sid>	指定のSIDに対応するリポジトリをクリーン・アップします。
show	mtactl show <mta_sid>	指定のSIDにサービスを提供するMTA extprocの初期化パラメータを表示します。
bdsql	mtactl bdsql <mta_sid>	追加の操作を表示します。これらは、Oracle Big Data SQLで使用するようにMTA extprocを設定するためのものです。
set	mtactl set <init parameter> <value> <mta_sid>	指定のSIDにサービスを提供するMTA extprocの初期化パラメータを設定します。サポートされているパラメータは次のとおりです。 max_dispatchers tcp_dispatchers max_task_threads max_sessions listener_address
unset	mtactl unset <init parameter> <mta_sid>	指定のSIDにサービスを提供するMTA extprocのリポジトリ内の初期化パラメータを設定解除します。

例

$ mtactl start BDSQL_hadoop_cl_1 //note: using existing or default init parameter values

$ mtactl delete BDSQL_hadoop_cl_1
$ mtactl set max_sessions 200 BDSQL_hadoop_cl_1
$ mtactl set max_dispatchers 5 BDSQL_hadoop_cl_1
$ mtactl set max_task_threads 5 BDSQL_hadoop_cl_1
$ mtactl set listener_address "(ADDRESS=(PROTOCOL=ipc)(KEY=crs))" BDSQL_hadoop_cl_1
$ mtactl start BDSQL_hadoop_cl_1 (note: use customized parameter values)

$ mtactl restart BDSQL_hadoop_cl_1 //note: using default init parameter values