表屬性和表選項（Databricks SQL）

定義用戶定義的表和視圖標簽。

  • 表屬性

    表屬性是鍵值對創建表或a創建視圖。你可以不設置現有或放使用新的或現有的表屬性Alter表或者Alter表。

    您可以使用表格屬性將表格標記，並使用SQL未跟蹤的信息。

  • 表選項

    表選項的目的是將存儲屬性傳遞給基礎存儲，例如SERDE屬性到Hive。

    表選項是鍵值對創建表。你不能放或者不設置表選項。

tblproperties

在新表格或視圖中設置一個或多個表屬性。

您可以使用表格屬性將表格標記，並使用SQL未跟蹤的信息。

句法

tblproperties（（property_key[[=這是給予的property_val[，，...這是給予的）property_key{標識符[[。...這是給予的|字符串字麵量}

參數

  • property_key

    屬性密鑰。鑰匙可以由一個或多個組成身份標識被點或字符串字麵分開。

    屬性密鑰必須是唯一的並且對案例敏感。

  • property_val

    屬性的值。該值必須是布爾，字符串，整數或十進製文字。

例子

- 使用用戶定義的表屬性創建表>創造桌子t（（C1int）tblproperties（（'this.is.my.key'=12，，，，這個。是。我的。key2=真的）；>節目tblpropertiest;選項。序列化。格式1這個。是。我的。鑰匙12這個。是。我的。key2真的transient_lastddltime1649783569

設置tblproperties

在現有表或視圖中設置一個或多個表屬性。

句法

放tblproperties（（property_key[[=這是給予的property_val[，，...這是給予的）property_key{標識符[[。...這是給予的|字符串字麵量}

參數

  • property_key

    屬性密鑰。鑰匙可以由一個或多個組成身份標識被點或字符串字麵分開。

    屬性密鑰必須是唯一的並且對案例敏感。

  • property_val

    屬性的新值。該值必須是布爾，字符串，整數或十進製文字。

例子

- 更改A表的表屬性。>改變桌子t放tblproperties（（這個。是。我的。鑰匙=14，，，，'this.is.my.key2'=錯誤的）；>節目tblpropertiest;選項。序列化。格式1這個。是。我的。鑰匙14這個。是。我的。key2錯誤的transient_lastddltime1649783980

未設置tblproperties

從表或視圖中刪除一個或多個表屬性。

句法

放tblproperties[[如果存在這是給予的（（property_key[，，...這是給予的）property_key{標識符[[。...這是給予的|字符串字麵量}

參數

  • 如果存在

    如果不存在任何屬性鍵，則指導Databricks SQL的可選子句不要引起錯誤。

  • property_key

    要刪除的屬性鍵。鑰匙可以由一個或多個組成身份標識被點或字符串字麵分開。

    財產密鑰對案例敏感。如果property_key不存在，除非如果存在已指定。

例子

- 刪除表的表屬性。>改變桌子t不設置tblproperties（（這個。是。我的。鑰匙，，，，'this.is.my.key2'）；>節目tblpropertiest;選項。序列化。格式1transient_lastddltime1649784415

選項

在新表中設置一個或多個表選項。

表選項的目的是將存儲屬性傳遞給基礎存儲，例如SERDE屬性到Hive。

指定Delta Lake表的表選項還將與這些選項相呼應作為表屬性。

句法

選項（（property_key[[=這是給予的property_val[，，...這是給予的）property_key{標識符[[。...這是給予的|字符串字麵量}

參數

  • property_key

    屬性密鑰。鑰匙可以由一個或多個組成身份標識被點或字符串字麵分開。

    屬性密鑰必須是唯一的並且對案例敏感。

  • property_val

    屬性的值。該值必須是布爾，字符串，整數或十進製文字。

例子

- 使用用戶定義的表選項創建表格- 選項以```option''出現。前綴。>創造桌子t（（C1int）選項（（這個。是。我的。鑰匙='綠色'）；>節目tblpropertiest;選項。一個。b綠色選項。序列化。格式2

保留表屬性鍵

Databricks SQL保留一些屬性鍵以供其自身使用，並加重和錯誤，如果您嚐試使用它們：

您不應使用從以前開始的屬性密鑰選項標識符。此前綴標識符將在顯示tblproperties。這選項前綴也用於顯示表選項。

常見的tblproperties和選項鍵

以下設置通常與三角洲湖一起使用：

  • delta.appendonly： 調成真的禁用更新和刪除操作。

  • delta.dataskippingnumindexedcols：設置為收集和考慮統計數據的領先列數。

  • delta.deletedfileretentionduration：設置為諸如'間隔7天'控製何時真空允許刪除文件。

  • delta.logretentionduration：設置為諸如'間隔60天'控製時間旅行查詢的曆史長時間。