ip_as_binary Função

Aplica-se a: Databricks Runtime 18.2 e superior

Retorna a representação binária canônica de um endereço IP ou bloco CIDR.

Syntax

ip_as_binary ( 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 BINARY representação da forma binária canônica do endereço IP ou do bloco CIDR. Os endereços IPv4 são representados como 4 bytes, endereços IPv6 como 16 bytes e blocos CIDR incluem um byte adicional para o comprimento do prefixo.

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.

Exemplos

> SELECT hex(ip_as_binary('192.168.1.1'));
  C0A80101

> SELECT hex(ip_as_binary('2001:db8::1'));
  20010DB8000000000000000000000001

> SELECT hex(ip_as_binary('192.168.1.5/24'));
  C0A8010018

> SELECT hex(ip_as_binary(X'C0A80101'));
  C0A80101

> SELECT ip_as_binary(NULL);
  NULL

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

Funções relacionadas

• try_ip_as_binary função
• ip_as_string função