DESCRIBE POSTGRES INSTANCE¶

:doc:`Snowflake Postgres 인스턴스 </user-guide/snowflake-postgres/about>`의 속성을 설명합니다.

이 명령을 사용하여 다음을 수행할 수 있습니다.

ALTER, CREATE 또는 FORK와 같은 비동기 작업 중 인스턴스의 :ref:`상태 <instance-states>`를 모니터링합니다.
호스트 이름과 같은 연결 세부 정보를 검색합니다.
고가용성 상태, Postgres 버전, 사용자 지정 서버 설정과 같은 구성 설정을 확인합니다.
origin 필드를 확인하여 포크된 인스턴스 및 해당 소스를 식별합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:: CREATE POSTGRES INSTANCE, ALTER POSTGRES INSTANCE, DROP POSTGRES INSTANCE, SHOW POSTGRES INSTANCES

구문¶

{ DESC | DESCRIBE } POSTGRES INSTANCE <name>

매개 변수¶

name

설명할 Postgres 인스턴스의 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

출력¶

명령의 출력에는 오브젝트의 속성과 메타데이터를 설명하는 다음 열이 포함됩니다.

이 명령은 열 형식 출력이 아닌 속성/값 형식으로 결과를 반환합니다. 각 속성은 해당 값과 함께 별도의 행으로 표시됩니다.


속성	설명
`name`	Postgres 인스턴스의 이름입니다.
`owner`	Postgres 인스턴스를 소유한 역할입니다.
`owner_role_type`	소유자 역할의 유형(예: ROLE 또는 DATABASE_ROLE)입니다.
`created_on`	Postgres 인스턴스가 생성된 날짜 및 시간입니다.
`updated_on`	Postgres 인스턴스가 마지막으로 업데이트된 날짜 및 시간입니다.
`type`	Postgres 인스턴스의 유형(예: PRIMARY)입니다.
`host`	Postgres 인스턴스에 연결하는 데 사용되는 호스트 이름입니다.
`privatelink_service_identifier`	인스턴스에 대해 Private Link가 구성된 경우 :doc:`Private Link 서비스 </user-guide/admin-security-privatelink>`의 식별자입니다.
`compute_family`	Postgres 인스턴스의 :doc:`컴퓨팅 제품군 </user-guide/snowflake-postgres/postgres-instance-sizes>`(인스턴스 크기)입니다.
`storage_size_gb`	Postgres 인스턴스에 할당된 저장소 크기(GB)입니다.
`postgres_version`	인스턴스에서 실행 중인 Postgres의 기본 버전입니다.
`postgres_settings`	인스턴스에 대해 구성된 사용자 지정 :doc:`Postgres 서버 설정 </user-guide/snowflake-postgres/postgres-server-settings>`입니다.
`high_availability`	인스턴스에 대해 고가용성 </user-guide/snowflake-postgres/high-availability>`이 활성화되어 있는지 여부(``true` 또는 `false`)입니다.
`authentication_authority`	인스턴스에 사용되는 인증 방법입니다(현재 `POSTGRES`).
`maintenance_window_start`	:doc:`유지 관리 윈도우 </user-guide/snowflake-postgres/managing-instances>`를 시작할 수 있는 시간(0~23, UTC)이며, 설정되지 않은 경우 ``None``입니다.
`state`	인스턴스의 현재 상태 <instance-states>`입니다. 가능한 값은 ``CREATING`, `RESTORING`, `STARTING`, `REPLAYING`, `FINALIZING`, `READY`, `RESTARTING`, `RESUMING`, `SUSPENDING`, ``SUSPENDED``입니다.
`comment`	Postgres 인스턴스에 대한 설명이며, 설정되지 않은 경우 ``None``입니다.
`origin`	Postgres 인스턴스의 원본(예: 다른 인스턴스에서 포크된 경우)이며, 포크가 아닌 경우 ``None``입니다.
`replicas`	인스턴스와 연결된 :doc:`읽기 전용 복제본 </user-guide/snowflake-postgres/postgres-create-replica>`의 목록입니다.
`operations`	인스턴스에서 보류 중이거나 진행 중인 작업(예: 크기 조정, 업그레이드, HA 활성화)입니다
`network_policy`	인스턴스에 연결된 :doc:`네트워크 정책 </user-guide/snowflake-postgres/postgres-network>`이며, 설정되지 않은 경우 ``None``입니다.
`storage_integration`	인스턴스에서 사용하는 저장소 통합이며, 설정되지 않은 경우 ``None``입니다.
`certificate`	Postgres 인스턴스에 대한 보안 연결을 위한 :doc:`SSL 인증서 </user-guide/snowflake-postgres/postgres-ssl-certs>`입니다.

액세스 제어 요구 사항¶

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.


권한	오브젝트	참고
OPERATE 또는 OWNERSHIP	Postgres 인스턴스

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

이 명령의 출력을 후처리하기 위해 파이프 연산자 (->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.

예를 들어, 파이프 연산자 또는 RESULT_SCAN 함수를 사용하여 SHOW 명령 출력에서 특정 열을 선택하거나 행을 필터링할 수 있습니다.

출력 열을 참조하는 경우 열 이름에 :ref:`큰따옴표로 묶인 식별자<label-delimited_identifier>`를 사용합니다. 예를 들어, 출력 열 ``type``을 선택하려면 ``SELECT “type”``을 지정합니다.

SHOW 명령의 출력 열 이름은 소문자이므로 큰따옴표로 묶인 식별자를 사용해야 합니다. 큰따옴표는 SELECT 목록 또는 WHERE 절의 열 이름이 스캔된 SHOW 명령 출력과 일치하도록 보장합니다.

이 명령을 사용하여 생성, 수정 또는 기타 비동기 작업 중 인스턴스의 상태 <instance-states>`를 확인합니다. ``operations` 필드는 CREATE POSTGRES INSTANCE 또는 ALTER POSTGRES INSTANCE 작업 중에 발생하는 모든 작업 시퀀스를 반영하는 JSON 문자열입니다. operations 필드가 비어 있거나 태스크 중 하나에 ready 값이 있을 때까지 대기할 수 있습니다. 다음은 COMPUTE_FAMILY 설정을 변경하기 위한 ALTER POSTGRES INSTANCE 작업이 끝날 때쯤의 operations 필드 값 예제를 보여줍니다.

 {
   "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"
     } ]
   }
}

예¶

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-----             |
|                                |                                       |
+------------------------------------------------------------------------+

SHOW와 :doc:`흐름 연산자 </sql-reference/operators-flow>`를 사용하여 인스턴스를 찾은 다음 설명합니다.

-- 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;

흐름 연산자를 사용하여 특정 속성을 추출합니다.

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';