try_ip_as_string 関数

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

Important

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

IP アドレスまたは CIDR ブロックの正規文字列形式を返します。 入力が無効な場合にエラーを発生させる代わりに、 NULL を返します。

構文

try_ip_as_string ( ip_or_cidr )

引数

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

返品

IP アドレスまたは CIDR ブロックの正規の文字列形式を表す STRINGBINARY入力の場合、バイナリ表現は同等の文字列形式に変換されます。

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

Examples

> SELECT try_ip_as_string('192.168.1.1');
  192.168.1.1

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

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

> SELECT try_ip_as_string(X'C0A80101');
  192.168.1.1

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

> SELECT try_ip_as_string('invalid');
  NULL

> SELECT try_ip_as_string(X'');
  NULL

> SELECT try_ip_as_string(NULL);
  NULL