ip4r

前提条件

この拡張機能は、次のエンジンを実行するPolarDB for PostgreSQL (Compatible with Oracle) クラスターでサポートされています。

• PolarDB for PostgreSQL (Oracle互換) 2.0 (バージョン2.0.14.13.0以降)

• PolarDB for PostgreSQL (Oracle互換) 1.0 (バージョン1.1.36以降)

SHOW polar_version;

概要

ip4rは、 PolarDB for PostgreSQL (Oracle互換) でサポートされているサードパーティの拡張機能です。 IPv4またはIPv6アドレスを格納するデータ型を提供します。 PostgreSQLによって提供されるinet /cidrデータ型とは異なり、ip4r拡張機能は、クエリが >>= (contains or equals) 演算子を使用する場合にインデックススキャンをサポートします。 さらに、ip4r拡張機能には、組み込みのネットワークアドレスタイプのPostgreSQLよりも次の利点があります。

• セマンティックオーバーロードが少ない: ネットブロックと特定のIPアドレスを処理するための特殊なデータ型を提供します。

• オーバーヘッドの削減: PostgreSQLは可変長のデータ型を使用して、IPv6アドレスとIPv4アドレスの両方を格納します。 これにより、IPv4アドレスのみを含むユースケースでは、大きなオーバーヘッドが発生します。 ip4r拡張機能は、IPv4またはIPv6アドレスに合わせた固定長データ型を提供します。

データ型

ip4rは、IPv4およびIPv6アドレスを格納および表すための幅広いデータ型を提供します。

単一IPアドレスのデータ型と型変換

単一のIPアドレスを格納するには、次の3つのデータ型が使用されます。

• ip4: nnn.nnn.nnn.nnnの形式で入力を受け付けます。 IPアドレスを32ビットの符号なし整数として格納します。

• ip6: IPv6アドレスの標準16進表現の形式で入力を受け付けます。 IPアドレスを2つの64ビット値として格納します。

• ipaddress: ip4またはip6のいずれかで有効な入力を受け入れます。

次の表に、ip4rの上記3つの型の型変換を示します。

ネットブロックのデータ型と型変換

ネットブロックの格納には、次の3つのデータ型が使用されます。

• ip4r: 192.0.2.100-192.0.2.200などのIPv4ネットブロックを格納するために使用されます。 また、192.0.2.0/24などのCIDRブロックの形式で入力を受け付けます。これは192.0.2.0-192.0.2.255に相当します。

• ip6r: 2001::1234-2001::2000:0000などのIPv6ネットブロックを格納するために使用されます。 また、2001::/112などのCIDRブロックの形式で入力を受け付けます。これは、2001::-2001::ffffに相当します。

• iprange: ip4rまたはip6rのいずれかで有効な入力を受け入れます。

次の表に、ip4rの上記3つの型の型変換を示します。

使用法

ip4r拡張子の作成

CREATE EXTENSION ip4r;

テストテーブルの作成とテーブルへのデータのインポート

CREATE TABLE ipranges (r iprange, r4 ip4r, r6 ip6r);
INSERT INTO ipranges
    SELECT r, null, r
    FROM (
        SELECT ip6r(regexp_replace(ls, E'(....(?!$))', E'\\1:', 'g')::ip6,
               regexp_replace(substring(ls FOR n + 1) || substring(us FROM n + 2),
               E'(....(?!$))', E'\\1:', 'g')::ip6) AS r
        FROM (
            SELECT md5(i || ' lower 1') AS ls,
                   md5(i || ' upper 1') AS us,
                   (i % 11) + (i/11 % 11) + (i/121 % 11) AS n
            FROM generate_series(1,13310) i) s1) s2;

GiSTインデックスの作成

CREATE INDEX ipranges_r ON ipranges USING gist (r);

>>= (contains or equals) 演算子を使用する

EXPLAIN (COSTS OFF) SELECT * FROM ipranges WHERE r >>= '5555::' ORDER BY r;
                     QUERY PLAN
-----------------------------------------------------
 Sort
   Sort Key: r
   ->  Bitmap Heap Scan on ipranges
         Recheck Cond: (r >>= '5555::'::iprange)
         ->  Bitmap Index Scan on ipranges_r
               Index Cond: (r >>= '5555::'::iprange)
(6 rows)

拡張機能を削除するRemove the extension

DROP EXTENSION ip4r;