다음을 통해 공유

Databricks ODBC 드라이버에 대한 드라이버 기능 설정

  • 아티클

이 문서에서는 Databricks ODBC 드라이버에 대한 특수 및 고급 드라이버 기능 설정을 구성하는 방법을 설명합니다.

Datbricks ODBC 드라이버는 다음과 같은 특수 및 고급 드라이버 기능 설정을 제공합니다.

ODBC에서 초기 스키마 설정

ODBC 드라이버를 사용하면 Schema=<schema-name>을 연결 구성으로 설정하여 스키마를 지정할 수 있습니다. 이는 USE <schema-name>을 사용하는 것과 같습니다.

ODBC의 ANSI SQL-92 쿼리 지원

ODBC 드라이버는 ANSI SQL-92 언어로 SQL 쿼리를 수락하고 쿼리를 Databricks SQL 언어로 변환합니다. 그러나 애플리케이션이 직접 Databricks SQL을 생성하거나 애플리케이션이 Azure Databricks와 관련된 비 ANSI SQL-92 표준 SQL 구문을 사용하는 경우, Databricks는 UseNativeQuery=1를 연결 구성으로 설정하는 것이 좋습니다. 이 설정으로 드라이버는 SQL 쿼리를 Azure Databricks에 그대로 전달합니다.

ODBC에서 대규모 쿼리 결과 추출

대규모 쿼리 결과를 추출할 때 최상의 성능을 얻으려면 다음 최적화를 포함하는 최신 버전의 ODBC 드라이버를 사용합니다.

ODBC의 화살표 serialization

ODBC 드라이버 버전 2.6.15 이상에서는 Apache Arrow를 사용하는 최적화된 쿼리 결과 serialization 형식을 지원합니다.

ODBC의 Cloud Fetch

ODBC 드라이버 버전 2.6.17 이상은 Azure Databricks 배포에 설정된 클라우드 스토리지를 통해 쿼리 결과를 가져오는 기능인 Cloud Fetch를 지원합니다.

쿼리 결과는 화살표 직렬화된 파일로 내부 DBFS 스토리지 위치에 최대 20MB까지 업로드됩니다. 쿼리 완료 후 드라이버에서 가져오기 요청을 보내면 Azure Databricks는 업로드된 파일에 공유 액세스 서명을 생성하고 반환합니다. 그런 다음 ODBC 드라이버는 URL을 사용하여 DBFS에서 직접 결과를 다운로드합니다.

Cloud Fetch는 1MB보다 큰 쿼리 결과에만 사용됩니다. 더 작은 결과는 Azure Databricks에서 직접 검색됩니다.

Azure Databricks는 24시간 후에 삭제되도록 표시된 누적 파일을 자동으로 수집합니다. 이렇게 표시된 파일은 24시간 후에 완전히 삭제됩니다.

Cloud Fetch 아키텍처에 대한 자세한 내용은 BI Tools를 사용하여 높은 대역폭 연결을 달성한 방법을 참조하세요.

로깅 사용

Windows용 ODBC 드라이버에서 로깅을 사용하도록 설정하려면 관련 DSN에 대한 ODBC 데이터 원본 관리자에서 다음 필드를 설정합니다.

  • 모든 드라이버 활동을 기록하려면 TRACE를 통해 심각한 이벤트만 기록하도록 로그 수준 필드를 FATAL에서 설정합니다.
  • 로그 파일을 저장할 폴더의 전체 경로로 로그 경로 필드를 설정합니다.
  • 최대 숫자 파일 필드를 유지할 최대 로그 파일 수로 설정합니다.
  • 최대 파일 크기 필드를 각 로그 파일의 최대 크기(MB)로 설정합니다.

비 Windows 컴퓨터에 대해 ODBC 드라이버에서 로깅을 사용하도록 설정하려면 관련 DSN 또는 DSN이 없는 연결 문자열 다음 속성을 설정합니다.

  • LogLevel 모든 드라이버 활동을 기록하기 위해 심각한 이벤트 6 만 기록하도록 속성을 1 설정합니다.
  • LogPath 로그 파일을 저장할 폴더의 전체 경로로 속성을 설정합니다.
  • 속성을 LogFileCount 유지할 최대 로그 파일 수로 설정합니다.
  • LogFileSize 속성을 각 로그 파일의 최대 크기(바이트)로 설정합니다.

자세한 내용은 섹션 Configuring Logging Options on Windows 및 Configuring Logging Options on a Non-Windows MachineDatabricks JDBC 드라이버 가이드를 참조하세요.