ユーザ定義の名前付きパラメータ

独自のパラメータを定義することもできます。独自のパラメータは、ユーザ定義の変数を使用できない RDBMS に特に便利です。

ユーザ定義のパラメータは、最初に参照されるときに定義され、NULL に設定されます。パラメータが参照専用 (入力専用) の場合は、パラメータに ui とピリオド (ui.) のプレフィクスを付ける必要があります。パラメータが更新される (in/out) 場合は、u とピリオド (u.) のプレフィクスを付ける必要があります。ユーザ定義のパラメータは 1 つの同期が終わるまで値が維持され、別の同期が開始されるときに NULL に設定されます。

ユーザ定義のパラメータは通常、テーブルに格納しないでステータス情報にアクセスするために使用します。テーブルに格納するには、複雑なジョインが必要です。

例

たとえば、var1 という変数を custom_value に設定する MyCustomProc というストアドプロシージャを作成するとします。

CREATE PROCEDURE MyCustomProc(
  IN username VARCHAR(128), INOUT var1 VARCHAR(128)
)
begin
 SET var1 = 'custom_value';
end

次の begin_synchronization スクリプトでは、ユーザ定義のパラメータ var1 を定義し、値を custom_value に設定しています。

CALL ml_add_connection_script ( 
  'version1', 
  'begin_synchronization', 
  '{call MyCustomProc( {ml s.username}, {ml u.var1} )}' );

次の download_cursor テーブルスクリプトでは、値が custom_value の var1 を参照しています。

CALL ml_add_table_script (
  'version1',
  'MyTable',
  'download_cursor',
  'select pk,col1 from MyTable where u_name = {ml s.username} and some_other_column = {ml ui.var1}' );

最初のパラメータを in/out に定義する MyPFDProc という別のストアドプロシージャがあるとします。次の prepare_for_download スクリプトでは、var1 の値を pfd_value に変更しています。

CALL ml_add_connection_script ( 
  'version1', 
  'prepare_for_download', 
  '{call MyPFDProc( {ml u.var1} )}' );

次の begin_download スクリプトでは、値が pfd_value の var1 を参照しています。

CALL ml_add_connection_script ( 
  'version1', 
  'begin_download', 
  'insert into SomeTable values( {ml s.username}, {ml ui.var1} )' );

DocCommentXchange で意見交換できます