클라이언트, 드라이버, 라이브러리 또는 서드 파티 애플리케이션을 Snowflake에 연결하도록 구성하기

클라이언트, 드라이버, 라이브러리 또는 서드 파티 애플리케이션을 Snowflake에 연결하도록 구성하려면 Snowflake 계정 식별자를 지정해야 합니다. 또한 사용해야 하는 웨어하우스, 데이터베이스, 스키마 및 역할을 지정해야 할 수도 있습니다.

이 정보는 Snowsight 또는 SQL 명령을 실행하여 확인할 수 있습니다.

Snowsight 를 사용하여 연결 설정 가져오기

클라이언트, 드라이버, 라이브러리 또는 서드 파티 애플리케이션을 구성하는 데 사용할 수 있는 설정을 가져오려면 다음과 같이 하십시오.

  1. Snowsight 에 로그인 합니다.

  2. 사용자 이름을 선택하여 사용자 메뉴를 엽니다.

    계정 메뉴
  3. 사용자 메뉴에서 Connect a tool to Snowflake 을 선택하여 Account Details 대화 상자를 표시합니다.

    계정 선택기 에서 계정 세부 정보를 볼 수도 있습니다.

  4. 다음 탭 중 하나를 선택합니다.

    • 클라이언트, 드라이버, 라이브러리 또는 서드 파티 애플리케이션이 TOML 구성 파일(예: Snowflake CLI, Snowflake Python APIs 또는 Snowflake Connector for Python) 사용을 지원하는 경우:

      1. Config file 탭을 선택합니다.

      2. 구성 파일에서 웨어하우스를 지정하려면 Warehouse 메뉴에서 웨어하우스를 선택합니다.

      3. 구성 파일에서 데이터베이스와 스키마를 지정하려면 Database 메뉴를 사용하여 데이터베이스와 스키마를 선택합니다.

      4. Connection Method 메뉴에서 인증에 사용할 방법을 선택합니다.

        참고

        클라이언트, 드라이버, 라이브러리 및 서드 파티 애플리케이션은 메뉴에 목록에 없는 추가 인증 방법을 지원합니다. 자세한 내용은 Snowflake 보호 섹션을 참조하십시오.

      5. 복사본 아이콘(보조 기술의 경우 복사본 버튼입니다.)을 선택하여 구성 파일의 내용을 복사합니다.

      참고

      Snowflake Python APIs 의 경우 account 설정에서 밑줄은 지원되지 않습니다. 계정 식별자에 밑줄이 포함되어 있으면 대시로 바꾸십시오.

    • 클라이언트, 드라이버, 라이브러리 또는 서드 파티 애플리케이션이 연결 문자열 지정을 지원하는 경우(예: ODBC Driver, JDBC Driver, Go Snowflake Driver 또는 .NET Driver):

      1. Connectors/Drivers 탭을 선택합니다.

      2. Select Connector or Driver 메뉴에서 사용하려는 드라이버를 선택합니다.

      3. 연결 문자열에 웨어하우스를 지정하려면 Warehouse 메뉴에서 웨어하우스를 선택합니다. (ODBC 및 .NET 에는 이 메뉴가 없습니다.)

      4. 연결 문자열에 데이터베이스와 스키마를 지정하려면 Database 메뉴를 사용하여 데이터베이스와 스키마를 선택합니다.

      5. Connection Method 메뉴에서 인증에 사용할 방법을 선택합니다.

        참고

        클라이언트, 드라이버, 라이브러리 및 서드 파티 애플리케이션은 메뉴에 목록에 없는 추가 인증 방법을 지원합니다. 자세한 내용은 Snowflake 보호 섹션을 참조하십시오.

      6. 복사본 아이콘(보조 기술의 경우 복사본 버튼입니다.)을 선택하여 결과 문자열을 복사합니다.

    • SQL 명령을 실행하여 구성 정보를 가져옵니다.

      1. SQL Commands 탭을 선택합니다.

      2. 필요한 정보를 제공하는 명령 옆에 있는 복사본 아이콘(보조 기술의 경우 복사본 버튼입니다.)을 선택하고 해당 명령을 워크시트에 붙여넣은 다음 명령을 실행합니다.

SQL 명령을 사용하여 연결 설정 가져오기

SQL 명령을 실행하여 클라이언트, 드라이버, 라이브러리 또는 애플리케이션을 구성하는 데 필요한 다음 정보를 얻을 수 있습니다.

설정

SQL 명령

현재 계정의 계정 식별자

  • organization_name-account_name 양식의 계정 식별자를 받으려면:

    SELECT CURRENT_ORGANIZATION_NAME() || '-' || CURRENT_ACCOUNT_NAME();
    
    Copy
  • 계정 찾기 양식의 계정 식별자를 얻으려면:

    SELECT CURRENT_ACCOUNT();
    
    Copy

현재 사용자 이름

SELECT CURRENT_USER();
Copy

현재 역할

SELECT CURRENT_ROLE();
Copy

현재 리전

SELECT CURRENT_REGION();
Copy

현재 웨어하우스

SELECT CURRENT_WAREHOUSE();
Copy

현재 데이터베이스

SELECT CURRENT_DATABASE();
Copy

현재 스키마

SELECT CURRENT_SCHEMA();
Copy

클라이언트 및 드라이버가 사용하는 계정 형식

클라이언트와 드라이버에 따라 계정을 지정하는 구문이 다릅니다.

일반적으로 조직 이름(orgname)과 계정 이름(account_name)이 포함된 변형을 사용해야 합니다.

이 규칙의 한 가지 예외 는 클라이언트 리디렉션 기능을 사용하는 경우입니다. 이 기능을 사용하는 경우 계정 이름(account_name)을 연결 이름(connection_name)으로 바꾸십시오. 이 구문의 예는 연결 URL 사용하기 섹션을 참조하십시오.

Snowflake 서비스에 대한 비공개 연결을 구성하려면 계정 이름 또는 계정 찾기 구문에 .privatelink 를 추가합니다. 비공개 연결을 사용할 때 Snowflake에 연결하는 데 사용해야 하는 값을 결정하려면 Snowflake 계정에서 SYSTEM$GET_PRIVATELINK_CONFIG 함수를 호출하십시오.

계정 위치 찾기를 사용해야 하는 경우 계정 위치 찾기 뒤에 클라우드 리전 ID, 클라우드 및 정부 규정 준수 수준을 추가 세그먼트로 지정해야 할 수도 있습니다. 사용할 형식은 형식 2: 리전의 계정 로케이터 섹션을 참조하십시오. 아래 예제에서 account_locator_with_additional_segments 는 필수인 추가 세그먼트가 있는 계정 위치를 나타냅니다.

SnowSQL:
  • 계정 이름: snowsql -a orgname-account_name

  • 계정 로케이터: snowsql -a account_locator_with_additional_segments

자세한 내용은 연결 구문 섹션을 참조하십시오.

JDBC:
  • 계정 이름: jdbc:snowflake://orgname>-<account_name.snowflakecomputing.com/?connection_paramsr

  • 계정 로케이터: jdbc:snowflake://account_locator_with_additional_segments.snowflakecomputing.com/?connection_params

자세한 내용은 JDBC 드라이버 연결 문자열 섹션을 참조하십시오.

ODBC:
  • 계정 이름:

    • 서버: orgname-account_name.snowflakecomputing.com

  • 계정 로케이터:

    • 서버: account_locator_with_additional_segments.snowflakecomputing.com}

자세한 내용은 ODBC 구성 및 연결 매개 변수 섹션을 참조하십시오.

Python:
  • 계정 이름:

    • ACCOUNT 매개 변수 값을 orgname-account_name 으로 설정합니다.

  • 계정 로케이터:

    • ACCOUNT 매개 변수 값을 account_locator_with_additional_segments 로 설정합니다.

자세한 내용은 Python 커넥터를 사용하여 Snowflake에 연결하기 섹션을 참조하십시오.

.Net:
  • 계정 이름:

    • ACCOUNT 매개 변수 값을 orgname-account_name 으로 설정합니다.

    • HOST 매개 변수 값을 기본값(.snowflakecomputing.com)으로 설정합니다.

  • 계정 로케이터:

    • ACCOUNT 매개 변수 값을 account_locator_with_additional_segments 로 설정합니다.

    • HOST 매개 변수 값을 기본값 .snowflakecomputing.com 으로 설정합니다. Snowflake 계정이 us-west 리전에 없는 경우 지정합니다.

자세한 내용은 연결하기 섹션을 참조하십시오.

Golang:
  • 계정 이름: db, err := sql.Open("snowflake", "jsmith:mypassword@orgname-account_name/mydb/testschema?warehouse=mywh")

  • 계정 로케이터: sql.Open("snowflake", "jsmith:mypassword@account_locator_with_additional_segments/mydb/testschema?warehouse=mywh")

자세한 내용은 연결 문자열 섹션을 참조하십시오.

node.js:
  • 계정 이름: ACCOUNT 매개 변수 값을 orgname-account_name 으로 설정합니다.

  • 계정 로케이터: ACCOUNT 매개 변수 값을 account_locator_with_additional_segments 로 설정합니다.

자세한 내용은 연결 관리하기 섹션을 참조하십시오.

Spark(커넥터):
  • 계정 이름: JDBC와 동일함

  • 계정 로케이터: JDBC와 동일함

자세한 내용은 커넥터에 대한 구성 옵션 설정하기 섹션을 참조하십시오.

Spark(Databricks):
  • 계정 이름: Account URL for Snowflake account

  • 계정 로케이터: Account Locator URL for Snowflake account

자세한 내용은 Databricks에서 Spark용 Snowflake 구성하기 섹션을 참조하십시오.

Spark(Qubole):
  • 계정 이름: Host Address 필드 값을 orgname-account_name.snowflakecomputing.com 으로 설정합니다.

  • 계정 로케이터: Host Address 필드 값을 account_locator_with_additional_segments.snowflakecomputing.com 으로 설정합니다.

자세한 내용은 Qubole에서 Spark용 Snowflake 구성하기 섹션을 참조하십시오.

PHP:
  • 계정 이름:

    • ACCOUNT 매개 변수 값을 orgname-account_name 으로 설정합니다.

    • 모든 리전에 대해 REGION 매개 변수 값을 공백으로 둡니다.

  • 계정 로케이터:

    • ACCOUNT 매개 변수 값을 account_locator 로 설정합니다.

    • Snowflake 계정이 us-west 리전에 없는 경우 REGION 매개 변수 값을 설정합니다.

자세한 내용은 Snowflake 데이터베이스에 연결하기 섹션을 참조하십시오.

SQLAlchemy:
  • 계정 이름: snowflake://user_login_name:password@orgname-account_name

  • 계정 로케이터: snowflake://user_login_name:password@account_locator_with_additional_segments

자세한 내용은 Python 커넥터와 함께 Snowflake SQLAlchemy 도구 키트 사용하기 섹션을 참조하십시오.

추가 구성 단계

다음 항목에서는 연결 구성의 특정 영역에 대해 설명합니다.