Список функций, предоставляемых модулем intarray, приведен в таблице Таблица F.9, операторы - в таблице Таблица F.10.

Операторы &&, @> и <@ эквивалентны встроенным операторам с теми же именами в Tantor BE, за исключением того, что они работают только с целочисленными массивами, не содержащими пустых значений, в то время как встроенные операторы работают с любым типом массива. Это ограничение делает их во многих случаях быстрее встроенных операторов.

Операторы @@ и ~~ проверяют, удовлетворяет ли массив запросу, который выражается в виде значения специализированного типа данных query_int. Запрос состоит из целочисленных значений, которые проверяются на соответствие элементам массива, возможно, с использованием операторов & (И), | (ИЛИ) и ! (Не). Можно использовать скобки по необходимости. Например, запрос 1&(2|3) соответствует массивам, содержащим 1 и также содержащим либо 2, либо 3.

intarray обеспечивает поддержку индексов для операторов &&, @> и @@, а также для обычного сравнения массивов.

Доступны два класса операторов индекса GiST с параметрами: gist__int_ops (используется по умолчанию) подходит для небольших и средних наборов данных, в то время как gist__intbig_ops использует более крупную сигнатуру и более подходит для индексации больших наборов данных (т.е. столбцов, содержащих большое количество отдельных значений массива). Реализация использует структуру данных RD-дерева с встроенным потерянным сжатием.

gist__int_ops приближает целочисленное множество в виде массива целочисленных диапазонов. Его необязательный целочисленный параметр numranges определяет максимальное количество диапазонов в одном ключе индекса. Значение по умолчанию для numranges равно 100. Допустимые значения находятся в диапазоне от 1 до 253. Использование более крупных массивов в качестве ключей индекса GiST приводит к более точному поиску (сканирование меньшей доли индекса и меньшее количество страниц кучи), но требует большего размера индекса.

gist__intbig_ops приближает целое множество в виде битовой подписи. Его необязательный целочисленный параметр siglen определяет длину подписи в байтах. По умолчанию длина подписи составляет 16 байт. Допустимые значения длины подписи находятся в диапазоне от 1 до 2024 байт. Более длинные подписи обеспечивают более точный поиск (сканирование меньшей доли индекса и меньшее количество страниц кучи), но требуют большего объема индекса.

Также существует нестандартный класс операторов GIN gin__int_ops, который поддерживает эти операторы, а также <@.

Выбор между индексированием GiST и GIN зависит от относительных характеристик производительности GiST и GIN, которые обсуждаются в другом месте.

-- a message can be in one or more “sections”
CREATE TABLE message (mid INT PRIMARY KEY, sections INT[], ...);

-- create specialized index with signature length of 32 bytes
CREATE INDEX message_rdtree_idx ON message USING GIST (sections gist__intbig_ops (siglen = 32));

-- select messages in section 1 OR 2 - OVERLAP operator
SELECT message.mid FROM message WHERE message.sections && '{1,2}';

-- select messages in sections 1 AND 2 - CONTAINS operator
SELECT message.mid FROM message WHERE message.sections @> '{1,2}';

-- the same, using QUERY operator
SELECT message.mid FROM message WHERE message.sections @@ '1&2'::query_int;

Каталог исходного кода contrib/intarray/bench содержит набор тестов производительности, который можно запустить на установленном сервере Tantor BE. (Также требуется установка DBD::Pg). Для запуска:

cd .../contrib/intarray/bench
createdb TEST
psql -c "CREATE EXTENSION intarray" TEST
./create_test.pl | psql TEST
./bench.pl

Скрипт bench.pl имеет множество параметров, которые отображаются при его запуске без аргументов.

Всю работу выполнили Федор Сигаев (<teodor@sigaev.ru>) и Олег Бартунов (<oleg@sai.msu.su>). Дополнительную информацию можно найти на странице http://www.sai.msu.su/~megera/postgres/gist/. Андрей Октябрьский внес большой вклад в добавление новых функций и операций.