ANSI_MODE

Platí pro: Databricks SQL

Parametr ANSI_MODE konfigurace řídí chování klíčů předdefinovaných funkcí a operací přetypování.

Tento článek popisuje režim ANSI v Databricks SQL. Informace o dodržování předpisů ANSI v Databricks Runtime najdete v tématu Dodržování předpisů ANSI v Databricks Runtime.

Nastavení

• PRAVDIVÝ

  Dodržuje standard SQL v tom, jak se zabývá určitými aritmetickými operacemi a převody typů, podobně jako většina databází a datových skladů. Dodržování tohoto standardu podporuje lepší kvalitu dat, integritu a přenositelnost.

• FALEŠNÝ

  Databricks SQL používá chování kompatibilní s Hivem.

Tento parametr můžete nastavit na úrovni relace pomocí příkazu SET a na globální úrovni pomocí parametrů konfigurace SQL nebo rozhraní SQL Warehouse API.

Výchozí systém

Výchozí hodnota systému je TRUE pro účty přidané v Databricks SQL 2022.35 a vyšší.

Podrobný popis

Referenční dokumentace k Sql Databricks popisuje standardní chování SQL.

Následující části popisují rozdíly mezi ANSI_MODE TRUE (režimEM ANSI) a FALSE (bez režimu ANSI).

Operátory

V režimu jiného typu než ANSI můžou aritmetické operace prováděné s číselnými typy vracet přetečení hodnot nebo HODNOTU NULL, zatímco v režimu ANSI tyto operace vrací chybu.

Funkce

Chování některých předdefinovaných funkcí se může lišit v režimu ANSI v režimu jiné než ANSI za podmínek uvedených níže.

Přetypování pravidel

Pravidla a chování týkající se přetypování jsou v režimu ANSI přísnější. Mohou být rozděleny do následujících tří kategorií:

• Pravidla převodu v čase kompilace
• Chyby za běhu
• Implicitní pravidla převodu typů

Pravidla převodu v čase kompilace

Chyby za běhu

Implicitní pravidla převodu typů

V části ANSI_MODE = TRUEDatabricks SQL používá jasná pravidla přetypování datových typů SQL pro:

• zvýšení úrovně typu
• downcasting
• crosscasting

Naproti tomu ANSI_MODE = FALSE je nekonzistentní a více lenientní. Příklad:

• Při použití STRING typu s libovolným aritmetickým operátorem je řetězec implicitně přetypován na DOUBLE.
• Při porovnávání libovolného číselného STRING typu se řetězec implicitně přetypuje na typ, se který porovnává.
• Při provádění UNIONoperací , COALESCEnebo jiných operací, kde musí být nalezen nejméně společný typ, všechny typy jsou přetypována, STRING pokud existuje nějaký STRING typ.

Databricks doporučuje použít explicitní přetypování nebo funkci try_cast místo toho, abyste se spoléhali na ANSI_MODE = FALSE.

Příklady

> 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

Související

• Pravidla datových typů SQL
• RESET
• Příkaz SET
• Konfigurace parametrů SQL
• SQL Warehouse API