PostgreSQL
ローカルPostgreSQLデータベースのセットアップ
概要
このページでは、PostgreSQLデータベースサーバーとpsqlコマンドラインクライアントをインストールおよび構成する方法について説明します。このガイドでは、これらのコンポーネントをローカルアクセス用にコンピューターにインストールしてセットアップする方法について説明します。
このガイドでは、以下のプラットフォームについて説明します。
使用するプラットフォームに一致するセクションに移動してください。
PostgreSQLデータベースを構築したら、JavaScriptまたはTypeScriptアプリケーション内からPrisma Clientを使用して管理できます。PostgreSQL入門ガイドを試して始めてみましょう。
WindowsでのPostgreSQLのセットアップ
PostgreSQLプロジェクトは、データベースをインストールおよび構成するためのネイティブWindowsインストーラーを提供しています。
PostgreSQL Windowsインストールページにアクセスして、インストーラーへのリンクを見つけてください。ページの先頭にあるDownload the installerをクリックしてください。
次のページで、Windows x86-64またはWindows x86-32の列（コンピューターのアーキテクチャによる）で、インストールしたいPostgreSQLのバージョンを選択してください。
選択したバージョンのDownloadをクリックし、ファイルを便利な場所に保存してください。
ダウンロードが完了したら、ファイルをダブルクリックしてインストーラーを実行します（プログラムがコンピューターに変更を加えることを許可するかどうかを確認する必要がある場合があります）。
最初のページでNextをクリックして、インストールの設定を開始します。
次のページで、インストールディレクトリを選択します。
デフォルトの場所を承認するためにNextをクリックしてください。
次のページでは、インストールしたいコンポーネントを選択できます。最低でもPostgreSQL ServerとCommand Line Toolsが選択されている必要があります。
Nextをクリックして続行してください。
次に、データベースデータファイルを保存する場所を選択します。
デフォルトの場所を承認するためにNextをクリックしてください。
次に、PostgreSQLのスーパーユーザー（postgresという名前）の管理者パスワードを選択し、確認します。
完了したらNextをクリックしてください。
サーバーがリッスンするポートを選択します。
デフォルトの5432ポートを承認するためにNextをクリックしてください。
次に、データベースが使用するロケールを選択します。
コンピューターのデフォルトロケールを使用するためにNextをクリックしてください。
これでインストールの構成部分は完了です。選択した内容の概要を確認できます。
すべてが正しければ、Nextをクリックしてください。
最後に、PostgreSQLをインストールする準備ができました。
Nextをクリックしてインストールプロセスを開始してください。
インストールが完了したら、psqlコマンドラインツールを使用してインストールを検証できます。
スタートメニューでpsqlと入力し、ツールをクリックしてプログラムを起動します。使用したい接続詳細の入力を求められます。
角括弧で囲まれたデフォルトの選択を受け入れるには、Enterを押します。最後のプロンプトは、セットアップ中に設定したpostgresユーザーのパスワードになります。
認証に成功すると、データベースとのインタラクティブなpsqlセッションに入ります。
完了したら、以下を入力してセッションを終了します。
macOSでのPostgreSQLのセットアップ
PostgreSQLプロジェクトは、データベースをインストールおよび構成するためのネイティブmacOSインストーラーを提供しています。
PostgreSQL macOSインストールページにアクセスして、インストーラーへのリンクを見つけてください。Interactive Installer by EnterpriseDBセクションの冒頭にあるDownload the installerをクリックしてください。
次のページで、Mac OS Xの列で、インストールしたいPostgreSQLのバージョンを選択してください。
選択したバージョンのDownloadをクリックし、ファイルを便利な場所に保存してください。
ダウンロードが完了したら、ダウンロードフォルダにあるPostgreSQLインストーラーDMGを見つけてください。ダウンロードしたDMGファイルをダブルクリックして、インストーラーアーカイブをマウントしてください。
マウントされたアーカイブで、PostgreSQLインストーラーパッケージをクリックします（パッケージがコンピューターに変更を加えることを許可するかどうかを確認するプロンプトが表示される場合があります）。
PostgreSQLインストーラーがウェルカム画面で開きます。
最初のページでNextをクリックして、インストールの設定を開始します。
次のページで、インストールディレクトリを選択します。
デフォルトの場所を承認するためにNextをクリックしてください。
次のページでは、インストールしたいコンポーネントを選択できます。最低でもPostgreSQL ServerとCommand Line Toolsが選択されている必要があります。
Nextをクリックして続行してください。
次に、データベースデータファイルを保存する場所を選択します。
デフォルトの場所を承認するためにNextをクリックしてください。
次のページで、PostgreSQLスーパーユーザー（postgresという名前）の管理者パスワードを選択し、確認します。
完了したらNextをクリックしてください。
次のページでは、サーバーがリッスンするポートを選択できます。
デフォルトの5432ポートを承認するためにNextをクリックしてください。
次に、データベースが使用するロケールを選択します。
コンピューターのデフォルトロケールを使用するためにNextをクリックしてください。
これでインストールの構成部分は完了です。選択した内容の概要を確認できます。
すべてが正しければ、Nextをクリックしてください。
PostgreSQLをインストールする準備ができました。
Nextをクリックしてインストールプロセスを開始してください。
プロセスが完了すると、インストーラーは完了を確認します。
PostgreSQLがインストールされたので、psqlコマンドラインツールを使用してインストールを検証できます。このクライアントはインストールされていますが、簡単にアクセスできるようにターミナルのPATH変数を変更する必要があります。
まず、新しいターミナルウィンドウを開きます。次に、以下を入力してPostgreSQLのbinディレクトリを見つけます。
応答はPostgreSQLのbinディレクトリのパスになります。例えば：
使用するディレクトリがわかったので、以下を入力して/etc/pathsファイルを編集します。
続行するには、コンピューターの管理者パスワードの入力を求められます。
見つけたbinディレクトリへのパスをファイルの末尾に追加します。
完了したら、CTL-X、Yと入力し、ENTERを押してファイルを保存し、閉じます。
新しいPATH設定を使用するには、新しいターミナルウィンドウを開きます。新しいウィンドウで、以下を入力します。
PostgreSQLの設定プロセス中に設定したpostgresユーザーの管理者パスワードの入力を求められます。
認証に成功すると、データベースとのインタラクティブなpsqlセッションに入ります。
終了したら、以下を入力してセッションを終了します。
LinuxでのPostgreSQLのセットアップ
インストール方法は、使用しているLinuxディストリビューションによって異なります。以下の、ご使用のLinuxディストリビューションに該当するセクションに従ってください。
DebianとUbuntu
PostgreSQLのバージョンは、ディストリビューションのデフォルトリポジトリで利用可能なものを使用するか、PostgreSQLプロジェクトが提供するリポジトリを使用するかを選択できます。デフォルトリポジトリのパッケージは、ディストリビューション向けに提供される他のすべてのソフトウェアと連携するようにテストされていますが、古い場合があります。PostgreSQLプロジェクトのパッケージはより新しいですが、追加の設定が必要になる場合があります。
DebianまたはUbuntuのデフォルトリポジトリを使用してインストールする
UbuntuとDebianの両方で、PostgreSQLサーバーのバージョンがデフォルトのリポジトリ内のパッケージとして提供されています。PostgreSQLのバージョンはPostgreSQLウェブサイトで見られるものより古いかもしれませんが、これらのディストリビューションにインストールする最も簡単な方法です。
PostgreSQLサーバーをインストールするには、コンピューターのローカルパッケージキャッシュを最新のパッケージセットで更新します。その後、postgresqlパッケージをインストールします。
デフォルトでは、PostgreSQLはピア認証を使用するように設定されており、これにより、オペレーティングシステムのユーザー名がPostgreSQLの内部名と一致する場合にユーザーがログインできます。
インストールプロセスにより、postgresデータベースの管理アカウントと一致するpostgresというオペレーティングシステムユーザーが作成されました。psqlクライアントでPostgreSQLにログインするには、sudoを使用してpostgresユーザーとしてコマンドを実行します。
完了したら、以下を入力してpsqlセッションを終了できます。
PostgreSQLプロジェクトのDebianおよびUbuntuリポジトリを使用してインストールする
より最新のPostgreSQLバージョンが必要な場合は、Linuxディストリビューションが提供するリポジトリの代わりに、PostgreSQLプロジェクトが管理するリポジトリを使用できます。
まず、以下を入力してシステムに新しいリポジトリ定義を追加します。
次に、新しいリポジトリのパッケージを信頼するように、PostgreSQLパッケージ署名キーをaptに追加します。
リポジトリがセットアップされたら、ローカルパッケージインデックスを更新し、PostgreSQLをインストールできます。
デフォルトでは、PostgreSQLはピア認証を使用するように設定されており、これにより、オペレーティングシステムのユーザー名がPostgreSQLの内部名と一致する場合にユーザーがログインできます。
インストールプロセスにより、postgresデータベースの管理アカウントと一致するpostgresというオペレーティングシステムユーザーが作成されました。psqlクライアントでPostgreSQLにログインするには、sudoを使用してpostgresユーザーとしてコマンドを実行します。
完了したら、以下を入力してpsqlセッションを終了できます。
CentOSとFedora
PostgreSQLのバージョンは、ディストリビューションのデフォルトリポジトリで利用可能なものを使用するか、PostgreSQLプロジェクトが提供するリポジトリを使用するかを選択できます。デフォルトリポジトリのパッケージは、ディストリビューション向けに提供される他のすべてのソフトウェアと連携するようにテストされていますが、古い場合があります。PostgreSQLプロジェクトのパッケージはより新しいですが、追加の設定が必要になる場合があります。
CentOSまたはFedoraのデフォルトリポジトリを使用してインストールする
CentOSとFedoraの両方で、PostgreSQLサーバーのバージョンがデフォルトのリポジトリ内のパッケージとして提供されています。PostgreSQLのバージョンはPostgreSQLウェブサイトで見られるものより古いかもしれませんが、これらのディストリビューションにインストールする最も簡単な方法です。
PostgreSQLサーバーをインストールするには、ディストリビューションのパッケージマネージャーを使用してmysql-serverパッケージをインストールします。
CentOSの場合は、yumパッケージマネージャーを使用します。
Fedoraの場合は、dnfパッケージマネージャーを使用します。
MySQLパッケージがインストールされたら、以下を入力してデータベースを初期化します。
その後、以下を入力してサービスを起動します。
オプションとして、以下を入力して起動時にPostgreSQLを自動的に開始することもできます。
デフォルトでは、PostgreSQLはピア認証を使用するように設定されており、これにより、オペレーティングシステムのユーザー名がPostgreSQLの内部名と一致する場合にユーザーがログインできます。
インストールプロセスにより、postgresデータベースの管理アカウントと一致するpostgresというオペレーティングシステムユーザーが作成されました。psqlクライアントでPostgreSQLにログインするには、sudoを使用してpostgresユーザーとしてコマンドを実行します。
完了したら、以下を入力してpsqlセッションを終了できます。
PostgreSQLプロジェクトのCentOSおよびFedoraリポジトリを使用してインストールする
より最新のPostgreSQLバージョンが必要な場合は、Linuxディストリビューションが提供するリポジトリの代わりに、PostgreSQLプロジェクトが管理するリポジトリを使用できます。
PostgreSQLプロジェクトのリポジトリを構成するには、端末でリポジトリセットアップパッケージをダウンロードしてインストールします。
CentOSの場合は、以下のコマンドを実行します。
Fedoraの場合は、このコマンドを使用します。
CentOS 8を使用している場合は、システムのPostgreSQLモジュールを無効にして、リポジトリのPostgreSQLバージョンと競合しないようにする必要があります。これを行うには、次のように入力します。
次に、対象とするPostgreSQLのバージョンを選択します。
CentOSの場合、以下を入力して利用可能なPostgreSQLのバージョンを確認します。
Fedoraの場合は、dnfパッケージマネージャーを使用します。
使用するバージョンを決定したら、パッケージマネージャーを使用してインストールできます。
CentOSの場合はyumパッケージマネージャーを使用します。例えば、PostgreSQL 12をインストールするには、以下を入力します。
Fedoraの場合はdnfパッケージマネージャーを使用します。例えば、PostgreSQL 12をインストールするには、以下を入力します。
PostgreSQLパッケージがインストールされたら、データベースを初期化します。
PostgreSQLのバージョンに対応するsystemdユニットファイルの名前を見つけます。
見つけたユニットファイルを使用してサービスを開始します。例えば、PostgreSQL 12の場合は以下のようになります。
オプションとして、enableを使用して起動時にPostgreSQLを自動的に開始することもできます。
デフォルトでは、PostgreSQLはピア認証を使用するように設定されており、これにより、オペレーティングシステムのユーザー名がPostgreSQLの内部名と一致する場合にユーザーがログインできます。
インストールプロセスにより、postgresデータベースの管理アカウントと一致するpostgresというオペレーティングシステムユーザーが作成されました。psqlクライアントでPostgreSQLにログインするには、sudoを使用してpostgresユーザーとしてコマンドを実行します。
完了したら、以下を入力してpsqlセッションを終了できます。
