全部產品
Search
文件中心

MaxCompute:TCPING

更新時間:Apr 02, 2026

TCPING函數用於驗證目標網域名稱或IP地址的某個連接埠是否可連通。

注意事項

  • 需確保要訪問的網域名稱或IP是公網地址。

  • 需確保要訪問的網域名稱或IP已添加到MaxCompute外部网络配置中,配置方式詳見網路開通流程

  • 使用函數前需要加上參數SET odps.internet.access.list=<url:port>;如果需要訪問多個網域名稱或連接埠,請使用英文逗號(,)分隔。

命令格式

STRING TCPING(STRING <url>, BIGINT <port>)

參數說明

  • url:必填。STRING類型,待訪問的公網網域名稱或IP地址。

  • port:必填。BIGINT類型,待訪問的公網網域名稱或IP地址連接埠。

傳回值說明

返回BOOLEAN類型。 下列任一條件成立時,該函數返回NULL:

  • 若輸入url為NULL,返回NULL。

  • 若輸入port為NULL,返回NULL。

使用樣本

-- 已添加到【MaxCompute外部網路】配置中,返回true。
SET odps.internet.access.list= www.aliyun.com:80;
SELECT TCPING('www.aliyun.com',80);

-- 未添加到【MaxCompute外部網路】配置中,返回false。
SET odps.internet.access.list=www.aliyun.com:80;
SELECT TCPING('www.aliyun.com',80);

-- 返回NULL
SET odps.internet.access.list=www.aliyun.com:80;
SELECT TCPING('www.aliyun.com',NULL);

-- 返回NULL
SET odps.internet.access.list=www.aliyun.com:80;
SELECT TCPING(NULL,80);