psql에서 \l은 데이터베이스 목록을 보여 주고, \c dbname은 그 데이터베이스에 접속하며, \dt는 현재 데이터베이스의 테이블 목록을 보여 줍니다. SQL이나 다른 클라이언트에서는 카탈로그를 조회합니다. 데이터베이스는 pg_database, 테이블은 information_schema.tables입니다.
두 테이블은 BASE TABLE로, 뷰는 VIEW로 나오며 모두 public 스키마에 있습니다. WHERE 조건은 시스템 카탈로그를 숨깁니다. 그렇지 않으면 수백 개의 행이 더 나옵니다. 뷰를 빼려면 AND table_type = 'BASE TABLE'을 추가하세요.
데이터베이스와 테이블을 보는 psql 명령
다음은 psql 메타 명령입니다. psql이 각 명령을 카탈로그 쿼리로 바꿔 실행하므로, 다른 클라이언트나 애플리케이션 코드에서는 동작하지 않습니다.
| 명령 | 보여 주는 것 |
|---|---|
\l | 데이터베이스 (\l+는 크기 추가) |
\c shop | 데이터베이스 shop에 접속 |
\conninfo | 현재 데이터베이스, 사용자, 호스트 |
\dn | 스키마 |
\dt | search_path에 있는 스키마의 테이블 |
\dt sales.* | 스키마 sales의 테이블 |
\dt *.* | 시스템 스키마를 포함한 모든 스키마의 테이블 |
\dt+ | 크기와 설명이 붙은 테이블 |
\dv, \di, \ds | 뷰, 인덱스, 시퀀스 |
\d orders | orders의 컬럼, 인덱스, 제약 조건 |
\d+ orders | 위 내용과 저장 방식, 주석 |
\du | 롤 |
셸에서 psql -l은 데이터베이스 목록을 출력하고 종료하며, -c는 명령 하나를 실행합니다.
psql -l
psql -d shop -c '\dt'
psql을 -E로 시작하면 각 메타 명령 뒤에서 실행되는 SQL이 출력됩니다. 카탈로그 테이블을 빠르게 익히는 방법입니다.
SQL로 데이터베이스 목록 보기
서버의 모든 데이터베이스는 pg_database의 행입니다. template0과 template1은 CREATE DATABASE가 복사하는 템플릿이므로 걸러 냅니다.
이 페이지에서는 실행할 때마다 이름이 lesson_으로 시작하는 새 데이터베이스가 만들어집니다. 결과에는 그 데이터베이스와, 모든 서버가 만드는 기본 데이터베이스인 postgres가 나옵니다. SELECT current_database()는 지금 접속한 데이터베이스를 돌려줍니다.
테이블의 컬럼 확인하기
psql에서는 \d orders가 테이블 구조를 보여 줍니다. SQL에서는 information_schema.columns에 컬럼마다 행이 하나씩 있습니다.
기본 키는 항상 NOT NULL이므로 id의 is_nullable은 NO입니다. column_default는 비어 있습니다. identity 컬럼은 기본값이 아니라 시퀀스에서 값을 가져오기 때문입니다.
pg_catalog 직접 조회하기
information_schema는 SQL 표준의 뷰이며, 권한이 있는 객체만 보여 줍니다. pg_catalog에 있는 PostgreSQL 전용 카탈로그에는 인덱스 정의처럼 더 많은 정보가 있습니다.
인덱스 세 개가 나옵니다. UNIQUE에서 생긴 orders_email_key, 기본 키에서 생긴 orders_pkey, 직접 만든 부분 인덱스입니다. 각각 다시 만들 때 쓸 CREATE INDEX 문이 함께 나옵니다. pg_tables는 테이블만 보여 주며, 뷰와 구체화된 뷰는 pg_views와 pg_matviews에 있습니다.
모든 테이블의 행 수 세기
카탈로그는 정확한 행 수를 저장하지 않습니다. pg_class.reltuples에는 VACUUM과 ANALYZE가 갱신하는 플래너의 추정값이 들어 있습니다. 큰 테이블을 찾기에는 충분히 정확하며, -1은 한 번도 분석되지 않은 테이블이라는 뜻입니다.
SELECT relname, reltuples::bigint AS estimated_rows
FROM pg_class
WHERE relkind = 'r' AND relnamespace = 'public'::regnamespace
ORDER BY reltuples DESC;
정확한 수가 필요하면 테이블 전체를 읽는 SELECT count(*) FROM orders를 실행하세요. 카탈로그 테이블은 PostgreSQL 매뉴얼의 System Catalogs에 정리되어 있습니다.
자주 묻는 질문
PostgreSQL에 SHOW TABLES나 SHOW DATABASES가 있나요?
없습니다. 그건 MySQL 명령입니다. PostgreSQL에서 SHOW는 서버 설정을 읽는 명령이라 SHOW TABLES는 "unrecognized configuration parameter" 오류를 냅니다. psql에서 \dt와 \l을 쓰거나 information_schema.tables와 pg_database를 조회하세요.
\dt가 "Did not find any relations"라고 나오는 이유는 무엇인가요?
테이블이 있는 데이터베이스가 아닌 다른 데이터베이스에 접속해 있거나, 테이블이 search_path에 없는 스키마에 있기 때문입니다. \conninfo로 확인한 뒤 \dt *.*나 \dt schema_name.*을 실행해 보세요.
PostgreSQL에서 데이터베이스는 어떻게 전환하나요?
연결 하나는 데이터베이스 하나에 속하며, SQL에는 USE 문이 없습니다. psql에서 \c other_db를 실행하면 새 연결이 열립니다. 셸에서는 psql -d other_db로 시작하세요.
PostgreSQL에서 테이블 크기는 어떻게 확인하나요?
psql에서 \dt+를 쓰면 크기 컬럼이 추가됩니다. SQL로는 pg_size_pretty(pg_total_relation_size('orders'))가 인덱스와 TOAST 데이터를 포함한 테이블 크기를 알려 줍니다.