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 codeは
220であり、SMTPサーバーがクライアントからのリクエストを処理する準備ができていることを示します。 utl_smtp.connectionバージョンが返す際にはreply codeをチェックし、エラーを示す場合は例外をスローします。utl_smtp.replyバージョンが返す場合は、ユーザーがreplyをチェックします。tx_timeoutは読み取り操作と書き込み操作の管理を目的としています。ただし、実装上の制限により、現在のバージョンではtx_timeoutによる書き込み操作の管理はできません。