OPEN_CONNECTIONは、指定されたサービスへのTCPまたはIP接続を開くために使用されます。
適用対象
この内容はOceanBaseデータベースのOracleモードでのみ適用されます。
構文
UTL_TCP.OPEN_CONNECTION (
remote_host IN VARCHAR2,
remote_port IN PLS_INTEGER,
local_host IN VARCHAR2 DEFAULT NULL,
local_port IN PLS_INTEGER DEFAULT NULL,
in_buffer_size IN PLS_INTEGER DEFAULT NULL,
out_buffer_size IN PLS_INTEGER DEFAULT NULL,
charset IN VARCHAR2 DEFAULT NULL,
newline IN VARCHAR2 DEFAULT CRLF,
tx_timeout IN PLS_INTEGER DEFAULT NULL,
wallet_path IN VARCHAR2 DEFAULT NULL,
wallet_password IN VARCHAR2 DEFAULT NULL,
RETURN connection;
パラメータ説明
パラメータ |
説明 |
|---|---|
| remote_host | サービスに接続するホスト名。NULL の場合、エラーが発生します。 |
| remote_port | サービスがリッスンする接続ポート番号。 |
| local_host | サービスに提供されるホスト名。(保持フィールド)。 |
| local_port | サービスがリッスンする接続ポート番号。(保持フィールド)。 |
| in_buffer_size | 入力バッファサイズ(バイト)。0 はバッファを使用しないことを意味し、NULL はユーザーがバッファサイズを設定していないことを意味し、オペレーティングシステムによって制御されます。バッファの最大値は 32767 バイトです。 |
| out_buffer_size | 出力バッファサイズ(バイト)。0 はバッファを使用しないことを意味し、NULL はユーザーがバッファサイズを設定していないことを意味し、オペレーティングシステムによって制御されます。バッファの最大値は 32767 バイトです。 |
| charset | オンライン文字セット。データの送受信時に文字セット変換を行います。 |
| newline | 改行文字。write_line で送信するテキスト行の後に追加されます。 |
| tx_timeout | UTL_SMTP パッケットが接続の読み取りおよび書き込み操作でタイムアウトするまでの待機時間(秒単位)。読み取り操作では、すぐに読み取り可能なデータがない場合、このパッケットはタイムアウトします。書き込み操作では、出力バッファがいっぱいであり、ネットワークに送信されずにブロックされていないデータがない場合、このパッケットはタイムアウトします。0 は待機しないことを表し、NULL は常に待機することを表します。 |
| wallet_path | 現在、このフィールドはサポートされていません。現在、このフィールドのデフォルトは NULL です。 |
| wallet_password | 現在、このフィールドはサポートされていません。現在、このフィールドのデフォルトは NULL です。 |
戻り値
戻り値 |
説明 |
|---|---|
| connection | サービスへのTCP/IP接続。 |
使用方法
- 1つのセッションで最大16個の接続を開けます。
open_connectionで開いた接続は明示的に閉じる必要があります。これはセッションレベルのリソースであり、セッション間で共有することはできません。セッションが切断されると、そのセッションのすべての接続が閉じられます。remote_hostはIPアドレスまたはURLアドレスを指定でき、内部で変換されます。local_hostとlocal_portは予約語であり、TCP/IP接続の確立時には無視されます。返されるconnection変数では、これら2つのフィールドはNULLに設定されます。