3.5.8. システム機能
システム機能は、クエリー内から Data Virtualization システムの情報へのアクセスを提供します。
COMMANDPAYLOAD
コマンドペイロードから文字列を取得します。コマンドペイロードが指定されていない場合は null になります。コマンドペイロードは、クエリーごとに Data Virtualization JDBC API エクステンションの TeiidStatement.setPayload
メソッドで設定されます。
COMMANDPAYLOAD([key])
key パラメーターを指定すると、コマンドペイロードオブジェクトは java.util.Properties オブジェクトにキャストされ、キーに対応するプロパティー値が返されます。キーが指定されていない場合、戻り値はコマンドペイロードオブジェクト toString 値になります。
key、戻り値は文字列です。
ENV
システムプロパティーを取得します。この関数は名前がなく、レガシーの互換性のために含まれています。より適切に名前付き関数については、ENV_VAR および SYS_PROP を参照してください。
ENV(key)
ENV('KEY')を使用して呼び出し、値を文字列として返します。ex: ENV('PATH')。渡されたキーで値が見つからなかった場合、小文字を使ったキーのバージョンも試行されます。この機能は、実行時にシステムプロパティーを設定することはできますが、決定論的に処理されます。
ENV_VAR
環境変数を取得します。
ENV_VAR(key)
ENV_VAR('KEY')を使用して呼び出し、値を文字列として返します。ex: ENV_VAR('USER')この機能の動作は、ケースの機密性に関してプラットフォームに依存します。この機能は、実行時に環境変数を変更することはできますが、決定論的に処理されます。
SYS_PROP
システムプロパティーを取得します。
SYS_PROP(key)
SYS_PROP('KEY')を使用して呼び出し、値を文字列として返します。ex: SYS_PROP('USER')。この機能は実行時にシステムプロパティーを変更できる場合でも、決定論的として処理されます。
NODE_ID
ノード ID を取得します。通常、Data Virtualization に埋め込まれない「jboss.node.name」のシステムプロパティーの値を取得します。
NODE_ID()
戻り値は string です。
SESSION_ID
現在のセッション ID の文字列形式を取得します。
SESSION_ID()
戻り値は string です。
USER
クエリーを実行しているユーザーの名前を取得します。
USER([includeSecurityDomain])
includeSecurityDomain はブール値で、戻り値は string です。
includeSecurityDomain が省略されたり、true であった場合、ユーザー名は @security-domain が付加された状態で返されます。
CURRENT_DATABASE
データベースのカタログ名を取得します。VDB 名は常にカタログ名になります。
CURRENT_DATABASE()
戻り値は string です。
TEIID_SESSION_GET
セッション変数を取得します。
TEIID_SESSION_GET(name)
name は文字列で、戻り値はオブジェクトです。
null 名は null 値を返します。通常、get wrap を CAST でラップして必要なタイプに変換します。
TEIID_SESSION_SET
セッション変数を設定します。
TEIID_SESSION_SET(name, value)
name は文字列で、value はオブジェクトで、戻り値はオブジェクトです。
キーまたは null の以前の値が返されます。セットは現在のトランザクションには影響がなく、コミット/ロールバックの影響を受けません。
GENERATED_KEY
生成されたキーを返すこのセッションの最後の insert ステートメントで生成されたキーから列値を取得します。
通常、この機能は手順の範囲内でのみ使用され、挿入から生成されたキー値を決定します。すべてのソースが生成されたキーを返すわけではないため、すべての挿入が生成されたキーを提供するわけではありません。
GENERATED_KEY()
戻り値は long です。
最後に生成されたキーの最初のコラムを long 値として返します。そのような生成されたキーがない場合は null が返されます。
GENERATED_KEY(column_name)`
column_name
は文字列です。戻り値は type オブジェクトです。
複数の生成された列または long 以外のタイプがある場合は、より一般的な GENERATED_KEY
を使用できます。このような生成されたキーや一致するキー列がない場合は、null を返します。