ALTER TABLE PARTISI

  • Artikel

Berlaku untuk:check marked yes Databricks SQL check marked yes Databricks Runtime

Menambahkan, menjatuhkan, mengganti nama, atau memulihkan partisi tabel.

Mengelola partisi tidak didukung untuk tabel Delta Lake.

Sintaks

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

ADD PARTITION Klausul

Menambahkan satu atau beberapa partisi ke tabel.

Sintaks

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

Parameter

  • IF NOT EXISTS

    Klausa opsional yang mengarahkan Azure Databricks untuk mengabaikan pernyataan jika partisi sudah ada.

  • Klausul PARTISI

    Partisi yang akan ditambahkan. Kunci partisi harus cocok dengan partisi tabel dan dikaitkan dengan nilai. Jika partisi sudah ada, kesalahan akan muncul kecuali IF NOT EXISTS telah ditentukan.

  • LOCATION path

    path harus harfiah STRING yang mewakili lokasi opsional yang menunjuk ke partisi.

    Jika tidak ada lokasi yang ditentukan, lokasi akan berasal dari lokasi tabel dan kunci partisi.

    Jika terdapat file di lokasi, file tersebut akan mengisi partisi dan harus kompatibel dengan data_source tabel dan opsinya.

DROP PARTITION Klausul

Menghilangkan satu atau beberapa partisi dari tabel, secara opsional menghapus file apa pun di lokasi partisi.

Sintaks

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

Parameter

  • IF EXISTS

    Jika Anda menentukan IF EXISTS, Azure Databricks akan mengabaikan upaya untuk menghilangkan partisi yang tidak ada. Jika tidak, partisi yang tidak ada akan menyebabkan kesalahan.

  • Klausul PARTISI

    Menentukan partisi yang akan dihilangkan. Jika partisi hanya diidentifikasi sebagian, sepotong partisi dihilangkan.

  • PURGE

    Jika diatur, katalog tabel harus menghapus data partisi dengan melewatkan folder Trash bahkan ketika katalog telah mengonfigurasinya. Opsi ini hanya berlaku untuk tabel terkelola. Ini hanya efektif ketika:

    Sistem file mendukung folder Trash. Katalog telah dikonfigurasi untuk memindahkan partisi yang dihilangkan ke folder Trash. Tidak ada folder Trash di AWS S3, jadi tidak efektif.

    Tidak perlu menghapus file secara manual setelah menghilangkan partisi.

RENAME PARTITION Klausul

Mengganti kunci partisi.

Sintaks

from_partition_clause RENAME TO to_partition_clause

Parameter

RECOVER PARTITIONS Klausul

Klausul ini tidak berlaku untuk tabel Delta Lake.

Menginstruksikan Azure Databricks untuk memindai lokasi tabel dan menambahkan file apa pun ke tabel yang telah ditambahkan langsung ke sistem file.

Sintaks

RECOVER PARTITIONS

Parameter

Tidak ada

Klausa LOKASI SET PARTISI

Memindahkan lokasi partisi.

Sintaks

PARTITION clause SET LOCATION path

Parameter

  • Klausul PARTISI

    Mengidentifikasi partisi yang lokasinya akan diubah.

  • LOCATION path

    path harus harfiah STRING . Menentukan lokasi baru untuk partisi.

    File di lokasi asli tidak akan dipindahkan ke lokasi baru.

Contoh

Lihat Contoh ALTER TABLE.