ip_as_string Função

Aplica-se a: Databricks Runtime 18.2 e superior

Retorna a representação de cadeia de caracteres canônica de um endereço IP ou bloco CIDR.

Syntax

ip_as_string ( ip_or_cidr )

Argumentos

• ip_or_cidr: A STRING ou BINARY valor que representa um endereço IPv4 ou IPv6 ou um bloco CIDR.

Returns

Uma STRING representação da forma de cadeia de caracteres canônica do endereço IP ou do bloco CIDR. Para BINARY entradas, a representação binária é convertida em seu formulário de cadeia de caracteres equivalente.

A função retorna NULL se a entrada for NULL.

Condições de erro

• Se a entrada não for um endereço IP válido ou um bloco CIDR, a função retornará INVALID_IP_ADDRESS_OR_CIDR_BLOCK.

Examples

> SELECT ip_as_string('192.168.1.1');
  192.168.1.1

> SELECT ip_as_string('2001:0db8:0000:0000:0000:0000:0000:0001');
  2001:db8::1

> SELECT ip_as_string('192.168.1.5/24');
  192.168.1.0/24

> SELECT ip_as_string(X'C0A80101');
  192.168.1.1

> SELECT ip_as_string(X'20010DB8000000000000000000000001');
  2001:db8::1

> SELECT ip_as_string(NULL);
  NULL

> SELECT ip_as_string('invalid.ip');
  Error: INVALID_IP_ADDRESS_OR_CIDR_BLOCK

Funções relacionadas

• try_ip_as_string função
• ip_as_binary função