macOS용 ODBC 드라이버 설치 및 구성하기¶
Windows와 유사하게, macOS에서도 명명된 데이터 소스(DSNs)를 사용하여 ODBC 기반 클라이언트 애플리케이션을 Snowflake로 연결합니다.
이 항목의 내용:
전제 조건¶
iODBC¶
Mac용 Snowflake ODBC 드라이버를 위해서는 iODBC가 필요하며, 이를 다운로드할 수 있는 위치는 다음과 같습니다.
iODBC을 설치하려면:
iODBC를 다운로드한 후 다운로드한 .dmg 파일을 두 번 클릭합니다.
설치 관리자 파일인
iODBC-SDK.pkg
를 두 번 클릭한 후 안내를 따릅니다.기본적으로 패키지는
/Library/Application Support/iODBC/bin
디렉터리에 소프트웨어를 설치합니다. iODBC 명령을 실행하려고 전체 경로 이름을 지정할 필요가 없도록 이 디렉터리를$PATH
환경 변수에 추가할 수 있습니다.
참고
iODBC는 드라이버 및 DSNs를 구성하기 위한 GUI 관리자 도구를 제공하지만, 이 도구는 Snowflake에서의 사용이 테스트되지 않았으므로 DSNs를 생성하거나 관리하기 위한 용도로 사용하지 말아야 합니다. 대신, ODBC 관리자를 사용하십시오.
ODBC 관리자 — 선택 사항/권장됨¶
ODBC 관리자는 드라이버를 구성하고 DSNs를 생성/관리하기 위한 GUI 도구입니다. 해당 odbc.ini
파일을 편집하여 DSNs를 수동으로 생성할 수도 있으므로 이 도구를 사용하는 것은 선택 사항입니다. ODBC 관리자 제공처:
ODBC 관리자를 설치하려면:
ODBC 관리자를 다운로드한 후 다운로드한 .dmg 파일을 두 번 클릭합니다.
설치 관리자 파일인
ODBC Manager.pkg
를 두 번 클릭한 후 안내를 따릅니다.
설치 관리자가 ODBC 관리자를 ~/Applications/Utilities
디렉터리에 설치합니다.
1단계: ODBC 드라이버 설치¶
macOS용 Snowflake ODBC 드라이버를 설치하려면:
아직 드라이버를 설치하지 않은 경우 지금 다운로드합니다. 자세한 내용은 ODBC 드라이버 다운로드하기 섹션을 참조하십시오.
다운로드한 .dmg 파일인
snowflake_odbc_mac-<버전>.dmg
를 두 번 클릭합니다.설치 관리자 파일인
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를 생성하려면:
ODBC 관리자를 시작합니다.
User DSN 또는 System DSN 를 클릭합니다.
Add 버튼을 클릭합니다.
사용할 드라이버(Snowflake)를 선택하고 OK 을 클릭합니다.
DSN의 이름을 입력하고 선택 사항으로 설명을 입력합니다.
각 DSN 매개 변수에 대한 키워드/값 페어를 생성합니다.
Add 를 클릭하여 키워드/값 페어를 생성합니다.
Keyword 를 선택하고 매개 변수 이름으로 바꿉니다.
Value 을 선택하고 매개 변수의 값으로 바꿉니다.
각 매개 변수에서 이 프로세스를 반복합니다. 각 DSN에 대하여 설정할 수 있는 매개 변수에 대한 자세한 내용은 ODBC 구성 및 연결 매개 변수 를 참조하십시오.
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
형식의 드라이버 파일에 대한 디렉터리 경로 및 이름.연결 매개 변수, 예:
server
및uid
(사용자 로그인 이름). DSN에 추가한 모든 연결 매개 변수는 ODBC 연결 문자열에 지정할 필요가 없습니다.모든 추가 매개 변수, 예: 기본
role
,database
및warehouse
.
매개 변수는 <매개 변수_이름> = <값>
의 형식으로 지정됩니다. 각 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
다음 사항을 참고하십시오.
testodbc1
및testodbc2
모두에 기본 역할이 있습니다.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>