ip_as_binary функция

Область применения: Databricks Runtime 18.2 и выше

Это важно

Эта функция доступна в бета-версии. Администраторы рабочей области могут управлять доступом к этой функции на странице "Предварительные версии ". См. статью "Управление предварительными версиями Azure Databricks".

Возвращает каноническое двоичное представление IP-адреса или блока CIDR.

Syntax

ip_as_binary ( ip_or_cidr )

Аргументы

• ip_or_cidr: значение STRING или BINARY значение, представляющее IPv4 или IPv6-адрес или блок CIDR.

Returns

Представляет BINARY каноническую двоичную форму IP-адреса или блока CIDR. IPv4-адреса представлены как 4 байта, IPv6-адреса как 16 байт, а блоки CIDR включают дополнительный байт для длины префикса.

Функция возвращается NULL , если входные данные являются NULL.

Условия ошибок

• Если входные данные не являются допустимым IP-адресом или блоком CIDR, функция возвращает INVALID_IP_ADDRESS_OR_CIDR_BLOCK.

Примеры

> 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

Связанные функции

• try_ip_as_binary функция
• ip_as_string функция