grup perintah external-locations

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.

external-locations Grup perintah dalam Databricks CLI berisi perintah untuk membuat dan mengelola lokasi eksternal untuk Unity Catalog. Lihat Apa itu Unity Catalog volumes?.

databricks buat-lokasi-eksternal

Buat entri lokasi eksternal baru di metastore. Pemanggil harus menjadi admin metastore atau memiliki CREATE_EXTERNAL_LOCATION hak istimewa pada metastore dan kredensial penyimpanan terkait.

databricks external-locations create NAME URL CREDENTIAL_NAME [flags]

Arguments

NAME

    Nama lokasi eksternal.

URL

    Jalur URL ke lokasi eksternal.

CREDENTIAL_NAME

    Nama kredensial penyimpanan yang digunakan dengan lokasi ini.

Opsi

--comment string

    Deskripsi teks bentuk bebas yang disediakan pengguna.

--enable-file-events

    Apakah akan mengaktifkan aktivitas berkas pada lokasi eksternal ini.

--fallback

    Menunjukkan apakah mode fallback diaktifkan untuk lokasi eksternal ini.

--json JSON

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

--read-only

    Menunjukkan apakah lokasi eksternal hanya dapat dibaca.

--skip-validation

    Mengabaikan validasi kredensial penyimpanan yang terkait dengan lokasi eksternal.

Bendera global

Examples

Contoh berikut membuat lokasi eksternal dengan komentar:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"

Contoh berikut membuat lokasi eksternal baca-saja:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only

databricks hapus lokasi-eksternal

Hapus lokasi eksternal yang ditentukan dari metastore. Pemanggil harus menjadi pemilik lokasi eksternal.

databricks external-locations delete NAME [flags]

Arguments

NAME

    Nama lokasi eksternal.

Opsi

--force

    Penghapusan paksa bahkan jika ada tabel eksternal atau pemasangan dependen.

Bendera global

Examples

Contoh berikut menghapus lokasi eksternal bernama my-external-location:

databricks external-locations delete my-external-location

Contoh berikut secara paksa menghapus lokasi eksternal meskipun ada dependensi:

databricks external-locations delete my-external-location --force

databricks lokasi-eksternal dapatkan

Temukan lokasi eksternal dari metastore. Pemanggil harus berupa admin metastore, pemilik lokasi eksternal, atau pengguna yang memiliki beberapa hak istimewa di lokasi eksternal.

databricks external-locations get NAME [flags]

Arguments

NAME

    Nama lokasi eksternal.

Opsi

--include-browse

    Apakah lokasi eksternal yang hanya dapat diakses oleh prinsipal dengan metadata selektif harus disertakan dalam respons.

Bendera global

Examples

Contoh berikut mendapatkan informasi tentang lokasi eksternal bernama my-external-location:

databricks external-locations get my-external-location

Contoh berikut mendapatkan informasi termasuk menelusuri metadata:

databricks external-locations get my-external-location --include-browse

Daftar Lokasi Eksternal Databricks

Cantumkan lokasi eksternal dari metastore. Pemanggil harus merupakan admin metastore, pemilik lokasi eksternal, atau pengguna yang memiliki beberapa hak istimewa di lokasi eksternal. Tidak ada jaminan urutan elemen tertentu dalam array.

databricks external-locations list [flags]

Opsi

--include-browse

    Apakah lokasi eksternal yang hanya dapat diakses oleh prinsipal dengan metadata selektif harus disertakan dalam respons.

--include-unbound

    Apakah akan menyertakan lokasi eksternal yang tidak terikat ke ruang kerja.

--max-results int

    Jumlah maksimum lokasi eksternal yang akan dikembalikan.

--page-token string

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

Bendera global

Examples

Contoh berikut mencantumkan semua lokasi eksternal:

databricks external-locations list

Contoh berikut mencantumkan lokasi eksternal dengan maksimal 10 hasil:

databricks external-locations list --max-results 10

pembaruan lokasi eksternal Databricks

Perbarui lokasi eksternal di metastore. Pemanggil harus menjadi pemilik lokasi eksternal, atau menjadi admin metastore. Dalam kasus kedua, admin hanya dapat memperbarui nama lokasi eksternal.

databricks external-locations update NAME [flags]

Arguments

NAME

    Nama lokasi eksternal.

Opsi

--comment string

    Deskripsi teks bentuk bebas yang disediakan pengguna.

--credential-name string

    Nama kredensial penyimpanan yang digunakan dengan lokasi ini.

--enable-file-events

    Apakah akan mengaktifkan aktivitas berkas pada lokasi eksternal ini.

--fallback

    Menunjukkan apakah mode fallback diaktifkan untuk lokasi eksternal ini.

--force

    Paksa pembaruan bahkan jika mengubah URL membuat tabel eksternal yang bergantung atau pemasangan menjadi tidak valid.

--isolation-mode IsolationMode

    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 lokasi eksternal.

--owner string

    Pemilik lokasi eksternal.

--read-only

    Menunjukkan apakah lokasi eksternal hanya dapat dibaca.

--skip-validation

    Mengabaikan validasi kredensial penyimpanan yang terkait dengan lokasi eksternal.

--url string

    Jalur URL ke lokasi eksternal.

Bendera global

Examples

Contoh berikut mengganti nama lokasi eksternal:

databricks external-locations update my-external-location --new-name my-renamed-location

Contoh berikut ini menunjukkan bagaimana mengubah pemilik lokasi eksternal tersebut.

databricks external-locations update my-external-location --owner someone@example.com

Bendera dunia

--debug

  Apakah akan mengaktifkan pengelogan debug.

-h atau --help

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

--log-file tali

    String yang mewakili file 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 yang ~/.databrickscfg akan 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