句の値に使用する代入パラメータ

ストアドプロシージャまたはファンクションの宣言済みパラメータは、そのプロシージャまたはファンクションが実行されるたびに、句の定義内のプレースホルダを自動的に置き換えます。代入パラメータを使用すると、実行時に動的に句を設定する一般的な Web サービスプロシージャを作成できます。感嘆符 '!' の後に宣言されたパラメータの 1 つの名前が続いている部分文字列はすべて、パラメータの値で置換されます。こうして、実行時に 1 つ以上のパラメータ値が代入され、1 つ以上の句の値が抽出されます。

パラメータの代入を行うには、次の規則を順守する必要があります。

代入に使用するパラメータはすべて英数字にします。アンダースコアは使用できません。
代入パラメータの直後は、英数字以外の文字が続くか終了である必要があります。たとえば、!sizeXL は、X が英数字であるため、size というパラメータの値で置換されません。
パラメータ名に一致しない代入パラメータは無視されます。
感嘆符 (!) は別の感嘆符でエスケープできます。

たとえば、次のプロシージャは、代入パラメータの使用方法を示します。URL と HTTP ヘッダの定義は、パラメータとして渡します。

CREATE PROCEDURE test(uid CHAR(128), pwd CHAR(128), headers LONG VARCHAR)
    URL 'http://!uid:!pwd@localhost/myservice'
    HEADER '!headers';

次の文を使用して test プロシージャを呼び出し、HTTP 要求を開始できます。

CALL test('dba', 'sql', 'NewHeader1:value1\nNewHeader2:value2');

このプロシージャが呼び出されるたびに、異なる値を使用できます。

暗号化証明書の例

代入パラメータを使用してファイルからストアドプロシージャまたはストアド関数に暗号化証明書を渡すことができます。

次の例は、証明書を代入文字列として渡す方法を示します。

CREATE PROCEDURE secure(cert LONG VARCHAR)
URL 'https://localhost/secure'
TYPE 'HTTP:GET'
CERTIFICATE 'cert=!cert;company=test;unit=test;name=RSA Root';

証明書は次の呼び出しでファイルから読み込まれて secure に渡されます。

CALL secure( xp_read_file('C:\\Users\\Public\\Documents\\SQL Anywhere 16\\Samples\\Certificates\\rsaroot.crt) );

この例は説明でのみ使用されます。CERTIFICATE 句の file= キーワードを使用して、証明書をファイルから直接読み込むことができます。

一致するパラメータ名がない場合の例

一致するパラメータ名のないプレースホルダは、自動的に削除されます。

たとえば、次のプロシージャでは、パラメータ size はプレースホルダを置換しません。

CREATE PROCEDURE orderitem (size CHAR(18))
    URL 'HTTP://localhost/salesserver/order?size=!sizeXL'
    TYPE 'SOAP:RPC';

この例では、!sizeXL は一致するパラメータがないプレースホルダであるため、常に削除されます。

パラメータはストアド関数またはストアドプロシージャの呼び出し時に、それらの本文内のプレースホルダを置換するためにも使用できます。特定の変数のプレースホルダが存在しない場合、パラメータとその値が要求の一部として渡されます。このようにして代入に使用されるパラメータは、要求の一部として渡されません。

DocCommentXchange で意見交換できます