---
title: github-fill
description: OPEN_CONNECTION OPEN_CONNECTION 用于打开并返回一个与 SMTP 服务的连接。 功能适用性 该内容仅适用于 OceanBase 数据库 Oracle 模式。 语法 UTL_SMTP.OPEN_CONNECTION ( host IN VARCHAR2, port IN PLS_INTEG…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.5 LTS

# OPEN_CONNECTION

更新时间：2026-07-15 20:56:58

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.5/zh-CN/700.reference/500.sql-reference/300.pl-reference/300.pl-oracle/1400.pl-system-package-oracle/27200.utl-smtp-oracle/200.utl-smtp-open-connection-oracle.md)  

`OPEN_CONNECTION` 用于打开并返回一个与 SMTP 服务的连接。

#### 功能适用性

该内容仅适用于 OceanBase 数据库 Oracle 模式。

## 语法

```sql
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 | command 的回复。如果有多个回复，则返回最后一个回复。 |

## 使用说明

- 期待的 reply code 是 `220`， 表示 SMTP 服务器用来表明它已经准备好处理来自客户端的请求。
 - 返回 `utl_smtp.connection` 的版本会检查 reply code，如果回复指示了错误，将抛出异常。返回 `utl_smtp.reply` 的版本则由用户检查 reply。
 - `tx_timeout` 旨在管理读取操作和写入操作。但是，实施限制会阻止 `tx_timeout` 管理当前版本中的写入操作。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线