ODBC 드라이버

Open Database Connectivity(ODBC) 드라이버는 Windows와 macOS용 읽기 전용 ODBC 드라이버로, Microsoft Excel과 Power BI 같은 비즈니스 인텔리전스(BI) 및 데이터 시각화 애플리케이션을 SQL 플러그인에 연결할 수 있게 해줘요.

드라이버 다운로드 및 사용 방법은 GitHub의 SQL 저장소에서 확인할 수 있어요.

출처: 문서

본문

사양 (Specifications)

ODBC 드라이버는 ODBC 버전 3.51과 호환돼요.

지원되는 운영체제 버전 (Supported operating system versions)

다음 운영체제가 지원돼요.

Operating system	Version
Windows	Windows 10, Windows 11
macOS	Catalina 10.15.4, Mojave 10.14.6, Big Sur 11.6.7, Monterey 12.4

개념 (Concepts)

Term	Definition
DSN	DSN(Data Source Name)은 드라이버 정보를 시스템에 저장하는 데 사용돼요. 정보를 시스템에 저장해 두면 드라이버가 연결할 때마다 정보를 지정할 필요가 없어요.
.tdc 파일	TDC 파일은 파일에 정의된 데이터베이스 벤더 이름과 드라이버 이름과 일치하는 모든 연결에 Tableau가 적용하는 구성 정보를 담고 있어요. 이 구성을 통해 ODBC 데이터 연결의 일부를 미세 조정하고, 데이터 소스에서 지원되지 않는 특정 기능을 켜거나 끌 수 있어요.

드라이버 설치 (Install driver)

드라이버를 설치하려면 여기에서 번들 배포 설치 프로그램을 다운로드하거나 소스에서 빌드하세요.

Windows

다운로드한 OpenSearch SQL ODBC Driver--Windows.msi 설치 프로그램을 엽니다. 설치 프로그램은 서명되지 않아 보안 대화상자가 표시돼요. More info를 선택한 다음 Run anyway를 선택하세요. OpenSearch SQL ODBC Driver--Windows.msi

More info

Run anyway
설치를 진행하려면 Next를 선택하세요. Next
계약에 동의하고 Next를 선택하세요. Next
설치 프로그램에는 다양한 BI 도구에 연결하기 위한 문서와 유용한 리소스 파일이 함께 제공돼요(예: Tableau용 .tdc 파일). 이 리소스를 유지하거나 제거할 수 있어요. Next를 선택하세요. .tdc

Next
Install과 Finish를 선택하세요. Install

Finish

기본 DSN의 일부로 다음 연결 정보가 설정돼요.

Host: localhost
Port: 9200
Auth: NONE

DSN을 사용자 지정하려면 Windows 10에 미리 설치된 ODBC Data Source Administrator를 사용하세요.

macOS

macOS에 ODBC 드라이버를 설치하기 전에 iODBC Driver Manager를 설치하세요.

다운로드한 OpenSearch SQL ODBC Driver--Darwin.pkg 설치 프로그램을 엽니다. 설치 프로그램은 서명되지 않아 보안 대화상자가 표시돼요. 설치 프로그램을 오른쪽 클릭하고 Open을 선택하세요. OpenSearch SQL ODBC Driver--Darwin.pkg

Open
설치를 진행하려면 Continue를 여러 번 선택하세요. Continue
드라이버 파일을 설치할 Destination을 선택하세요. Destination
설치 프로그램에는 다양한 BI 도구에 연결하기 위한 문서와 유용한 리소스 파일이 함께 제공돼요(예: Tableau용 .tdc 파일). 이 리소스를 유지하거나 제거할 수 있어요. Continue를 선택하세요. .tdc

Continue
Install과 Close를 선택하세요. Install

Close

현재 DSN은 설치의 일부로 설정되지 않으므로 수동으로 구성해야 해요. 먼저 iODBC Administrator를 여세요.

sudo /Applications/iODBC/iODBC\ Administrator64.app/Contents/MacOS/iODBC\ Administrator64

이 명령은 애플리케이션에 드라이버와 DSN 구성을 저장할 권한을 부여해요.

ODBC Drivers 탭을 선택하세요.
Add a Driver를 선택하고 다음 내용을 입력하세요: Description of the Driver: ODBC 연결에 사용한 드라이버 이름을 입력해요(예: OpenSearch SQL ODBC Driver). Driver File Name: 드라이버 파일 경로를 입력해요(기본값: /bin/libopensearchsqlodbc.dylib). Setup File Name: 설정 파일 경로를 입력해요(기본값: /bin/libopensearchsqlodbc.dylib). Description of the Driver: ODBC 연결에 사용한 드라이버 이름을 입력해요(예: OpenSearch SQL ODBC Driver).

Driver File Name: 드라이버 파일 경로를 입력해요(기본값: <driver-install-dir>/bin/libopensearchsqlodbc.dylib).

Setup File Name: 설정 파일 경로를 입력해요(기본값: <driver-install-dir>/bin/libopensearchsqlodbc.dylib).
사용자 드라이버를 선택하세요.
옵션을 저장하려면 OK를 선택하세요.
User DSN 탭을 선택하세요.
Add를 선택하세요.
앞에서 추가한 드라이버를 선택하세요.
**Data Source Name (DSN)**에는 연결 옵션을 저장하는 데 사용할 DSN 이름을 입력해요(예: OpenSearch SQL ODBC DSN).
Comment에는 선택 사항으로 주석을 추가해요.
+ 버튼을 사용해 키-값 쌍을 추가하세요. 기본 로컬 OpenSearch 설치에는 다음 옵션을 권장해요. vale off

Host: localhost - OpenSearch 서버 엔드포인트
Port: 9200 - 서버 포트
Auth: NONE - 인증 모드
Username: (blank) - BASIC 인증에 사용되는 사용자 이름
Password: (blank)- BASIC 인증에 사용되는 비밀번호
ResponseTimeout: 10 - 서버의 응답을 기다리는 시간(초)
UseSSL: 0 - 연결에 SSL을 사용하지 않음

DSN 구성을 저장하려면 OK를 선택하세요.
iODBC Administrator를 종료하려면 OK를 선택하세요.

ODBC 드라이버 사용자 지정 (Customizing the ODBC driver)

드라이버는 라이브러리 파일 형태로 제공돼요. Windows에서는 opensearchsqlodbc.dll, macOS에서는 libopensearchsqlodbc.dylib예요.

ODBC 호환 BI 도구와 함께 사용하는 경우 새 ODBC 드라이버 구성에 대한 BI 도구 문서를 참고하세요. 일반적으로 필요한 것은 BI 도구가 드라이버 라이브러리 파일의 위치를 알게 한 다음 그걸 사용해 데이터베이스(즉, OpenSearch) 연결을 설정하는 것뿐이에요.

연결 문자열 및 기타 설정 (Connection strings and other settings)

ODBC 드라이버는 ODBC 연결 문자열을 사용해요. 연결 문자열은 세미콜론으로 구분된 문자열로, 연결에 사용할 수 있는 옵션 집합을 지정해요. 일반적으로 연결 문자열은 다음 중 하나를 사용해요.

미리 구성된 옵션 집합을 담고 있는 Data Source Name(DSN)을 지정하거나(DSN=xxx;User=xxx;Password=xxx;).
문자열을 사용해 옵션을 명시적으로 구성하거나(Host=xxx;Port=xxx;LogLevel=ES_DEBUG;...).

DSN 또는 연결 문자열을 사용해 다음 드라이버 옵션을 구성할 수 있어요.

모든 옵션 이름은 대소문자를 구분하지 않아요.

기본 옵션 (Basic options)

Option	Description	Type	Default
`DSN`	연결을 구성하는 데 사용한 데이터 소스 이름이에요.	`string`	-
`Host / Server`	대상 클러스터의 호스트 이름 또는 IP 주소예요.	`string`	-
`Port`	OpenSearch 클러스터의 REST 인터페이스가 수신 대기하는 포트 번호예요.	`string`	-

인증 옵션 (Authentication options)

Option	Description	Type	Default
`Auth`	사용할 인증 메커니즘이에요.	`BASIC` (basic HTTP), `AWS_SIGV4` (AWS auth), 또는 `NONE`	`NONE`
`User / UID`	[`Auth=BASIC`] 연결에 대한 사용자 이름이에요.	`string`	-
`Password / PWD`	[`Auth=BASIC`] 연결에 대한 비밀번호예요.	`string`	-
`Region`	[`Auth=AWS_SIGV4`] 요청 서명에 사용되는 리전이에요.	`AWS region (for example, us-west-1)`	-

고급 옵션 (Advanced options)

Option	Description	Type	Default
`UseSSL`	SSL/TLS를 통해 연결을 설정할지 여부예요.	`boolean (0 or 1)`	`false (0)`
`HostnameVerification`	SSL/TLS 연결에 대해 인증서 호스트 이름 검증을 수행해야 하는지 여부를 나타내요.	`boolean` (0 or 1)	`true (1)`
`ResponseTimeout`	호스트의 응답을 기다리는 최대 시간(초)이에요.	`integer`	`10`

로깅 옵션 (Logging options)

Option	Description	Type	Default
`LogLevel`	드라이버 로그의 심각도 수준이에요.	`LOG_OFF`, `LOG_FATAL`, `LOG_ERROR`, `LOG_INFO`, `LOG_DEBUG`, `LOG_TRACE`, 또는 `LOG_ALL`	`LOG_WARNING`
`LogOutput`	드라이버 로그를 저장할 위치예요.	`string`	`WIN: C:\`, `MAC: /tmp`

로깅 옵션을 변경하려면 관리자 권한이 필요해요.

Tableau에 연결하기 (Connecting to Tableau)

사전 요구 사항:

DSN이 이미 설정되어 있는지 확인하세요.
OpenSearch가 DSN에서 구성한 _host_와 _port_에서 실행 중인지 확인하세요.
.tdc가 macOS와 Windows 모두에서 <user_home_directory>/Documents/My Tableau Repository/Datasources에 복사되어 있는지 확인하세요.

Tableau를 시작해요. Connect 섹션에서 To a Server로 이동해 Other Databases (ODBC)를 선택하세요. Connect

To a Server

Other Databases (ODBC)
DSN 드롭다운에서 앞의 단계에서 설정한 OpenSearch DSN을 선택하세요. 추가한 옵션은 Connection Attributes 아래에 자동으로 채워져요. DSN drop-down

Connection Attributes
Sign In을 선택하세요. 몇 초 후 Tableau가 OpenSearch 서버에 연결돼요. 연결되면 Datasource 창으로 이동하게 돼요. Database에는 OpenSearch 클러스터의 이름이 이미 채워져 있어요. 모든 인덱스를 나열하려면 Table 아래의 검색 아이콘을 클릭하세요. Sign In

Datasource

Database

Table
테이블을 연결 영역으로 끌어다 놓아 데이터 실험을 시작하세요. 테이블 데이터를 채우려면 Update Now 또는 Automatically Update를 선택하세요. Update Now

Automatically Update

더 자세한 내용은 GitHub 저장소에서 확인하세요.

문제 해결 (Troubleshooting)

Problem

서버에 연결할 수 없어요.

Workaround

이 문제는 대부분 OpenSearch 서버가 DSN에 구성된 host와 post에서 실행 중이지 않기 때문이에요. host와 post가 올바른지, OpenSearch 서버가 OpenSearch SQL 플러그인과 함께 실행 중인지 확인하세요. 또한 설치 프로그램과 함께 다운로드된 .tdc가 <user_home_directory>/Documents/My Tableau Repository/Datasources 디렉터리에 올바르게 복사되었는지 확인하세요.

Microsoft Power BI에 연결하기 (Connecting to Microsoft Power BI)

GitHub 저장소에 게시된 설치 지침과 구성 지침을 따르세요.

ODBC 드라이버

ODBC 드라이버

본문

사양 (Specifications)

지원되는 운영체제 버전 (Supported operating system versions)

개념 (Concepts)

드라이버 설치 (Install driver)

Windows

macOS

ODBC 드라이버 사용자 지정 (Customizing the ODBC driver)

연결 문자열 및 기타 설정 (Connection strings and other settings)

기본 옵션 (Basic options)

인증 옵션 (Authentication options)

고급 옵션 (Advanced options)

로깅 옵션 (Logging options)

Tableau에 연결하기 (Connecting to Tableau)

문제 해결 (Troubleshooting)

Microsoft Power BI에 연결하기 (Connecting to Microsoft Power BI)

더 알아보기 (Learn more)