Partilhar via

Propriedades e opções de tabela

Aplica-se a:Sim, assinalado Databricks SQL Sim, assinalado Databricks Runtime

Define tags definidas pelo usuário para tabelas e exibições.

  • propriedades da tabela

    Uma propriedade de tabela é um par chave-valor que podes inicializar quando executas um CREATE TABLE ou um CREATE VIEW. Você pode DESFAZER propriedades de tabela existentes ou novas utilizando SET ou ALTER TABLE.

    Você pode usar as propriedades da tabela para marcar tabelas com informações não controladas pelo SQL.

  • opções de tabela

    O objetivo das opções de tabela é passar propriedades de armazenamento ao sistema de armazenamento subjacente, como as propriedades SERDE ao Hive.

    Uma opção de tabela é um par chave-valor que se pode inicializar ao executar um CREATE TABLE. Não é possível SET ou UNSET uma opção de tabela.

TBLPROPERTIES

Define uma ou mais propriedades de tabela em uma nova tabela ou exibição.

Você pode usar as propriedades da tabela para marcar tabelas com informações não controladas pelo SQL.

Sintaxe

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

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

Parâmetros

  • property_key

    A chave da propriedade. A chave pode consistir em um ou mais identificadores separados por um ponto, ou uma cadeia literal.

    As chaves de propriedade devem ser exclusivas e distinguem maiúsculas de minúsculas.

  • property_val

    O valor da propriedade. O valor deve ser um BOOLEAN, STRING, INTEGER, ou DECIMAL literal.

Exemplos

-- 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

Define uma ou mais propriedades de tabela em uma tabela ou exibição existente.

Sintaxe

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

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

Parâmetros

  • property_key

    A chave da propriedade. A chave pode consistir em um ou mais identificadores separados por um ponto, ou uma cadeia literal.

    As chaves de propriedade devem ser exclusivas e distinguem maiúsculas de minúsculas.

  • property_val

    O novo valor para a propriedade. O valor deve ser um BOOLEAN, STRING, INTEGER, ou DECIMAL literal.

Exemplos

-- 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
...

Remover Propriedades da Tabela

Remove uma ou mais propriedades de tabela de uma tabela ou exibição.

Sintaxe

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

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

Parâmetros

  • SE EXISTE

    Uma cláusula opcional direcionando o Databricks SQL para não gerar um erro se qualquer uma das chaves de propriedade não existir.

  • property_key

    A chave de propriedade que deve ser removida. A chave pode consistir em um ou mais identificadores separados por um ponto, ou uma cadeia literal.

    As chaves de propriedade são sensíveis a maiúsculas e minúsculas. Caso property_key não exista, um erro será gerado, a menos que IF EXISTS tenha sido especificado.

Exemplos

-- 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 ...

OPÇÕES

Define uma ou mais opções de tabela em uma nova tabela.

O objetivo das opções de tabela é passar propriedades de armazenamento ao sistema de armazenamento subjacente, como as propriedades SERDE ao Hive.

A especificação de opções de tabela para tabelas Delta Lake também refletirá essas opções como propriedades de tabela.

Sintaxe

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

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

Parâmetros

  • property_key

    A chave da propriedade. A chave pode consistir em um ou mais identificadores separados por um ponto, ou uma cadeia literal.

    As chaves de propriedade devem ser exclusivas e são sensíveis a maiúsculas e minúsculas.

  • property_val

    O valor da propriedade. O valor deve ser um BOOLEAN, STRING, INTEGER, ou DECIMAL literal.

    No Databricks SQL e Databricks Runtime 13.3 LTS e superior property_val pode ser uma expressão constante.

Exemplos

-- 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
...

Chaves de propriedades reservadas da tabela

O Azure Databricks reserva algumas chaves de propriedade para seu próprio uso e gera um erro se você tentar usá-las:

  • external

    Use CREATE EXTERNAL TABLE para criar uma tabela externa.

  • location

    Use as cláusulas LOCATION de ALTER TABLE e CREATE TABLE para definir um local para a tabela.

  • owner

    Utilize a cláusula [SET] OWNER TO de ALTER TABLE e ALTER VIEW para transferir a propriedade de uma tabela ou vista. SET é permitido como uma palavra-chave opcional no Databricks SQL.

  • provider

    Use a cláusula USING de CREATE TABLE para definir a fonte de dados de uma tabela

Você não deve usar chaves de propriedade começando com o identificador option. Este identificador de prefixo será filtrado através de SHOW TBLPROPERTIES. O prefixo option também é usado para exibir opções de tabela.

Chaves comuns de TBLPROPERTIES e OPTIONS

As seguintes configurações são comumente usadas com o Delta Lake:

  • delta.appendOnly: Defina como true para desativar as operações UPDATE e DELETE.
  • delta.dataSkippingNumIndexedCols: Configure o número de colunas iniciais para as quais coletar e considerar as estatísticas.
  • delta.deletedFileRetentionDuration: Defina para um intervalo como 'interval 7 days' para controlar quando VACUUM tem permissão para excluir arquivos.
  • delta.logRetentionDuration: Defina um intervalo como 'interval 60 days' para controlar quanto tempo o histórico é mantido para consultas de viagens no tempo.
  • Last updated on