Параметры конфигурации

Область применения:check marked yes Databricks SQL

Параметр конфигурации — это настройка, которая влияет на поведение Databricks SQL за пределами указанного синтаксиса SQL.

Эффективное значение параметра конфигурации выводится с разных уровней, где он задан.

Области параметров конфигурации

  • Системные

    Системное значение — это значение по умолчанию, используемое Databricks SQL, если переопределения нет.

  • Global

    Администратор может переопределить системное значение по умолчанию для параметра с помощью настройки параметров SQL или API хранилища SQL. Это значение становится начальным значением, которое будет использоваться для каждого нового сеанса.

  • Согласованность сеанса

    Пользователь может временно переопределить параметр конфигурации в области сеанса с помощью инструкции SET. Этот параметр остается в силе в течение сеанса, если пользователь снова не переопределит его с помощью инструкции SET или RESET.

Поддерживаемые параметры конфигурации

Ниже приведен список поддерживаемых параметров конфигурации, которые можно задать в Databricks SQL, их системные значения по умолчанию и на каких уровнях их можно задать. Databricks SQL не поддерживает настройку конфигураций Spark, которые не перечислены.

Наименование параметра Description По умолчанию Задаваемое глобально Задаваемое для сеанса
ANSI_MODE Позволяет отключить строгое поведение ANSI SQL для определенных функций и правил приведения. TRUE Да Да
ENABLE_PHOTON Управляет использованием векторизованной подсистемы запросов Photon. TRUE No Да
LEGACY_TIME_PARSER_POLICY Определяет способ синтаксического анализа и форматирования даты и меток времени. ИСКЛЮЧЕНИЕ Да Да
MAX_FILE_PARTITION_BYTES Максимальное число байтов для упаковки в одну секцию при чтении из источников на основе файлов. 128 MБ No Да
READ_ONLY_EXTERNAL_METASTORE Определяет, обрабатывается ли внешнее хранилище метаданных как доступное только для чтения. FALSE Да Нет
STATEMENT_TIMEOUT Задает время ожидания инструкции SQL в секундах 172800 секунд Да Да
TIMEZONE Задает местный часовой пояс. UTC Да Да
USE_CACHED_RESULT Управляет тем, кэширует ли Databricks SQL результаты и использует ли их повторно по возможности. TRUE No Да

Системное ANSI_MODE значение по умолчанию для FALSE учетных записей, добавленных до Databricks SQL 2022.35.