volumes 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 volumesDatabricks parancssori felületének parancscsoportja a kötetek Unity Catalogban való kezelésére szolgáló parancsokat tartalmaz. A kötetek funkciókkal rendelkeznek a fájlok eléréséhez, tárolásához, szabályozásához, rendszerezéséhez és feldolgozásához. Lásd: Mik azok a Unity Catalog-kötetek?.

Databricks kötetek létrehozása

Hozzon létre egy új kötetet.

A felhasználó létrehozhat egy külső vagy egy felügyelt kötetet. A rendszer létrehoz egy külső kötetet a megadott külső helyen, míg a felügyelt kötet a szülőséma, a szülőkatalógus vagy a metaadattár által megadott alapértelmezett helyen lesz.

Ahhoz, hogy a kötet létrehozása sikeres legyen, a felhasználónak a következő feltételeknek kell megfelelnie:

• A hívónak metaadattár-rendszergazdának kell lennie, vagy a szülőkatalógus és -séma tulajdonosának kell lennie, vagy rendelkeznie kell a USE_CATALOG szülőkatalógus jogosultságával és a USE_SCHEMA szülőséma jogosultságával.
• A hívónak rendelkeznie kell CREATE VOLUME jogosultsággal a szülősémán.

Külső kötet esetén a következő feltételeknek is teljesülniük kell:

• A hívónak jogosultsággal kell rendelkeznie CREATE EXTERNAL VOLUME a külső helyen.
• A megadott tárolóhelyen nincsenek más táblák, sem kötetek. – A megadott tárolási hely nincs más táblák, kötetek vagy katalógusok vagy sémák helye alatt.

databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    Annak a katalógusnak a neve, amelyben a séma és a kötet található

SCHEMA_NAME

    Annak a sémának a neve, amelyben a kötet található

NAME

    A kötet neve

VOLUME_TYPE

    A kötet típusa. A külső kötet a megadott külső helyen található. A felügyelt kötet a szülőséma, a szülőkatalógus vagy a Metaadattár által megadott alapértelmezett helyen található. Lásd: Felügyelt és külső kötetek. Támogatott értékek: EXTERNAL, MANAGED

Beállítások

--comment string

    A kötethez csatolt megjegyzés.

--json JSON

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

--storage-location string

    A felhőbeli tárolási hely.

Globális jelzők

Examples

Az alábbi példa egy felügyelt kötetet hoz létre:

databricks volumes create my_catalog my_schema my_volume MANAGED

Az alábbi példa egy megjegyzéssel rendelkező külső kötetet hoz létre:

databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"

Databricks kötetek törlése

Töröljön egy kötetet a megadott szülőkatalógusból és sémából.

A hívónak metaadattár-rendszergazdának vagy a kötet tulajdonosának kell lennie. Az utóbbi esetben a hívónak tulajdonosnak kell lennie, vagy USE_CATALOG jogosultsággal kell rendelkeznie a szülőkatalógusban, valamint USE_SCHEMA jogosultsággal a szülősémán.

databricks volumes delete NAME [flags]

Arguments

NAME

    A kötet háromszintű (teljesen megadott) neve

Beállítások

Globális jelzők

Examples

Az alábbi példa egy kötetet töröl:

databricks volumes delete my_catalog.my_schema.my_volume

databricks-kötetek listája

Az aktuális metaadattár köteteinek listázása a szülőkatalógus és séma alatt.

A visszaadott kötetek a hívó felhasználó jogosultságai alapján lesznek szűrve. A metaadattár rendszergazdája például listázhatja az összes kötetet. A kötetek válaszban való fogadásához egy normál felhasználónak kell lennie a tulajdonosnak, vagy jogosultsággal kell rendelkeznie a READ VOLUME kötetre. Az utóbbi esetben a hívónak tulajdonosnak kell lennie, vagy USE_CATALOG jogosultsággal kell rendelkeznie a szülőkatalógusban, valamint USE_SCHEMA jogosultsággal a szülősémán.

A tömb elemeinek adott sorrendje nem garantált.

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    A katalógus azonosítója

SCHEMA_NAME

    A séma azonosítója

Beállítások

--include-browse

    Kötetek belefoglalása a válaszba, amelyekhez az egyszerű felhasználó csak a szelektív metaadatokhoz fér hozzá.

--max-results int

    A visszaadandó kötetek maximális száma (oldalhossz).

--page-token string

    Egy korábbi kérés által visszaadott átlátszatlan jogkivonat.

Globális jelzők

Examples

Az alábbi példa egy katalógus és séma összes kötetét felsorolja:

databricks volumes list my_catalog my_schema

databricks-kötetek megtekintése

Kötet lekérése a metaadattárból egy adott katalógushoz és sémához.

A hívónak metaadattár-rendszergazdának, a kötet tulajdonosának kell lennie, vagy rendelkeznie kell a READ VOLUME jogosultsággal a kötetre vonatkozóan. Az utóbbi esetben a hívónak tulajdonosnak kell lennie, vagy USE_CATALOG jogosultsággal kell rendelkeznie a szülőkatalógusban, valamint USE_SCHEMA jogosultsággal a szülősémán.

databricks volumes read NAME [flags]

Arguments

NAME

    A kötet háromszintű (teljesen megadott) neve

Beállítások

--include-browse

    Kötetek belefoglalása a válaszba, amelyekhez az egyszerű felhasználó csak a szelektív metaadatokhoz fér hozzá.

Globális jelzők

Examples

Az alábbi példa egy kötetre vonatkozó információkat kap:

databricks volumes read my_catalog.my_schema.my_volume

Az alábbi példa hangerő-információkat kap, beleértve a böngészési metaadatokat.

databricks volumes read my_catalog.my_schema.my_volume --include-browse

databricks-kötetek frissítése

Frissítse a megadott kötetet a megadott szülőkatalógus és séma keretein belül.

A hívónak metaadattár-rendszergazdának vagy a kötet tulajdonosának kell lennie. Az utóbbi esetben a hívónak tulajdonosnak kell lennie, vagy USE_CATALOG jogosultsággal kell rendelkeznie a szülőkatalógusban, valamint USE_SCHEMA jogosultsággal a szülősémán.

Jelenleg csak a kötet neve, tulajdonosa vagy megjegyzése frissíthető.

databricks volumes update NAME [flags]

Arguments

NAME

    A kötet háromszintű (teljesen megadott) neve

Beállítások

--comment string

    A kötethez csatolt megjegyzés.

--json JSON

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

--new-name string

    A kötet új neve.

--owner string

    A kötet tulajdonosának azonosítója.

Globális jelzők

Examples

Az alábbi példa frissíti egy kötet megjegyzését:

databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"

Az alábbi példa egy kötet tulajdonosát módosítja:

databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com

Az alábbi példa egy kötetet nevez át:

databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name

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 karakterlánc

    A karakterlánc, amely megadja, melyik fájlba írja az kimeneti naplókat. 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, amely lehet text vagy json. Az alapértelmezett érték a text.

--log-level karakterlánc

    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: text vagy json. Az alapértelmezett érték a text.

-p, --profile karakterlánc

    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 karakterlánc

    Ha alkalmazható, a használni kívánt célcsomag