Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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 shares příkazů v rozhraní příkazového řádku Databricks umožňuje spravovat sdílené složky v katalogu Unity.
Podíl je kontejner vytvořený pomocí shares create. Po vytvoření můžete iterativním způsobem zaregistrovat kolekci existujících datových prostředků definovaných v rámci metastoru pomocí shares update. Datové prostředky můžete zaregistrovat pod původním názvem s odpovídajícím původním schématem nebo zadat alternativní vystavené názvy.
Vytvoření sdílených složek Databricks
Vytvořte novou sdílenou složku pro datové objekty. Datové objekty lze přidat po vytvoření pomocí update. Volající musí být správcem metastoru nebo musí mít CREATE_SHARE oprávnění k metastoru.
databricks shares create NAME [flags]
Arguments
NAME
Název sdílené složky.
Možnosti
--comment string
Popis bezplatného textu poskytnutého uživatelem
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--storage-root string
Kořenová adresa URL úložiště pro soubory poznámkového bloku ve sdílené složce
Examples
Následující příklady vytvoří sdílenou složku s názvem my-analytics-share s komentářem:
databricks shares create my-analytics-share --comment "Sales analytics data share"
Následující příklad vytvoří sdílenou složku s konkrétním kořenem úložiště:
databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"
Odstranění sdílených objektů Databricks
Odstraňte sdílenou složku z metastoru. Volající musí být vlastníkem sdílené složky.
databricks shares delete NAME [flags]
Arguments
NAME
Název sdílené složky.
Možnosti
Examples
Následující příklad odstraní sdílenou složku s názvem my-analytics-share:
databricks shares delete my-analytics-share
Akcie společnosti Databricks
Získejte podíl z metastoru. Volající musí být správcem metastoru nebo vlastníkem sdílené složky.
databricks shares get NAME [flags]
Arguments
NAME
Název sdílené složky.
Možnosti
--include-shared-data
Zadejte dotaz na data, která se mají zahrnout do sdílené složky.
Examples
Následující příklad získá informace o sdílené složce s názvem my-analytics-share:
databricks shares get my-analytics-share
Následující příklad získá sdílené data s podrobnostmi o těchto datech:
databricks shares get my-analytics-share --include-shared-data
(Zastaralé) seznam podílů Databricks
Deprecated. Zobrazí seznam sdílených složek z metastoru. Volající musí být správcem metastoru nebo vlastníkem sdílené složky. Pořadí prvků v poli není zaručeno.
databricks shares list [flags]
Arguments
None
Možnosti
--max-results int
Maximální počet podílů k zobrazení.
--page-token string
Netransparentní token stránkování pro přechod na další stránku na základě předchozího dotazu.
Databricks – seznam sdílení
Zobrazí seznam sdílených složek z metastoru. Volající musí být správcem metastoru nebo vlastníkem sdílené složky. Pořadí prvků v poli není zaručeno.
databricks shares list-shares [flags]
Arguments
None
Možnosti
--max-results int
Maximální počet podílů k zobrazení.
--page-token string
Netransparentní token stránkování pro přechod na další stránku na základě předchozího dotazu.
Examples
Následující příklad uvádí všechny sdílené položky:
databricks shares list-shares
Aktualizace akcií Databricks
Aktualizujte sdílenou složku o změny a datové objekty v požadavku. Volající musí být vlastníkem sdíleného objektu nebo administrátorem metastoru.
Pokud je volající správcem metastoru owner , je možné aktualizovat pouze pole.
V případě změny názvu sdílené složky vyžaduje, updateShare aby volající byl vlastníkem sdílené složky a má oprávnění CREATE_SHARE .
Pokud jsou ve sdílené složce soubory poznámkového bloku, storage_root pole nelze aktualizovat.
Pro každou tabulku přidanou touto metodou musí mít vlastník sdílené složky také SELECT oprávnění k tabulce. Aby příjemci měli přístup k tabulce, musí být toto oprávnění trvale zachováno. Obvykle byste jako vlastníka sdílené složky měli použít skupinu.
Odebrání tabulky prostřednictvím update nevyžaduje další oprávnění.
databricks shares update NAME [flags]
Arguments
NAME
Název sdílené složky.
Možnosti
--comment string
Popis bezplatného textu poskytnutého uživatelem
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--new-name string
Nový název sdílené složky
--owner string
Uživatelské jméno aktuálního vlastníka sdílené složky
--storage-root string
Kořenová adresa URL úložiště pro soubory poznámkového bloku ve sdílené složce
Examples
Následující příklad aktualizuje komentář ke sdílené složce:
databricks shares update my-analytics-share --comment "Updated sales analytics data share"
Následující příklad změní název sdílené složky:
databricks shares update my-analytics-share --new-name "sales-analytics-share"
Následující příklad aktualizuje vlastníka sdílené složky:
databricks shares update my-analytics-share --owner "someone@example.com"
Následující příklad aktualizuje sdílenou složku pomocí konfigurace JSON:
databricks shares update my-analytics-share --json '{
"comment": "Updated share with new tables",
"objects": [
{
"name": "sales.customers",
"data_object_type": "TABLE"
}
]
}'
Databricks sdílí oprávnění ke sdílení
Získejte oprávnění ke sdílení dat z metastoru. Volající musí být správcem metastoru nebo vlastníkem sdílené složky.
databricks shares share-permissions NAME [flags]
Arguments
NAME
Název sdílené složky.
Možnosti
--max-results int
Maximální počet oprávnění k vrácení
--page-token string
Netransparentní token stránkování pro přechod na další stránku na základě předchozího dotazu.
Examples
Následující příklad získá oprávnění pro sdílenou složku s názvem my-analytics-share:
databricks shares share-permissions my-analytics-share
Databricks sdílí oprávnění k aktualizaci
Aktualizujte oprávnění pro sdílení dat v metastore. Volající musí být správcem metastoru nebo vlastníkem sdílené složky.
Pro povolení pro nové příjemce musí být uživatel také vlastníkem příjemce nebo správcem metastoru. Odvolání práv pro příjemce nevyžadují další oprávnění.
databricks shares update-permissions NAME [flags]
Arguments
NAME
Název sdílené složky.
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--omit-permissions-list
Optional.
Examples
Následující příklad uděluje příjemcům oprávnění:
databricks shares update-permissions my-analytics-share --json '{
"changes": [
{
"principal": "recipient-name",
"add": ["SELECT"]
}
]
}'
Následující příklad odvolá oprávnění od příjemce:
databricks shares update-permissions my-analytics-share --json '{
"changes": [
{
"principal": "recipient-name",
"remove": ["SELECT"]
}
]
}'
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