ALTER TABLE ... PARTITION

Berlaku untuk: Databricks SQL 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 }

klausa ADD PARTITION

Menambahkan satu atau beberapa partisi ke tabel.

Mengelola partisi tidak didukung untuk tabel Delta Lake.

Sintaks

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

Parameter-parameternya

• IF NOT EXISTS

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

• PARTITION klausa

  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 berupa literal STRING yang mewakili lokasi opsional yang mengarah 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.

klausa DROP PARTITION

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

Mengelola partisi tidak didukung untuk tabel Delta Lake.

Sintaks

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

Parameter-parameternya

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

• PARTITION klausa

  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.

klausa RENAME PARTITION

Mengganti kunci partisi.

Mengelola partisi tidak didukung untuk tabel Delta Lake.

Sintaks

from_partition_clause RENAME TO to_partition_clause

Parameter-parameternya

• from_partition_clause

  Definisi partisi yang akan diganti namanya.

• to_partition_clause

  Definisi baru untuk partisi ini. Partisi dengan kunci yang sama tidak boleh sudah ada.

klausa RECOVER PARTITIONS

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.

Mengelola partisi tidak didukung untuk tabel Delta Lake.

Sintaks

RECOVER PARTITIONS

Parameter-parameternya

Tidak

PARTITION SET Klausa Lokasi

Memindahkan lokasi partisi.

Mengelola partisi tidak didukung untuk tabel Delta Lake.

Sintaks

PARTITION clause SET LOCATION path

Parameter-parameternya

• PARTITION klausa

  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.

Artikel terkait

• ALTER TABLE