↑↓ select ↵ open ⌫ change scope Open full search

PG.CENTER connects PostgreSQL documentation, reference, and ecosystem knowledge. Maintained by Pigsty.

Wiki / Operator Families / B-tree classes

btree/int8_ops (class)

B-tree operator class for int8; member of integer_ops.

Reading PostgreSQL 18.6.

Description

B-tree operator class for int8; member of integer_ops.

Object kind
Operator class
Index AM
B-tree
Input type
int8
Stored key type
Same as input type (catalog zero)
Default class
yes

Usage

btree/int8_ops

Operator classes and families

An index definition can specify an operator class for each column of an index.

The operator class identifies the operators to be used by the index for that column. For example, a B-tree index on the type int4 would use the int4_ops class; this operator class includes comparison functions for values of type int4 . In practice the default operator class for the column's data type is usually sufficient. The main reason for having operator classes is that for some data types, there could be more than one meaningful index behavior. For example, we might want to sort a complex-number data type either by absolute value or by real part. We could do this by defining two operator classes for the data type and then selecting the proper class when making an index. The operator class determines the basic sort ordering (which can then be modified by adding sort options COLLATE , ASC / DESC and/or NULLS FIRST / NULLS LAST ).

There are also some built-in operator classes besides the default ones:

Family operator strategies

Operator overloadStrategyPurposeOrdering familyMembership scopeSource description
<(int2,int2)1searchFamily memberless than
<=(int2,int2)2searchFamily memberless than or equal
=(int2,int2)3searchFamily memberequal
>=(int2,int2)4searchFamily membergreater than or equal
>(int2,int2)5searchFamily membergreater than
<(int2,int4)1searchFamily memberless than
<=(int2,int4)2searchFamily memberless than or equal
=(int2,int4)3searchFamily memberequal
>=(int2,int4)4searchFamily membergreater than or equal
>(int2,int4)5searchFamily membergreater than
<(int2,int8)1searchFamily memberless than
<=(int2,int8)2searchFamily memberless than or equal
=(int2,int8)3searchFamily memberequal
>=(int2,int8)4searchFamily membergreater than or equal
>(int2,int8)5searchFamily membergreater than
<(int4,int4)1searchFamily memberless than
<=(int4,int4)2searchFamily memberless than or equal
=(int4,int4)3searchFamily memberequal
>=(int4,int4)4searchFamily membergreater than or equal
>(int4,int4)5searchFamily membergreater than
<(int4,int2)1searchFamily memberless than
<=(int4,int2)2searchFamily memberless than or equal
=(int4,int2)3searchFamily memberequal
>=(int4,int2)4searchFamily membergreater than or equal
>(int4,int2)5searchFamily membergreater than
<(int4,int8)1searchFamily memberless than
<=(int4,int8)2searchFamily memberless than or equal
=(int4,int8)3searchFamily memberequal
>=(int4,int8)4searchFamily membergreater than or equal
>(int4,int8)5searchFamily membergreater than
<(int8,int8)1searchClass input pairless than
<=(int8,int8)2searchClass input pairless than or equal
=(int8,int8)3searchClass input pairequal
>=(int8,int8)4searchClass input pairgreater than or equal
>(int8,int8)5searchClass input pairgreater than
<(int8,int2)1searchFamily memberless than
<=(int8,int2)2searchFamily memberless than or equal
=(int8,int2)3searchFamily memberequal
>=(int8,int2)4searchFamily membergreater than or equal
>(int8,int2)5searchFamily membergreater than
<(int8,int4)1searchFamily memberless than
<=(int8,int4)2searchFamily memberless than or equal
=(int8,int4)3searchFamily memberequal
>=(int8,int4)4searchFamily membergreater than or equal
>(int8,int4)5searchFamily membergreater than

Family support functions

Support numberLeft typeRight typeFunction signatureResult type
1int2int2btint2cmp(int2,int2)int4
2int2int2btint2sortsupport(internal)void
4int2int2btequalimage(oid)bool
6int2int2btint2skipsupport(internal)void
1int2int4btint24cmp(int2,int4)int4
1int2int8btint28cmp(int2,int8)int4
3int2int8in_range(int2,int2,int8,bool,bool)bool
3int2int4in_range(int2,int2,int4,bool,bool)bool
3int2int2in_range(int2,int2,int2,bool,bool)bool
1int4int4btint4cmp(int4,int4)int4
2int4int4btint4sortsupport(internal)void
4int4int4btequalimage(oid)bool
6int4int4btint4skipsupport(internal)void
1int4int8btint48cmp(int4,int8)int4
1int4int2btint42cmp(int4,int2)int4
3int4int8in_range(int4,int4,int8,bool,bool)bool
3int4int4in_range(int4,int4,int4,bool,bool)bool
3int4int2in_range(int4,int4,int2,bool,bool)bool
1int8int8btint8cmp(int8,int8)int4
2int8int8btint8sortsupport(internal)void
4int8int8btequalimage(oid)bool
6int8int8btint8skipsupport(internal)void
1int8int4btint84cmp(int8,int4)int4
1int8int2btint82cmp(int8,int2)int4
3int8int8in_range(int8,int8,int8,bool,bool)bool

Classes in this family

ClassInput typeKey typeDefault
int2_opsint2Same as input typeyes
int4_opsint4Same as input typeyes
int8_opsint8Same as input typeyes

Related entries

Documentation and source

Source build
Version
18.6
Build
https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
Source fingerprint
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f

Compare versions

PostgreSQL 12 → 13: changed.

--- PostgreSQL 12
+++ PostgreSQL 13
@@ -657,6 +657,33 @@
       "number": "3",
       "result_type": "bool",
       "right_type": "int8"
+    },
+    {
+      "family": "integer_ops",
+      "function": "btequalimage(oid)",
+      "left_type": "int2",
+      "method": "btree",
+      "number": "4",
+      "result_type": "bool",
+      "right_type": "int2"
+    },
+    {
+      "family": "integer_ops",
+      "function": "btequalimage(oid)",
+      "left_type": "int4",
+      "method": "btree",
+      "number": "4",
+      "result_type": "bool",
+      "right_type": "int4"
+    },
+    {
+      "family": "integer_ops",
+      "function": "btequalimage(oid)",
+      "left_type": "int8",
+      "method": "btree",
+      "number": "4",
+      "result_type": "bool",
+      "right_type": "int8"
     }
   ]
 }

Compares recorded interfaces and attributes. Source fingerprints and build metadata are excluded; an absent sample is not proof of the introduction or removal release.

Related entries

Export JSON · Back to Operator Families · Recorded in PostgreSQL 10 through 20; the first sample is not necessarily its introduction.