Bagikan melalui

grup perintah functions

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.

functions Grup perintah dalam Databricks CLI memungkinkan Anda mengelola fungsi yang ditentukan pengguna (UDF) di Unity Catalog. Implementasi fungsi dapat berupa ekspresi atau kueri SQL apa pun, dan dapat dipanggil di mana pun referensi tabel diizinkan dalam kueri. Di Unity Catalog, fungsi berada di tingkat yang sama dengan tabel, sehingga dapat direferensikan dengan formulir catalog_name.schema_name.function_name.

pembuatan fungsi pada databricks

Buat fungsi baru.

Important

Ini adalah fitur eksperimental.

Pengguna harus memiliki izin berikut agar fungsi dibuat:

- USE_CATALOG pada katalog induk fungsi

  • USE_SCHEMA dan CREATE_FUNCTION pada skema induk fungsi
databricks functions create [flags]

Opsi

--json JSON

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

Bendera global

Examples

Contoh berikut membuat fungsi menggunakan file JSON:

databricks functions create --json @function-definition.json

Contoh berikut membuat fungsi menggunakan JSON sebaris:

databricks functions create --json '{"name": "my_catalog.my_schema.my_function", "data_type": "INT", "full_data_type": "INT", "return_params": {"parameters": []}, "routine_body": "SQL", "routine_definition": "SELECT 1", "routine_dependencies": {"dependencies": []}, "parameter_style": "S", "is_deterministic": true, "sql_data_access": "CONTAINS_SQL", "is_null_call": false, "security_type": "DEFINER", "specific_name": "my_function"}'

hapus fungsi databricks

Hapus fungsi yang cocok dengan nama yang disediakan.

Agar penghapusan berhasil, pengguna harus memenuhi salah satu kondisi berikut:

  • Adalah pemilik katalog induk fungsi
  • Adalah pemilik skema induk fungsi dan memiliki USE_CATALOG hak istimewa pada katalog induknya
  • Adalah pemilik fungsi itu sendiri dan memiliki USE_CATALOG hak istimewa pada katalog induknya dan USE_SCHEMA hak istimewa pada skema induknya
databricks functions delete NAME [flags]

Arguments

NAME

    Nama fungsi yang sepenuhnya memenuhi syarat (dari formulir catalog_name.schema_name.function_name).

Opsi

--force

    Hapus paksa bahkan jika fungsinya adalah notempty.

Bendera global

Examples

Contoh berikut menghapus fungsi:

databricks functions delete my_catalog.my_schema.my_function

Contoh berikut memaksa penghapusan fungsi:

databricks functions delete my_catalog.my_schema.my_function --force

fungsi databricks mendapatkan

Dapatkan fungsi dari dalam katalog dan skema induk.

Agar pengambilan berhasil, pengguna harus memenuhi salah satu persyaratan berikut:

  • Adalah admin metastore
  • Adalah pemilik katalog induk fungsi
  • USE_CATALOG Memiliki hak istimewa pada katalog induk fungsi dan menjadi pemilik fungsi
  • USE_CATALOG Memiliki hak istimewa pada katalog induk fungsi, USE_SCHEMA hak istimewa pada skema induk fungsi, dan EXECUTE hak istimewa pada fungsi itu sendiri
databricks functions get NAME [flags]

Arguments

NAME

    Nama fungsi yang sepenuhnya memenuhi syarat (dari formulir catalog_name.schema_name.function_name).

Opsi

--include-browse

    Apakah akan menyertakan fungsi dalam respons yang hanya dapat diakses oleh prinsipal metadata selektif.

Bendera global

Examples

Contoh berikut mendapatkan informasi tentang fungsi:

databricks functions get my_catalog.my_schema.my_function

Contoh berikut mendapatkan fungsi termasuk informasi penelusuran:

databricks functions get my_catalog.my_schema.my_function --include-browse

daftar fungsi databricks

Mencantumkan fungsi dalam katalog dan skema induk yang ditentukan.

Jika pengguna adalah admin metastore, semua fungsi dikembalikan dalam daftar output. Jika tidak, pengguna harus memiliki USE_CATALOG hak istimewa pada katalog dan USE_SCHEMA hak istimewa pada skema, dan daftar output hanya berisi fungsi di mana pengguna memiliki EXECUTE hak istimewa atau pengguna adalah pemiliknya. Tidak ada jaminan urutan elemen tertentu dalam array.

databricks functions list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Nama katalog induk untuk fungsi yang diminati.

SCHEMA_NAME

    Skema induk fungsi.

Opsi

--include-browse

    Apakah akan menyertakan fungsi dalam respons yang hanya dapat diakses oleh prinsipal metadata selektif.

--max-results int

    Jumlah maksimum fungsi yang akan dikembalikan.

--page-token string

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

Bendera global

Examples

Contoh berikut mencantumkan semua fungsi dalam katalog dan skema:

databricks functions list my_catalog my_schema

Contoh berikut mencantumkan fungsi dengan maksimal 10 hasil:

databricks functions list my_catalog my_schema --max-results 10

Contoh berikut mencantumkan fungsi dengan informasi penelusuran yang disertakan:

databricks functions list my_catalog my_schema --include-browse

pembaruan fungsi databricks

Perbarui fungsi yang cocok dengan nama yang disediakan.

Hanya pemilik fungsi yang dapat diperbarui. Jika pengguna bukan admin metastore, pengguna harus menjadi anggota grup yang merupakan pemilik fungsi baru. Pengguna harus memenuhi salah satu kondisi berikut:

  • Adalah admin metastore
  • Adalah pemilik katalog induk fungsi
  • Adalah pemilik skema induk fungsi dan memiliki USE_CATALOG hak istimewa pada katalog induknya
  • Adalah pemilik fungsi itu sendiri dan memiliki USE_CATALOG hak istimewa pada katalog induknya serta USE_SCHEMA hak istimewa pada skema induk fungsi
databricks functions update NAME [flags]

Arguments

NAME

    Nama fungsi yang sepenuhnya memenuhi syarat (dari formulir catalog_name.schema_name.function_name).

Opsi

--json JSON

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

--owner string

    Nama pengguna pemilik fungsi saat ini.

Bendera global

Examples

Contoh berikut ini memperbarui pemilik fungsi:

databricks functions update my_catalog.my_schema.my_function --owner someone@example.com

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