grup perintah warehouses

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.

warehouses Grup perintah dalam Databricks CLI memungkinkan Anda mengelola gudang SQL. Gudang SQL adalah sumber daya komputasi yang memungkinkan Anda menjalankan perintah SQL pada objek data dalam Databricks SQL. Lihat Menyambungkan ke gudang SQL.

pembuatan gudang data Databricks

Buat gudang SQL baru.

databricks warehouses create [flags]

Arguments

None

Opsi

--auto-stop-mins int

    Jumlah waktu dalam menit yang harus tidak digunakan gudang data SQL (dengan kata lain, tidak ada RUNNING kueri) sebelum dihentikan secara otomatis.

--cluster-size string

    Ukuran kluster yang dialokasikan untuk gudang ini.

--creator-name string

    Nama pembuat gudang.

--enable-photon

    Mengonfigurasi apakah gudang harus menggunakan kluster yang dioptimalkan Photon.

--enable-serverless-compute

    Mengonfigurasi apakah gudang harus menggunakan komputasi tanpa server.

--instance-profile-arn string

    Deprecated.

--json JSON

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

--max-num-clusters int

    Jumlah maksimum kluster yang akan dibuat penskala otomatis untuk menangani kueri bersamaan.

--min-num-clusters int

    Jumlah minimum kluster yang tersedia yang akan dipertahankan untuk gudang SQL ini.

--name string

    Nama logis untuk kluster.

--no-wait

    Jangan menunggu hingga mencapai status BERJALAN

--spot-instance-policy SpotInstancePolicy

    Apakah konfigurasi gudang harus menggunakan instance spot? Nilai yang didukung: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED

--timeout duration

    Jumlah waktu maksimum untuk mencapai RUNNING status (default 20ms)

--warehouse-type CreateWarehouseRequestWarehouseType

    Jenis gudang: PRO atau CLASSIC. Nilai yang didukung: CLASSIC, PRO, TYPE_UNSPECIFIED

Bendera global

Examples

Contoh berikut membuat gudang SQL baru dengan konfigurasi dasar:

databricks warehouses create --name "my-warehouse" --cluster-size "Small" --min-num-clusters 1 --max-num-clusters 10 --auto-stop-mins 60

Contoh berikut membuat gudang tanpa server dengan Photon diaktifkan:

databricks warehouses create --name "serverless-warehouse" --enable-serverless-compute --enable-photon --warehouse-type PRO

gudang databricks create-default-warehouse-override

Buat penggantian gudang default untuk pengguna. Pengguna dapat membuat penimpaan mereka sendiri. Admin dapat membuat penimpaan untuk pengguna mana pun.

databricks warehouses create-default-warehouse-override DEFAULT_WAREHOUSE_OVERRIDE_ID TYPE [flags]

Arguments

DEFAULT_WAREHOUSE_OVERRIDE_ID

    ID untuk penimpaan. Gunakan ID pengguna numerik atau string me harfiah untuk pengguna saat ini.

TYPE

    Jenis perilaku penimpaan. Nilai yang didukung: CUSTOM, LAST_SELECTED.

Opsi

--json JSON

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

--name string

    Nama sumber daya dari penggantian gudang default.

--warehouse-id string

    ID gudang tertentu saat jenisnya adalah CUSTOM.

Bendera global

Examples

Contoh berikut membuat penggantian gudang kustom untuk pengguna saat ini:

databricks warehouses create-default-warehouse-override me CUSTOM --warehouse-id 1234567890abcdef

hapus gudang databricks

Menghapus gudang SQL.

databricks warehouses delete ID [flags]

Arguments

ID

    Required. Id gudang SQL.

Opsi

Bendera global

Examples

Contoh berikut menghapus gudang dengan ID yang ditentukan:

databricks warehouses delete 1234567890abcdef

gudang databricks menghapus-default-warehouse-override

Hapus penimpaan gudang default untuk pengguna. Pengguna dapat menghapus penimpaan mereka sendiri. Admin dapat menghapus penimpaan untuk pengguna mana pun. Setelah penghapusan, gudang default ruang kerja digunakan.

databricks warehouses delete-default-warehouse-override NAME [flags]

Arguments

NAME

    Nama sumber daya dari penimpaan gudang default untuk dihapus. Format: default-warehouse-overrides/{default_warehouse_override_id}. ID dapat berupa ID pengguna numerik atau string me harfiah untuk pengguna saat ini.

Opsi

Bendera global

Examples

Contoh berikut menghapus penimpaan gudang default untuk pengguna saat ini:

databricks warehouses delete-default-warehouse-override default-warehouse-overrides/me

Mengedit gudang data databricks

Perbarui gudang. Memperbarui konfigurasi untuk gudang SQL.

databricks warehouses edit ID [flags]

Arguments

ID

    Required. Id gudang yang akan dikonfigurasi.

Opsi

--auto-stop-mins int

    Jumlah waktu dalam menit yang harus tidak digunakan gudang data SQL (dengan kata lain, tidak ada RUNNING kueri) sebelum dihentikan secara otomatis.

--cluster-size string

    Ukuran kluster yang dialokasikan untuk gudang ini.

--creator-name string

    Nama pembuat gudang.

--enable-photon

    Mengonfigurasi apakah gudang harus menggunakan kluster yang dioptimalkan Photon.

--enable-serverless-compute

    Mengonfigurasi apakah gudang harus menggunakan komputasi tanpa server.

--instance-profile-arn string

    Deprecated.

--json JSON

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

--max-num-clusters int

    Jumlah maksimum kluster yang akan dibuat penskala otomatis untuk menangani kueri bersamaan.

--min-num-clusters int

    Jumlah minimum kluster yang tersedia yang akan dipertahankan untuk gudang SQL ini.

--name string

    Nama logis untuk kluster.

--no-wait

    Jangan menunggu untuk mencapai RUNNING status

--spot-instance-policy SpotInstancePolicy

    Apakah konfigurasi gudang harus menggunakan instance spot? Nilai yang didukung: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED

--timeout duration

    Jumlah waktu maksimum untuk mencapai RUNNING status (default 20ms)

--warehouse-type EditWarehouseRequestWarehouseType

    Jenis gudang. Nilai yang didukung: CLASSIC, PRO, TYPE_UNSPECIFIED

Bendera global

Examples

Contoh berikut memperbarui gudang untuk mengubah ukuran kluster dan waktu berhenti otomatisnya:

databricks warehouses edit 1234567890abcdef --cluster-size "Medium" --auto-stop-mins 30

Contoh berikut memungkinkan Photon untuk gudang yang ada:

databricks warehouses edit 1234567890abcdef --enable-photon

gudang databricks diakses

Dapatkan informasi untuk satu gudang SQL.

databricks warehouses get ID [flags]

Arguments

ID

    Required. Id gudang SQL.

Opsi

Bendera global

Examples

Contoh berikut mendapatkan informasi tentang gudang dengan ID yang ditentukan:

databricks warehouses get 1234567890abcdef

gudang databricks get-default-warehouse-override

Dapatkan penimpaan gudang default untuk pengguna. Pengguna dapat mengambil alih mereka sendiri. Admin dapat mengambil alih untuk pengguna mana pun. Jika tidak ada penimpaan, gudang default ruang kerja digunakan.

databricks warehouses get-default-warehouse-override NAME [flags]

Arguments

NAME

    Nama sumber daya dari penimpaan gudang default untuk diambil. Format: default-warehouse-overrides/{default_warehouse_override_id}. ID dapat berupa ID pengguna numerik atau string me harfiah untuk pengguna saat ini.

Opsi

Bendera global

Examples

Contoh berikut mendapatkan penggantian gudang default untuk pengguna saat ini:

databricks warehouses get-default-warehouse-override default-warehouse-overrides/me

gudang databricks dapatkan-konfigurasi-gudang-ruang-kerja

Dapatkan konfigurasi tingkat ruang kerja yang dibagikan oleh semua gudang SQL di ruang kerja.

databricks warehouses get-workspace-warehouse-config [flags]

Arguments

None

Opsi

Bendera global

Examples

Contoh berikut mendapatkan konfigurasi gudang ruang kerja:

databricks warehouses get-workspace-warehouse-config

daftar gudang databricks

Cantumkan semua gudang SQL tempat pengguna mengelola izin.

databricks warehouses list [flags]

Arguments

None

Opsi

--run-as-user-id int

    Perwakilan Layanan yang akan digunakan untuk mengambil daftar gudang.

Bendera global

Examples

Contoh berikut mencantumkan semua gudang:

databricks warehouses list

Contoh berikut mencantumkan gudang menggunakan prinsipal layanan tertentu.

databricks warehouses list --run-as-user-id 123456789

gudang databricks daftar-default-warehouse-overrides

Cantumkan semua penggantian gudang default di ruang kerja. Hanya administrator ruang kerja yang dapat mencantumkan semua penimpaan.

databricks warehouses list-default-warehouse-overrides [flags]

Opsi

--page-size int

    Jumlah maksimum penimpaan yang akan dikembalikan.

--page-token string

    Token halaman diterima dari panggilan sebelumnya list-default-warehouse-overrides .

Bendera global

Examples

Contoh berikut mencantumkan semua penggantian gudang default:

databricks warehouses list-default-warehouse-overrides

gudang databricks setelan konfigurasi gudang ruang kerja

Atur konfigurasi tingkat ruang kerja yang dibagikan oleh semua gudang SQL di ruang kerja.

databricks warehouses set-workspace-warehouse-config [flags]

Arguments

None

Opsi

--google-service-account string

    Hanya GCP: Akun Layanan Google yang digunakan untuk meneruskan ke kluster untuk mengakses Google Cloud Storage.

--instance-profile-arn string

    AWS Only: Profil instance yang digunakan untuk meneruskan peran IAM ke kluster.

--json JSON

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

--security-policy SetWorkspaceWarehouseConfigRequestSecurityPolicy

    Kebijakan keamanan untuk gudang. Nilai yang didukung: DATA_ACCESS_CONTROL, NONE, PASSTHROUGH

Bendera global

Examples

Contoh berikut menetapkan konfigurasi gudang ruang kerja dengan kebijakan keamanan:

databricks warehouses set-workspace-warehouse-config --security-policy DATA_ACCESS_CONTROL

gudang databricks diinisialisasi

Mulai gudang SQL.

databricks warehouses start ID [flags]

Arguments

ID

    Required. Id gudang SQL.

Opsi

--no-wait

    Jangan menunggu untuk mencapai RUNNING status

--timeout duration

    Jumlah waktu maksimum untuk mencapai RUNNING status (default 20ms)

Bendera global

Examples

Berikut ini adalah contoh cara memulai gudang dengan ID yang sudah ditentukan.

databricks warehouses start 1234567890abcdef

Contoh berikut memulai gudang tanpa menunggunya mencapai RUNNING status:

databricks warehouses start 1234567890abcdef --no-wait

gudang Databricks dihentikan

Hentikan gudang SQL.

databricks warehouses stop ID [flags]

Arguments

ID

    Required. Id gudang SQL.

Opsi

--no-wait

    Jangan menunggu untuk mencapai STOPPED status

--timeout duration

    Jumlah waktu maksimum untuk mencapai STOPPED status (default 20ms)

Bendera global

Examples

Contoh di bawah ini menghentikan gudang dengan ID yang ditentukan:

databricks warehouses stop 1234567890abcdef

Contoh berikut menghentikan gudang tanpa menunggunya mencapai STOPPED status:

databricks warehouses stop 1234567890abcdef --no-wait

gudang databricks update-default-warehouse-override

Perbarui penimpaan gudang default yang ada untuk pengguna. Pengguna dapat memperbarui penimpaan mereka sendiri. Admin dapat memperbarui penimpaan untuk pengguna mana pun.

databricks warehouses update-default-warehouse-override NAME UPDATE_MASK TYPE [flags]

Arguments

NAME

    Nama sumber daya dari penggantian gudang default. Format: default-warehouse-overrides/{default_warehouse_override_id}.

UPDATE_MASK

    Masker bidang yang menentukan bidang mana yang akan diperbarui. Gunakan * untuk memperbarui semua bidang. Ketika --allow-missing diatur, bidang ini diabaikan dan semua bidang diterapkan.

TYPE

    Jenis perilaku penimpaan. Nilai yang didukung: CUSTOM, LAST_SELECTED.

Opsi

--allow-missing

    Jika set dan penimpaan tidak ditemukan, buat penimpaan baru sebagai gantinya.

--json JSON

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

--name string

    Nama sumber daya dari penggantian gudang default.

--warehouse-id string

    ID gudang tertentu saat jenisnya adalah CUSTOM.

Bendera global

Examples

Contoh berikut memperbarui penimpaan pengguna saat ini ke gudang tertentu:

databricks warehouses update-default-warehouse-override default-warehouse-overrides/me warehouse_id CUSTOM --warehouse-id 1234567890abcdef

gudang databricks memperoleh tingkat izin

Mendapatkan tingkat izin penyimpanan SQL.

databricks warehouses get-permission-levels WAREHOUSE_ID [flags]

Arguments

WAREHOUSE_ID

    Gudang SQL untuk mendapatkan atau mengelola izin.

Opsi

Bendera global

Examples

Contoh berikut mendapatkan tingkat izin untuk gudang:

databricks warehouses get-permission-levels 1234567890abcdef

peroleh izin untuk gudang Databricks

Dapatkan izin gudang SQL. Gudang SQL dapat mewarisi izin dari objek akarnya.

databricks warehouses get-permissions WAREHOUSE_ID [flags]

Arguments

WAREHOUSE_ID

    Gudang SQL untuk mendapatkan atau mengelola izin.

Opsi

Bendera global

Examples

Contoh berikut mendapatkan izin untuk gudang:

databricks warehouses get-permissions 1234567890abcdef

pengaturan izin penyimpanan databricks

Atur izin gudang SQL. Mengatur izin pada objek, menggantikan izin yang ada jika ada. Menghapus semua izin langsung jika tidak ada yang ditentukan. Objek dapat mewarisi izin dari objek akarnya.

databricks warehouses set-permissions WAREHOUSE_ID [flags]

Arguments

WAREHOUSE_ID

    Gudang SQL untuk mendapatkan atau mengelola izin.

Opsi

--json JSON

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

Bendera global

Examples

Contoh berikut menetapkan izin untuk gudang menggunakan file JSON:

databricks warehouses set-permissions 1234567890abcdef --json @permissions.json

izin pembaruan gudang databricks

Perbarui izin pada gudang SQL. Gudang SQL dapat mewarisi izin dari objek akarnya.

databricks warehouses update-permissions WAREHOUSE_ID [flags]

Arguments

WAREHOUSE_ID

    Gudang SQL untuk mendapatkan atau mengelola izin.

Opsi

--json JSON

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

Bendera global

Examples

Contoh berikut memperbarui izin untuk gudang menggunakan file JSON:

databricks warehouses update-permissions 1234567890abcdef --json @permissions.json

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