.disable | .enable materialized-view

Menonaktifkan atau mengaktifkan proses materialisasi untuk tampilan materialisasi.

Catatan

Karena ada beberapa implikasi performa penting yang terkait dengan penonaktifan/pengaktifan tampilan materialisasi, pastikan Anda terbiasa dengannya sebelum melanjutkan penggunaan perintah ini. Untuk informasi selengkapnya, lihat bagian Implikasi performa untuk mengaktifkan/menonaktifkan tampilan materialisasi .

Izin

Anda harus memiliki setidaknya Admin Tampilan Terwujud untuk menjalankan perintah ini.

Sintaks

.enable | disablematerialized-viewMaterializedViewName

Pelajari selengkapnya tentang konvensi sintaksis.

Parameter

Nama	Jenis	Diperlukan	Deskripsi
MaterializedViewName	string	✔️	Nama tampilan yang dimaterialisasi.

Mengembalikan

Jika tampilan materialisasi sudah dalam status di mana perintah mencoba mengaturnya, perintah gagal dengan kesalahan yang menunjukkan bahwa adalah kasusnya.

Jika tidak, ia mengembalikan detail tentang tampilan materialisasi yang properti IsEnabled-nya telah diubah.

Skema output:

Nama	Jenis	Deskripsi
Nama	string	Nama tampilan yang dimaterialisasi.
SourceTable	string	Nama tabel sumber tempat tampilan didefinisikan.
Kueri	string	Definisi kueri dari tampilan terwujud.
MaterializedTo	datetime	Tanda waktu ingestion_time() terwujud maksimum dalam tabel sumber. Untuk informasi selengkapnya, lihat cara kerja tampilan yang dimaterialisasi.
LastRun	datetime	Terakhir kali materialisasi dijalankan.
LastRunResult	string	Hasil dari operasi terakhir. Mengembalikan Completed untuk operasi sukses, jika tidak mengembalikan Failed.
IsHealthy	bool	true jika tampilan dianggap sehat, false jika sebaliknya. Tampilan dianggap sehat jika berhasil dimaterialisasi hingga satu jam terakhir (MaterializedTo lebih besar dari ago(1h)).
IsEnabled	bool	true saat tampilan diaktifkan (lihat Menonaktifkan atau mengaktifkan tampilan yang dimaterialisasi).
Folder	string	Folder tempat tampilan materialisasi dibuat.
DocString	string	Deskripsi yang ditetapkan ke tampilan materialisasi.
AutoUpdateSchema	bool	Apakah tampilan diaktifkan untuk pembaruan otomatis.
EffectiveDateTime	datetime	Waktu tanggal efektif tampilan, ditentukan selama waktu pembuatan (lihat .create materialized-view).
Lookback	timespan	Rentang waktu yang membatasi periode waktu di mana duplikat diharapkan.

Contoh

Mengaktifkan tampilan materialisasi

Perintah berikut memungkinkan view ViewName yang terwujud:

.enable materialized-view ViewName

Output

Nama	SourceTable	Kueri	MaterializedTo	LastRun	LastRunResult	IsHealthy	IsEnabled	Folder	DocString	AutoUpdateSchema	EffectiveDateTime	Lookback
ViewName	TableName	TableName | meringkas arg_max(Kolom3, *) menurut Kolom1	2023-02-26T16:40:03.3345704Z	2023-02-26T16:44:15.9033667Z	Selesai	TRUE	TRUE			salah	2023-02-23T14:01:42.5172342Z

Menonaktifkan tampilan materialisasi

Perintah berikut menonaktifkan view ViewName yang terwujud:

.disable materialized-view ViewName

Output

Nama	SourceTable	Kueri	MaterializedTo	LastRun	LastRunResult	IsHealthy	IsEnabled	Folder	DocString	AutoUpdateSchema	EffectiveDateTime	Lookback
ViewName	TableName	TableName | meringkas arg_max(Kolom3, *) menurut Kolom1	2023-02-26T16:40:03.3345704Z	2023-02-26T16:44:15.9033667Z	Selesai	TRUE	false			false	2023-02-23T14:01:42.5172342Z

Keterangan

Menonaktifkan tampilan materialisasi

Tampilan materialisasi dapat dinonaktifkan dengan salah satu cara berikut:

• Nonaktifkan otomatis oleh sistem: Tampilan materialisasi dinonaktifkan secara otomatis jika materialisasi gagal dengan kesalahan permanen. Proses ini dapat terjadi dalam kasus-kasus berikut:
  • Perubahan skema yang tidak konsisten dengan definisi tampilan.
  • Perubahan pada tabel sumber yang mengakibatkan kueri tampilan terwujud menjadi tidak valid secara semantik.
• Nonaktifkan tampilan materialisasi secara eksplisit: Jika tampilan materialisasi berdampak negatif pada kesehatan kluster (misalnya, mengonsumsi terlalu banyak CPU), nonaktifkan tampilan menggunakan .disable materialized-view perintah .

Tampilan materialisasi dan Keamanan Tingkat Baris

Jika tampilan materialisasi dinonaktifkan, dan saat tampilan dinonaktifkan, seseorang menentukan kebijakan keamanan tingkat baris pada tabel sumber tampilan, tetapi tampilan materialisasi tidak memiliki kebijakan keamanan tingkat baris yang ditentukan, maka mengaktifkan tampilan gagal karena alasan keamanan. Untuk mengurangi kesalahan ini, Anda dapat:

• Menentukan kebijakan keamanan tingkat baris pada tampilan terwujud.
• Memilih untuk mengabaikan kesalahan dengan menambahkan properti allowMaterializedViewsWithoutRowLevelSecurity ke perintah ubah kebijakan. Contohnya:

    .enable materialized-view MV with (allowMaterializedViewsWithoutRowLevelSecurity=true)

Implikasi performa mengaktifkan/menonaktifkan tampilan materialisasi

• Saat tampilan materialisasi dinonaktifkan, materialisasi akan dijeda dan tidak akan menghabiskan sumber daya dari kluster. Mengkueri tampilan materialisasi dimungkinkan bahkan ketika dinonaktifkan, tetapi performana bisa buruk. Performa pada tampilan materialisasi yang dinonaktifkan bergantung pada jumlah catatan yang diserap ke tabel sumber karena dinonaktifkan.
• Anda dapat mengaktifkan tampilan materialisasi yang sebelumnya telah dinonaktifkan. Saat diaktifkan kembali, tampilan materialisasi akan terus terwujud dari titik yang ditinggalkannya, dan tidak ada catatan yang akan dilewati. Jika tampilan dinonaktifkan untuk waktu yang lama, mungkin perlu waktu lama untuk mengejar ketinggalan.
• Menonaktifkan tampilan hanya disarankan jika Anda menduga bahwa tampilan memengaruhi kesehatan kluster Anda.