macOS용 ODBC 드라이버 설치 및 구성하기

Windows와 유사하게, macOS에서도 명명된 데이터 소스(DSNs)를 사용하여 ODBC 기반 클라이언트 애플리케이션을 Snowflake로 연결합니다.

이 항목의 내용:

전제 조건

운영 체제

Snowflake 클라이언트에서 지원되는 운영 체제 목록은 운영 체제 지원 을 참조하십시오.

iODBC

Mac용 Snowflake ODBC 드라이버를 위해서는 iODBC가 필요하며, 이를 다운로드할 수 있는 위치는 다음과 같습니다.

iODBC을 설치하려면:

  1. iODBC를 다운로드한 후 다운로드한 .dmg 파일을 두 번 클릭합니다.

  2. 설치 관리자 파일인 iODBC-SDK.pkg 를 두 번 클릭한 후 안내를 따릅니다.

    기본적으로 패키지는 /Library/Application Support/iODBC/bin 디렉터리에 소프트웨어를 설치합니다. iODBC 명령을 실행하려고 전체 경로 이름을 지정할 필요가 없도록 이 디렉터리를 $PATH 환경 변수에 추가할 수 있습니다.

참고

iODBC는 드라이버 및 DSNs를 구성하기 위한 GUI 관리자 도구를 제공하지만, 이 도구는 Snowflake에서의 사용이 테스트되지 않았으므로 DSNs를 생성하거나 관리하기 위한 용도로 사용하지 말아야 합니다. 대신, ODBC 관리자를 사용하십시오.

1단계: ODBC 드라이버 설치

macOS용 Snowflake ODBC 드라이버를 설치하려면:

  1. 아직 드라이버를 설치하지 않은 경우 지금 다운로드합니다. 자세한 내용은 ODBC 드라이버 다운로드하기 섹션을 참조하십시오.

  2. 다운로드한 .dmg 파일인 snowflake_odbc_mac-<버전>.dmg 를 두 번 클릭합니다.

  3. 설치 관리자 파일인 snowflakeODBC_<버전>.pkg 을 두 번 클릭하고 안내를 따릅니다.

    드라이버를 설치 중인 시스템의 관리자/sudo 비밀번호를 입력하라는 메시지가 표시될 수 있습니다.

메시지가 표시될 때 기본 디렉터리를 선택하면 설치 관리자는 ODBC 드라이버 파일을 다음 디렉터리에 설치합니다.

/opt/snowflake/snowflakeodbc

/Library/ODBC

2단계: ODBC 드라이버 구성

macOS용 ODBC 드라이버를 구성하려면 데이터 소스(DSNs)를 1개 이상 생성합니다. 그러면 생성할 DSN의 타입에 따라 다음 파일에 저장됩니다.

  • 사용자 DSNs: ~/Library/ODBC/odbc.ini

  • 시스템 DSNs: /Library/ODBC/odbc.ini

DSN를 생성하려면, ODBC 관리자를 사용하거나 해당 odbc.ini 파일을 편집합니다.

ODBC 관리자를 사용하여 DSN 만들기

ODBC 관리자에 DSN를 생성하려면:

  1. ODBC 관리자를 시작합니다.

  2. User DSN 또는 System DSN 를 클릭합니다.

  3. Add 버튼을 클릭합니다.

  4. 사용할 드라이버(Snowflake)를 선택하고 OK 을 클릭합니다.

  5. DSN의 이름을 입력하고 선택 사항으로 설명을 입력합니다.

  6. 각 DSN 매개 변수에 대한 키워드/값 페어를 생성합니다.

    1. Add 를 클릭하여 키워드/값 페어를 생성합니다.

    2. Keyword 를 선택하고 매개 변수 이름으로 바꿉니다.

    3. Value 을 선택하고 매개 변수의 값으로 바꿉니다.

    각 매개 변수에서 이 프로세스를 반복합니다. 각 DSN에 대하여 설정할 수 있는 매개 변수에 대한 자세한 내용은 ODBC 구성 및 연결 매개 변수 를 참조하십시오.

  7. OK 을 클릭하여 DSN을 생성합니다.

ODBC 드라이버용 첫 번째 사용자 또는 시스템 DSN를 생성하는 경우, ODBC 드라이버는 생성 중인 DSN의 타입에 해당하는 디렉터리에 odbc.ini 파일을 생성합니다. 추가 DSNs를 생성하는 경우, ODBC 관리자는 각 DSN에 대한 항목을 기존 odbc.ini 파일에 추가합니다.

odbc.ini 파일에 항목을 추가하여 DSN 만들기

드라이버용 사용자 또는 시스템 DSN가 이미 생성된 경우, 생성 중인 DSN의 타입에 해당하는 디렉터리에 이미 있는 odbc.ini 파일에 새 항목을 추가합니다. 드라이버용 첫 번째 DSN를 생성하는 경우에는 반드시 odbc.ini 파일을 수동으로 생성한 후 항목을 파일에 추가해야 합니다.

각 DSN에 대하여 다음을 지정합니다.

  • <dsn_이름> = <드라이버_이름> 형식의 DSN 이름 및 드라이버 이름(Snowflake).

  • Driver = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib 형식의 드라이버 파일에 대한 디렉터리 경로 및 이름.

  • 연결 매개 변수, 예: serveruid (사용자 로그인 이름). DSN에 추가한 모든 연결 매개 변수는 ODBC 연결 문자열에 지정할 필요가 없습니다.

  • 모든 추가 매개 변수, 예: 기본 role, databasewarehouse.

매개 변수는 <매개 변수_이름> = <값> 의 형식으로 지정됩니다. 각 DSN에 대하여 설정할 수 있는 매개 변수에 대한 자세한 내용은 ODBC 구성 및 연결 매개 변수 를 참조하십시오.

다음 예는 server URL에 계정 식별자 의 다른 형식을 사용하는 데이터 소스 2개를 구성하는 odbc.ini 파일을 보여줍니다.

  • testodbc1 에서는 myorganization 조직에 myaccount 계정을 지정하는 계정 식별자 를 사용하는 계정 식별자를 사용합니다.

  • testodbc2 에서는 계정 로케이터 xy12345 를 계정 식별자로 사용합니다.

    testodbc2 에서는 AWS US 서부(오레곤) 리전의 계정을 사용함에 유의하십시오. 계정이 다른 리전에 있거나 계정이 다른 클라우드 공급자를 사용하는 경우 계정 로케이터 다음에 추가 세그먼트를 지정 해야 합니다.

    [ODBC Data Sources]
    testodbc1 = Snowflake
    testodbc2 = Snowflake
    
    
    [testodbc1]
    Driver      = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib
    Description =
    uid         = peter
    server      = myorganization-myaccount.snowflakecomputing.com
    role        = sysadmin
    
    
    [testodbc2]
    Driver      = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib
    Description =
    uid         = mary
    server      = xy12345.snowflakecomputing.com
    role        = analyst
    database    = sales
    warehouse   = analysis
    

다음 사항을 참고하십시오.

  • testodbc1testodbc2 모두에 기본 역할이 있습니다.

  • testodbc2 에도 기본 데이터베이스 및 웨어하우스가 있습니다.

3단계: ODBC 드라이버 테스트

iODBC와 함께 제공되는 iodbctest 명령줄 유틸리티를 사용하여 생성한 DSNs를 테스트할 수 있습니다.

ODBC 연결 문자열을 입력하라는 메시지가 표시되면, 필수 연결 매개 변수(DSN 이름, 서버, 사용자 로그인 이름 및 비밀번호)와 함께 연결 문자열의 일부로 입력할 기타 모든 매개 변수를 입력합니다. 연결 문자열에서는 <매개 변수_이름>=<값> (예: dsn=testodbc2)의 형식을 갖는 매개 변수가 사용되며, 각 매개 변수는 세미 콜론(;)으로 구분되고 공백이 없어야 합니다. 지원되는 매개 변수 목록은 ODBC 구성 및 연결 매개 변수 를 참조하십시오.

참고

DSN에 서버 및 사용자 로그인 이름을 설정하는 경우 연결 문자열에는 유일한 필수 매개 변수인 DSN 이름 및 사용자 비밀번호만 필요합니다.

예:

$ "/Library/Application Support/iODBC/bin/iodbctest"

iODBC Demonstration program
This program shows an interactive SQL processor
Driver Manager: 03.52.0607.1008

Enter ODBC connect string (? shows list): dsn=testodbc2;pwd=<password>

Dec 14 20:16:08 INFO  1299 SFConnection::connect: Tracing level: 4

Driver: 2.12.36 (Snowflake - Latest version supported by Snowflake: 2.12.38)

SQL>
맨 위로 이동