Databricks OSS ODBC 드라이버

Important

Databricks OSS ODBC 드라이버 버전 0.5.0은 베타 버전입니다. 정식 출시된 버전 2.x 드라이버에 대한 자세한 내용은 Databricks ODBC 드라이버 문서를 참조하세요.

드라이버가 베타인 동안 문제를 보고하거나 기능 추가를 요청하려면 Databricks 계정 담당 팀에 문의하세요.

Databricks OSS ODBC 드라이버는 Databricks SQL 및 Lakehouse//RT 웨어하우스용 ODBC 3.8 드라이버입니다. 지원되는 워크로드를 위해 Databricks ODBC 드라이버 버전 2.x와 호환되도록 설계되었습니다. 기존 애플리케이션, DSN, 그리고 공통 2.x 기능을 사용하는 연결 문자열은 일반적으로 변경 없이 작동해야 합니다.

Requirements

Databricks OSS ODBC 드라이버와 Databricks ODBC 드라이버 버전 2.x는 동일한 등록된 ODBC 드라이버 이름, 패키지 식별자, 설치 경로, 라이브러리 이름을 사용합니다. 한 버전을 다른 버전보다 설치하면 기존 설치가 대체됩니다. 드라이버를 바꾸려면, 원하는 버전의 패키지를 다시 설치하세요.

Databricks OSS ODBC 드라이버는 다음 플랫폼에서 지원됩니다:

운영 체제 패키지 및 아키텍처 요구 사항
Windows x64와 x86용 MSI 드라이버 아키텍처는 애플리케이션 아키텍처와 일치해야 합니다.
macOS 인텔과 애플 실리콘용 범용 .pkg macOS 13.3 이상입니다.
리눅스 x86_64, aarch64 및 i686용 .deb 및 .rpm glibc 2.28 이상과 호환되는 ODBC 드라이버 관리자.

Databricks SQL 또는 Lakehouse//RT 웨어하우스를 위해 서버 호스트네임 과 HTTP 경로 도 필요합니다. Azure Databricks 컴퓨팅 리소스에 대한 연결 세부 정보 가져오기를 참조하세요.

Databricks OSS ODBC 드라이버를 설치하세요

  1. Databricks OSS ODBC 드라이버 아카이브에서 운영체제와 아키텍처에 맞는 Databricks OSS ODBC 드라이버 버전 0.5.0을 다운로드하세요.
  2. 다운로드한 패키지 설치:

    • Windows에서는 다운로드를 압축 해제하고 32비트 또는 64비트 MSI를 실행하세요. 설치 프로그램은 Databricks ODBC 드라이버를 Windows ODBC 드라이버 관리자에 등록합니다.

    • macOS에서는 DatabricksODBC-<version>-macOS.pkg을 실행하세요.

    • 리눅스에서는 or .rpm 패키지를 .deb 설치하고 드라이버를 unixODBC에 등록하세요:

      sudo odbcinst -i -d -f /opt/databricks/databricksodbc/Setup/odbcinst.ini

드라이버 라이브러리는 버전 2.x와 동일한 위치에 설치됩니다:

  • Windows 64비트: C:\Program Files\Databricks ODBC Driver\lib\databricksodbc64.dll
  • Windows 32비트: C:\Program Files (x86)\Databricks ODBC Driver\lib\databricksodbc32.dll
  • macOS: /Library/databricks/databricksodbc/lib/libdatabricksodbc.dylib
  • 리눅스 64비트: /opt/databricks/databricksodbc/lib/64/libdatabricksodbc64.so
  • 리눅스 32비트: /opt/databricks/databricksodbc/lib/32/libdatabricksodbc32.so

연결 구성

기존의 2.x DSN이나 연결 문자열부터 시작하세요. , 와 같은 일반적인 속성DriverHTTPPathPortSSLHostCatalog들은 호환됩니다.Schema 드라이버는 기존 DSN을 재사용할 수 있도록, 해당 HTTP 전송에는 필요하지 않은 일반적인 2.x 속성도 지원합니다.

이 설정으로 DSN 또는 DSN 없는 연결 문자열을 생성하려면 Databricks ODBC 드라이버용 ODBC DSN 생성 또는 Databricks ODBC 드라이버용 ODBC DSN 없는 연결 문자열 생성 항목을 참조하세요.

새로운 연결의 경우, 다음 예시의 속성을 사용하세요. DSN의 경우, ODBC 드라이버 매니저를 사용해 동일한 키값 쌍을 입력하세요.

다음 예시는 OAuth 사용자-기계(U2M) 인증을 사용합니다. 가독성을 위해 줄 바뉏기가 포함되어 있습니다. 연결 문자열에는 포함하지 마세요:

Driver=<path-to-driver>;
Host=<server-hostname>;
Port=443;
HTTPPath=<http-path>;
SSL=1;
AuthMech=11;
Auth_Flow=2;
Catalog=main;
Schema=default

지원되는 인증 방법은 다음과 같습니다.

인증 방법 Properties
OAuth U2M(사용자-컴퓨터) AuthMech=11;Auth_Flow=2; PWD 가 필요하지 않습니다. 영구 토큰 캐싱은 기본적으로 활성화되어 있습니다. 비활성화하려면 EnableTokenCache=0로 설정하고, 캐시를 암호화할 때 패스프레이즈를 사용하려면 TokenCachePassPhrase로 설정하세요.
OAuth 기계 간 (M2M) AuthMech=11;Auth_Flow=1;Auth_Client_ID=<client-id>;Auth_Client_Secret=<client-secret>;
OAuth 토큰 패스스루 AuthMech=11;Auth_Flow=0;Auth_AccessToken=<oauth-token>;
Azure Databricks 개인용 액세스 토큰 AuthMech=3;UID=token;PWD=<personal-access-token>;

버전 2.x에서 마이그레이션하기

  1. 애플리케이션에서 사용하는 기능들의 알려진 제한 사항을 검토하세요.
  2. 설치된 2.x 버전을 기록하고 DSN, 연결 문자열, 드라이버 설정 파일을 백업하세요.
  3. Databricks OSS ODBC 드라이버를 설치하세요.
  4. 기존 DSN이나 연결 문자열을 재사용하세요.
  5. 연결 생성, 메타데이터 탐색, 준비된 문장, 매개변수 바인딩, 취소, 대규모 결과 검색, 대표성 애플리케이션 워크플로우 테스트.

Databricks OSS ODBC 드라이버는 2.x보다 더 구체적인 Databricks 타입 이름과 선언된 십진법 정밀도 및 스케일을 보고할 수 있습니다. 메타데이터 값을 정확하게 일치 비교하는 애플리케이션을 검증하세요.

설치 교체 후 롤백하려면 필요한 2.x 패키지를 재설치하고 백업된 구성을 복원하세요.

알려진 제한 사항

드라이버가 베타 상태일 때는 다음과 같은 제한사항이 적용됩니다:

  • 이 드라이버는 Databricks SQL 및 Lakehouse//RT 웨어하우스를 지원합니다. 이 소프트웨어는 다목적 컴퓨팅을 지원하지 않습니다.
  • SQL은 항상 Azure Databricks로 직접 전송됩니다. 드라이버는 2.x에서 제공되는 SQL-92 변환을 수행하지 않습니다. UseNativeQuery 호환성은 허용되지만 행동에는 변화를 주지 않습니다.
  • 비동기 실행 SQL_ATTR_ASYNC_ENABLESQLCompleteAsync 은 지원되지 않습니다.
  • PUT, GET 및 REMOVE Unity Catalog 볼륨 내 파일에 대한 작업은 지원되지 않습니다.
  • 이진 입력 매개변수는 지원되지 않습니다.
  • pyodbc fast_executemany 등 문자열 및 유니코드 값을 포함한 매개변수 배열도 지원하지만, 드라이버는 행당 한 번의 실행 요청을 보냅니다.
  • 큰 결과는 Cloud Fetch를 자동으로 사용하며 강제 인라인화할 수 없습니다. 결과 검색은 OBJECT 및 FILE를 제외한 Databricks SQL 데이터 형식을 지원합니다. 복소 값은 텍스트로 반환됩니다.
  • HTTPS 프록시는 기본 인증은 지원하지만, Kerberos나 SPNEGO 인증은 지원하지 않습니다.
  • 인증서 취소 설정과 암호화된 상호 TLS 개인 키는 지원되지 않습니다.
  • 일부 고급 2.x 속성은 지원되지 않습니다. 운전자는 해당 부동산이 적용되지 않을 때 경고를 기록합니다.
  • 에 마지막으로 업데이트됨