스키마 정보
트랜잭션 익스플로러 데이터베이스의 테이블, 인덱스(Index), 확장 기능 스키마(Schema)를 확인합니다.
4.2 인덱스 확인
- 인덱스 탭 선택: 상단 탭에서 [인덱스]를 클릭합니다
- 인덱스 목록 확인: 모든 인덱스의 정보를 확인합니다
- 인덱스 상태: 인덱스 크기, uniqueness 등을 확인합니다
4.3 확장 기능 확인
- 확장 기능 탭 선택: 상단 탭에서 [확장 기능]을 클릭합니다
- 설치된 확장 목록: PostgreSQL 확장 기능 목록을 확인합니다
- 버전 정보: 확장 기능의 버전을 확인합니다
4.4 새로고침
- 우측 상단의 새로고침 아이콘을 클릭합니다
- 현재 탭의 데이터가 다시 로드됩니다
5. 데이터 확인
5.1 테이블 목록
테이블 탭에서 조회할 수 있는 정보는 다음과 같습니다.
| 컬럼 | 설명 | 예시 |
|---|---|---|
| schemaname | 스키마 이름 | flowkat |
| tablename | 테이블 이름 | xlog_partitioned |
| tableowner | 테이블 소유자 | flowkat |
| tablespace | 테이블스페이스 | pg_default |
| hasindexes | 인덱스 보유 여부 | t |
| hasrules | 룰 보유 여부 | f |
| hastriggers | 트리거 보유 여부 | t |
| rowsecurity | 로우 레벨 보안 | f |
5.2 인덱스 목록
인덱스 탭에서 조회할 수 있는 정보는 다음과 같습니다.
| 컬럼 | 설명 | 예시 |
|---|---|---|
| schemaname | 스키마 이름 | flowkat |
| tablename | 소속 테이블 | xlog_partitioned |
| indexname | 인덱스 이름 | xlog_partitioned_pkey |
| indexdef | 인덱스 정의 | CREATE UNIQUE INDEX... |
인덱스 확인 용도
인덱스 목록은 쿼리 성능 저하 원인을 파악하거나, 인덱스가 누락된 테이블을 식별할 때 유용합니다.
5.3 확장 기능 목록
확장 기능 탭에서 조회할 수 있는 정보는 다음과 같습니다.
| 컬럼 | 설명 | 예시 |
|---|---|---|
| extname | 확장 기능 이름 | postgis |
| extversion | 확장 기능 버전 | 3.4.2 |
| nspname | 네임스페이스 | public |
| extrelocatable | 재배치 가능 여부 | f |
주요 확장 기능
트랜잭션 익스플로러에서 사용하는 주요 PostgreSQL 확장 기능:
- postgis: 지리 공간 데이터 처리
- pg_stat_statements: 쿼리 성능 통계
- timescaledb: 시계열 데이터 최적화
6. 화면 상호작용 이벤트
6.1 탭 전환
| 액션 | 동작 | 비고 |
|---|---|---|
| 테이블 탭 클릭 | 테이블 목록 로드 | 기본 탭 |
| 인덱스 탭 클릭 | 인덱스 목록 로드 | API: GET /admin/schema/indexes |
| 확장 기능 탭 클릭 | 확장 기능 목록 로드 | API: GET /admin/schema/extensions |
탭 전환 최적화
탭 전환 시 해당 탭의 데이터만 로드되므로 불필요한 API 호출이 발생하지 않습니다.
6.2 새로고침
| 액션 | 동작 | API |
|---|---|---|
| 새로고침 아이콘 클릭 | 현재 탭 데이터 갱신 | 현재 탭에 따라 GET /admin/schema/* |
6.3 로딩 상태
| 상태 | 표시 |
|---|---|
| 데이터 로딩 중 | 중앙에 로딩 스피너 |
| 데이터 없음 | "데이터가 없습니다" 메시지 |
| 로딩 완료 | 데이터 테이블에 데이터 표시 |
7. 주의사항
7.1 데이터베이스 연결
연결 실패 처리
데이터베이스 연결 실패 시 다음 조치를 취하십시오:
- 네트워크 연결 상태 확인
- 데이터베이스 서버 상태 확인
- 관리자에게 문의
7.2 읽기 전용
읽기 전용 제약
본 페이지는 읽기 전용입니다. 다음 작업은 직접 수행할 수 없습니다:
- 테이블 생성/수정/삭제
- 인덱스 추가/제거
- 확장 기능 설치/제거
스키마 변경이 필요한 경우 데이터베이스 관리자에게 문의하십시오.
7.3 권한 요구사항
관리자 권한
본 페이지 접근을 위해서는 다음 권한이 필요합니다:
- 설정 > 트랜잭션 익스플로러 관리 메뉴 접근 권한
- 데이터베이스 읽기 권한
8. 문제 해결
8.1 자주 발생하는 문제
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 데이터가 표시되지 않음 | 데이터베이스 연결 실패 | DB 서버 상태 확인 후 새로고침 |
| 일부 컬럼만 표시됨 | 데이터 테이블 자동 너비 설정 | 테이블 너비를 확대하여 확인 |
| 새로고침 해도 변화 없음 | 데이터 실시간 갱신 안 됨 | 스냅샷 갱신 작업 필요 |
| 탭 클릭 시 로딩만 계속 | API 응답 지연 | 잠시 후 다시 시도 또는 관리자 문의 |
8.2 오류 메시지
| 메시지 | 의미 | 조치 |
|---|---|---|
| "데이터를 불러오는 중 오류가 발생했습니다" | API 호출 실패 | 네트워크 또는 서버 상태 확인 |