Ubuntuにインストール

このドキュメントはUbuntuにPGroongaをインストールする方法を説明します。

サポートしているバージョン

サポートしているUbuntuのバージョンは次の通りです。

システムのPostgreSQL用のインストール方法

UbuntuでシステムのPostgreSQL用にPGroongaをインストールする手順は次の通りです。

Ubuntu 22.04を使っている場合はpostgresql-14-pgroongaパッケージをインストールしてください。

Ubuntu 24.04を使っている場合はpostgresql-16-pgroongaパッケージをインストールしてください。

$ sudo apt install -y -V ca-certificates lsb-release wget
$ wget https://packages.groonga.org/ubuntu/groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ sudo apt install -y -V ./groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ rm -f groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ sudo apt update
Ubuntu 22.04:
$ sudo apt install -y -V postgresql-14-pgroonga
Ubuntu 24.04:
$ sudo apt install -y -V postgresql-16-pgroonga

MeCabベースのトークナイザーを使いたい場合は、groonga-tokenizer-mecabパッケージもインストールする必要があります。

$ sudo apt install -y -V groonga-tokenizer-mecab

セマンティックサーチ用に、<&@*>演算子 または、 &@*演算子を使いたい場合は、groonga-plugin-language-modelパッケージもインストールする必要があります。

$ sudo apt install -y -V groonga-plugin-language-model

データベースを作成します。

$ sudo -u postgres -H psql --command 'CREATE DATABASE pgroonga_test'

（通常はpgroonga_testデータベース用のユーザーを作ってそのユーザーを利用するべきです。詳細はGRANT USAGE ON SCHEMA pgroongaを参照してください。）

作成したデータベースに接続し、CREATE EXTENSION pgroongaを実行します。

$ sudo -u postgres -H psql -d pgroonga_test --command 'CREATE EXTENSION pgroonga'

これで終わりです！

チュートリアルを試してください。PGroongaについてもっと理解できるはずです。

公式PostgreSQL用のインストール方法

UbuntuでPostgreSQL Global Development Groupが提供するPostgreSQLパッケージ用にPGroongaをインストールする手順は次の通りです。

$ sudo apt install -y -V ca-certificates lsb-release wget
$ wget https://packages.groonga.org/ubuntu/groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ sudo apt install -y -V ./groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ rm -f groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ sudo apt install -y postgresql-common
$ sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh -y
$ sudo apt install -y -V postgresql-18-pgdg-pgroonga

MeCabベースのトークナイザーを使いたい場合は、groonga-tokenizer-mecabパッケージもインストールする必要があります。

$ sudo apt install -y -V groonga-tokenizer-mecab

セマンティックサーチ用に、<&@*>演算子 または、 &@*演算子を使いたい場合は、groonga-plugin-language-modelパッケージもインストールする必要があります。

$ sudo apt install -y -V groonga-plugin-language-model

データベースを作成します。

$ sudo -u postgres -H psql --command 'CREATE DATABASE pgroonga_test'

（通常はpgroonga_testデータベース用のユーザーを作ってそのユーザーを利用するべきです。詳細はGRANT USAGE ON SCHEMA pgroongaを参照してください。）

作成したデータベースに接続し、CREATE EXTENSION pgroongaを実行します。

$ sudo -u postgres -H psql -d pgroonga_test --command 'CREATE EXTENSION pgroonga'

これで終わりです！

チュートリアルを試してください。PGroongaについてもっと理解できるはずです。