xp_getenv システムプロシージャ

xp_getenv( environment_variable )

environment_variable 環境変数の所有者を指定する VARCHAR(8000) パラメータ。このパラメータは、データベースの大文字と小文字の区別に関係なく、Windows オペレーティングシステム上では大文字と小文字が区別されず、その他のすべてのオペレーティングシステム上では大文字と小文字が区別されます。デフォルト値は NULL です。

この関数は LONG BINARY 値を返します。

指定されている環境変数が NULL または設定されていない場合、NULL が返されます。

SERVER OPERATOR システム権限が必要です。

なし

次の例は、xp_getenv システムプロシージャを使用して、環境変数 PATH の値を返します。

SELECT CAST(xp_getenv('PATH') AS LONG VARCHAR);

次の例は、xp_getenv と sa_split_list のシステムプロシージャを使用して、Windows 環境変数 PATH の値をリストとして返します。UNIX オペレーティングシステムでは、':' を区切り文字として使用します。

CALL sa_split_list(CAST(xp_getenv('PATH') AS LONG VARCHAR), ';');

次の例は、存在しないことを想定する環境変数 NONEXISTENT を使用します。したがって、クエリを実行すると NULL が返されます。

SELECT xp_getenv( 'NONEXISTENT' );