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接続。 |
使用方法
- 同一セッションで最大16個の接続を開くことができます。
open_connectionで開いた接続は明示的に閉じる必要があり、セッションレベルのリソースであるため、セッション間で共有することはできません。セッションが切断されると、現在のセッションのすべての接続が閉じられます。remote_hostはIPアドレスまたはURLであり、内部で変換されます。local_hostとlocal_portは予約フィールドであり、TCP/IP接続を確立する際に無視されます。返されるconntection変数では、これら2つのフィールドはNULLに設定されます。