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接続の確立時に無視されます。返されるconnection変数において、これら2つのフィールドはNULLに設定されます。