psqlとは何か、また必須コマンドは何か

Question

Accepted Answer

**`psql`**はPostgreSQLのインタラクティブなコマンドラインクライアントです。データベースに接続してクエリを実行したり、スキーマを検査したり、データベースを管理するために使用されます。SQLを実行する以外に、ナビゲーションと管理用の特別な**メタコマンド**（`\`で始まる）があります。

## 接続

```bash
psql -U username -d database_name -h host -p 5432   # connect with options
psql postgresql://user:pass@host:5432/dbname        # or a connection URL
psql mydb                                            # connect to a local database
```

## 必須メタコマンド（バックスラッシュコマンド）

```text
\l            list all databases
\c dbname     connect to a database
\dt           list TABLES in the current database
\d tablename  describe a table (columns, types, indexes, constraints)
\di           list indexes
\dn           list schemas
\du           list roles/users
\df           list functions
\dv           list views
\x            toggle expanded display (vertical — readable for wide rows)
	iming       toggle query timing
\?            help on meta-commands
\h SELECT     help on a SQL command
\q            quit
```

これらの`\`メタコマンドを使うことで、データベースを素早く探索・管理できます。`\dt`（テーブル一覧）、`\d tablename`（テーブル構造の検査）、`\l`（データベース一覧）は常に使用されます。

## クエリとスクリプトの実行

```sql
SELECT * FROM users LIMIT 5;          -- run SQL directly (end with ;)
```

```bash
psql -d mydb -f script.sql            -- run a SQL FILE
psql -d mydb -c "SELECT count(*) FROM users"   -- run a single command and exit
\i script.sql                          -- run a file from within psql
\copy users TO 'users.csv' CSV HEADER  -- export to CSV (client-side)
```

## 便利な設定

```text
\x auto       auto-switch to vertical display for wide results
	iming on    show how long each query takes
\e            open the last query in an editor
\set, \pset   configure variables and output formatting
```

## なぜ重要なのか

`psql`はPostgreSQLを直接操作するための必須の日常ツールです。開発者とDBAは常にそれを使ってデータベースに接続、クエリ実行、検査、管理を行うため、その基本を理解することはPostgres作業に関する実践的で基礎的な知識です。

GUIツールは存在しますが、`psql`は普遍的で常に利用可能なインターフェース（Postgresがある場所であればどこにでも存在する）です。そして**メタコマンド**（`\`）により、純粋なSQLでは簡単にはできない迅速なデータベース探索と管理が特に強力になります。`\dt`（テーブル一覧）、`\d tablename`（テーブルの完全な構造を検査—カラム、型、インデックス、制約—これは常に必要）、`\l`（データベース一覧）、`\du`（ユーザー/ロール一覧）などを使用すれば、データベースを素早くナビゲートして理解できます。

接続方法（オプションまたはURLを使用）、クエリとスクリプトの実行（ファイルの場合は`-f`、単発コマンドの場合は`-c`）、検査用メタコマンドの使用、および便利な設定（幅広い行を読みやすく表示する`\x`、クエリのタイミング計測の`	iming`）の知識は、Postgresの開発者または管理者にとって日常的な実践知識です。

`psql`はPostgreSQLへの標準的で普遍的なコマンドラインインターフェースであり、開発、デバッグ、管理、スクリプト作成、探索に使用されます。そのため、その必須コマンドとワークフローを理解することは、Postgresでの作業を効率的にする貴重で頻繁に応用される知識であり、データベースを直接操作する誰もが期待される基本的なスキルです。