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

Относится к:установлен флажок Databricks SQL

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

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

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

  • Система

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

  • Глобальный

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

  • Сеанс

    Пользователь может переопределить параметр конфигурации на время сессии с помощьюSET этого оператора. Некоторые параметры имеют выделенный оператор, например SET PATH или SET TIME ZONE. Настройка действует до тех пор, пока пользователь не переопределит её снова или не использует RESET.

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

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

Наименование параметра Описание Системное значение по умолчанию Глобально настраиваемое Настраиваемое для сеанса
ANSI_MODE Позволяет отключить строгое поведение ANSI SQL для определенных функций и правил приведения. ИСТИНА Да Да
LEGACY_TIME_PARSER_POLICY Определяет способ синтаксического анализа и форматирования даты и меток времени. ИСКЛЮЧЕНИЕ Да Да
MAX_FILE_PARTITION_BYTES Максимальное количество байтов, которое можно упаковать в один раздел при чтении из источников, основанных на файлах. 128 м Нет Да
PATH Задаёт путь поиска по схеме, используемый для разрешения неквалифицированных имён. system.session, system.builtin, system.ai, CURRENT_SCHEMA Да Да
READ_ONLY_EXTERNAL_METASTORE Определяет, обрабатывается ли внешнее хранилище метаданных как доступное только для чтения. ЛОЖЬ Да Нет
STATEMENT_TIMEOUT Задает время ожидания инструкции SQL в секундах 172800 секунд Да Да
TIMEZONE Задает местный часовой пояс. UTC Да Да
USE_CACHED_RESULT Управляет тем, кэширует ли Databricks SQL результаты и использует ли их повторно по возможности. ИСТИНА Нет Да

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