Aracılığıyla paylaş

functions komut grubu

Note

Bu bilgiler Databricks CLI 0.205 ve üzeri sürümleri için geçerlidir. Databricks CLI Genel Önizleme aşamasındadır.

Databricks CLI kullanımı, Kullanım Verileri sağlamaları da dahil olmak üzere Databricks Lisansı ve Databricks Gizlilik Bildirimi'ne tabidir.

functions Databricks CLI içindeki komut grubu, Unity Kataloğu'nda kullanıcı tanımlı işlevleri (UDF) yönetmenize olanak tanır. İşlev uygulaması herhangi bir SQL ifadesi veya sorgusu olabilir ve sorguda tablo başvurusuna izin verilen her yerde çağrılabilir. Unity Kataloğu'nda, bir işlev tabloyla aynı düzeyde yer alır, bu nedenle catalog_name.schema_name.function_name biçiminde başvurulabilir.

databricks işlevleri oluşturma

Yeni bir işlev oluşturun.

Important

Bu, deneysel bir özelliktir.

İşlevin oluşturulabilmesi için kullanıcının aşağıdaki izinlere sahip olması gerekir:

- USE_CATALOG işlevin ana dizininde

  • USE_SCHEMA ve CREATE_FUNCTION işlevin üst şemasında
databricks functions create [flags]

Options

--json JSON

    satır içi JSON dizesi veya @path istek gövdesine sahip JSON dosyasına.

Genel bayraklar

Examples

Aşağıdaki örnek, JSON dosyası kullanarak bir işlev oluşturur:

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

Aşağıdaki örnek, satır içi JSON kullanarak bir işlev oluşturur:

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"}'

databricks işlevleri silme

Sağlanan adla eşleşen işlevi silin.

Silme işleminin başarılı olması için kullanıcının aşağıdaki koşullardan birini karşılaması gerekir:

  • İşlevin üst kataloğunun sahibidir
  • İşlevin üst şemasının sahibidir ve üst kataloğunda USE_CATALOG ayrıcalığına sahiptir.
  • Kendisi işlevin sahibidir ve hem üst kataloğunda USE_CATALOG ayrıcalığına hem de üst şemasında USE_SCHEMA ayrıcalığına sahiptir.
databricks functions delete NAME [flags]

Arguments

NAME

    İşlevin tam nitelikli adı (şu biçimde: catalog_name.schema_name.function_name).

Options

--force

    İşlev boş değilse bile silinmesini zorla.

Genel bayraklar

Examples

Aşağıdaki örnek bir işlevi siler:

databricks functions delete my_catalog.my_schema.my_function

Aşağıdaki örnek bir işlevin silinmesini zorlar:

databricks functions delete my_catalog.my_schema.my_function --force

databricks işlevleri get

Üst katalog ve şema içinden bir işlev alın.

Getirme işleminin başarılı olması için kullanıcının aşağıdaki gereksinimlerden birini karşılaması gerekir:

  • Meta veri deposu yöneticisi mi?
  • İşlevin ana kataloğunun sahibidir
  • İşlevin USE_CATALOG üst kataloğunda ayrıcalığa sahip ol ve işlevin sahibi ol.
  • İşlevin USE_CATALOG üst kataloğunda ayrıcalığına, işlevin USE_SCHEMA üst şemasındaki ayrıcalığına ve işlevin EXECUTE kendisinde ayrıcalığına sahip olun
databricks functions get NAME [flags]

Arguments

NAME

    İşlevin tam nitelikli adı (şu biçimde: catalog_name.schema_name.function_name).

Options

--include-browse

    Sorumlunun yalnızca seçmeli meta verilere erişebildiği yanıta işlevler eklenip eklenmeyeceği.

Genel bayraklar

Examples

Aşağıdaki örnek bir işlev hakkında bilgi alır:

databricks functions get my_catalog.my_schema.my_function

Aşağıdaki örnek, göz atma bilgilerini içeren bir işlev alır:

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

databricks işlevleri listesi

Belirtilen üst katalog ve şema içindeki işlevleri listeleyin.

Kullanıcı bir meta veri deposu yöneticisiyse, tüm işlevler çıkış listesinde döndürülür. Aksi takdirde, kullanıcının katalogda USE_CATALOG ayrıcalığına ve şemada USE_SCHEMA ayrıcalığına sahip olması gerekir ve çıkış listesi yalnızca kullanıcının ya EXECUTE ayrıcalığına sahip olduğu ya da kullanıcının sahibi olduğu işlevleri içerir. Dizideki öğelerin belirli bir sıralama garantisi yoktur.

databricks functions list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    İlgi alanına giren işlevler için üst kataloğun adı.

SCHEMA_NAME

    İşlevlerin ana şeması.

Options

--include-browse

    Sorumlunun yalnızca seçmeli meta verilere erişebildiği yanıta işlevler eklenip eklenmeyeceği.

--max-results int

    Döndürülecek en fazla fonksiyon sayısı.

--page-token string

    Önceki sorguya göre sonraki sayfaya gitmek için opak sayfalama belirteci.

Genel bayraklar

Examples

Aşağıdaki örnekte bir katalogdaki ve şemadaki tüm işlevler listelenmektedir:

databricks functions list my_catalog my_schema

Aşağıdaki örnekte en fazla 10 sonuç içeren işlevler listelenmektedir:

databricks functions list my_catalog my_schema --max-results 10

Aşağıdaki örnekte, göz atma bilgilerinin dahil olduğu işlevler listelenmektedir:

databricks functions list my_catalog my_schema --include-browse

Databricks işlevleri güncellemesi

Sağlanan adla eşleşen işlevi güncelleştirin.

Yalnızca işlevin sahibi güncelleştirilebilir. Kullanıcı bir meta veri deposu yöneticisi değilse, kullanıcının yeni işlev sahibi olan grubun üyesi olması gerekir. Kullanıcının aşağıdaki koşullardan birini karşılaması gerekir:

  • Meta veri deposu yöneticisi mi?
  • İşlevin üst kataloğunun sahibidir
  • İşlevin ana şemasının sahibidir ve ana kataloğunda USE_CATALOG ayrıcalığına sahiptir.
  • İşlevin kendisinin sahibidir ve üst kataloğu üzerinde USE_CATALOG yetkisine ve işlevin üst şeması üzerinde USE_SCHEMA yetkisine sahiptir.
databricks functions update NAME [flags]

Arguments

NAME

    İşlevin tam nitelikli adı (şu biçimde: catalog_name.schema_name.function_name).

Options

--json JSON

    satır içi JSON dizesi veya @path istek gövdesine sahip JSON dosyasına.

--owner string

    Geçerli işlev sahibinin kullanıcı adı.

Genel bayraklar

Examples

Aşağıdaki örnek bir işlevin sahibini güncelleştirir:

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

Genel bayraklar

--debug

  Hata ayıklama günlüğünün etkinleştirilip etkinleştirilmeyileceği.

-h veya --help

    Databricks CLI veya ilgili komut grubu ya da ilgili komut için yardım görüntüleyin.

--log-file dizgi

    Yazılım günlüklerini yazmak için kullanılacak dosyayı temsil eden bir metin. Bu bayrak belirtilmezse varsayılan değer, çıkış günlüklerini stderr'a yazmaktır.

--log-format biçim

    Günlük biçimi türü, text veya json. Varsayılan değer şudur: text.

--log-level dizgi

    Günlük format düzeyini temsil eden bir karakter dizisi. Belirtilmezse günlük format seviyesi devre dışı bırakılır.

-o, --output tür

    Komut çıktı türü text veya json. Varsayılan değer şudur: text.

-p, --profile dizgi

    Komutu çalıştırmak için kullanılacak dosyadaki ~/.databrickscfg profilin adı. Bu bayrak belirtilmezse ve varsa, DEFAULT adlı profil kullanılır.

--progress-format biçim

    İlerleme günlüklerini görüntüleme biçimi: default, append, inplaceveya json

-t, --target dizgi

    Varsa, kullanılacak paket hedefi

  • Last updated on