Sdílet prostřednictvím

functions skupina příkazů

Note

Tyto informace platí pro Databricks CLI verze 0.205 a vyšší. Rozhraní příkazového řádku Databricks je ve veřejné ukázce.

Použití rozhraní příkazového řádku Databricks podléhá licenci Databricks a oznámení o ochraně osobních údajů Databricks, včetně všech ustanovení o využití.

Skupina functions příkazů v rozhraní příkazového řádku Databricks umožňuje spravovat uživatelem definované funkce (UDF) v katalogu Unity. Implementace funkce může být libovolný výraz NEBO dotaz SQL a lze ji vyvolat všude, kde je v dotazu povolen odkaz na tabulku. V Katalogu Unity se funkce nachází na stejné úrovni jako tabulka, aby na ni bylo možné odkazovat pomocí formuláře catalog_name.schema_name.function_name.

Vytvoření funkcí Databricks

Vytvořte novou funkci.

Important

Toto je experimentální funkce.

Aby mohla být funkce vytvořena, musí mít uživatel následující oprávnění:

- USE_CATALOG v katalogu nadřazeném funkci

  • USE_SCHEMA a CREATE_FUNCTION na nadřazeném datovém modelu funkce
databricks functions create [flags]

Možnosti

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

Examples

Následující příklad vytvoří funkci pomocí souboru JSON:

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

Následující příklad vytvoří funkci pomocí inline JSON:

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

Smazání funkcí Databricks

Odstraňte funkci, která odpovídá zadanému názvu.

Aby odstranění proběhlo úspěšně, musí uživatel splňovat jednu z následujících podmínek:

  • Je vlastníkem katalogu nadřazeného funkce.
  • Je vlastníkem nadřazeného schématu funkce a má USE_CATALOG oprávnění k nadřazenému katalogu.
  • Je vlastníkem samotné funkce a má jak USE_CATALOG oprávnění pro nadřazený katalog, tak USE_SCHEMA oprávnění pro nadřazené schéma.
databricks functions delete NAME [flags]

Arguments

NAME

    Plně kvalifikovaný název funkce (formuláře catalog_name.schema_name.function_name).

Možnosti

--force

    Vynutit odstranění i v případě, že funkce není nechtěná.

Globální příznaky

Examples

Následující příklad odstraní funkci:

databricks functions delete my_catalog.my_schema.my_function

Následující příklad vynutí odstranění funkce:

databricks functions delete my_catalog.my_schema.my_function --force

Získání funkcí v Databricks

Získejte funkci z nadřazeného katalogu a schématu.

Aby bylo načtení úspěšné, musí uživatel splňovat jeden z následujících požadavků:

  • Je správcem metastoru.
  • Je vlastníkem katalogu nadřazeného funkce.
  • Mít USE_CATALOG oprávnění na nadřazený katalog funkce a být vlastníkem funkce
  • Mít USE_CATALOG oprávnění k nadřazenému katalogu funkce, USE_SCHEMA oprávnění k nadřazenému schématu funkce a EXECUTE oprávnění k samotné funkci.
databricks functions get NAME [flags]

Arguments

NAME

    Plně kvalifikovaný název funkce (formuláře catalog_name.schema_name.function_name).

Možnosti

--include-browse

    Zda zahrnout funkce do odpovědi, k jejichž selektivním metadatům má subjekt pouze omezený přístup.

Globální příznaky

Examples

Následující příklad získá informace o funkci:

databricks functions get my_catalog.my_schema.my_function

Následující příklad získá funkci s zahrnutými informacemi o procházení:

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

Seznam funkcí Databricks

Zobrazení seznamu funkcí v rámci zadaného nadřazeného katalogu a schématu

Pokud je uživatel správcem metastoru, vrátí se všechny funkce ve výstupním seznamu. Jinak musí mít uživatel oprávnění ke katalogu a ke schématu a výstupní seznam obsahuje pouze funkce, pro které má uživatel oprávnění USE_CATALOG, nebo je vlastníkem. Neexistuje žádná záruka konkrétního řazení prvků v poli.

databricks functions list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Název nadřazeného katalogu pro funkce, které nás zajímají

SCHEMA_NAME

    Nadřazené schéma funkcí

Možnosti

--include-browse

    Zda zahrnout funkce do odpovědi, k jejichž selektivním metadatům má subjekt pouze omezený přístup.

--max-results int

    Maximální počet funkcí, které se mají vrátit.

--page-token string

    Netransparentní token stránkování pro přechod na další stránku na základě předchozího dotazu.

Globální příznaky

Examples

Následující příklad uvádí všechny funkce v katalogu a schématu:

databricks functions list my_catalog my_schema

Následující příklad uvádí funkce s maximálně 10 výsledky:

databricks functions list my_catalog my_schema --max-results 10

Následující příklad uvádí funkce s zahrnutými informacemi o procházení:

databricks functions list my_catalog my_schema --include-browse

Aktualizace funkcí Databricks

Aktualizujte funkci, která odpovídá zadanému názvu.

Aktualizovat lze pouze vlastníka funkce. Pokud uživatel není správcem metastoru, musí být uživatel členem skupiny, která je novým vlastníkem funkce. Uživatel musí splňovat jednu z následujících podmínek:

  • Je správcem metastoru.
  • Je vlastníkem katalogu nadřazeného funkce.
  • Je vlastníkem nadřazeného schématu funkce a má USE_CATALOG oprávnění pro nadřazený katalog.
  • Je vlastníkem samotné funkce a má USE_CATALOG oprávnění ke svému nadřazenému katalogu a také USE_SCHEMA oprávnění k nadřazenému schématu funkce.
databricks functions update NAME [flags]

Arguments

NAME

    Plně kvalifikovaný název funkce (formuláře catalog_name.schema_name.function_name).

Možnosti

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

--owner string

    Uživatelské jméno aktuálního vlastníka funkce

Globální příznaky

Examples

Následující příklad aktualizuje vlastníka funkce:

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

Globální příznaky

--debug

  Zda povolit protokolování ladění.

-h nebo --help

    Zobrazení nápovědy k rozhraní příkazového řádku Databricks nebo související skupině příkazů nebo souvisejícímu příkazu

--log-file řetězec

    Řetězec představující soubor, do kterého se zapisují výstupní protokoly. Pokud tento příznak není zadaný, výchozí hodnota je zápis výstupních protokolů do stderru.

--log-format formát

    Typ formátu protokolu, text nebo json. Výchozí hodnota je text.

--log-level řetězec

    Řetězec představující úroveň formátu protokolu. Pokud není zadána, je úroveň formátu protokolu zakázaná.

-o, --output typ

    Typ výstupu příkazu, text nebo json. Výchozí hodnota je text.

-p, --profile řetězec

    Název profilu v ~/.databrickscfg souboru, který se má použít ke spuštění příkazu. Pokud tento příznak není zadán, použije se profil s názvem DEFAULT, pokud existuje.

--progress-format formát

    Formát pro zobrazení protokolů průběhu: default, append, inplacenebo json

-t, --target řetězec

    Pokud je to relevantní, cílový balíček, který se má použít

  • Last updated on