try_ip_as_binary 関数

適用対象:はい Databricks Runtime 18.2 以降とマークされているチェック

Important

この機能は ベータ版です。 ワークスペース管理者は、[ プレビュー] ページからこの機能へのアクセスを制御できます。 Manage Azure Databricks プレビューを参照してください。

IP アドレスまたは CIDR ブロックの正規バイナリ表現を返します。 入力が無効な場合にエラーを発生させる代わりに、 NULL を返します。

構文

try_ip_as_binary ( ip_or_cidr )

引数

  • ip_or_cidr: IPv4 または IPv6 アドレスまたは CIDR ブロックを表す STRING 値または BINARY 値。

返品

IP アドレスまたは CIDR ブロックの正規バイナリ形式を表す BINARY 。 IPv4 アドレスは 4 バイト、IPv6 アドレスは 16 バイトとして表され、CIDR ブロックにはプレフィックス長の追加バイトが含まれます。

この関数は、入力がNULLまたは無効な場合にNULLを返します。

Examples

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

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

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

> SELECT hex(try_ip_as_binary('::ffff:192.168.1.1'));
  00000000000000000000FFFFC0A80101

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

> SELECT try_ip_as_binary('invalid');
  NULL

> SELECT try_ip_as_binary(X'');
  NULL

> SELECT try_ip_as_binary(NULL);
  NULL