ご自身のパソコン（ローカル）上にPostgreSQLをインストールし、DBeaverを使ってデータベースを管理できるようにします。
PostgreSQLは高機能なオープンソースのデータベースであり、DBeaverはその操作を効率化する便利なGUIツールです。

様々な言語に共通するスキルを学べます。

共通技術コース

開発を始める前の準備

PostgreSqlとDbeaver環境構築

ここではデータベースの一つである、PostgreSQLのインストール方法を説明します。

## PostgreSQLインストール方法

### Windows場合
1. [PostgreSQL公式サイト](https://www.postgresql.org/download/windows/)からダウンロード  
a. Windowsを選択    
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/09096b1e-2474-49f9-9463-4eb8c6862900.png)
b. Download the installer をクリックする  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/7d57893d-e935-4086-b6cf-8cc00eabb911.png)
c. 最新のPostgreSQLのバージョンを選択して、ダウンロードする  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/d318f7c5-919d-4916-9f0f-dc622bcc6cb7.png)
2. インストーラーの実行  
a. ダウンロードしたインストーラーをダブルクリックして起動します。  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/30065f0a-f544-4a95-8554-c198512d7139.png)
b. セットアップウィザードに従い、以下を設定してください。  
**インストールディレクトリ:** デフォルト設定のままでOKです。  
**コンポーネントの選択:** 必要なツール（pgAdminなど）は選択解除可能です。  
**スーパーユーザーパスワード:** 初回ログイン時に必要ですので、忘れないように設定してください。  
**ポート番号:** デフォルト設定5432のままでOKです。  
最後のLaunch Stack Buildeはチェックを外して**finish**して下さい。
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/eb718fef-7525-41c5-9d9d-f1d38ef2ccd9.png)
3. サービスの起動確認  
インストールが完了すると、PostgreSQLサービスは自動的に起動します。  
手動で確認したい場合は以下を使用して下さい。  
・`スタートメニュー` > `PostgreSQL` > `Application Stack Builder`で確認。  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/cf16b0c9-26cd-4093-bc41-8ccc25d37c5d.png)![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/ef7495ba-0fed-4d38-b01d-47b7beb16d5e.png)
・または、タスクマネージャーでpostgresプロセスを確認。
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/3f92ff91-d437-41bd-ad79-9a4a8effe7f8.png)
### Macの場合 
以下の2つの方法から、あなたの操作スタイルに合ったものを選んでください。

* ターミナルを使い慣れている方は「**Homebrewを使ったインストール方法**」
* 画面操作がよい方は「**DMG形式でのインストール方法**」 **（簡単）**

---
#### Homebrewを使ったインストール方法
1. Homebrewのインストール確認

まず、Homebrewがインストールされているか確認します。
ターミナルを開き、以下を実行してください。
```sh
brew --version
```
結果例:
<terminal filename="ターミナル">
Homebrew x.x.x
</terminal>

※確認できない場合は、以下のコマンドでHomebrewをインストールして下さい
```sh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

2. PostgreSQLのインストール  

Homebrewがインストールされている場合、以下のコマンドでPostgreSQLをインストールします。
```sh
brew install postgresql
```
3. サービスの起動

PostgreSQLをバックグラウンドで自動起動させるには、以下を実行します。
```sh
brew services start postgresql
```

4. 動作確認

ターミナルで以下を実行し、PostgreSQLの操作環境が動作していることを確認します。
```sh
psql postgres
```
成功すると下記のようなPostgreSQLの対話型コンソールが表示されます。
<terminal filename="ターミナル">
psql (xx.xx (Homebrew))
Type "help" for help.
postgres=# 
</terminal>
終了するには、以下を入力します。
```sh
\q
```
---

#### DMG形式でのインストール方法
1. [PostgreSQL公式サイト](https://www.postgresql.org/download/)からダウンロード  
a. Mac OSを選択  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/d88d1448-3333-4f7f-920c-7f0b2bc9f89a.png)
b. Download the installer をクリックする  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/188bd142-0c29-48e3-91c9-5d861cedbe22.png)
c. 最新のPostgreSQLのバージョンを選択して、ダウンロードする  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/4aa59e39-d2a7-4764-8de7-3086e79fc070.png)
d. postgresql-xx.x-x-osx.app をアプリケーションへドラッグ＆ドロップする  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/399fa2ab-9880-4c81-8a1c-34bd4e8314ca.png)
2. インストール手順  
postgresql-xx.x-x-osx.app を開いて、インストーラーの指示に従う(基本的に**Next**でOK)  
**インストールディレクトリ:** デフォルト設定のままでOKです。  
**コンポーネントの選択:** 必要なツール（pgAdminなど）は選択解除可能です。  
**スーパーユーザーパスワード:** 初回ログイン時に必要ですので、忘れないように設定してください。  
**ポート番号:** デフォルト設定5432のままでOKです。  
最後のLaunch Stack Buildeはチェックを外して**finish**して下さい。
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/e8f83767-c74f-415a-b25f-c9ad4470ff8d.png)
3. サービスの起動と確認  
a. インストール完了後、PostgreSQLは自動的に起動します  
b. インストールされた、SQL Shell(psql) をクリックすると、下記のようなターミナルが立ち上がる  

<terminal filename="ターミナル">
/Library/PostgreSQL/17/scripts/runpsql.sh; exit
<ユーザー名>@<ホスト名> ~ % /Library/PostgreSQL/17/scripts/runpsql.sh; exit
</terminal>

c. 下記はそのまま**Enter**キーで進む  
```sh
Server [localhost]: 
Database [postgres]: 
Port [5433]: 
Username [postgres]: 
```

d. 下記でパスワードを聞かれたら、2.`スーパーユーザーパスワード`で設定したパスワードを入力する  
```sh
Password for user postgres: 
```
e. 下記のようなPostgreSQLの対話型コンソールが表示されれば成功です。  
<terminal filename="ターミナル">
psql (xx.x)
Type "help" for help.
postgres=# 
</terminal>

データベース【 PostgreSQL】の利用準備

DBeaverはデータベースやテーブルの作成や、SQLを使ってのデータの確認をしやすくするツールです。
この例では、`PostgreSQL`というデータベースに接続する例を表示しますが、`MySQL`や`sqlite`など、他のデータベースに接続する場合も、同様の手順で利用ができます。

## DBeaverインストール方法
MacでDBeaverをインストールするのは、**データベースのテーブルを画面操作で簡単に確認したい方**のみに推奨します。

1. DBeaverのインストール  
a. [DBeaver公式サイト](https://dbeaver.io/)にアクセス  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/1eb4c8dd-fed5-43d5-831f-a09a4203eab8.png)
b. OSに合ったDBeaverをダウンロードしてインストールします。
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/679d58da-760b-44da-ac86-c9ee3b81a74d.png)
2. PostgreSQLへの接続  
a. DBeaverを開き、「新しい接続」をクリック(初回起動時は自動で開きます)  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/a17546ab-367c-4bfe-9b39-9062a90efebd.png)
b. リストから「PostgreSQL」を選択し、「次へ」をクリック  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/20138df6-a6e1-48e1-8f4a-2cdef0ce4148.png)
c. 下記項目を入力
   項目|入力値
   ---|---
   Host|`*localhost*`
   Port|`*5432*`
   Database|`接続するデータベース(デフォルトはpostgres)`
   ユーザー名|`*postgres*`
   パスワード|`PostgreSQLインストール時に設定したものを使用`

![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/fbec6c32-2acb-4640-8415-521f05a0ebe8.png)
3. GUIでの操作開始  
接続が完了すると、DBeaver内でPostgreSQLのデータベースを作成したり、データを操作することができます。
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/a172c077-6154-4c91-817d-665e2b2eaa5f.png)

SQLクライアント【DBeaver】の利用準備（PostgreSQL接続例）

## 1. PostgreSQLインストール方法

### Windows場合
1. [PostgreSQL公式サイト](https://www.postgresql.org/download/windows/)からダウンロード  
PostgreSQLの公式サイトにアクセスして、インストーラーをダウンロードします。  
2. インストーラーの実行  
a. ダウンロードしたインストーラーをダブルクリックして起動します。  
b. セットアップウィザードに従い、以下を設定してください。  
**インストールディレクトリ:** デフォルト設定のままでOKです。  
**コンポーネントの選択:** 必要なツール（pgAdminなど）は選択解除可能です。  
**スーパーユーザーパスワード:** 初回ログイン時に必要ですので、忘れないように設定してください。  
**ポート番号:** デフォルト設定5432のままでOKです。
3. サービスの起動確認  
インストールが完了すると、PostgreSQLサービスは自動的に起動します。  
手動で確認したい場合は以下を使用して下さい。  
・`スタートメニュー` > `PostgreSQL` > `Application Stack Builder`で確認。  
・または、タスクマネージャーでpostgresプロセスを確認。

### Macの場合 
以下の2つの方法から、あなたの操作スタイルに合ったものを選んでください。

* ターミナルを使い慣れている方はHomebrewを使ったインストール方法
* 画面操作が好きな方はDMG形式でのインストール方法
#### Homebrewを使ったインストール方法
1. Homebrewのインストール確認

まず、Homebrewがインストールされているか確認します。
ターミナルを開き、以下を実行してください。
```sh
brew --version
```
結果例:
<terminal filename="ターミナル">
Homebrew x.x.x
</terminal>

※確認できない場合は、以下のコマンドでHomebrewをインストールして下さい
```sh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

2. PostgreSQLのインストール  

Homebrewがインストールされている場合、以下のコマンドでPostgreSQLをインストールします。
```sh
brew install postgresql
```
3. サービスの起動

PostgreSQLをバックグラウンドで自動起動させるには、以下を実行します。
```sh
brew services start postgresql
```

4. 動作確認

ターミナルで以下を実行し、PostgreSQLの操作環境が動作していることを確認します。
```sh
psql postgres
```
成功すると下記のようなPostgreSQLの対話型コンソールが表示されます。
<terminal filename="ターミナル">
psql (xx.xx (Homebrew))
Type "help" for help.
postgres=# 
</terminal>
終了するには、以下を入力します。
```sh
\q
```

#### DMG形式でのインストール方法
1. [PostgreSQL公式サイト](https://www.postgresql.org/download/)からダウンロード  
a. Mac OSを選択  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/d88d1448-3333-4f7f-920c-7f0b2bc9f89a.png)
b. Download the installer をクリックする  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/188bd142-0c29-48e3-91c9-5d861cedbe22.png)
c. 最新のPostgreSQLのバージョンを選択して、ダウンロードする  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/4aa59e39-d2a7-4764-8de7-3086e79fc070.png)
d. postgresql-xx.x-x-osx.app をアプリケーションへドラッグ＆ドロップする  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/399fa2ab-9880-4c81-8a1c-34bd4e8314ca.png)
2. インストール手順  
postgresql-xx.x-x-osx.app を開いて、インストーラーの指示に従う(基本的に**Next**でOK)  
**インストールディレクトリ:** デフォルト設定のままでOKです。  
**コンポーネントの選択:** 必要なツール（pgAdminなど）は選択解除可能です。  
**スーパーユーザーパスワード:** 初回ログイン時に必要ですので、忘れないように設定してください。  
**ポート番号:** デフォルト設定5432のままでOKです。  
最後のLaunch Stack Buildeはチェックを外して**finish**して下さい。
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/e8f83767-c74f-415a-b25f-c9ad4470ff8d.png)
3. サービスの起動と確認  
a. インストール完了後、PostgreSQLは自動的に起動します  
b. インストールされた、SQL Shell(psql) をクリックすると、下記のようなターミナルが立ち上がる  

<terminal filename="ターミナル">
/Library/PostgreSQL/17/scripts/runpsql.sh; exit
<ユーザー名>@<ホスト名> ~ % /Library/PostgreSQL/17/scripts/runpsql.sh; exit
</terminal>

c. 下記はそのまま**Enter**キーで進む  
```sh
Server [localhost]: 
Database [postgres]: 
Port [5433]: 
Username [postgres]: 
```

d. 下記でパスワードを聞かれたら、2.`スーパーユーザーパスワード`で設定したパスワードを入力する  
```sh
Password for user postgres: 
```
e. 成功すると下記のようなPostgreSQLの対話型コンソールが表示されます  
<terminal filename="ターミナル">
psql (xx.x)
Type "help" for help.
postgres=# 
</terminal>
## 2. DBeaverインストール方法
MacでDBeaverをインストールするのは、**データベースのテーブルを画面操作で簡単に確認したい方**のみに推奨します。

1. DBeaverのインストール  
a. [DBeaver公式サイト](https://dbeaver.io/)にアクセス  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/1eb4c8dd-fed5-43d5-831f-a09a4203eab8.png)
b. OSに合ったDBeaverをダウンロードしてインストールします。
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/679d58da-760b-44da-ac86-c9ee3b81a74d.png)
2. PostgreSQLへの接続  
a. DBeaverを開き、「新しい接続」をクリック(初回起動時は自動で開きます)  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/a17546ab-367c-4bfe-9b39-9062a90efebd.png)
b. リストから「PostgreSQL」を選択し、「次へ」をクリック  
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/20138df6-a6e1-48e1-8f4a-2cdef0ce4148.png)
c. 下記項目を入力
   項目|入力値
   ---|---
   Host|`*localhost*`
   Port|`*5432*`
   Database|`接続するデータベース(デフォルトはpostgres)`
   ユーザー名|`*postgres*`
   パスワード|`PostgreSQLインストール時に設定したものを使用`

![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/fbec6c32-2acb-4640-8415-521f05a0ebe8.png)
3. GUIでの操作開始  
接続が完了すると、DBeaver内でPostgreSQLのデータベースを作成したり、データを操作することができます。
![image](https://prod-code-lesson-api.s3.ap-northeast-1.amazonaws.com/cms/a172c077-6154-4c91-817d-665e2b2eaa5f.png)

PostgreSqlとDbeaver環境構築

チュートリアル