Bagikan melalui

grup perintah shares

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.

shares Grup perintah dalam Databricks CLI memungkinkan Anda mengelola berbagi di Unity Catalog.

Share adalah wadah yang dibuat dengan shares create. Setelah dibuat, Anda dapat secara berulang mendaftarkan kumpulan aset data yang ada yang ditentukan dalam metastore menggunakan shares update. Anda dapat mendaftarkan aset data dengan nama aslinya yang terkait dengan skema aslinya, atau memberikan nama alternatif yang diekspos.

pembuatan berbagi databricks

Buat pembagian baru untuk objek-objek data. Objek data dapat ditambahkan setelah dibuat dengan update. Pemanggil harus menjadi admin metastore atau memiliki CREATE_SHARE hak istimewa di metastore.

databricks shares create NAME [flags]

Arguments

NAME

    Nama saham.

Opsi

--comment string

    Deskripsi teks bentuk bebas yang disediakan pengguna.

--json JSON

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

--storage-root string

    URL akar penyimpanan untuk file buku catatan di berbagi.

Bendera global

Examples

Contoh berikut membuat berbagi bernama my-analytics-share dengan komentar:

databricks shares create my-analytics-share --comment "Sales analytics data share"

Contoh berikut membuat folder berbagi dengan akar penyimpanan tertentu:

databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"

penghapusan saham databricks

Menghapus bagian dari metastore. Penelepon harus menjadi pemilik saham.

databricks shares delete NAME [flags]

Arguments

NAME

    Nama berbagi.

Opsi

Bendera global

Examples

Contoh berikut menghapus folder berbagi bernama my-analytics-share:

databricks shares delete my-analytics-share

saham Databricks mendapatkan

Dapatkan bagian dari metastore. Pengguna yang menelepon harus menjadi administrator metastore atau pemilik pembagian.

databricks shares get NAME [flags]

Arguments

NAME

    Nama berbagi.

Opsi

--include-shared-data

    Kueri untuk data yang akan disertakan dalam berbagi.

Bendera global

Examples

Contoh berikut mendapatkan informasi tentang saham bernama my-analytics-share:

databricks shares get my-analytics-share

Contoh berikut mendapatkan akses dengan rincian tentang data yang dibagikan:

databricks shares get my-analytics-share --include-shared-data

(Dihentikan) daftar saham Databricks

Deprecated. Mendaftar bagian dari metastore. Pengguna yang menelepon harus menjadi administrator metastore atau pemilik pembagian. Urutan elemen dalam array tidak dijamin.

databricks shares list [flags]

Arguments

None

Opsi

--max-results int

    Jumlah maksimum saham yang dikembalikan.

--page-token string

    Token paginasi buram untuk masuk ke halaman berikutnya berdasarkan kueri sebelumnya.

Bendera global

daftar saham databricks

Mendaftar bagian dari metastore. Pengguna yang menelepon harus menjadi administrator metastore atau pemilik pembagian. Urutan elemen dalam array tidak dijamin.

databricks shares list-shares [flags]

Arguments

None

Opsi

--max-results int

    Jumlah maksimum saham yang dikembalikan.

--page-token string

    Token paginasi buram untuk masuk ke halaman berikutnya berdasarkan kueri sebelumnya.

Bendera global

Examples

Contoh berikut mencantumkan semua berbagi:

databricks shares list-shares

pembaruan saham Databricks

Perbarui izin berbagi dengan perubahan dan objek data dalam permintaan. Penelepon harus menjadi pemilik berbagi atau admin metastore.

Ketika penelepon adalah admin metastore, hanya bidang owner yang dapat diperbarui.

Jika nama share diubah, updateShare mengharuskan pengguna adalah pemilik share dan memiliki CREATE_SHARE privilege.

Jika ada file buku catatan pada share, storage_root bidang tidak dapat diperbarui.

Untuk setiap tabel yang ditambahkan melalui metode ini, pemilik akses berbagi juga harus memiliki SELECT hak istimewa pada tabel. Hak istimewa ini harus dipertahankan tanpa batas waktu agar penerima dapat mengakses tabel. Biasanya, Anda harus menggunakan grup sebagai pemilik bagian.

Penghapusan tabel melalui update tidak memerlukan hak istimewa tambahan.

databricks shares update NAME [flags]

Arguments

NAME

    Nama berbagi.

Opsi

--comment string

    Deskripsi teks bentuk bebas yang disediakan pengguna.

--json JSON

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

--new-name string

    Nama baru untuk berbagi.

--owner string

    Nama pengguna pemilik berbagi saat ini.

--storage-root string

    URL akar penyimpanan untuk file buku catatan di berbagi.

Bendera global

Examples

Contoh berikut memperbarui komentar berbagi:

databricks shares update my-analytics-share --comment "Updated sales analytics data share"

Contoh di bawah ini mengubah nama folder/berkas yang dibagikan:

databricks shares update my-analytics-share --new-name "sales-analytics-share"

Contoh berikut memperbarui pemilik bagian:

databricks shares update my-analytics-share --owner "someone@example.com"

Contoh berikut memperbarui berbagi menggunakan konfigurasi JSON:

databricks shares update my-analytics-share --json '{
  "comment": "Updated share with new tables",
  "objects": [
    {
      "name": "sales.customers",
      "data_object_type": "TABLE"
    }
  ]
}'

databricks berbagi izin berbagi

Dapatkan izin untuk berbagi data dari metastore. Pengguna yang menelepon harus menjadi administrator metastore atau pemilik pembagian.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    Nama berbagi.

Opsi

--max-results int

    Maksimal jumlah izin yang dapat dikembalikan.

--page-token string

    Token paginasi buram untuk masuk ke halaman berikutnya berdasarkan kueri sebelumnya.

Bendera global

Examples

Contoh berikut mendapatkan izin untuk saham bernama my-analytics-share:

databricks shares share-permissions my-analytics-share

databricks berbagi izin pembaruan

Perbarui izin untuk berbagi data di metastore. Penelepon harus menjadi admin metastore atau pemilik bagian.

Untuk pemberian penerima baru, pengguna juga harus menjadi pemilik penerima atau admin metastore. Pencabutan penerima tidak memerlukan hak istimewa tambahan.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    Nama berbagi.

Opsi

--json JSON

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

--omit-permissions-list

    Optional.

Bendera global

Examples

Contoh berikut memberikan izin kepada penerima:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "add": ["SELECT"]
    }
  ]
}'

Contoh berikut mencabut izin dari penerima:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "remove": ["SELECT"]
    }
  ]
}'

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

  • Last updated on