SET_JOB_ARGUMENT_VALUE プロシージャは、ジョブパラメータの値を設定します。
SET_JOB_ARGUMENT_VALUE は、対応するプログラムまたはストアドプロシージャで設定されたパラメータのデフォルト値を上書きします。パラメータは位置または名前で指定できます。また、DEFINE_PROGRAM_ARGUMENT プロシージャを使用してパラメータに名前を割り当てることもできます。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
構文
位置指定でパラメータ値を設定する
DBMS_SCHEDULER.SET_JOB_ARGUMENT_VALUE (
job_name IN VARCHAR2,
argument_position IN PLS_INTEGER,
argument_value IN VARCHAR2);
名前指定でパラメータ値を設定する
DBMS_SCHEDULER.SET_JOB_ARGUMENT_VALUE (
job_name IN VARCHAR2,
argument_name IN VARCHAR2,
argument_value IN VARCHAR2);
パラメータ説明
パラメータ |
説明 |
|---|---|
| job_name | 変更するジョブの名前。 |
| argument_name | 設定するプログラムパラメータの名前。 |
| argument_position | 設定するプログラムパラメータの位置。 |
| argument_value | プログラムパラメータに設定する新しい値。 |
使用方法
SET_JOB_ARGUMENT_VALUE を実行するには、ジョブ所有者であるか、そのジョブに対する ALTER 権限が付与されている必要があります。CREATE ANY JOB 権限が付与されている場合は、ジョブパラメータの値も設定できます。
SET_JOB_ARGUMENT_VALUE はSQL型のパラメータのみをサポートします。そのため、プログラムやジョブのパラメータは、ブール値などの非SQL型のパラメータ値をサポートしません。
ただし、パラメータの型が VARCHAR2 の場合にのみ、SET_JOB_ARGUMENT_VALUE はライトウェイトジョブのパラメータを設定するために使用できます。
例
BEGIN
DBMS_SCHEDULER.CREATE_PROGRAM (
program_name => 'empprog',
program_type => 'STORED_PROCEDURE',
program_action => 'hr.empproc',
number_of_arguments => 1,
enabled => FALSE);
DBMS_SCHEDULER.DEFINE_PROGRAM_ARGUMENT (
program_name =>'empprog',
argument_name =>'emp_no',
argument_position => 1,
argument_type =>'VARCHAR2',
default_value => '0',
out_argument => false);
DBMS_SCHEDULER.ENABLE (job_name => 'empprog');
DBMS_SCHEDULER.DROP_JOB (
job_name =>'job_insert_emp',
force => TRUE);
DBMS_SCHEDULER.CREATE_JOB (
job_name =>'job_insert_emp',
program_name =>'empprog',
auto_drop => TRUE,
start_date => SYSDATE,
job_style => 'LIGHTWEIGHT');
DBMS_SCHEDULER.SET_JOB_ARGUMENT_VALUE (
job_name =>'job_insert_emp',
argument_name =>'emp_no',
argument_value =>'1357');
DBMS_SCHEDULER.ENABLE ( job_name => 'job_insert_emp');
END;