구성 매개 변수
적용 대상: 
Databricks SQL
구성 매개 변수는 지정된 SQL 구문 외부의 Databricks SQL 동작에 영향을 미치는 설정입니다.
구성 매개 변수의 유효 값은 설정된 다양한 수준에서 파생됩니다.
구성 매개 변수 범위
시스템
시스템 값은 재정의가 없는 경우 Databricks SQL에서 사용하는 기본값입니다.
Global
관리자는 SQL 매개 변수 구성 또는 SQL Warehouse API를 사용하여 매개 변수의 시스템 기본값을 재정의할 수 있습니다. 그러면 이후로는 이 값이 새로 설정된 세션에 표시되는 초기 값이 됩니다.
세션
사용자는 SET 문을 사용하여 세션 범위 내에서 구성 매개 변수를 일시적으로 재정의할 수 있습니다. 사용자가 SET 문 또는 RESET을 사용하여 다시 재정의하지 않는 한 이 설정은 세션 기간 동안 그대로 유지됩니다.
지원되는 구성 매개 변수
다음은 Databricks SQL에서 설정할 수 있는 지원되는 구성 매개 변수 목록, 해당 시스템 기본값 및 설정할 수 있는 수준입니다. Databricks SQL은 나열되지 않은 Spark 구성 설정을 지원하지 않습니다.
| 매개 변수 이름 | 설명 | 시스템 기본값 | 전역으로 설정 가능 | 세션 설정 가능 |
|---|---|---|---|---|
| ANSI_MODE | 특정 함수 및 캐스팅 규칙에 대해 엄격한 ANSI SQL 동작을 사용하지 않도록 설정할 수 있습니다. | TRUE | 예 | 예 |
| LEGACY_TIME_PARSER_POLICY | 날짜 및 타임스탬프를 구문 분석하고 서식을 지정하는 방법을 제어합니다. | EXCEPTION | 예 | 예 |
| MAX_FILE_PARTITION_BYTES | 파일 기반 원본에서 읽을 때 단일 파티션으로 압축할 최대 바이트 수입니다. | 128m | 예 | 예 |
| READ_ONLY_EXTERNAL_METASTORE | 외부 메타스토어가 읽기 전용으로 처리되는지 여부를 제어합니다. | FALSE | 예 | 아니요 |
| STATEMENT_TIMEOUT | SQL 문 제한 시간(초)을 설정합니다. | 172800초 | 예 | 예 |
| 표준 시간대 | 로컬 표준 시간대를 선택합니다. | UTC | 예 | 예 |
| USE_CACHED_RESULT | 가능한 모든 상황에서 Databricks SQL이 결과를 캐시하여 재사용하는지 여부를 제어합니다. | TRUE | 예 | 예 |
ANSI_MODE 시스템 기본값은 FALSE Databricks SQL 2022.35 이전에 추가된 계정에 대한 것입니다.