Поделиться через

Свойства таблицы и параметры таблицы

Область применения:отмечено «Да» Databricks SQL и отмечено «Да» Databricks Runtime

Определяет пользовательские теги для таблиц и представлений.

  • свойства таблицы

    Свойство таблицы — это пара "ключ-значение", которую можно инициализировать при использовании CREATE TABLE или CREATE VIEW. Можно убрать свойства таблицы, которые являются новыми или существующими, с помощью или SET.

    Свойства таблицы можно использовать для тегов таблиц с информацией, не отслеживаемой SQL.

  • опции таблицы

    Назначение параметров таблицы — передать свойства хранилища в базовое хранилище, например свойства SERDE в Hive.

    Параметр таблицы — это пара ключей и значений, которую можно инициализировать при выполнении CREATE TABLE. Невозможно выполнить SET или UNSET параметр таблицы.

TBLPROPERTIES

Задает одно или несколько свойств таблицы в новой таблице или представлении.

Свойства таблицы можно использовать для тегов таблиц с информацией, не отслеживаемой SQL.

Синтаксис

TBLPROPERTIES ( { property_key [ = ] property_val } [, ...] )

property_key
  { identifier [. ...] | string_literal }

Параметры

  • property_key

    Ключ свойства. Ключ может состоять из одного или нескольких идентификаторов, разделенных точкой, или строки в кавычках.

    Ключи свойств должны быть уникальными и чувствительны к регистру.

  • property_val

    Значение свойства. Значение должно быть BOOLEAN, STRING, INTEGER или DECIMAL литералом.

Примеры

-- Create table with user defined table properties
> CREATE TABLE T(c1 INT) TBLPROPERTIES('this.is.my.key' = 12, this.is.my.key2 = true);
> SHOW TBLPROPERTIES T;
key              value
---------------- -----
...
this.is.my.key      12
this.is.my.key2   true
...

SET TBLPROPERTIES

Задает одно или несколько свойств таблицы в существующей таблице или представлении.

Синтаксис

SET TBLPROPERTIES ( { property_key [ = ] property_val } [, ...] )

property_key
  { identifier [. ...] | string_literal }

Параметры

  • property_key

    Ключ свойства. Ключ может состоять из одного или нескольких идентификаторов, разделенных точкой, или строки в кавычках.

    Ключи свойств должны быть уникальными и чувствительны к регистру.

  • property_val

    Новое значение для свойства. Значение должно быть BOOLEAN, STRING, INTEGER или DECIMAL литералом.

Примеры

-- Alter the a table's table properties.
>  ALTER TABLE T SET TBLPROPERTIES(this.is.my.key = 14, 'this.is.my.key2' = false);
> SHOW TBLPROPERTIES T;
key              value
---------------- -----
...
this.is.my.key      14
this.is.my.key2  false
...

Сброс TBLPROPERTIES

Удаляет одно или несколько свойств таблицы из таблицы или представления.

Синтаксис

UNSET TBLPROPERTIES [ IF EXISTS ] ( property_key [, ...] )

property_key
  { identifier [. ...] | string_literal }

Параметры

  • ЕСЛИ СУЩЕСТВУЕТ

    Необязательная инструкция, предписывающая Databricks SQL не выдавать ошибку, если какой-либо из ключей свойств не существует.

  • property_key

    Ключ свойства для удаления. Ключ может состоять из одного или нескольких идентификаторов, разделенных точкой, или строки в кавычках.

    В ключах свойств учитывается регистр. Если property_key не существует и возникает ошибка, если IF EXISTS не указано.

Примеры

-- Remove a table's table properties.
>  ALTER TABLE T UNSET TBLPROPERTIES(this.is.my.key, 'this.is.my.key2');
> SHOW TBLPROPERTIES T;
key                              value
-------------------------------- -----
... keys other that key and key2 ...

ПАРАМЕТРЫ

Задает один или несколько параметров таблицы в новой таблице.

Назначение параметров таблицы — передать свойства хранилища в базовое хранилище, например свойства SERDE в Hive.

Указание параметров для таблиц Delta Lake также будет отражать эти параметры как свойства таблицы.

Синтаксис

OPTIONS ( { property_key [ = ] property_val } [, ...] )

property_key
  { identifier [. ...] | string_literal }

Параметры

  • property_key

    Ключ свойства. Ключ может состоять из одного или нескольких идентификаторов, разделенных точкой, или строки в кавычках.

    Ключи свойств должны быть уникальными и учитывать регистр.

  • property_val

    Значение свойства. Значение должно быть BOOLEAN, STRING, INTEGER или DECIMAL литералом.

    В Databricks SQL и версиях Databricks Runtime 13.3 LTS и более поздних property_val может быть константное выражение.

Примеры

-- Create table with user defined table option
-- The options appears with an `option.` prefix.
> CREATE TABLE T(c1 INT) OPTIONS(this.is.my.key = 'blue' || 'green');
> SHOW TBLPROPERTIES T;
key              value
---------------- -----
...
option.this.is.my.key bluegreen
...

Ключи свойств зарезервированной таблицы

Azure Databricks резервирует некоторые ключи свойств для собственного использования и вызывает ошибку при попытке их использования:

  • external

    Используйте CREATE EXTERNAL TABLE для создания внешней таблицы.

  • location

    Используйте пункты LOCATION, ALTER TABLE и CREATE TABLE, чтобы задать расположение таблицы.

  • owner

    Используйте положения [SET] OWNER TO, ALTER TABLE и ALTER VIEW для передачи права собственности на таблицу или представление. SET разрешено в качестве необязательного ключевого слова в Databricks SQL.

  • provider

    Используйте пункт USING из CREATE TABLE, чтобы установить источник данных для таблицы.

Не следует использовать ключи свойств, начиная с идентификатора option. Этот идентификатор префикса будет отфильтрован в SHOW TBLPROPERTIES. Префикс option также используется для отображения параметров таблицы.

Общие ключи TBLPROPERTIES и OPTIONS

Свойства таблицы Delta и Iceberg

Следующие параметры часто используются в таблицах Delta Lake и Apache Iceberg:

  • delta.appendOnly: установите значение true, чтобы отключить операции UPDATE и DELETE.
  • delta.dataSkippingNumIndexedCols: задайте число ведущих столбцов, для которых необходимо собирать и рассматривать статистику.
  • delta.deletedFileRetentionDuration: Задайте интервал, например 'interval 7 days', чтобы управлять разрешением на удаление файлов для VACUUM.
  • delta.logRetentionDuration: Установите интервал, например 'interval 60 days', чтобы контролировать, как долго сохраняется история для запросов о путешествиях во времени.

Полный список доступных свойств таблицы Delta Lake и Apache Iceberg, включая описания, типы данных и значения по умолчанию, см. в справочнике по свойствам таблицы.

ПАРАМЕТРЫ формата файла

При создании таблицы с источником данных, отличного от Delta Lake, с помощью USINGCREATE TABLE можно OPTIONS передавать свойства хранилища в формате файла. Доступные ключи параметров зависят от формата файла (CSV, , PARQUETJSON, AVRO, TEXTORC, XMLBINARYFILE). Дополнительные сведения о доступных параметрах для каждого формата файла см read_files . в табличном значении функции.

  • Last updated on