ANSI_MODE

적용 대상: Databricks SQL

ANSI_MODE 구성 매개 변수는 기본 제공 함수 및 캐스트 작업의 주요 동작을 제어합니다.

이 문서에서는 Databricks SQL의 ANSI 모드에 대해 설명합니다. Databricks 런타임의 ANSI 규정 준수에 대한 내용은 Databricks 런타임의 ANSI 규정 준수를 참조하십시오.

설정

• 참

  대부분의 데이터베이스 및 데이터 웨어하우스와 유사한 특정 산술 연산 및 형식 변환을 처리하는 방법에 대한 SQL 표준을 따릅니다. 이 표준을 따르면 데이터 품질, 무결성 및 이식성이 향상됩니다.

• FALSE

  Databricks SQL은 Hive 호환 동작을 사용합니다.

SET 문 사용하여 세션 수준에서 그리고 SQL 구성 매개 변수 또는 SQL Warehouse API사용하여 전역 수준에서 이 매개 변수를 설정할 수 있습니다.

시스템 기본값

2022년 10월 19일 이후에 만든 계정의 경우 시스템 기본값은 .입니다 TRUE.

자세한 설명

Databricks SQL 참조 설명서에서는 SQL 표준 동작에 대해 설명합니다.

다음 섹션에서는 ANSI_MODETRUE(ANSI 모드)와 FALSE(비 ANSI 모드)의 차이점을 설명합니다.

운영자

ANSI가 아닌 모드에서는 숫자 형식에서 수행된 산술 연산이 오버플로된 값 또는 NULL을 반환할 수 있지만 ANSI 모드에서는 이러한 작업이 오류를 반환합니다.

함수

일부 기본 제공 함수의 동작은 아래 지정된 조건에서 ANSI 모드와 비 ANSI 모드에서 다를 수 있습니다.

캐스팅 규칙

CAST와 관련된 규칙 및 동작은 ANSI 모드에서 더 엄격합니다. 이들/그들은 다음 세 범주로 나눌 수 있습니다.

• 컴파일 시간 변환 규칙
• 런타임 오류
• 암시적 형식 강제 변환 규칙

컴파일 시간 변환 규칙

런타임 오류

암시적 형식 강제 변환 규칙

ANSI_MODE = TRUE아래에서 Databricks SQL은 다음과 같은 명확한 SQL 데이터 형식 캐스팅 규칙을 사용합니다.

• 타입 프로모션
• 다운캐스팅
• 크로스캐스트

반면 ANSI_MODE = FALSE은(는) 일관성이 없고 관대합니다. 예시:

• 산술 연산자가 있는 STRING 형식을 사용하는 경우 문자열은 암시적으로 DOUBLE(으)로 캐스팅됩니다.
• STRING을(를) 숫자 형식과 비교하면 문자열은 암시적으로 비교되는 형식으로 캐스팅됩니다.
• UNION, COALESCE 또는 최소 공통 형식을 찾아야 하는 기타 작업을 수행하는 경우 모든 형식이 STRING(으)로 캐스팅됩니다(STRING 형식이 있는 경우).

Databricks에서는 에 의존하지 말고 명시적 cast 또는 ANSI_MODE = FALSE 함수를 사용하는 것이 좋다고 권장합니다.

예제

> SET ansi_mode = true;

-- Protects against integral numeric overflow
> SELECT cast(12345 AS TINYINT);
  Casting 12345 to tinyint causes overflow

-- For invalid values raises errors instead of returning NULL.
> SELECT cast('a' AS INTEGER);
  Invalid input syntax for type numeric: a.
  To return NULL instead, use 'try_cast'

-- try_cast() is consistent for both modes
> SELECT try_cast('a' AS INTEGER);
  NULL

-- Does not allow ambiguous crosscasting.
> SELECT c1 + c2 FROM VALUES('5', '7.6') AS T(c1, c2);
  Cannot resolve '(T.c1 + T.c2)' due to data type mismatch:
  '(T.c1 + T.c2)' requires (numeric or interval day to second or interval year to month or interval) type, not string

-- Promotes STRING to least common type (STRING, INTEGER --> BIGINT) for arithmetic operation.
> SELECT typeof(5 - '3');
  bigint

-- Promotes STRING to least common type (INTEGER, STRING --> BIGINT) with runtime check
> SELECT c1 = c2 FROM VALUES(10, '10.1') AS T(c1, c2);
  Invalid input syntax for type numeric: 10.1. To return NULL instead, use 'try_cast'.

-- Promotes STRING to least common type (STRING, INTEGER --> BIGINT) for set operation with runtime check.
> SELECT typeof(c1) FROM (SELECT 5 UNION ALL SELECT '6') AS T(c1);
  bigint
  bigint

> SET ansi_mode = false;

-- Silent integral numeric overflow
> SELECT cast(12345 AS TINYINT);
  57

-- Returns NULL instead of an error
> SELECT cast('a' AS INTEGER);
  NULL

-- try_cast() is safe for both modes
> SELECT try_cast('a' AS INTEGER);
  NULL

-- Does allow ambiguous crosscasting using DOUBLE.
> SELECT c1 + c2 FROM VALUES('5', '7.6') AS T(c1, c2);
  12.6

-- Crosscasts STRING to DOUBLE for arithmetic operation.
> SELECT typeof(5 - '3');
  double

-- Implicitly casts STRING to INTEGER equating 10 with 10.1
> SELECT c1 = c2 FROM VALUES(10, '10.1') AS T(c1, c2);
  true

-- Promotes to string for set operations
> SELECT typeof(c1) FROM (SELECT 5 UNION ALL SELECT '6') AS T(c1);
  string
  string

관련

• SQL 데이터 형식 규칙
• RESET
• SET 성명
• SQL 매개변수 구성
• SQL Warehouse API