Ubuntuにインストール

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

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

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

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

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

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

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

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

$ sudo apt install -y software-properties-common
$ sudo add-apt-repository -y universe
$ sudo add-apt-repository -y ppa:groonga/ppa
$ sudo apt update
Ubuntu 20.04:
$ sudo apt install -y -V postgresql-12-pgroonga
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

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

$ 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 software-properties-common
$ sudo add-apt-repository -y universe
$ sudo add-apt-repository -y ppa:groonga/ppa
$ sudo apt install -y wget lsb-release
$ 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
$ echo "deb http://apt.postgresql.org/pub/repos/apt/ $(lsb_release --codename --short)-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
$ wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
$ sudo apt update
$ sudo apt install -y -V postgresql-17-pgdg-pgroonga

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

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

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

$ 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についてもっと理解できるはずです。