Bagikan melalui


grup perintah quality-monitors

Note

Informasi ini berlaku untuk Databricks CLI versi 0.205 ke atas. Databricks CLI ada di Pratinjau Publik.

Penggunaan Databricks CLI tunduk pada Lisensi Databricks dan Pemberitahuan Privasi Databricks, termasuk ketentuan Data Penggunaan apa pun.

quality-monitors Grup perintah dalam Databricks CLI berisi perintah untuk membuat, mengedit, dan menghapus monitor kualitas. Monitor menghitung dan memantau data atau metrik kualitas model untuk tabel dari waktu ke waktu. Ini menghasilkan tabel metrik dan dasbor yang dapat Anda gunakan untuk memantau kesehatan tabel dan mengatur pemberitahuan. Lihat Pembuatan profil data.

buat pemantau kualitas databricks

Buat monitor baru untuk tabel yang ditentukan.

Pemanggil harus melakukan salah satu dari langkah berikut:

  1. menjadi pemilik katalog induk tabel, memiliki USE_SCHEMA pada skema induk tabel, dan memiliki SELECT akses ke tabel
  2. memiliki USE_CATALOG pada katalog induk tabel, menjadi pemilik skema induk tabel, dan memiliki SELECT akses ke tabel.
  3. memiliki izin berikut:
    • USE_CATALOG pada katalog induk tabel
    • USE_SCHEMA pada skema induk tabel
    • menjadi pemilik tabel.

Aset ruang kerja, seperti dasbor, akan dibuat di ruang kerja tempat panggilan ini dilakukan.

databricks quality-monitors create TABLE_NAME ASSETS_DIR OUTPUT_SCHEMA_NAME [flags]

Arguments

TABLE_NAME

    Nama lengkap tabel.

ASSETS_DIR

    Direktori untuk menyimpan aset pemantauan (misalnya dasbor, tabel metrik).

OUTPUT_SCHEMA_NAME

    Skema tempat tabel metrik output dibuat.

Opsi

--baseline-table-name string

    Nama tabel garis besar tempat metrik penyimpangan dihitung.

--json JSON

    String JSON sebaris atau @path ke file JSON dengan isi permintaan.

--skip-builtin-dashboard

    Apakah akan melewati pembuatan dasbor default yang meringkas metrik kualitas data.

--warehouse-id string

    Argumen opsional untuk menentukan gudang untuk pembuatan dasbor.

Bendera global

Examples

Contoh berikut membuat monitor kualitas untuk tabel:

databricks quality-monitors create main.my_schema.my_table /monitoring/assets main.monitoring_schema

hapus pemantau-kualitas databricks

Hapus monitor untuk tabel yang ditentukan.

Pemanggil harus melakukan salah satu dari langkah berikut:

  1. menjadi pemilik katalog induk tabel
  2. memiliki USE_CATALOG pada katalog induk dari tabel dan menjadi pemilik skema induk dari tabel
  3. memiliki izin berikut:
    • USE_CATALOG pada katalog induk tabel
    • USE_SCHEMA pada skema induk tabel
    • menjadi pemilik tabel.

Selain itu, panggilan harus dilakukan dari ruang kerja tempat monitor dibuat.

Perhatikan bahwa tabel metrik dan dasbor tidak akan dihapus sebagai bagian dari panggilan ini; aset tersebut harus dibersihkan secara manual (jika diinginkan).

databricks quality-monitors delete TABLE_NAME [flags]

Arguments

TABLE_NAME

    Nama lengkap tabel.

Opsi

Bendera global

Examples

Contoh berikut menghapus monitor kualitas:

databricks quality-monitors delete main.my_schema.my_table

Mendapatkan pemantau kualitas databricks

Dapatkan monitor untuk tabel yang ditentukan.

Pemanggil harus melakukan salah satu dari langkah berikut:

  1. menjadi pemilik katalog induk tabel
  2. memiliki USE_CATALOG pada katalog induk tabel dan menjadi pemilik skema induk tabel.
  3. memiliki izin berikut:
    • USE_CATALOG pada katalog induk tabel
    • USE_SCHEMA pada skema induk tabel
    • SELECT hak istimewa tersedia di atas meja.

Informasi yang dikembalikan mencakup nilai konfigurasi, serta informasi tentang aset yang dibuat oleh monitor. Beberapa informasi (misalnya, dasbor) dapat difilter jika pemanggil berada di ruang kerja yang berbeda dari tempat monitor dibuat.

databricks quality-monitors get TABLE_NAME [flags]

Arguments

TABLE_NAME

    Nama lengkap tabel.

Opsi

Bendera global

Examples

Contoh berikut mendapatkan informasi tentang monitor kualitas:

databricks quality-monitors get main.my_schema.my_table

databricks pemantau-kualitas get-refresh

Dapatkan info tentang refresh monitor tertentu menggunakan ID refresh yang diberikan.

Pemanggil harus melakukan salah satu dari langkah berikut:

  1. menjadi pemilik katalog induk tabel
  2. memiliki USE_CATALOG pada katalog induk dari tabel dan menjadi pemilik skema induk dari tabel
  3. memiliki izin berikut:
    • USE_CATALOG pada katalog induk tabel
    • USE_SCHEMA pada skema induk tabel
    • SELECT hak istimewa tersedia di atas meja.

Selain itu, panggilan harus dilakukan dari ruang kerja tempat monitor dibuat.

databricks quality-monitors get-refresh TABLE_NAME REFRESH_ID [flags]

Arguments

TABLE_NAME

    Nama lengkap tabel.

REFRESH_ID

    ID dari refresh.

Opsi

Bendera global

Examples

Contoh berikut mendapatkan informasi tentang refresh tertentu:

databricks quality-monitors get-refresh main.my_schema.my_table 12345

daftar penyegaran pengawas kualitas databricks

Cantumkan riwayat refresh terbaru (hingga 25) untuk tabel ini.

Pemanggil harus melakukan salah satu dari langkah berikut:

  1. menjadi pemilik katalog induk tabel
  2. memiliki USE_CATALOG pada katalog induk dari tabel dan menjadi pemilik skema induk dari tabel
  3. memiliki izin berikut:
    • USE_CATALOG pada katalog induk tabel
    • USE_SCHEMA pada skema induk tabel
    • SELECT hak istimewa tersedia di atas meja.

Selain itu, panggilan harus dilakukan dari ruang kerja tempat monitor dibuat.

databricks quality-monitors list-refreshes TABLE_NAME [flags]

Arguments

TABLE_NAME

    Nama lengkap tabel.

Opsi

Bendera global

Examples

Contoh berikut menyajikan daftar penyegaran untuk pengawasan kualitas:

databricks quality-monitors list-refreshes main.my_schema.my_table

Pemantau kualitas Databricks penyegaran otomatis

Antrekan refresh metrik pada monitor untuk tabel yang ditentukan. Refresh akan dijalankan di latar belakang.

Pemanggil harus melakukan salah satu dari langkah berikut:

  1. menjadi pemilik katalog induk tabel
  2. memiliki USE_CATALOG pada katalog induk dari tabel dan menjadi pemilik skema induk dari tabel
  3. memiliki izin berikut:
    • USE_CATALOG pada katalog induk tabel
    • USE_SCHEMA pada skema induk tabel
    • menjadi pemilik tabel sistem atau basis data

Selain itu, panggilan harus dilakukan dari ruang kerja tempat monitor dibuat.

databricks quality-monitors run-refresh TABLE_NAME [flags]

Arguments

TABLE_NAME

    Nama lengkap tabel.

Opsi

Bendera global

Examples

Contoh berikut mengantrekan refresh untuk monitor kualitas:

databricks quality-monitors run-refresh main.my_schema.my_table

pembaruan monitor kualitas databricks

Perbarui monitor untuk tabel yang ditentukan.

Pemanggil harus melakukan salah satu dari langkah berikut:

  1. menjadi pemilik katalog induk tabel
  2. memiliki USE_CATALOG pada katalog induk dari tabel dan menjadi pemilik skema induk dari tabel
  3. memiliki izin berikut:
    • USE_CATALOG pada katalog induk tabel
    • USE_SCHEMA pada skema induk tabel
    • menjadi pemilik tabel.

Selain itu, panggilan harus dilakukan dari ruang kerja tempat monitor dibuat, dan pemanggil harus menjadi pembuat asli monitor.

Bidang konfigurasi tertentu, seperti pengidentifikasi aset output, tidak dapat diperbarui.

databricks quality-monitors update TABLE_NAME OUTPUT_SCHEMA_NAME [flags]

Arguments

TABLE_NAME

    Nama lengkap tabel.

OUTPUT_SCHEMA_NAME

    Skema tempat tabel metrik output dibuat.

Opsi

--baseline-table-name string

    Nama tabel garis besar tempat metrik penyimpangan dihitung.

--dashboard-id string

    Id dasbor yang memvisualisasikan metrik yang dihitung.

--json JSON

    String JSON sebaris atau @path ke file JSON dengan isi permintaan.

Bendera global

Examples

Contoh berikut memperbarui monitor kualitas:

databricks quality-monitors update main.my_schema.my_table main.monitoring_schema

Contoh berikut memperbarui monitor kualitas dengan tabel garis besar baru:

databricks quality-monitors update main.my_schema.my_table main.monitoring_schema --baseline-table-name main.my_schema.new_baseline

Bendera dunia

--debug

  Apakah debug logging ingin diaktifkan?

-h atau --help

    Tampilkan bantuan untuk Databricks CLI atau grup perintah terkait atau perintah terkait.

--log-file tali

    String yang mewakili file yang akan digunakan untuk menulis log output. Jika bendera ini tidak ditentukan, maka defaultnya adalah menulis log output ke stderr.

--log-format Format

    Jenis format log, text atau json. Nilai defaultnya adalah text.

--log-level tali

    Untaian yang menggambarkan tingkat format log. Jika tidak ditentukan, maka tingkat format log akan dinonaktifkan.

-o, --output jenis

    Jenis output perintah, text atau json. Nilai defaultnya adalah text.

-p, --profile tali

    Nama profil dalam file ~/.databrickscfg yang digunakan untuk menjalankan perintah. Jika bendera ini tidak ditentukan maka jika ada, profil bernama DEFAULT digunakan.

--progress-format Format

    Format untuk menampilkan log kemajuan: default, , append, inplaceatau json

-t, --target tali

    Jika berlaku, target bundel yang akan digunakan