メインコンテンツへスキップ

IPv4CIDRToRange

導入バージョン: v20.1.0 IPv4 アドレスとその Classless Inter-Domain Routing (CIDR) プレフィックス長を受け取り、そのサブネットのアドレス範囲を、2 つの IPv4 値からなるタプルとして返します。つまり、そのサブネットの先頭アドレスと末尾アドレスです。 IPv6 版については IPv6CIDRToRange を参照してください。 構文
引数
  • ipv4 — IPv4 アドレス。IPv4 または String
  • cidr — CIDR 値。UInt8
戻り値 サブネットの範囲を表す 2 つの IPv4 アドレスからなるタプルを返します。Tuple(IPv4, IPv4) 例 使用例
Query
Response

IPv4NumToString

導入バージョン: v1.1.0 32 ビット整数を、ドット区切りの 10 進表記 (A.B.C.D 形式) の IPv4 アドレスの文字列表現に変換します。 入力はビッグエンディアンのバイト順で解釈されます。 構文
別名: INET_NTOA 引数
  • num — IPv4 アドレスを表す UInt32 型の数値。UInt32
戻り値 MAC アドレスを表す数値を返します。形式が無効な場合は 0 を返します。String 例 使用例
Query
Response

IPv4NumToStringClassC

導入バージョン: v1.1.0 32 ビット整数を、ドット区切りの 10 進表記 (A.B.C.D 形式) の IPv4 アドレスの文字列表現に変換します。 IPv4NumToString と似ていますが、最後のオクテットの代わりに xxx を使用します。 構文
引数
  • num — UInt32 値として表された IPv4 アドレス。UInt32
戻り値 最後のオクテットを xxx に置き換えた IPv4 アドレス文字列を返します。String 例 集計を用いた基本例
Query
Response

IPv4StringToNum

導入バージョン: v1.1.0 ドット区切りの 10 進表記 (A.B.C.D 形式) の IPv4 アドレス文字列を、対応する 32 ビット整数表現に変換します (IPv4NumToString の逆です) 。 IPv4 アドレスの形式が無効な場合は、例外が発生します。 構文
別名: INET_ATON 引数
  • string — IPv4 アドレス文字列。String
戻り値 IPv4 アドレスを返します。UInt32 例 使用例
Query
Response

IPv4StringToNumOrDefault

導入バージョン: v22.3.0 ドット区切りの10進表記 (A.B.C.D 形式) の IPv4 アドレス文字列を、対応する 32 ビット整数表現に変換します。IPv4 アドレスの形式が無効な場合は、0 を返します。 構文
引数
  • string — IPv4 アドレス文字列。String
戻り値 IPv4アドレスを返します。無効な場合は 0 を返します。UInt32 例 無効なアドレスの例
Query
Response

IPv4StringToNumOrNull

導入バージョン: v22.3.0 32 ビット整数を、ドット区切りの 10 進表記 (A.B.C.D 形式) による IPv4 アドレスの文字列表現に変換します。IPv4 アドレスの形式が無効な場合は、NULL を返します。 構文
引数
  • string — IPv4 アドレス文字列。String
戻り値 IPv4 アドレスを返します。無効な場合は NULL を返します。Nullable(UInt32) 例 無効なアドレスの例
Query
Response

IPv4ToIPv6

導入バージョン: v1.1.0 (ビッグエンディアンの) 32ビット整数を IPv4 アドレスとして解釈し、さらにそれを対応する IPv6 アドレスとして FixedString(16) フォーマットで表します。 構文
引数
  • x — IPv4アドレス。UInt32
戻り値 バイナリ形式のIPv6アドレスを返します。FixedString(16) 例 使用例
Query
Response

IPv6CIDRToRange

導入バージョン: v20.1.0 IPv6 アドレスとその Classless Inter-Domain Routing (CIDR) のプレフィックス長を受け取り、そのサブネットのアドレス範囲を、サブネット内の最小アドレスと最大アドレスからなる 2 つの IPv6 値のタプルとして返します。 IPv4 版については IPv4CIDRToRange を参照してください。 構文
引数
  • ipv6 — IPv6 アドレス。IPv6 または String
  • cidr — CIDR 値。UInt8
戻り値 サブネットの範囲を表す 2 つの IPv6 アドレスからなるタプルを返します。Tuple(IPv6, IPv6) 例 使用例
Query
Response

IPv6NumToString

導入バージョン: v1.1.0 IPv6 アドレスをバイナリ形式 (FixedString(16)) から標準的なテキスト表現に変換します。 IPv4 マップド IPv6 アドレスは、::ffff:111.222.33.44 の形式で表示されます。 構文
別名: INET6_NTOA 引数 戻り値 テキスト形式の IPv6 アドレスを表す文字列を返します。String 例 使用例
Query
Response
hits を用いた IPv6 の分析
Query
Response
IPv6マップドIPv4アドレス
Query
Response

IPv6StringToNum

導入バージョン: v1.1.0 IPv6 アドレスを標準的なテキスト表現からバイナリ形式 (FixedString(16)) に変換します。 ::ffff:111.222.33.44. 形式の IPv4 マップド IPv6 アドレスを受け付けます。 IPv6 アドレスの形式が無効な場合は、例外が発生します。 入力文字列に有効な IPv4 アドレスが含まれている場合は、対応する IPv6 アドレスを返します。 HEX には大文字と小文字の両方を使用できます。 構文
別名: INET6_ATON 引数
  • string — IPv6 アドレスの文字列。String
戻り値 IPv6 アドレスをバイナリ形式で返します。FixedString(16) 例 基本例
Query
Response

IPv6StringToNumOrDefault

導入バージョン: v22.3.0 IPv6 アドレスを標準的なテキスト表現からバイナリ形式 (FixedString(16)) に変換します。 ::ffff:111.222.33.44. 形式の IPv4 マップド IPv6 アドレスを受け付けます。 IPv6 アドレスの形式が無効な場合は、デフォルト値 :: を返します。 構文
引数
  • string — IPv6 アドレスの文字列。String
戻り値 バイナリ形式の IPv6 アドレス。無効な場合は、ゼロで埋められた FixedString(16)。FixedString(16) 例 無効なアドレスの基本例
Query
Response

IPv6StringToNumOrNull

導入バージョン: v22.3.0 IPv6 アドレスを標準的なテキスト表現からバイナリ形式 (FixedString(16)) に変換します。 ::ffff:111.222.33.44. 形式の IPv4 マップド IPv6 アドレスを受け付けます。 IPv6 アドレスの形式が無効な場合は、NULL を返します。 構文
引数
  • string — IPv6 アドレスの文字列。String
戻り値 IPv6 アドレスをバイナリ形式で返します。無効な場合は NULL を返します。Nullable(FixedString(16)) 例 無効なアドレスを使った基本例
Query
Response

cutIPv6

導入バージョン: v1.1.0 IPv6 アドレスをバイナリ形式で格納した FixedString(16) 型の値を受け取ります。 指定したバイト数を取り除いたアドレスを、テキスト形式の文字列で返します。 構文
引数
  • x — バイナリ形式の IPv6 アドレス。FixedString(16) または IPv6
  • bytesToCutForIPv6 — IPv6 で切り取るバイト数。UInt8
  • bytesToCutForIPv4 — IPv4 で切り取るバイト数。UInt8
戻り値 指定したバイトを削除した、テキスト形式の IPv6 アドレスを含む文字列を返します。String 例 使用例
Query
Response

ipcryptDecrypt

導入バージョン: v26.10.0
この関数は実験的なものであり、今後のリリースで予測できない後方互換性のない方法で変更される可能性があります。 有効にするには enable_ipcrypt = 1 を設定してください。
ipcryptEncrypt で暗号化された IP アドレスを、暗号化時と同じ鍵を使用して復号します。 入力が IPv4/IPv6 の場合は IPv6 を返し、String型の入力の場合は String を返します (リファレンス実装と同様に、IPv4 マップドアドレスとなる結果は IPv4 形式のテキストとして出力されます) 。 構文
引数
  • encrypted_ip — 復号する暗号化済みIPアドレス。IPv4、IPv6、または String
  • key — 16バイトの暗号鍵 (raw bytes または32文字の16進数) 。定数である必要があります。String または FixedString
戻り値 復号されたIPアドレス。IPv4/IPv6の入力に対してはIPv6を、String型の入力に対してはStringを返します。IPv6 または String 例 暗号化して復号する往復変換
Query
Response

ipcryptEncrypt

導入バージョン: v26.10.0
この関数は実験的な機能であり、今後のリリースにおいて予測できない形で後方互換性のない方法で変更される可能性があります。 有効にするには enable_ipcrypt = 1 を設定してください。
16バイトの鍵を使用し、決定論的なフォーマット保持暗号化によって IP アドレスを暗号化します。 IPv4/IPv6 の入力に対しては IPv6 を返し、String型の入力に対しては String を返します (参照実装と同様に、IPv4 マップドの結果は IPv4 のテキスト形式で書き込まれます) 。 構文
引数
  • ip — 暗号化するIPアドレス。IPv4、IPv6、または String
  • key — 16バイトの暗号鍵 (raw bytes または16進数32文字) 。定数である必要があります。String または FixedString
戻り値 暗号化されたIPアドレス。入力がIPv4/IPv6の場合はIPv6を、String型の入力の場合はStringを返します。IPv6 または String 例 IPv4アドレスを暗号化する
Query
Response

ipcryptPrefixDecrypt

導入バージョン: v26.10.0
この関数は実験的なものであり、今後のリリースで予測できない形で後方互換性のない変更が加えられる可能性があります。 有効にするには enable_ipcrypt = 1 を設定してください。
ipcryptPrefixEncrypt で暗号化された IP アドレスを、同じ鍵を使用して復号します。 戻り値の型は入力と同じ種類になります。IPv4 の場合は IPv4、IPv6 の場合は IPv6 が返されます。 構文
引数
  • encrypted_ip — 復号対象の暗号化されたIPアドレス。IPv4、IPv6、または String
  • key — 32バイトの暗号鍵 (raw bytes または 64文字の16進数) 。定数である必要があります。String または FixedString
戻り値 復号されたIPアドレス。入力がIPv4の場合はIPv4、IPv6の場合はIPv6、Stringの場合はStringを返します。IPv4、IPv6、または String 例 プレフィックス保持暗号化から復号までの往復変換
Query
Response

ipcryptPrefixEncrypt

導入バージョン: v26.10.0
この関数は実験的な機能であり、今後のリリースで予期せず後方互換性のない方法で変更される可能性があります。 有効にするには enable_ipcrypt = 1 を設定してください。
32 バイトの鍵を用いたプレフィックス保持暗号化により、IP アドレスを暗号化します。 ネットワークプレフィックスが共通するアドレスは、暗号化後のアドレスも同じくプレフィックスが共通します。 戻り値の型は入力のクラスを保持します。IPv4 は IPv4 のまま、IPv6 は IPv6 のままとなります。 構文
引数
  • ip — 暗号化するIPアドレス。IPv4、IPv6、または String
  • key — 32バイトの暗号鍵 (raw bytes または64文字の16進数) 。定数である必要があります。String または FixedString
戻り値 暗号化されたIPアドレス。入力がIPv4の場合はIPv4、IPv6の場合はIPv6、Stringの場合はStringを返します。IPv4、IPv6、または String 例 IPv4のプレフィックス保持暗号化
Query
Response

isIPAddressInRange

導入バージョン: v21.4.0 IP アドレスが、Classless Inter-Domain Routing (CIDR) 表記のネットワークに含まれているかどうかを判定します。 この関数は、文字列として表された IPv4 と IPv6 の両方のアドレス (およびネットワーク) を受け取ります。アドレスの IP バージョンと CIDR が一致しない場合は、0 を返します。 構文
引数
  • address — IPv4 または IPv6 のアドレス。String
  • prefix — CIDR 形式の IPv4 または IPv6 ネットワークプレフィックス。String
戻り値 アドレスの IP バージョンと CIDR が一致する場合は 1、それ以外の場合は 0 を返します。UInt8 例 範囲内の IPv4 アドレス
Query
Response
範囲外のIPv4アドレス
Query
Response
範囲外のIPv6アドレス
Query
Response

isIPv4String

導入バージョン: v21.1.0 入力文字列が IPv4 アドレスかどうかを判定します。 IPv6 版については、isIPv6Stringを参照してください。 構文
引数
  • string — 判定対象の IP アドレス文字列。String
戻り値 string が IPv4 アドレスの場合は 1、それ以外の場合は 0 を返します。UInt8 例 使用例
Query
Response

isIPv6String

導入バージョン: v21.1.0 入力文字列が IPv6 アドレスかどうかを判定します。 IPv4 版については isIPv4String を参照してください。 構文
引数
  • string — 確認対象の IP アドレス文字列。String
戻り値 string が IPv6 アドレスの場合は 1、それ以外の場合は 0 を返します。UInt8 例 使用例
Query
Response

toIPv4

導入バージョン: v20.1.0 IPv4 アドレスを表す文字列、または IPv4 アドレスの UInt32 形式を IPv4 型に変換します。 IPv4StringToNum 関数および IPv4NumToString 関数に似ていますが、入力引数として文字列型と符号なし整数型の両方をサポートしています。 構文
引数 戻り値 IPv4 アドレスを返します。IPv4 例 使用例
Query
Response
IPv4StringToNum 関数および IPv4NumToString 関数との比較
Query
Response
整数値からの変換
Query
Response

toIPv4OrDefault

導入バージョン: v22.3.0 IPv4 アドレスの文字列、または IPv4 アドレスを表す UInt32 形式の値を IPv4 型に変換します。 IPv4 アドレスのフォーマットが無効な場合は、0.0.0.0 (IPv4 の 0) または指定されたデフォルトの IPv4 アドレスを返します。 構文
引数
  • string — 変換対象の IP アドレス文字列。String
  • default — 任意。string が無効な IPv4 アドレスの場合に返す値。IPv4
戻り値 文字列から変換された IPv4 アドレス、または変換に失敗した場合はデフォルト値を返します。IPv4 例 有効な IPv4 文字列と無効な IPv4 文字列
Query
Response

toIPv4OrNull

導入バージョン: v22.3.0 入力値を IPv4 型の値に変換します。エラーが発生した場合は NULL を返します。 toIPv4 と同様ですが、変換エラー時に例外を発生させる代わりに NULL を返します。 サポートされる引数:
  • ドット区切りの 10 進表記による IPv4 アドレスの文字列表現。
  • IPv4 アドレスの整数表現。
サポートされない引数 (NULL を返します) :
  • 無効な IP アドレス形式。
  • IPv6 アドレス。
  • 範囲外の値。
  • 形式が不正なアドレス。
構文
引数
  • x — IPv4 アドレスを表す文字列または整数形式の値。String または Integer
戻り値 成功した場合は IPv4 アドレスを返し、失敗した場合は NULL を返します。IPv4 または NULL 例 使用例
Query
Response

toIPv4OrZero

導入バージョン: v23.1.0 入力値を IPv4 型の値に変換しますが、エラー時にはゼロの IPv4 アドレスを返します。 toIPv4 と同様ですが、変換エラー時に例外を発生させる代わりに、ゼロの IPv4 アドレス (0.0.0.0) を返します。 サポートされる引数:
  • ドット区切りの 10 進表記による IPv4 アドレスの文字列表現。
  • IPv4 アドレスの整数表現。
サポートされない引数 (ゼロの IPv4 アドレスを返します) :
  • 無効な IP アドレスのフォーマット。
  • IPv6 アドレス。
  • 範囲外の値。
構文
引数
  • x — IPv4 アドレスを表す文字列または整数。String または Integer
戻り値 成功した場合は IPv4 アドレスを返し、失敗した場合はゼロの IPv4 アドレス (0.0.0.0) を返します。IPv4 例 使用例
Query
Response

toIPv6

導入バージョン: v20.1.0 文字列、または IPv6 アドレスを表す UInt128 形式の値を IPv6 型に変換します。 文字列の場合、IPv6 アドレスの形式が無効であれば、空の値を返します。 IPv6 アドレスをバイナリ形式 (つまり FixedString(16)) との間で相互変換する IPv6StringToNum 関数および IPv6NumToString 関数と似ています。 入力文字列に有効な IPv4 アドレスが含まれている場合は、その IPv4 アドレスに対応する IPv6 表現が返されます。 構文
引数 戻り値 IPv6 アドレスを返します。IPv6 例 使用例
Query
Response
IPv4からIPv6へのマッピング
Query
Response

toIPv6OrDefault

導入バージョン: v22.3.0 文字列または IPv6 アドレスの UInt128 形式を IPv6 型に変換します。 IPv6 アドレスの形式が無効な場合は、:: (0 IPv6) または指定したデフォルトの IPv6 を返します。 構文
Arguments
  • string — 変換する IP アドレス文字列。 - default — 任意。string のフォーマットが無効な場合に返す値です。
戻り値 IPv6 アドレスを返します。引数 string のフォーマットが無効な場合は、:: または指定された任意のデフォルト値を返します。IPv6 Examples 有効な IPv6 文字列と無効な IPv6 文字列
Query
Response

toIPv6OrNull

導入バージョン: v22.3.0 入力値を IPv6 型の値に変換します。エラーが発生した場合は NULL を返します。 toIPv6 と同様ですが、変換エラー時に例外を発生させる代わりに NULL を返します。 サポートされる引数:
  • 標準表記の IPv6 アドレスの文字列表現。
  • IPv4 アドレスの文字列表現 (IPv4 マップド IPv6 に変換されます) 。
  • IPv6 アドレスのバイナリ表現。
サポートされない引数 (NULL を返します) :
  • 無効な IP アドレス形式。
  • 不正な形式の IPv6 アドレス。
  • 範囲外の値。
  • 無効な表記。
構文
引数
  • x — IPv6 または IPv4 アドレスの文字列表現。String
戻り値 成功した場合は IPv6 アドレスを返し、失敗した場合は NULL を返します。IPv6 または NULL 例 使用例
Query
Response

toIPv6OrZero

導入バージョン: v23.1.0 入力値を IPv6 型の値に変換します。エラーが発生した場合は、ゼロ IPv6 アドレスを返します。 toIPv6 と似ていますが、変換エラー時に例外を発生させる代わりに、ゼロ IPv6 アドレス (::) を返します。 サポートされる引数:
  • 標準表記の IPv6 アドレスの文字列表現。
  • IPv4 アドレスの文字列表現 (IPv4 マップド IPv6 に変換されます) 。
  • IPv6 アドレスのバイナリ表現。
サポートされない引数 (ゼロ IPv6 を返します) :
  • 無効な IP アドレス形式。
  • 不正な形式の IPv6 アドレス。
  • 範囲外の値。
構文
引数
  • x — IPv6 または IPv4 アドレスの文字列表現。String
戻り値 成功した場合は IPv6 アドレスを返し、失敗した場合はゼロ IPv6 アドレス (::) を返します。IPv6 例 使用例
Query
Response