Bagikan melalui


grup perintah storage-credentials

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.

storage-credentials Grup perintah dalam Databricks CLI berisi perintah untuk mengelola kredensial penyimpanan di Katalog Unity. Kredensial penyimpanan mewakili mekanisme autentikasi dan otorisasi untuk mengakses data yang disimpan di penyewa cloud Anda. Setiap kredensial penyimpanan tunduk pada kebijakan kontrol akses Katalog Unity yang mengontrol pengguna dan grup mana yang dapat mengakses kredensial. Jika pengguna tidak memiliki akses ke kredensial penyimpanan di Unity Catalog, permintaan gagal dan Katalog Unity tidak mencoba mengautentikasi ke penyewa cloud Anda atas nama pengguna. Lihat Mengelola kredensial penyimpanan.

databricks kredensial-penyimpanan buat

Buat kredensial penyimpanan baru.

Pemanggil harus menjadi admin metastore atau memiliki CREATE_STORAGE_CREDENTIAL hak istimewa di metastore.

databricks storage-credentials create NAME [flags]

Arguments

NAME

    Nama kredensial. Nama harus unik di antara kredensial penyimpanan dan layanan dalam metastore.

Opsi

--comment string

    Komentar yang terkait dengan kredensial.

--json JSON

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

--read-only

    Apakah kredensial hanya dapat digunakan untuk operasi baca.

--skip-validation

    Menyediakan true ke argumen ini melewati validasi kredensial yang dibuat.

Bendera global

Examples

Contoh berikut membuat kredensial penyimpanan baru:

databricks storage-credentials create my-storage-credential

Contoh berikut membuat kredensial penyimpanan dengan komentar:

databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"

Contoh berikut membuat kredensial penyimpanan baca-saja:

databricks storage-credentials create my-storage-credential --read-only

databricks hapus kredensial penyimpanan

Menghapus kredensial penyimpanan dari metastore. Penelepon harus menjadi pemilik kredensial penyimpanan.

databricks storage-credentials delete NAME [flags]

Arguments

NAME

    Nama kredensial penyimpanan.

Opsi

--force

    Paksa pembaruan bahkan jika ada lokasi eksternal dependen atau tabel eksternal (ketika tujuannya adalah STORAGE) atau layanan dependen (ketika tujuannya adalah SERVICE).

Bendera global

Examples

Contoh berikut menghapus kredensial penyimpanan:

databricks storage-credentials delete my-storage-credential

Contoh paksa berikut menghapus kredensial penyimpanan:

databricks storage-credentials delete my-storage-credential --force

databricks storage-credentials get (perintah untuk mendapatkan kredensial penyimpanan di databricks)

Dapatkan kredensial penyimpanan dari metastore. Pemanggil harus merupakan admin metastore, pemilik kredensial penyimpanan, atau memiliki beberapa izin pada kredensial penyimpanan.

databricks storage-credentials get NAME [flags]

Arguments

NAME

    Nama kredensial penyimpanan.

Opsi

Bendera global

Examples

Contoh berikut mendapatkan informasi tentang kredensial penyimpanan:

databricks storage-credentials get my-storage-credential

daftar kredensial penyimpanan databricks

Mencantumkan kredensial penyimpanan. Daftar hanya terbatas pada kredensial penyimpanan yang dapat diakses oleh pemanggil. Jika penelepon adalah admin metastore, pengambilan kredensial tidak dibatasi. Tidak ada jaminan urutan elemen tertentu dalam array.

databricks storage-credentials list [flags]

Opsi

--max-results int

    Jumlah maksimum kredensial penyimpanan yang akan dikembalikan.

--page-token string

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

Bendera global

Examples

Contoh berikut mencantumkan semua kredensial penyimpanan:

databricks storage-credentials list

pembaruan kredensial penyimpanan untuk databricks

Perbarui kredensial penyimpanan di metastore.

Penelepon harus menjadi pemilik kredensial penyimpanan atau admin metastore. Jika penelepon adalah admin metastore, hanya bidang yang owner dapat diubah.

databricks storage-credentials update NAME [flags]

Arguments

NAME

    Nama kredensial penyimpanan.

Opsi

--comment string

    Komentar yang terkait dengan kredensial.

--force

    Perbarui secara paksa meskipun ada lokasi eksternal yang bergantung atau tabel eksternal.

--isolation-mode IsolationMode

    Apakah securable saat ini dapat diakses dari semua workspace atau sekumpulan workspace tertentu. Nilai yang didukung: [ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN]

--json JSON

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

--new-name string

    Nama baru untuk kredensial penyimpanan.

--owner string

    Nama pengguna pemilik kredensial saat ini.

--read-only

    Apakah kredensial hanya dapat digunakan untuk operasi baca.

--skip-validation

    Memasok true ke argumen ini melewati validasi kredensial yang diperbarui.

Bendera global

Examples

Contoh berikut memperbarui komentar kredensial penyimpanan:

databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"

Contoh berikut mengubah pemilik kredensial penyimpanan:

databricks storage-credentials update my-storage-credential --owner someone@example.com

Contoh berikut mengganti nama kredensial penyimpanan:

databricks storage-credentials update my-storage-credential --new-name updated-credential

databricks storage-credentials memvalidasi

Memvalidasi kredensial penyimpanan. Setidaknya salah satu dari external_location_name dan url perlu disediakan. Jika hanya satu dari mereka yang disediakan, itu akan digunakan untuk validasi. Dan jika keduanya disediakan, url akan digunakan untuk validasi, dan external_location_name akan diabaikan saat memeriksa url yang tumpang tindih.

storage_credential_name atau kredensial khusus cloud harus disediakan.

Pemanggil harus merupakan admin metastore atau pemilik kredensial penyimpanan atau memiliki CREATE_EXTERNAL_LOCATION hak istimewa pada metastore dan kredensial penyimpanan.

databricks storage-credentials validate [flags]

Opsi

--external-location-name string

    Nama lokasi eksternal yang ada untuk divalidasi.

--json JSON

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

--read-only

    Apakah kredensial penyimpanan hanya dapat digunakan untuk operasi baca.

--storage-credential-name string

    Required.

--url string

    Url lokasi eksternal untuk divalidasi.

Bendera global

Examples

Contoh berikut memvalidasi kredensial penyimpanan terhadap lokasi eksternal:

databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location

Contoh berikut memvalidasi kredensial penyimpanan terhadap URL:

databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path

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