DROP SERVER — 외부 서버 설명자 제거하기

DROP SERVER — 외부 서버 설명자 제거하기

외부 데이터 래퍼(FDW)로 연결해 쓰던 외부 서버가 더 이상 필요 없어졌을 때, 그 서버 설명자(server descriptor)를 데이터베이스에서 지우는 명령이 DROP SERVER예요. 간단해 보이지만, 이 서버를 참조하는 객체(예: 사용자 매핑)가 있으면 기본적으로는 삭제가 거부되니 주의해서 써야 해요. 이 명령은 SQL/MED에서 정의한 외부 서버 관리 기능 중 하나예요.

출처: PostgreSQL 문서

본문

Synopsis (문법)

DROP SERVER [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

Description (설명)

DROP SERVER는 기존 외부 서버 설명자를 제거해요. 이 명령을 실행하려면 현재 사용자가 해당 서버의 소유자여야 해요.

Parameters (매개변수)

  • IF EXISTS — 서버가 존재하지 않아도 오류를 내지 않아요. 이 경우에는 notice가 발행돼요.
  • name — 존재하는 서버의 이름이에요.
  • CASCADE — 서버에 의존하는 객체(예: 사용자 매핑)와, 다시 그 객체들에 의존하는 모든 객체를 자동으로 삭제해요 (Section 5.15 참고).
  • RESTRICT — 서버에 의존하는 객체가 있으면 삭제를 거부해요. 이것이 기본값이에요.

Examples (예제)

서버 foo가 존재하면 삭제해요:

DROP SERVER IF EXISTS foo;

Compatibility (호환성)

DROP SERVER는 ISO/IEC 9075-9 (SQL/MED)를 따르고, IF EXISTS 절은 PostgreSQL 확장이에요.

더 알아보기 (Learn more)

  • 외부 서버를 만들 때 쓰는 CREATE SERVER 명령
  • 외부 서버 설정을 바꾸는 ALTER SERVER 명령
  • PostgreSQL 외부 데이터(Foreign Data) 개념