metastores 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 metastoresDatabricks parancssori felületének parancscsoportja lehetővé teszi a metaadattárak kezelését. A metaadattár a Unity Catalog objektumainak legfelső szintű tárolója. Az adategységeket (táblákat és nézeteket) és az azokhoz való hozzáférést szabályozó engedélyeket tárolja. Lásd : Metastore.

databricks metatárolók hozzárendelése

Hozzon létre egy új metaadattár-hozzárendelést. Ha egy megegyező workspace_id hozzárendelés létezik, azt az új metastore_id és default_catalog_name felülírja. A hívónak fiókadminisztrátornak kell lennie.

databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]

Arguments

WORKSPACE_ID

    Munkaterület-azonosító.

METASTORE_ID

    A metaadattár egyedi azonosítója.

DEFAULT_CATALOG_NAME

    Deprecated. A Databricks-munkaterület alapértelmezett katalógusának konfigurálásához használja az "Alapértelmezett névtér API"-t. A metaadattár alapértelmezett katalógusának neve.

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 egy metaadattárat rendel egy munkaterülethez:

databricks metastores assign 123456789 abc123-def456-ghi789 main

databricks metaadattárak létrehozása

Hozzon létre egy új metaadattárat egy megadott név és opcionális tárgyökerű elérési út alapján. Alapértelmezés szerint (ha a tulajdonosmező nincs beállítva), az új metaadattár tulajdonosa az a felhasználó, aki meghívja a createMetastore API-t. Ha a tulajdonosmező üres sztringre ("") van állítva, a tulajdonos a rendszerfelhasználóhoz lesz rendelve.

databricks metastores create NAME [flags]

Arguments

NAME

    A metaadattár felhasználó által megadott neve.

Beállítások

--json JSON

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

--region string

    A metaadattár által kiszolgált felhőrégió (például us-west-2, westus).

--storage-root string

    A metastore tárhelyének gyökér URL-je.

Globális jelzők

Examples

Az alábbi példa létrehoz egy névvel és tárológyökérrel rendelkező metaadattárat:

databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2

databricks metaadattárak aktuális

Kérje le a hozzáférést kapó munkaterület metaadattár-hozzárendelését.

databricks metastores current [flags]

Beállítások

Globális jelzők

Examples

Az alábbi példa az aktuális metaadattár-hozzárendelést kapja:

databricks metastores current

databricks metaadattárak törlése

A metaadattár törlése. A hívónak metaadattár-rendszergazdának kell lennie.

databricks metastores delete ID [flags]

Arguments

ID

    A metaadattár egyedi azonosítója.

Beállítások

--force

    A törlés kényszerítése akkor is, ha a metaadattár nem üres.

Globális jelzők

Examples

Az alábbi példa egy metaadattárat töröl:

databricks metastores delete abc123-def456-ghi789

Az alábbi példa kényszerítve törli a metaadattárat, még akkor is, ha az nem üres:

databricks metastores delete abc123-def456-ghi789 --force

A databricks metaadattárak lekérése

Szerezze be a megadott azonosítónak megfelelő metaadattárat. Az adatok lekéréséhez a hívónak metaadattár-rendszergazdának kell lennie.

databricks metastores get ID [flags]

Arguments

ID

    A metaadattár egyedi azonosítója.

Beállítások

Globális jelzők

Examples

Az alábbi példa egy adott metaadattárra vonatkozó információkat kap:

databricks metastores get abc123-def456-ghi789

databricks metaadattárak listája

Sorolja fel az elérhető metaadattárakat. Az adatok lekéréséhez a hívónak rendszergazdai jogosultságúnak kell lennie. Nincs garancia a lista elemeinek meghatározott sorrendjére.

databricks metastores list [flags]

Beállítások

--max-results int

    A visszaadandó metaadattárak maximális száma.

--page-token string

    Átlátszatlan lapozási token a következő oldalra ugráshoz az előző lekérdezés alapján.

Globális jelzők

Examples

Az alábbi példa az összes elérhető metaadattárat felsorolja:

databricks metastores list

Az alábbi példa a lapozással rendelkező metaadattárakat sorolja fel:

databricks metastores list --max-results 10 --page-token abc123token

databricks metaadattárak összegzése

A metaadattárak összegzési információinak lekérése. Ez az összefoglalás tartalmazza a tárolási hitelesítő adatokat, a felhőszolgáltatót, a felhőrégiót és a globális metaadattár-azonosítót.

databricks metastores summary [flags]

Beállítások

Globális jelzők

Examples

Az alábbi példa egy metaadattár-összegzést kap:

databricks metastores summary

databricks metaadattárak hozzárendelésének megszüntetése

Metaadattár-hozzárendelés törlése. A hívónak fiókadminisztrátornak kell lennie.

databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]

Arguments

WORKSPACE_ID

    Munkaterület-azonosító.

METASTORE_ID

    A törölni kívánt metaadattár azonosítójának lekérdezése.

Beállítások

Globális jelzők

Examples

Az alábbi példa eltávolít egy metaadattárat egy munkaterületről:

databricks metastores unassign 123456789 abc123-def456-ghi789

databricks metaadattárak frissítése

Adott metaadattár adatainak frissítése. A hívónak metaadattár-rendszergazdának kell lennie. Ha a tulajdonosmező üres sztringre ("") van állítva, a tulajdonos a rendszerfelhasználóra frissül.

databricks metastores update ID [flags]

Arguments

ID

    A metaadattár egyedi azonosítója.

Beállítások

--delta-sharing-organization-name string

    A Databricks-to-Databricks Delta Sharingben hivatalos névként használandó Delta Sharing entitás szervezetneve.

--delta-sharing-recipient-token-lifetime-in-seconds int

    A deltamegosztás címzettjének token-élettartama másodpercben.

--delta-sharing-scope DeltaSharingScopeEnum

    A metaadattárhoz engedélyezett Delta Sharing hatóköre. Támogatott értékek: INTERNAL, INTERNAL_AND_EXTERNAL

--json JSON

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

--new-name string

    A metaadattár új neve.

--owner string

    A metaadattár tulajdonosa.

--privilege-model-version string

    A metaadattár jogosultságmodelljének verziója, fő.mellék formátumban (pl. 1.0).

--storage-root-credential-id string

    A tároló hitelesítő adatainak UUID azonosítója a metaadattár storage_root eléréséhez.

Globális jelzők

Examples

Az alábbi példa frissíti a metaadattár nevét:

databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore

Az alábbi példa frissíti a metaadattárat a Delta Sharing konfigurációjával:

databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org

databricks metaadattárak frissítés-hozzárendelése

Metaadattár-hozzárendelés frissítése. Ez a művelet használható egy megadott munkaterületen metastore_id vagy default_catalog_name frissítésére, ha a munkaterület már metatárral rendelkezik. A hívónak fiókadminisztrátornak kell lennie a frissítéshez metastore_id; ellenkező esetben a hívó lehet munkaterület-rendszergazda.

databricks metastores update-assignment WORKSPACE_ID [flags]

Arguments

WORKSPACE_ID

    Munkaterület-azonosító.

Beállítások

--default-catalog-name string

    A metaadattár alapértelmezett katalógusának neve.

--json JSON

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

--metastore-id string

    A metaadattár egyedi azonosítója.

Globális jelzők

Examples

Az alábbi példa frissíti a metaadattár-hozzárendelés alapértelmezett katalógusát:

databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog

Az alábbi példa frissíti a metaadattár-hozzárendelés metaadattár-azonosítóját:

databricks metastores update-assignment 123456789 --metastore-id new-metastore-id

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 naplófájlok kimenetének írására szolgáló karakterlánc. 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, 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 kimenetének tí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

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