TCPING

更新时间:
复制为 MD 格式

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:

  • 若输入urlNULL,返回NULL。

  • 若输入portNULL,返回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);