shares 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 sharesDatabricks parancssori felületének parancscsoportja lehetővé teszi a megosztások kezelését a Unity Catalogban.

Egy részesedés egy tároló, amely példányosítva van a shares create segítségével. A létrehozás után iteratív módon regisztrálhatja a metaadattárban definiált meglévő adategységek gyűjteményét a következő használatával shares update: . Az adategységeket az eredeti nevükben regisztrálhatja, az eredeti sémájuk szerint minősítheti, vagy alternatív közzétett neveket adhat meg.

Databricks megosztások létrehozása

Új megosztás létrehozása adatobjektumokhoz. Az adatobjektumok a létrehozás után is hozzáadhatók.update A hívónak metaadattár-rendszergazdának kell lennie, vagy rendelkeznie kell a CREATE_SHARE metaadattárbeli jogosultsággal.

databricks shares create NAME [flags]

Arguments

NAME

    A megosztás neve.

Beállítások

--comment string

    Felhasználó által megadott szabad formátumú szöveges leírás.

--json JSON

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

--storage-root string

    A megosztásban lévő jegyzetfüzetfájlok gyökér URL-címe.

Globális jelzők

Examples

Az alábbi példák egy megjegyzéssel ellátott my-analytics-share megosztást hoznak létre:

databricks shares create my-analytics-share --comment "Sales analytics data share"

Az alábbi példa egy megadott tárolási gyökérrel rendelkező megosztást hoz létre.

databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"

databricks-megosztások törlése

Megosztás törlése a metaadattárból. A hívónak a megosztás tulajdonosának kell lennie.

databricks shares delete NAME [flags]

Arguments

NAME

    A megosztás neve.

Beállítások

Globális jelzők

Examples

Az alábbi példa egy névvel rendelkező my-analytics-sharemegosztást töröl:

databricks shares delete my-analytics-share

A databricks-részvények alakulása

Megosztás lekérése a metaadattárból. A hívónak metaadattár-rendszergazdának vagy a megosztás tulajdonosának kell lennie.

databricks shares get NAME [flags]

Arguments

NAME

    A megosztás neve.

Beállítások

--include-shared-data

    Lekérdezheti, hogy az adatok szerepeljenek-e a megosztásban.

Globális jelzők

Examples

Az alábbi példa egy nevesített my-analytics-sharemegosztással kapcsolatos információkat kap:

databricks shares get my-analytics-share

Az alábbi példa egy megosztást kap a megosztott adatok részleteivel:

databricks shares get my-analytics-share --include-shared-data

(Elavult) Databricks-adatmegosztások listája

Warning

Ez a parancs elavult.

A metaadattárból származó megosztások listázása. A hívónak metaadattár-rendszergazdának vagy a megosztás tulajdonosának kell lennie. A tömb elemeinek sorrendje nem garantált.

databricks shares list [flags]

Arguments

None

Beállítások

--max-results int

    A visszaadandó megosztások 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

A databricks listamegosztásokat oszt meg

A metaadattárból származó megosztások listázása. A hívónak metaadattár-rendszergazdának vagy a megosztás tulajdonosának kell lennie. A tömb elemeinek sorrendje nem garantált.

databricks shares list-shares [flags]

Arguments

None

Beállítások

--max-results int

    A visszaadandó megosztások 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 megosztást felsorolja:

databricks shares list-shares

Databricks-megosztások frissítése

Frissítse a megosztást a kérelem módosításaival és adatobjektumaival. A hívónak a megosztás tulajdonosának vagy egy metaadat-tár rendszergazdájának kell lennie.

Ha a hívó metaadattár-rendszergazda, csak a owner mező frissíthető.

Amennyiben a megosztás neve megváltozik, a updateShare megköveteli, hogy a hívó legyen a megosztás tulajdonosa és rendelkezzen a CREATE_SHARE jogosultsággal.

Ha a megosztásban jegyzetfüzetfájlok találhatók, a storage_root mező nem frissíthető.

A metódussal hozzáadott összes tábla esetében a megosztás tulajdonosának is rendelkeznie SELECT kell jogosultsággal a táblán. Ezt a jogosultságot határozatlan ideig fenn kell tartani ahhoz, hogy a címzettek hozzáférhessenek a táblához. Általában ajánlott egy csoportot használnia megosztás tulajdonosaként.

A táblák eltávolítása update nem igényel további jogosultságokat.

databricks shares update NAME [flags]

Arguments

NAME

    A megosztás neve.

Beállítások

--comment string

    Felhasználó által megadott szabad formátumú szöveges leírás.

--json JSON

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

--new-name string

    A megosztás új neve.

--owner string

    A megosztás aktuális tulajdonosának felhasználóneve.

--storage-root string

    A megosztásban lévő jegyzetfüzetfájlok gyökér URL-címe.

Globális jelzők

Examples

Az alábbi példa frissíti egy megosztás megjegyzését:

databricks shares update my-analytics-share --comment "Updated sales analytics data share"

Az alábbi példa megváltoztatja egy megosztás nevét:

databricks shares update my-analytics-share --new-name "sales-analytics-share"

Az alábbi példa frissíti a megosztás tulajdonosát:

databricks shares update my-analytics-share --owner "someone@example.com"

Az alábbi példa JSON-konfigurációval frissíti a megosztást:

databricks shares update my-analytics-share --json '{
  "comment": "Updated share with new tables",
  "objects": [
    {
      "name": "sales.customers",
      "data_object_type": "TABLE"
    }
  ]
}'

A databricks megosztási engedélyeket oszt meg

Engedélyek lekérése egy adatmegosztáshoz a metaadattárból. A hívónak metaadattár-rendszergazdának vagy a megosztás tulajdonosának kell lennie.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    A megosztás neve.

Beállítások

--max-results int

    A visszaadandó engedélyek 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 a következő my-analytics-sharenevű megosztás engedélyeit kapja meg:

databricks shares share-permissions my-analytics-share

A databricks megosztja a frissítési engedélyeket

Frissítse az adatmegosztás engedélyeit a metaadattárban. A hívónak metaadattár-rendszergazdának vagy a megosztás tulajdonosának kell lennie.

Az új címzettek támogatása esetén a felhasználónak a címzett tulajdonosának vagy a metaadattár rendszergazdájának is kell lennie. A címzettek visszavonása nem igényel további jogosultságokat.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    A megosztás neve.

Beállítások

--json JSON

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

--omit-permissions-list

    Optional.

Globális jelzők

Examples

Az alábbi példa engedélyeket ad egy címzettnek:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "add": ["SELECT"]
    }
  ]
}'

Az alábbi példa visszavonja a címzett engedélyeit:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "remove": ["SELECT"]
    }
  ]
}'

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