Megosztás a következőn keresztül:

functions parancscsoport

Note

Ezek az információk a Databricks CLI 0.205-ös és újabb verzióira vonatkoznak. A Databricks parancssori felülete nyilvános előzetes verzióban érhető el.

A Databricks CLI használatára a Databricks Licenc és a Databricks adatvédelmi nyilatkozata vonatkozik, beleértve a használati adatokra vonatkozó rendelkezéseket is.

A functionsDatabricks parancssori felületének parancscsoportja lehetővé teszi a felhasználó által definiált függvények (UDF-ek) kezelését a Unity Catalogban. A függvény implementációja bármilyen SQL-kifejezés vagy lekérdezés lehet, és meghívható minden olyan helyen, ahol egy táblahivatkozás engedélyezve van egy lekérdezésben. A Unity Catalogban egy függvény a táblázattal azonos szinten található, így az űrlappal catalog_name.schema_name.function_nameis hivatkozhat rá.

databricks-függvények létrehozása

Hozzon létre egy új függvényt.

Important

Ez egy kísérleti funkció.

A függvény létrehozásához a felhasználónak a következő engedélyekkel kell rendelkeznie:

- USE_CATALOG a függvény szülőkatalógusában

  • USE_SCHEMA és CREATE_FUNCTION a függvény szülősémájához
databricks functions create [flags]

Beállítások

--json JSON

    A beágyazott JSON-sztring vagy a @path JSON-fájl a kérelem törzsével.

Globális jelzők

Examples

Az alábbi példa JSON-fájllal hoz létre függvényt:

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

Az alábbi példa egy függvényt hoz létre beágyazott JSON használatával:

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 függvények törlése

Törölje a megadott névnek megfelelő függvényt.

Ahhoz, hogy a törlés sikeres legyen, a felhasználónak meg kell felelnie az alábbi feltételek egyikének:

  • A függvény szülőkatalógusának tulajdonosa
  • A függvény szülősémájának tulajdonosa, és rendelkezik a USE_CATALOG szülőkatalógusban jogosultsággal.
  • A függvény tulajdonosa maga, és rendelkezik mind a USE_CATALOG szülőkatalógus jogosultságával, mind a USE_SCHEMA szülőséma jogosultságával.
databricks functions delete NAME [flags]

Arguments

NAME

    A függvény teljesen képzett neve (a formátum catalog_name.schema_name.function_name).

Beállítások

--force

    A törlés kényszerítése akkor is, ha a függvény nem üres.

Globális jelzők

Examples

Az alábbi példa egy függvényt töröl:

databricks functions delete my_catalog.my_schema.my_function

Az alábbi példa egy függvény törlését kényszeríti ki:

databricks functions delete my_catalog.my_schema.my_function --force

databricks-függvények lekérése

Függvény lekérése egy szülőkatalógus és séma belsejéből.

Ahhoz, hogy a beolvasás sikeres legyen, a felhasználónak meg kell felelnie az alábbi követelmények egyikének:

  • Metaadattár-rendszergazda
  • A függvény szülőkatalógusának tulajdonosa
  • Legyen jogosultsága a függvény szülőkatalógusán USE_CATALOG és legyen a függvény tulajdonosa.
  • Rendelkezzen a USE_CATALOG jogosultsággal a függvény szülőkatalógusán, a USE_SCHEMA jogosultsággal a függvény szülősémán, és a EXECUTE jogosultsággal magán a függvényen.
databricks functions get NAME [flags]

Arguments

NAME

    A függvény teljesen képzett neve (a formátum catalog_name.schema_name.function_name).

Beállítások

--include-browse

    A válaszban szerepeljenek-e olyan függvények, amelyekhez az egyszerű felhasználó csak a szelektív metaadatokhoz fér hozzá.

Globális jelzők

Examples

Az alábbi példa egy függvényről szerez be információkat:

databricks functions get my_catalog.my_schema.my_function

Az alábbi példa tartalmaz egy függvényt tallózási adatokkal együtt.

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

databricks - függvények listája

A megadott szülőkatalógus és séma függvényeinek listája.

Ha a felhasználó metaadattár-rendszergazda, a rendszer minden függvényt visszaad a kimeneti listában. Ellenkező esetben a felhasználónak rendelkeznie kell a USE_CATALOG katalógus és a USE_SCHEMA séma jogosultságával, és a kimeneti lista csak olyan függvényeket tartalmaz, amelyekhez vagy a felhasználó rendelkezik jogosultsággal EXECUTE , vagy a felhasználó a tulajdonos. A tömb elemeinek adott sorrendje nem garantált.

databricks functions list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Az érdekes függvények szülőkatalógusának neve.

SCHEMA_NAME

    A függvények szülősémája.

Beállítások

--include-browse

    A válaszban szerepeljenek-e olyan függvények, amelyekhez az egyszerű felhasználó csak a szelektív metaadatokhoz fér hozzá.

--max-results int

    A visszaadandó függvények maximális száma.

--page-token string

    Átlátszatlan lapozási jogkivonat a következő lapra való ugráshoz az előző lekérdezés alapján.

Globális jelzők

Examples

Az alábbi példa egy katalógus és séma összes függvényét felsorolja:

databricks functions list my_catalog my_schema

Az alábbi példa a legfeljebb 10 találatot tartalmazó függvényeket sorolja fel:

databricks functions list my_catalog my_schema --max-results 10

Az alábbi példa a tallózási információkat tartalmazó függvényeket sorolja fel:

databricks functions list my_catalog my_schema --include-browse

Databricks függvények frissítése

Frissítse a megadott névnek megfelelő függvényt.

Csak a függvény tulajdonosa frissíthető. Ha a felhasználó nem metaadattár-rendszergazda, a felhasználónak annak a csoportnak a tagja kell lennie, amely az új függvény tulajdonosa. A felhasználónak meg kell felelnie az alábbi feltételek egyikének:

  • Metaadattár-rendszergazda
  • A függvény szülőkatalógusának tulajdonosa
  • A függvény szülőséma tulajdonosa, és rendelkezik jogosultsággal a USE_CATALOG szülőkatalógusban
  • Maga a függvény tulajdonosa, és rendelkezik a USE_CATALOG szülőkatalóguson található jogosultsággal, valamint a USE_SCHEMA függvény szülőséma jogosultságával
databricks functions update NAME [flags]

Arguments

NAME

    A függvény teljesen képzett neve (a formátum catalog_name.schema_name.function_name).

Beállítások

--json JSON

    A beágyazott JSON-sztring vagy a @path JSON-fájl a kérelem törzsével.

--owner string

    A függvény aktuális tulajdonosának felhasználóneve.

Globális jelzők

Examples

Az alábbi példa frissíti egy függvény tulajdonosát:

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

Globális jelzők

--debug

  Engedélyezze-e a hibakeresési naplózást.

-h vagy --help

    Súgó megjelenítése a Databricks parancssori felületéhez, a kapcsolódó parancscsoporthoz vagy a kapcsolódó parancshoz.

--log-file húr

    A kimeneti naplók írásához a fájlt jelképező sztring. Ha ez a jelző nincs megadva, akkor az alapértelmezett beállítás a kimeneti naplók stderrbe írása.

--log-format formátum

    A naplóformátum típusa vagy textjson. Az alapértelmezett érték a text.

--log-level húr

    A naplóformátum szintjét képviselő karakterlánc. Ha nincs megadva, a naplóformátum szintje le van tiltva.

-o, --output típus

    A parancs kimenettípusa vagy textjson. Az alapértelmezett érték a text.

-p, --profile húr

    A parancs futtatásához használni kívánt fájl profiljának ~/.databrickscfg neve. Ha ez a jelző nincs megadva, akkor ha létezik, a rendszer a névvel ellátott DEFAULT profilt használja.

--progress-format formátum

    A folyamatnaplók megjelenítésének formátuma: default, append, inplacevagy json

-t, --target húr

    Adott esetben a használni kívánt csomagcél

  • Last updated on