Tablo özellikleri ve tablo seçenekleri

  • Makale

Şunlar için geçerlidir: onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime

Tablolar ve görünümler için kullanıcı tanımlı etiketleri tanımlar.

TBLPROPERTIES

Yeni bir tablo veya görünümde bir veya daha fazla tablo özelliği ayarlar.

SQL tarafından izlenmemiş bilgilerle tabloları etiketlemek için tablo özelliklerini kullanabilirsiniz.

Sözdizimi

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

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

Parametreler

  • property_key

    Özellik anahtarı. Anahtar, nokta veya dize değişmez değeriyle ayrılmış bir veya daha fazla tanımlayıcıdan oluşabilir.

    Özellik anahtarları benzersiz olmalı ve büyük/küçük harfe duyarlı olmalıdır.

  • property_val

    özelliğinin değeri. Değer , BOOLEAN, STRINGINTEGERveya DECIMAL değişmez değer olmalıdır.

Örnekler

-- 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;
option.serialization.format     1
this.is.my.key  12
this.is.my.key2 true
transient_lastDdlTime   1649783569

TBLPROPERTIES'I AYARLAMA

Varolan bir tablo veya görünümde bir veya daha fazla tablo özelliğini ayarlar.

Sözdizimi

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

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

Parametreler

  • property_key

    Özellik anahtarı. Anahtar, nokta veya dize değişmez değeriyle ayrılmış bir veya daha fazla tanımlayıcıdan oluşabilir.

    Özellik anahtarları benzersiz olmalı ve büyük/küçük harfe duyarlı olmalıdır.

  • property_val

    özelliği için yeni değer. Değer , BOOLEAN, STRINGINTEGERveya DECIMAL değişmez değer olmalıdır.

Örnekler

-- 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;
option.serialization.format     1
this.is.my.key  14
this.is.my.key2 false
transient_lastDdlTime   1649783980

TBLPROPERTIES'I KALDıRMA

Bir tablo veya görünümden bir veya daha fazla tablo özelliğini kaldırır.

Sözdizimi

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

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

Parametreler

  • VARSA

    Özellik anahtarlarından herhangi biri yoksa Databricks SQL'i hata oluşturmamaya yönlendiren isteğe bağlı bir yan tümce.

  • property_key

    Kaldırılacak özellik anahtarı. Anahtar, nokta veya dize değişmez değeriyle ayrılmış bir veya daha fazla tanımlayıcıdan oluşabilir.

    Özellik anahtarları büyük/küçük harfe duyarlıdır. Yoksa property_key ve belirtilmemişse IF EXISTS hata oluşur.

Örnekler

-- Remove a table's table properties.
>  ALTER TABLE T UNSET TBLPROPERTIES(this.is.my.key, 'this.is.my.key2');
> SHOW TBLPROPERTIES T;
option.serialization.format     1
transient_lastDdlTime   1649784415

OPTIONS

Yeni bir tablodaki bir veya daha fazla tablo seçeneğini ayarlar.

Tablo seçeneklerinin amacı, DEPOLAMA özelliklerini TEMEL alınan depolamaya (SERDE özellikleri gibi) Hive'a geçirmektir.

Delta Lake tabloları için tablo seçeneklerinin belirtilmesi, bu seçenekleri tablo özellikleri olarak da yankılar.

Sözdizimi

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

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

Parametreler

  • property_key

    Özellik anahtarı. Anahtar, nokta veya dize değişmez değeriyle ayrılmış bir veya daha fazla tanımlayıcıdan oluşabilir.

    Özellik anahtarları benzersiz olmalı ve büyük/küçük harfe duyarlı olmalıdır.

  • property_val

    özelliğinin değeri. Değer , BOOLEAN, STRINGINTEGERveya DECIMAL değişmez değer olmalıdır.

    Databricks SQL ve Databricks Runtime 13.3 LTS ve üzerinde property_val sabit bir ifade olabilir.

Örnekler

-- 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;
option.this.is.my.key bluegreen
option.serialization.format     2

Ayrılmış tablo özellik anahtarları

Azure Databricks bazı özellik anahtarlarını kendi kullanımı için ayırır ve kullanmaya çalışırsanız bir hata oluşturur:

  • external

    Dış tablo oluşturmak için CREATE EXTERNAL TABLE kullanın.

  • location

    LOCATION Tablo konumunu ayarlamak için ALTER TABLE ve CREATE TABLE yan tümcelerini kullanın.

  • owner

    [SET] OWNER TO Bir tablonun veya görünümün sahipliğini aktarmak için ALTER TABLE ve ALTER VIEW yan tümcesini kullanın. SET, Databricks SQL'de isteğe bağlı bir anahtar sözcük olarak izin verilir.

  • provider

    USING Bir tablonun veri kaynağını ayarlamak için CREATE TABLE yan tümcesini kullanın

Tanımlayıcı ile option başlayan özellik anahtarlarını kullanmamalısınız. Bu ön ek tanımlayıcısı SHOW TBLPROPERTIES içinde filtrelenir. Ön option ek, tablo seçeneklerini görüntülemek için de kullanılır.

Yaygın TBLPROPERTIES ve OPTIONS anahtarları

Delta Lake ile yaygın olarak aşağıdaki ayarlar kullanılır:

  • delta.appendOnly: ve DELETE işlemlerini devre dışı bırakmak UPDATE için olarak ayarlayıntrue.
  • delta.dataSkippingNumIndexedCols: İstatistiklerin toplanacağı ve dikkate alındığı baştaki sütunun sayısına ayarlayın.
  • delta.deletedFileRetentionDuration: Dosyaları silme izninin ne zaman VACUUM verilip verilmeyeceği gibi 'interval 7 days' bir zaman aralığına ayarlayın.
  • delta.logRetentionDuration: Zaman yolculuğu sorguları için geçmişin ne kadar süreyle tutulduğunu denetlemek için gibi 'interval 60 days' bir zaman aralığına ayarlayın.