DESCRIBE POSTGRES INSTANCE

DESCRIBE POSTGRES INSTANCE 명령은 Snowflake Postgres 인스턴스의 속성을 설명하는 명령이에요. 이 명령은 다음 용도로 사용해요: DESCRIBE는 DESC로 줄여 쓸 수 있습니다.

출처: DESCRIBE POSTGRES INSTANCE

본문

Snowflake Postgres 인스턴스의 속성을 설명하는 명령입니다. 이 명령을 사용해: 인스턴스의 현재 상태, 설정, 연결 정보를 확인할 수 있어요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.

Syntax

{ DESC | DESCRIBE } POSTGRES INSTANCE <name>

Parameters

name — 설명할 Postgres 인스턴스의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요. 자세한 내용은 Identifier requirements 문서를 참고하세요.

Output (출력)

명령 출력에는 객체의 속성과 메타데이터를 설명하는 다음 컬럼이 포함돼요. 이 명령은 컬럼형 출력이 아닌 속성/값 형식으로 결과를 반환해요. 각 속성은 해당 값과 함께 별도의 행으로 나타납니다.

Access control requirements (접근 제어 요구 사항)

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.

지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.

Usage notes (사용 참고 사항)

업그레이드 상태 예시:

{
   "upgrade" : {
     "state" : "UPGRADING",
     "start" : "2026-02-16 14:13:58.371 -0800",
     "duration" : "3m36s",
     "compute_family" : "BURST_M",
     "tasks" : [ {
       "flavor" : "resize",
       "state" : "creating"
     }, {
       "flavor" : "resize",
       "state" : "finalizing"
     }, {
       "flavor" : "resize",
       "state" : "ready"
     } ]
   }
}

Examples (예제)

Postgres 인스턴스를 설명해 봅시다.

DESCRIBE POSTGRES INSTANCE my_postgres;

그 명령의 일반적인 출력은 다음과 같아요.

+------------------------------------------------------------------------+
| property                       | value                                 |
|--------------------------------+---------------------------------------|
| name                           | MY_TEST_INSTANCE                      |
| owner                          | ACCOUNTADMIN                          |
| owner_role_type                | ROLE                                  |
| created_on                     | 2026-01-29 10:04:59.485 -0800         |
| updated_on                     | 2026-02-16 13:21:58.018 -0800         |
| type                           | PRIMARY                               |
| host                           | my-instance-hostname.us-west-2.aws    |
|                                | .postgres.snowflake.pp                |
| privatelink_service_identifier | None                                  |
| compute_family                 | BURST_S                               |
| storage_size_gb                | 10                                    |
| postgres_version               | 18                                    |
| postgres_settings              | {}                                    |
| high_availability              | false                                 |
| authentication_authority       | POSTGRES                              |
| maintenance_window_start       | None                                  |
| state                          | READY                                 |
| comment                        | None                                  |
| origin                         | None                                  |
| replicas                       |                                       |
| operations                     | { }                                   |
| network_policy                 | None                                  |
| storage_integration            | None                                  |
| certificate                    | -----BEGIN CERTIFICATE-----           |
|                                | ... several lines of certificate ...  |
|                                | -----END CERTIFICATE-----             |
|                                |                                       |
+------------------------------------------------------------------------+

flow 연산자와 함께 SHOW를 사용해 인스턴스를 찾은 다음 설명해 봅시다.

-- Find instances in a specific state
SHOW POSTGRES INSTANCES
  ->> SELECT "name", "state", "postgres_version"
      FROM $1
      WHERE "state" = 'READY' AND "postgres_version" = '17';

-- Then describe a specific instance for full details
DESCRIBE POSTGRES INSTANCE my_postgres;

flow 연산자를 사용해 특정 속성을 추출해 봅시다.

DESCRIBE POSTGRES INSTANCE my_postgres
  ->> SELECT "property", "value"
      FROM $1
      WHERE "property" IN ('name', 'state', 'host',
        'postgres_version', 'high_availability');

인스턴스의 연결 호스트 이름을 확인해 봅시다.

DESCRIBE POSTGRES INSTANCE my_postgres
  ->> SELECT "value" AS hostname
      FROM $1
      WHERE "property" = 'host';

DESCRIBE POSTGRES INSTANCE