Snowflake Postgres에 연결하기

Snowflake Postgres 인스턴스를 생성하면 psql 또는 DBeaver와 같은 PostgreSQL 클라이언트에 연결할 수 있습니다. 연결을 설정하려면 다음을 사용하여 클라이언트를 구성합니다.

  • 인스턴스의 호스트 이름. 이는 가상 머신 호스트의 URL입니다.

  • 사용자 이름. 인스턴스를 생성하면 기본적으로 snowflake_admin 사용자가 생성되며 관리 액세스용으로 설계됩니다.

  • 연결할 Postgres 데이터베이스. 이 매개 변수는 Postgres 연결을 생성하는 데 필요합니다. 기본 데이터베이스의 이름은 ``postgres``입니다.

  • 사용자의 비밀번호.

다음은 psql 명령줄 클라이언트와 함께 사용되는 해당 연결 세부 정보의 예제입니다.

$ psql -h abcefg.snowflake.app  -U snowflake_admin -d postgres
Copy

(``psql``은 비밀번호를 묻는 메시지를 표시합니다.)

포트를 지정해야 하는 경우 5432를 사용합니다.

$ psql -h abcefg.snowflake.app  -U snowflake_admin -p 5432 -d postgres
Copy

중요

Snowflake Postgres 인스턴스에 연결하려면 SSL이 필요합니다.

연결 문자열 정보

Snowsight를 통해 Postgres 인스턴스를 생성할 때 Snowflake Postgres는 `libpq URI 형식<https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING>`_의 연결 문자열을 제공하여 ``psql``을 통해 직접 연결하거나 애플리케이션 구성에 입력하여 연결합니다.

참고

지정된 역할에 대한 액세스 권한을 명시적으로 재설정하지 않는 한, 클러스터의 연결 문자열은 클러스터 관리 작업 전체에서 동일하게 유지됩니다.

데이터베이스 URL로서의 연결 문자열에는 다음 매개 변수가 포함됩니다.

  • 프로토콜: postgres://

  • 사용자 이름: 자세한 내용은 Snowflake Postgres 역할 섹션을 참조하세요.

  • 비밀번호

  • 호스트 이름

  • 포트: 5432

  • database_name: 기본값은 ``postgres``입니다.

그런 다음 이를 사용하여 해당 형식의 URI 연결 문자열을 빌드합니다.

postgresql://<username>:<password>@hostname:<port>/<database_name>
Copy

클라이언트 환경이 SSL 연결을 적용하도록 구성되지 않은 경우 :codenowrap:`?sslmode=require`를 URI에 추가할 수 있습니다.

postgresql://<username>:<password>@hostname:<port>/<database_name>?sslmode=require
Copy

sslmode 매개 변수는 다양한 수준의 SSL 암호화 및 인증서 확인을 나타내는 다른 값을 허용합니다. ``sslmode=require``는 SSL 암호화를 적용하는 데 필요한 최소 수준입니다. Snowflake Postgres 서버 인증서의 SSL 인증서 확인을 수행하도록 클라이언트를 구성하려면 Snowflake Postgres SSL 인증서 섹션을 참조하세요.

위에서 ``sslmode``가 지정된 방식과 동일한 방식으로 연결 URI에서 여러 다른 클라이언트 연결 매개 변수를 지정할 수 있습니다. 전체 목록은 PostgreSQL 설명서의 `URI 연결 매개 변수 목록 <https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-PARAMKEYWORDS>`_을 참조하세요.

libpq에서 인식하는 환경 변수 <https://www.postgresql.org/docs/current/libpq-envars.html>`_를 통해 이러한 매개 변수 중 대부분을 설정할 수도 있습니다. 예를 들어, 다음은 `psql 연결이 ?sslmode=require 설정으로 수행되도록 보장합니다.

export PGSSLMODE=require
psql -h {hostname} -U {username} {dbname}
Copy

환경 변수를 통해 클라이언트 연결 매개 변수를 설정하면 필요한 연결 매개 변수에 대한 구성 옵션을 제공하지 않는 애플리케이션 프레임워크에 대한 연결을 구성할 때 유용합니다.

참고

libpq 기반이 아닌 데이터베이스 드라이버를 사용하는 애플리케이션의 경우, 클라이언트 구성 매개 변수 옵션 및 사양 형식은 다른 드라이버의 설명서를 참조하세요. 예를 들어, `PostgreSQL 의 JDBC 드라이버 <https://jdbc.postgresql.org/documentation/use/>`_는 ``libpq``에서 제공하는 매개 변수와 동등한 많은 매개 변수를 제공하지만 URIs의 사양은 약간 다릅니다.