OPEN_CONNECTIONは、SMTPサービスとの接続を開いて返すために使用されます。
適用対象
この内容はOceanBaseデータベースのOracleモードにのみ適用されます。
構文
UTL_SMTP.OPEN_CONNECTION (
host IN VARCHAR2,
port IN PLS_INTEGER DEFAULT 25,
c OUT connection,
tx_timeout IN PLS_INTEGER DEFAULT NULL,
wallet_path IN VARCHAR2 DEFAULT NULL,
wallet_password IN VARCHAR2 DEFAULT NULL,
secure_connection_before_smtp IN BOOLEAN DEFAULT FALSE,
secure_host IN VARCHAR2 DEFAULT NULL)
RETURN reply;
UTL_SMTP.OPEN_CONNECTION (
host IN VARCHAR2,
port IN PLS_INTEGER DEFAULT 25,
tx_timeout IN PLS_INTEGER DEFAULT NULL,
wallet_path IN VARCHAR2 DEFAULT NULL,
wallet_password IN VARCHAR2 DEFAULT NULL,
secure_connection_before_smtp IN BOOLEAN DEFAULT FALSE,
secure_host IN VARCHAR2 DEFAULT NULL)
RETURN connection;
パラメータの説明
| パラメータ | 説明 |
|---|---|
| host | SMTPサービスのホスト名。 |
| port | smtpサービスのポート番号（通常は25）。 |
| c | smtp接続。 |
| tx_timeout | UTL_SMTPパケットが接続の読み取りおよび書き込み操作でタイムアウトするまでの待機時間（単位：秒）。読み取り操作では、即座に読み取るデータがない場合、このパケットはタイムアウトします。書き込み操作では、出力バッファがいっぱいになっていて、ネットワークに送信されずにブロックされていないデータがない場合、このパケットはタイムアウトします。0 は待機しないことを意味し、NULL は常に待機することを意味します。 |
| wallet_path | 現在このフィールドはサポートされておらず、現在のデフォルト値は NULL です。 |
| wallet_password | 現在このフィールドはサポートされておらず、現在のデフォルト値は NULL です。 |
| secure_connection_before_smtp | TRUE の場合、SMTP通信の前にSSL/TLSを使用してセキュリティ接続を確立します。FALSE の場合、セキュリティ接続は確立されません。（現在は FALSE のみサポートされています）。 |
| secure_host | 現在このフィールドはサポートされておらず、現在のデフォルト値は NULL です。 |
戻り値
| 戻り値 | 説明 |
|---|---|
| reply | コマンドのレスポンス。複数のレスポンスがある場合は、最後のレスポンスを返します。 |
使用方法
- 期待されるreplyコードは
220であり、SMTPサーバーがクライアントからのリクエストを処理する準備ができていることを示します。 utl_smtp.connectionバージョンの返却はreplyコードをチェックし、レスポンスがエラーを示す場合は例外をスローします。utl_smtp.replyバージョンの返却は、ユーザーがreplyをチェックします。tx_timeoutは読み取り操作と書き込み操作を管理するために設計されています。ただし、実装上の制限により、tx_timeoutは現在のバージョンでの書き込み操作を管理することができません。