Todos os produtos
Search
Central de documentação

MaxCompute:TCPING

Última atualização: Jun 27, 2026

A função TCPING verifica a acessibilidade de uma porta específica em um nome de domínio ou endereço IP de destino.

Observações de uso

  • Verifique se o nome de domínio ou endereço IP é público.

  • Confirme que o nome de domínio ou endereço IP de destino está incluído na configuração da MaxCompute External Network. Para obter instruções, consulte Ativar acesso à rede.

  • Antes de usar a função, execute o comando SET odps.internet.access.list=<url:port>;. Separe por vírgulas os múltiplos nomes de domínio ou portas.

Sintaxe

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

Parâmetros

  • url: Obrigatório. Nome de domínio público ou endereço IP a verificar.

  • port: Obrigatório. Porta a verificar no host especificado.

Valor de retorno

Retorna um valor BOOLEAN. A função retorna NULL nas seguintes condições:

  • Se url for NULL.

  • Se port for NULL.

Exemplos

-- The destination is added to the MaxCompute external network configuration. Returns true.
SET odps.internet.access.list= www.aliyun.com:80;
SELECT TCPING('www.aliyun.com',80);

-- The destination is not added to the MaxCompute external network configuration. Returns false.
SET odps.internet.access.list=www.aliyun.com:80;
SELECT TCPING('www.aliyun.com',80);

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

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