Partilhar via

ALTER TABLE PARTIÇÃO

  • Artigo

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime

Adiciona, descarta, renomeia ou recupera partições de uma tabela.

O gerenciamento de partições não é suportado para tabelas Delta Lake.

Sintaxe

ALTER TABLE table_name
   { ADD PARTITION clause |
     DROP PARTITION clause |
     PARTITION SET LOCATION clause |
     RENAME PARTITION clause |
     RECOVER PARTITIONS clause }

ADD PARTITION cláusula

Adiciona uma ou mais partições à tabela.

Sintaxe

ADD [IF NOT EXISTS] { PARTITION clause [ LOCATION path ] } [...]

Parâmetros

  • IF NOT EXISTS

    Uma cláusula opcional orientando o Azure Databricks a ignorar a instrução se a partição já existir.

  • Cláusula PARTITION

    Uma partição a ser adicionada. As chaves de partição devem corresponder ao particionamento da tabela e estar associadas a valores. Se a partição já existir, um erro será gerado, a menos que IF NOT EXISTS tenha sido especificado.

  • LOCATION path

    path deve ser um STRING literal representando um local opcional apontando para a partição.

    Se nenhum local for especificado, o local será derivado do local da tabela e das chaves de partição.

    Se houver arquivos presentes no local, eles preenchem a partição e devem ser compatíveis com a data_source tabela e suas opções.

DROP PARTITION cláusula

Descarta uma ou mais partições da tabela, opcionalmente excluindo todos os arquivos nos locais das partições.

Sintaxe

DROP [ IF EXISTS ] PARTITION clause [, ...] [PURGE]

Parâmetros

  • IF EXISTS

    Quando você especifica IF EXISTS o Azure Databricks ignorará uma tentativa de descartar partições que não existem. Caso contrário, partições não existentes causarão um erro.

  • Cláusula PARTITION

    Especifica uma partição a ser descartada. Se a partição for apenas parcialmente identificada, uma fatia de partições será descartada.

  • PURGE

    Se definido, o catálogo de tabelas deve remover os dados da partição ignorando a pasta Lixeira, mesmo quando o catálogo tiver configurado uma. A opção é aplicável apenas para tabelas gerenciadas. Só é eficaz quando:

    O sistema de arquivos suporta uma pasta Lixeira. O catálogo foi configurado para mover a partição descartada para a pasta Lixeira. Não há nenhuma pasta Lixo no AWS S3, portanto, ela não é eficaz.

    Não há necessidade de excluir manualmente os arquivos depois de soltar partições.

RENAME PARTITION cláusula

Substitui as chaves de uma partição.

Sintaxe

from_partition_clause RENAME TO to_partition_clause

Parâmetros

RECOVER PARTITIONS cláusula

Esta cláusula não se aplica às tabelas Delta Lake.

Instrui o Azure Databricks a verificar o local da tabela e adicionar quaisquer arquivos à tabela que tenham sido adicionados diretamente ao sistema de arquivos.

Sintaxe

RECOVER PARTITIONS

Parâmetros

Nenhuma

Cláusula PARTITION SET LOCATION

Move o local de uma partição.

Sintaxe

PARTITION clause SET LOCATION path

Parâmetros

  • Cláusula PARTITION

    Identifica a partição para a qual o local será alterado.

  • LOCATION path

    path deve ser um STRING literal. Especifica o novo local para a partição.

    Os arquivos no local original não serão movidos para o novo local.

Exemplos

Veja exemplos ALTER TABLE.