Megosztás a következőn keresztül:

Megosztások létrehozása és kezelése a Delta-megosztáshoz

  • Cikk

Ez a cikk bemutatja, hogyan hozhat létre és kezelhet megosztásokat a Delta-megosztáshoz.

A megosztás egy biztonságos objektum a Unity Katalógusban, amellyel a következő adategységeket oszthatja meg egy vagy több címzettel:

  • Táblák és táblapartíciók
  • Nézetek, beleértve a sor- és oszlopszintű hozzáférést korlátozó dinamikus nézeteket is
  • Mennyiségek
  • Jegyzetfüzetek
  • AI-modellek

Ha egy teljes sémát (adatbázist) oszt meg, a címzett a megosztás pillanatában hozzáférhet a séma összes táblájához, nézetéhez, modelljéhez és kötetéhez, valamint a sémához a jövőben hozzáadott adatokhoz és AI-eszközökhöz.

A megosztások csak egy Unity Catalog-metaadattárból származó adatokat és AI-objektumokat tartalmazhatnak. Egy megosztásból bármikor hozzáadhat vagy eltávolíthat adatokat és AI-objektumokat.

További információ: Megosztások, szolgáltatók és címzettek.

Követelmények

Megosztás létrehozásához a következőt kell tennie:

  • Legyen metaadattár-rendszergazda, vagy rendelkezik a CREATE SHARE Unity Catalog metaadattárának jogosultságával, ahol a megosztani kívánt adatok regisztrálva vannak.
  • Hozza létre a megosztást egy Azure Databricks-munkaterületen, amelyhez a Unity Catalog metaadattár van csatolva.

Ha táblákat vagy nézeteket szeretne hozzáadni egy megosztáshoz, a következőt kell tennie:

  • Legyen a megosztás tulajdonosa.
  • Rendelkezik a USE CATALOG katalógus és a séma azon jogosultságával és USE SCHEMA jogosultságával, amely tartalmazza a táblázatot vagy nézetet, illetve a katalógus vagy séma tulajdonjogát.
  • Rendelkezik jogosultsággal SELECT a táblában vagy a nézetben. Ezt a jogosultságot meg kell őriznie ahhoz, hogy a tábla vagy a nézet továbbra is meg legyen osztva. Ha elveszíti, a címzett nem tud hozzáférni a táblához vagy a nézethez a megosztáson keresztül. A Databricks ezért azt javasolja, hogy egy csoportot használjon megosztástulajdonosként.

Ha köteteket szeretne hozzáadni egy megosztáshoz, a következőkkel kell rendelkeznie:

  • Legyen a megosztás tulajdonosa.
  • Rendelkezik a USE CATALOG katalógusban és USE SCHEMA a sémában található jogosultsággal, amely tartalmazza a katalógus vagy séma kötetét vagy tulajdonjogát.
  • Rendelkezik jogosultsággal READ VOLUME a köteten. Ahhoz, hogy a kötet továbbra is meg legyen osztva, meg kell tartania ezt a jogosultságot. Ha elveszíti, a címzett nem férhet hozzá a kötethez a megosztáson keresztül. A Databricks ezért azt javasolja, hogy egy csoportot használjon megosztástulajdonosként.

Ha modelleket szeretne hozzáadni egy megosztáshoz, a következőket kell tennie:

  • Legyen a megosztás tulajdonosa.
  • Rendelkezik a USE CATALOG USE SCHEMA modellt vagy a katalógus vagy séma tulajdonjogát tartalmazó katalógusban és sémában lévő jogosultsággal.
  • Rendelkezik jogosultsággal EXECUTE a modellen. Ezt a jogosultságot meg kell őriznie ahhoz, hogy a modell továbbra is meg legyen osztva. Ha elveszíti, a címzett nem férhet hozzá a modellhez a megosztáson keresztül. A Databricks ezért azt javasolja, hogy egy csoportot használjon megosztástulajdonosként.

Egy teljes séma megosztásához a következőt kell tennie:

  • Legyen a megosztás tulajdonosa és a séma tulajdonosa, vagy USE SCHEMA.
  • Legyen SELECT a sémán a táblák megosztásához.
  • Legyen READ VOLUME a sémán a kötetek megosztásához.

Ha jegyzetfüzetfájlokat szeretne hozzáadni egy megosztáshoz, a következőnek kell lennie:

  • A megosztás tulajdonosa, és olvasási engedéllyel rendelkezik a jegyzetfüzeten.

Ha hozzáférést szeretne adni a címzettnek egy megosztáshoz, a következők egyikének kell lennie:

  • Metaadattár-rendszergazda.
  • Delegált engedélyekkel vagy tulajdonjoggal rendelkező felhasználó a megosztáson és a címzett objektumon ((USE SHARE + SET SHARE PERMISSION) vagy a megosztás tulajdonosán) ÉS (USE RECIPIENT vagy a címzett tulajdonosán).

A megosztások megtekintéséhez a következők egyikének kell lennie:

  • Metaadattár-rendszergazda (az összeset megtekintheti)
  • Jogosultsággal rendelkező USE SHARE felhasználó (az összeset megtekintheti)
  • A megosztási objektum tulajdonosa

Számítási követelmények:

  • Ha a megosztás létrehozásához Databricks-jegyzetfüzetet használ, a fürtnek a Databricks Runtime 11.3 LTS vagy újabb verzióját, valamint a megosztott vagy egyfelhasználós fürtelérési módot kell használnia.
  • Ha SQL-utasításokkal ad hozzá sémát egy megosztáshoz (vagy frissít vagy eltávolít egy sémát), akkor a Databricks Runtime 13.3 LTS-t vagy újabb verziót futtató SQL-adattárházat vagy számítást kell használnia. A Catalog Explorer használatával végzett műveletnek nincsenek számítási követelményei.

Megosztási objektum létrehozása

Megosztás létrehozásához használhatja a Catalog Explorert, a Databricks Unity Catalog CLI-t, vagy az CREATE SHARE SQL-parancsot egy Azure Databricks-jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben.

Szükséges engedélyek: Metaadattár-rendszergazda vagy a CREATE SHARE metaadattárhoz tartozó jogosultsággal rendelkező felhasználó.

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon kattintson az Adatok megosztása gombra.

  4. A Megosztás létrehozása lapon adja meg a megosztás nevét és egy nem kötelező megjegyzést.

  5. Kattintson a Mentés és a Folytatás gombra.

    Folytathatja az adategységek hozzáadását, vagy később leállíthatja és visszatérhet.

  6. Az Adategységek hozzáadása lapon válassza ki a megosztani kívánt táblákat, köteteket, nézeteket és modelleket.

    Részletes útmutatásért lásd:

  7. Kattintson a Mentés és a Folytatás gombra.

  8. A Jegyzetfüzetek hozzáadása lapon válassza ki a megosztani kívánt jegyzetfüzeteket.

    Részletes útmutatásért lásd : Jegyzetfüzetfájlok hozzáadása megosztáshoz.

  9. Kattintson a Mentés és a Folytatás gombra.

  10. A Címzettek hozzáadása lapon válassza ki a megosztani kívánt címzetteket.

    Részletes útmutatásért lásd: Delta Sharing-adatmegosztásokhoz való hozzáférés kezelése (szolgáltatók számára).

  11. Kattintson az Adatok megosztása gombra az adatok címzettekkel való megosztásához.

SQL

Futtassa a következő parancsot egy jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben:

CREATE SHARE [IF NOT EXISTS] <share-name>
[COMMENT "<comment>"];

Mostantól táblákat, köteteket, nézeteket és modelleket adhat hozzá a megosztáshoz.

Részletes útmutatásért lásd:

CLI

Futtassa a következő parancsot a Databricks parancssori felületével.

databricks shares create <share-name>

Megjegyzést fűzhet --comment hozzá, vagy --json eszközöket adhat hozzá a megosztáshoz. További részletekért tekintse meg az alábbi szakaszokat.

Mostantól táblákat, köteteket, nézeteket és modelleket adhat hozzá a megosztáshoz.

Részletes útmutatásért lásd:

Táblák hozzáadása megosztáshoz

Ha táblákat szeretne hozzáadni egy megosztáshoz, használhatja a Catalog Explorert, a Databricks Unity Catalog CLI-t vagy az SQL-parancsokat egy Azure Databricks-jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben.

Feljegyzés

A táblamegjegyzések, az oszlopbejegyzések és az elsődleges kulcskorlátozások olyan megosztások részét képezik, amelyek a Databricks-to-Databricks 2024. július 25-i vagy azt követő adatmegosztást használó címzettekkel vannak megosztva. Ha a megjegyzések és korlátozások megosztását egy olyan megosztáson keresztül szeretné kezdeni, amelyet a kiadás dátuma előtt osztottak meg egy címzettel, vissza kell vonnia és újra hozzáférést kell adnia a címzettnek a megjegyzés- és kényszermegosztás aktiválásához.

Szükséges engedélyek: A megosztási objektum tulajdonosa, USE CATALOG USE SCHEMA valamint a táblát tartalmazó katalógus és séma, valamint a SELECT tábla jogosultsága. Mindaddig fenn kell tartania a SELECT jogosultságot, amíg meg szeretné osztani a táblát. További információ: Követelmények.

Feljegyzés

Ha Ön munkaterület-rendszergazda, és örökölte a USE SCHEMA USE CATALOG munkaterület felügyeleti csoportjából származó táblát tartalmazó sémát és katalógust, akkor a táblát nem lehet hozzáadni egy megosztáshoz. Először meg kell adnia magának a sémára és USE CATALOG a USE SCHEMA katalógusra vonatkozó engedélyeket és engedélyeket.

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon keresse meg azt a megosztást, amelyhez táblát szeretne hozzáadni, és kattintson a nevére.

  4. Kattintson az Eszközök > kezelése adategységek hozzáadása elemre.

  5. A Táblák hozzáadása lapon válasszon ki egy teljes sémát (adatbázist) vagy egy-egy táblát és nézetet.

    • Táblázat vagy nézet kiválasztásához először válassza ki a katalógust, majd a táblát vagy nézetet tartalmazó sémát, majd magát a táblázatot vagy nézetet.

      A munkaterület-kereséssel táblákat kereshet név, oszlopnév vagy megjegyzés alapján. Lásd: Munkaterület-objektumok keresése.

    • Séma kiválasztásához először válassza ki a katalógust, majd a sémát.

      A megosztási sémákról további információt a Sémák hozzáadása megosztáshoz című témakörben talál.

  6. (Nem kötelező) Kattintson a Speciális táblázatbeállítások elemre a következő beállítások megadásához. Az aliasok és partíciók nem érhetők el, ha egy teljes sémát választ ki. A táblázatelőzmények alapértelmezés szerint akkor jelennek meg, ha egy teljes sémát választ ki.

    • Alias: Egy másik táblanév, amely olvashatóbbá teszi a tábla nevét. Az alias az a táblanév, amelyet a címzett lát, és amelyet használnia kell a lekérdezésekben. Ha alias van megadva, a címzettek nem használhatják a tényleges táblanevet.

    • Partíció: A tábla csak egy részének megosztása. Például: (column = 'value'). Lásd: A megosztani kívánt táblapartíciók megadása és a címzett tulajdonságainak használata partíciószűréshez.

    • Előzménymegosztás: Ossza meg a táblaelőzményeket, hogy a címzettek időutazási lekérdezéseket hajthassanak végre, vagy elolvassák a táblát a Spark strukturált streameléssel. A Databricks Runtime 12.2 LTS-t vagy újabb verziót igényel.

      Feljegyzés

      Ha az időutazási lekérdezések és a streamelési olvasások mellett azt szeretné, hogy az ügyfelek lekérdezhessék a tábla változásadatcsatornáját (CDF) a table_changes() függvénnyel, engedélyeznie kell a CDF-et a táblában , mielőtt megosztaná azt WITH HISTORY.

  7. Kattintson a Mentés gombra.

SQL

Tábla hozzáadásához futtassa a következő parancsot egy jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben:

ALTER SHARE <share-name> ADD TABLE <catalog-name>.<schema-name>.<table-name>  [COMMENT "<comment>"]
   [PARTITION(<clause>)] [AS <alias>]
   [WITH HISTORY | WITHOUT HISTORY];

Futtassa az alábbiakat egy teljes séma hozzáadásához. A ADD SCHEMA parancshoz egy Databricks Runtime 13.3 LTS-t vagy újabb verziót futtató SQL-raktár vagy számítás szükséges. A megosztási sémákról további információt a Sémák hozzáadása megosztáshoz című témakörben talál.

ALTER SHARE <share-name> ADD SCHEMA <catalog-name>.<schema-name>
[COMMENT "<comment>"];

A beállítások közé tartoznak a következők. PARTITION és AS <alias> nem érhetők el, ha egy teljes sémát választ ki. WITH HISTORY ha egy teljes sémát választ ki, alapértelmezés szerint az összes tábla esetében ki van jelölve.

  • PARTITION(<clause>): Ha a tábla csak egy részét szeretné megosztani, megadhat egy partíciót. Lásd például a megosztani kívánt táblapartíciók megadása és (column = 'value') a címzett tulajdonságainak használata partíciószűréshez című témakört.

  • AS <alias>: Másik táblanév vagy alias , amely olvashatóbbá teszi a tábla nevét. Az alias az a táblanév, amelyet a címzett lát, és amelyet használnia kell a lekérdezésekben. Ha alias van megadva, a címzettek nem használhatják a tényleges táblanevet. Használja a következő formátumot: <schema-name>.<table-name>.

  • WITH HISTORY vagy WITHOUT HISTORY: Ha WITH HISTORY meg van adva, ossza meg a táblát teljes előzményekkel, így a címzettek időutazási lekérdezéseket és streamelési olvasásokat hajthatnak végre. A táblamegosztás alapértelmezett viselkedése a WITHOUT HISTORY sémamegosztás esetében a következő WITH HISTORY. A Databricks Runtime 12.2 LTS-t vagy újabb verziót igényel.

    Feljegyzés

    Ha az időutazási lekérdezések és a streamelési olvasások mellett azt szeretné, hogy az ügyfelek lekérdezhessék a tábla változásadatcsatornáját (CDF) a table_changes() függvénnyel, engedélyeznie kell a CDF-et a táblában , mielőtt megosztaná azt WITH HISTORY.

A beállításokkal kapcsolatos ALTER SHARE további információkért lásd: ALTER SHARE.

CLI

Táblázat hozzáadásához futtassa a következő parancsot a Databricks parancssori felületével.

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<table-full-name>",
          "data_object_type": "TABLE",
          "shared_as": "<table-alias>"
        }
      }
    ]
  }'

Séma hozzáadásához futtassa a következő Databricks CLI-parancsot:

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<schema-full-name>",
          "data_object_type": "SCHEMA"
        }
      }
    ]
  }'

Feljegyzés

A táblák és csak a táblák esetében kihagyhatja a elemet "data_object_type".

Az ebben a példában felsorolt lehetőségekről az SQL lapon található utasításokat tekintheti meg.

További paraméterek megismeréséhez futtassa databricks shares update --help vagy tekintse meg a PATCH /api/2.1/unity-catalog/shares/ elemet a REST API-referenciaban.

A táblák megosztásból való eltávolításáról további információt a Megosztások frissítése című témakörben talál.

A megosztani kívánt táblapartíciók megadása

Ha csak egy tábla egy részét szeretné megosztani, amikor hozzáadja a táblát egy megosztáshoz, megadhat egy partíciós specifikációt. Partíciókat akkor adhat meg, ha táblát ad hozzá egy megosztáshoz, vagy frissít egy megosztást a Catalog Explorer, a Databricks Unity Catalog CLI vagy az Sql-parancsok használatával egy Azure Databricks-jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben. Lásd: Táblák hozzáadása megosztásokhoz és megosztások frissítése.

Egyszerű példa

Az alábbi SQL-példa a táblában lévő inventory adatok egy részét osztja meg a , monthés date az yearoszlopok által particionált módon:

  • A 2021-es évre vonatkozó adatok.
  • 2020. decemberi adatok.
  • 2019. december 25-i adatok.
ALTER SHARE share_name
ADD TABLE inventory
PARTITION (year = "2021"),
          (year = "2020", month = "Dec"),
          (year = "2019", month = "Dec", date = "2019-12-25");

Partíciószűrés a címzett tulajdonságainak használatával

Megoszthat egy olyan táblapartíciót, amely megfelel az adat címzett tulajdonságainak, más néven paraméteres partíciómegosztásnak.

Az alapértelmezett tulajdonságok a következők:

  • databricks.accountId: Az az Azure Databricks-fiók, amelyhez egy adatátvevő tartozik (csak a Databricks-to-Databricks megosztása).
  • databricks.metastoreId: A Unity Catalog metaadattára, amelyhez egy adat címzettje tartozik (csak a Databricks-to-Databricks megosztása).
  • databricks.name: Az adatátvevő neve.

A címzettek létrehozásakor vagy frissítésekor bármilyen egyéni tulajdonságot létrehozhat.

A címzettek szerinti szűrés lehetővé teszi, hogy ugyanazt a megosztást használva ugyanazokat a táblákat több Databricks-fiókon, munkaterületen és felhasználón is megossza, miközben megtartja közöttük az adathatárokat.

Ha például a táblák egy Azure Databricks-fiókazonosító oszlopot tartalmaznak, egyetlen megosztást hozhat létre az Azure Databricks-fiókazonosító által meghatározott táblapartíciókkal. Megosztáskor a Delta Sharing dinamikusan csak az Azure Databricks-fiókhoz társított adatokat továbbítja az egyes címzetteknek.

A paraméteralapú dinamikus partíciómegosztás diagramja a Delta Sharingben

Anélkül, hogy a tulajdonság alapján dinamikusan particionálódna, külön megosztást kellene létrehoznia minden címzett számára.

Ha meg szeretne adni egy partíciót, amely a megosztás létrehozásakor vagy frissítésekor a címzett tulajdonságai szerint szűr, használhatja a Catalog Explorert vagy az CURRENT_RECIPIENT SQL függvényt egy Azure Databricks-jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben:

Feljegyzés

A címzett tulajdonságai a Databricks Runtime 12.2-ben és újabb verziókban érhetők el.

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon keresse meg a frissíteni kívánt megosztást, és kattintson a nevére.

  4. Kattintson az Eszközök > kezelése adategységek hozzáadása elemre.

  5. A Táblák hozzáadása lapon válassza ki a táblázatot tartalmazó katalógust és adatbázist, majd jelölje ki a táblát.

    Ha nem tudja biztosan, hogy melyik katalógus és adatbázis tartalmazza a táblát, a munkaterület-kereséssel név, oszlopnév vagy megjegyzés alapján keresheti meg. Lásd: Munkaterület-objektumok keresése.

  6. (Nem kötelező) A Speciális táblabeállítások elemre kattintva adja hozzá a partíciós specifikációkat.

    A Partíció hozzáadása táblázathoz párbeszédpanelen adja hozzá a tulajdonságalapú partíciós specifikációt a következő szintaxissal:

    (<column-name> = CURRENT_RECIPIENT().<property-key>)

    Például,

    (country = CURRENT_RECIPIENT().'country')

  7. Kattintson a Mentés gombra.

SQL

Futtassa a következő parancsot egy jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben:

ALTER SHARE <share-name> ADD TABLE <catalog-name>.<schema-name>.<table-name>
   PARTITION (<column-name> = CURRENT_RECIPIENT().<property-key>);

Például,

ALTER SHARE acme ADD TABLE acme.default.some_table
  PARTITION (country = CURRENT_RECIPIENT().'country');

Táblák hozzáadása törlési vektorokkal vagy oszlopleképezéssel egy megosztáshoz

Fontos

Ez a funkció a nyilvános előzetes verzióban érhető el.

A törlési vektorok olyan tárolási optimalizálási funkciók, amelyeket engedélyezhet a Delta-táblákon. Lásd: Mik azok a törlési vektorok?.

Az Azure Databricks a Delta-táblák oszlopleképezését is támogatja. Lásd: Oszlopok átnevezése és elvetése Delta Lake-oszlopleképezéssel.

Ha meg szeretne osztani egy táblát törlési vektorokkal vagy oszlopleképezéssel, meg kell osztania az előzményekkel. Lásd: Táblák hozzáadása megosztáshoz.

Ha egy táblát törlési vektorokkal vagy oszlopleképezéssel oszt meg, a címzettek lekérdezhetik a táblát egy SQL Warehouse- vagy egy Databricks Runtime 14.1-et vagy újabb verziót futtató fürtöt, vagy a 3.1-nyílt forráskód delta-sharing-spark vagy újabb verziót futtató számítással. Lásd: Az olvasási táblák engedélyezett törlési vektorokkal vagy oszlopleképezéssel , valamint a törlési vektorokkal vagy oszlopleképezéssel rendelkező táblázatok olvasása.

Nézetek hozzáadása megosztáshoz

Fontos

Ez a funkció a nyilvános előzetes verzióban érhető el.

A nézetek írásvédett objektumok, amelyek egy vagy több táblából vagy más nézetből lettek létrehozva. A nézet létrehozható táblákból és más nézetekből, amelyek egy Unity Catalog-metaadattár több sémájában és katalógusában találhatók. Lásd: Nézetek létrehozása és kezelése.

Ez a szakasz azt ismerteti, hogyan adhat hozzá nézeteket egy megosztáshoz a Catalog Explorer, a Databricks CLI vagy az SQL-parancsok használatával egy Azure Databricks-jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben. Ha inkább a Unity Catalog REST API-t szeretné használni, tekintse meg a PATCH /api/2.1/unity-catalog/shares/ részt a REST API-referenciaban.

Szükséges engedélyek: A megosztási objektum tulajdonosa, USE CATALOG USE SCHEMA valamint a nézetet tartalmazó katalógus és séma, valamint SELECT a nézet. Mindaddig fenn kell tartania a SELECT jogosultságot, amíg meg szeretné osztani a nézetet. További információ: Követelmények.

További követelmények:

  • A nézetmegosztás csak a Databricks–Databricks megosztásban támogatott.
  • A megosztható nézeteket Delta-táblákon vagy más megosztható nézeteken kell meghatározni.
  • Nem oszthat meg megosztott táblákra vagy megosztott nézetekre hivatkozó nézeteket.
  • Ha nézetet ad hozzá egy megosztáshoz, sql warehouse-t vagy fürtöt kell használnia a Databricks Runtime 13.3 LTS-en vagy újabb verzión.
  • A nézetek címzettjeinek használatára vonatkozó követelményekről és korlátozásokról a megosztott nézetek olvasása című témakörben olvashat.

Nézetek hozzáadása megosztáshoz:

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon keresse meg azt a megosztást, amelyhez nézetet szeretne hozzáadni, és kattintson a nevére.

  4. Kattintson az Eszközök > kezelése adategységek hozzáadása elemre.

  5. A Táblák hozzáadása lapon keresse meg vagy keresse meg a megosztani kívánt nézetet, és jelölje ki.

  6. (Nem kötelező) A Speciális táblázatbeállítások elemre kattintva megadhat egy aliast vagy egy másik nézetnevet, hogy olvashatóbbá tegye a nézet nevét. Az alias az a név, amelyet a címzett lát, és amelyet használnia kell a lekérdezésekben. Ha alias van megadva, a címzettek nem használhatják a tényleges nézetnevet.

  7. Kattintson a Mentés gombra.

SQL

Futtassa a következő parancsot egy jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben:

ALTER SHARE <share-name> ADD VIEW <catalog-name>.<schema-name>.<view-name>
   [COMMENT "<comment>"]
   [AS <alias>];

A lehetőségek a következők:

  • AS <alias>: Egy másik nézetnév vagy alias, amely olvashatóbbá teszi a nézet nevét. Az alias az a nézetnév, amelyet a címzett lát, és amelyet használnia kell a lekérdezésekben. Ha alias van megadva, a címzettek nem használhatják a tényleges nézetnevet. Használja a következő formátumot: <schema-name>.<view-name>.
  • COMMENT "<comment>": A megjegyzések megjelennek a Katalóguskezelő felhasználói felületén, és amikor SQL-utasítások használatával listáz és jelenít meg nézetadatokat.

A beállításokkal kapcsolatos ALTER SHARE további információkért lásd: ALTER SHARE.

CLI

Futtassa a következő Databricks CLI-parancsot:

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<view-full-name>",
          "data_object_type": "VIEW",
          "shared_as": "<view-alias>"
        }
      }
    ]
  }'

"shared_as": "<view-alias>" nem kötelező, és alternatív nézetnevet vagy aliast biztosít a nézetnév olvashatóbbá tétele érdekében. Az alias az a nézetnév, amelyet a címzett lát, és amelyet használnia kell a lekérdezésekben. Ha alias van megadva, a címzettek nem használhatják a tényleges nézetnevet. Használja a következő formátumot: <schema-name>.<view-name>.

További paraméterek megismeréséhez futtassa databricks shares update --help vagy tekintse meg a PATCH /api/2.1/unity-catalog/shares/ elemet a REST API-referenciaban.

A megosztások nézeteinek eltávolításáról további információt a Megosztások frissítése című témakörben talál.

Dinamikus nézetek hozzáadása egy megosztáshoz sorok és oszlopok szűréséhez

Fontos

Ez a funkció a nyilvános előzetes verzióban érhető el.

Dinamikus nézetek használatával részletes hozzáférés-vezérlést konfigurálhat a táblázatadatokhoz, például:

  • Biztonság oszlopok vagy sorok szintjén.
  • Adatmaszkolás.

A CURRENT_RECIPIENT() függvényt használó dinamikus nézet létrehozásakor a címzettek hozzáférését a címzett definíciójában megadott tulajdonságok szerint korlátozhatja.

Ez a szakasz példákat tartalmaz arra, hogy a címzettek a táblázatadatokhoz való hozzáférését a sor- és oszlopszinten is dinamikus nézetben korlátozzák.

Követelmények

  • Databricks Runtime-verzió: A CURRENT_RECIPIENT függvény a Databricks Runtime 14.2-es és újabb verzióiban támogatott.
  • Engedélyek:
    • Nézet létrehozásához a megosztási objektum tulajdonosának kell lennie, rendelkeznie USE CATALOG kell a nézetet tartalmazó katalógusban és USE SCHEMA sémában SELECT , valamint a nézeten. Mindaddig fenn kell tartania a SELECT jogosultságot, amíg meg szeretné osztani a nézetet.
    • A címzett tulajdonságainak beállításához a címzett objektum tulajdonosának kell lennie.
  • Korlátozások: A nézetmegosztás összes korlátozása, beleértve a Databricks–Databricks-megosztás korlátozását, valamint a következőket:
    • Ha egy szolgáltató megosztja a CURRENT_RECIPIENT függvényt használó nézetet, a szolgáltató nem tudja közvetlenül lekérdezni a nézetet a megosztási környezet miatt. Egy ilyen dinamikus nézet teszteléséhez a szolgáltatónak meg kell osztania a nézetet magával, és le kell kérdeznie a nézetet címzettként.
    • A szolgáltatók nem hozhatnak létre dinamikus nézetre hivatkozó nézetet.

Címzett tulajdonság beállítása

Ezekben a példákban a megosztani kívánt táblázatnak van egy oszlopa, countryés csak az egyező country tulajdonsággal rendelkező címzettek tekinthetnek meg bizonyos sorokat vagy oszlopokat.

Egy Azure Databricks-jegyzetfüzetben vagy az SQL-lekérdezésszerkesztőben a Catalog Explorer vagy az SQL-parancsok használatával állíthatja be a címzettek tulajdonságait.

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Címzettek lapon keresse meg a tulajdonságokat hozzáadni kívánt címzettet, és kattintson a nevére.

  4. Kattintson a Tulajdonságok szerkesztése elemre.

  5. A Címzett tulajdonságainak szerkesztése párbeszédpanelen adja meg kulcsként az oszlop nevét (ebben az esetbencountry) és azt az értéket, CAamelyet értékként szeretne szűrni (például).

  6. Kattintson a Mentés gombra.

SQL

A címzett tulajdonságának beállításához használja a következőt ALTER RECIPIENT: . Ebben a példában a country tulajdonság értéke CA.

ALTER RECIPIENT recipient1 SET PROPERTIES ('country' = 'CA');

Dinamikus nézet létrehozása sorszintű engedéllyel a címzettek számára

Ebben a példában csak egyező country tulajdonsággal rendelkező címzettek tekinthetnek meg bizonyos sorokat.

CREATE VIEW my_catalog.default.view1 AS
  SELECT * FROM my_catalog.default.my_table
  WHERE country = CURRENT_RECIPIENT('country');

Egy másik lehetőség, hogy az adatszolgáltató egy külön leképezési táblát tart fenn, amely a ténytábla mezőit a címzett tulajdonságaihoz rendeli, így a címzett tulajdonságai és a ténytábla mezői különválaszthatók a nagyobb rugalmasság érdekében.

Dinamikus nézet létrehozása oszlopszintű engedéllyel a címzettek számára

Ebben a példában csak a country tulajdonságnak megfelelő címzettek tekinthetnek meg bizonyos oszlopokat. Mások a visszaadott adatokat a következőként REDACTEDlátják:

CREATE VIEW my_catalog.default.view2 AS
  SELECT
  CASE
    WHEN CURRENT_RECIPIENT('country') = 'US' THEN pii
    ELSE 'REDACTED'
  END AS pii
  FROM my_catalog.default.my_table;

A dinamikus nézet megosztása egy címzettel

Ha meg szeretné osztani a dinamikus nézetet egy címzettel, használja ugyanazt az SQL-parancsokat vagy felhasználói felületi eljárást, mint egy szabványos nézet esetében. Lásd: Nézetek hozzáadása megosztáshoz.

Kötetek hozzáadása megosztáshoz

A kötetek Unity Catalog-objektumok, amelyek egy felhőalapú objektumtárhelyen lévő logikai tárterületet jelölnek. Ezek célja elsősorban a nem táblázatos adategységek szabályozása. Lásd: Mik azok a Unity Catalog-kötetek?.

Ez a szakasz azt ismerteti, hogyan adhat hozzá köteteket egy megosztáshoz a Catalog Explorer, a Databricks CLI vagy az SQL-parancsok használatával egy Azure Databricks-jegyzetfüzetben vagy SQL-lekérdezésszerkesztőben. Ha inkább a Unity Catalog REST API-t szeretné használni, tekintse meg a PATCH /api/2.1/unity-catalog/shares/ részt a REST API-referenciaban.

Feljegyzés

A mennyiségi megjegyzések olyan megosztások részét képezik, amelyek 2024. július 25-én vagy azt követően a Databricks-to-Databricks-megosztást használó címzettekkel vannak megosztva. Ha a megjegyzések megosztását egy olyan megosztáson keresztül szeretné kezdeni, amelyet a kiadás dátuma előtt osztottak meg egy címzettel, vissza kell vonnia és újra hozzá kell adnia a címzettnek a megjegyzésmegosztás aktiválásához.

Szükséges engedélyek: A megosztási objektum tulajdonosa, USE CATALOG USE SCHEMA valamint a kötetet tartalmazó katalógus és séma, valamint READ VOLUME a kötet. Mindaddig fenn kell tartania a READ VOLUME jogosultságot, amíg meg szeretné osztani a kötetet. További információ: Követelmények.

További követelmények:

  • A kötetmegosztás csak a Databricks–Databricks megosztásban támogatott.
  • Ha kötetet ad hozzá egy megosztáshoz, sql warehouse-t kell használnia a 2023.50-es vagy újabb verzióban, vagy egy fürtöt a Databricks Runtime 14.1-es vagy újabb verziójában.
  • Ha a szolgáltatói oldalon a kötettároló egyéni hálózati konfigurációkkal (például tűzfallal vagy privát kapcsolattal) rendelkezik, akkor a szolgáltatónak biztosítania kell, hogy a címzett vezérlősíkja és adatsík-címei megfelelően csatlakozhassanak a kötet tárolási helyéhez.

Kötetek hozzáadása megosztáshoz:

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon keresse meg azt a megosztást, amelyhez kötetet szeretne hozzáadni, és kattintson a nevére.

  4. Kattintson az Eszközök > kezelése eszköz szerkesztése elemre.

  5. Az Eszközök szerkesztése lapon keresse meg vagy keresse meg a megosztani kívánt kötetet, és jelölje ki.

    Másik lehetőségként kiválaszthatja a kötetet tartalmazó teljes sémát. Lásd: Séma hozzáadása megosztáshoz.

  6. (Nem kötelező) A Speciális beállítások elemre kattintva másik kötetnevet vagy Aliast adhat meg a kötet nevének olvashatóbbá tétele érdekében.

    Az aliasok nem érhetők el, ha egy teljes sémát választ ki.

    Az alias az a név, amelyet a címzett lát, és amelyet használnia kell a lekérdezésekben. Ha alias van megadva, a címzettek nem használhatják a tényleges kötetnevet.

  7. Kattintson a Mentés gombra.

SQL

Futtassa a következő parancsot egy jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben:

ALTER SHARE <share-name> ADD VOLUME <catalog-name>.<schema-name>.<volume-name>
   [COMMENT "<comment>"]
   [AS <alias>];

A lehetőségek a következők:

  • AS <alias>: Másik kötetnév vagy alias, amely olvashatóbbá teszi a kötet nevét. Az alias az a kötetnév, amelyet a címzett lát, és amelyet használnia kell a lekérdezésekben. Ha alias van megadva, a címzettek nem használhatják a tényleges kötetnevet. Használja a következő formátumot: <schema-name>.<volume-name>.
  • COMMENT "<comment>": A megjegyzések megjelennek a Katalóguskezelő felhasználói felületén, és amikor SQL-utasítások használatával listáz és jelenít meg kötetadatokat.

A beállításokkal kapcsolatos ALTER SHARE további információkért lásd: ALTER SHARE.

CLI

Futtassa a következő parancsot a Databricks CLI 0.210 vagy újabb verziójával:

 databricks shares update <share-name> \
   --json '{
     "updates": [
       {
         "action": "ADD",
         "data_object": {
           "name": "<volume-full-name>",
           "data_object_type": "VOLUME",
           "string_shared_as": "<volume-alias>"
         }
       }
     ]
   }'

"string_shared_as": "<volume-alias>" nem kötelező, és alternatív kötetnevet vagy aliast ad meg a kötet nevének olvashatóbbá tétele érdekében. Az alias az a kötetnév, amelyet a címzett lát, és amelyet használnia kell a lekérdezésekben. Ha alias van megadva, a címzettek nem használhatják a tényleges kötetnevet. Használja a következő formátumot: <schema-name>.<volume-name>.

További paraméterek megismeréséhez futtassa databricks shares update --help vagy tekintse meg a PATCH /api/2.1/unity-catalog/shares/ elemet a REST API-referenciaban.

A kötetek megosztásból való eltávolításáról további információt a Megosztások frissítése című témakörben talál.

Modellek hozzáadása megosztáshoz

Ez a szakasz azt ismerteti, hogyan adhat hozzá modelleket egy megosztáshoz a Catalog Explorer, a Databricks CLI vagy az SQL-parancsok használatával egy Azure Databricks-jegyzetfüzetben vagy SQL-lekérdezésszerkesztőben. Ha inkább a Unity Catalog REST API-t szeretné használni, tekintse meg a PATCH /api/2.1/unity-catalog/shares/ részt a REST API-referenciaban.

Feljegyzés

A modellhez fűzött megjegyzések és a modellverzióval kapcsolatos megjegyzések a Databricks-to-Databricks megosztással megosztott megosztások részét képezik.

Szükséges engedélyek: A megosztási objektum tulajdonosa, USE CATALOG USE SCHEMA valamint a modellt tartalmazó katalógus és séma, valamint EXECUTE a modell. Mindaddig fenn kell tartania a EXECUTE jogosultságot, amíg meg szeretné osztani a modellt. További információ: Követelmények.

További követelmények:

  • A modellmegosztás csak a Databricks–Databricks megosztásban támogatott.
  • Ha modellt ad hozzá egy megosztáshoz, sql warehouse-t kell használnia a 2023.50-es vagy újabb verzióban, vagy egy fürtöt a Databricks Runtime 14.0-s vagy újabb verziójában.

Modellek hozzáadása megosztáshoz:

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon keresse meg a modellt hozzáadni kívánt megosztást, és kattintson a nevére.

  4. Kattintson az Eszközök > kezelése eszköz szerkesztése elemre.

  5. Az Eszközök szerkesztése lapon keresse meg vagy keresse meg a megosztani kívánt modellt, és jelölje ki.

    Másik lehetőségként kiválaszthatja a modellt tartalmazó teljes sémát. Lásd: Séma hozzáadása megosztáshoz.

  6. (Nem kötelező) A Speciális beállítások gombra kattintva másik modellnevet vagy aliast adhat meg a modell nevének olvashatóbbá tétele érdekében.

    Az aliasok nem érhetők el, ha egy teljes sémát választ ki.

    Az alias az a név, amelyet a címzett lát, és amelyet használnia kell a lekérdezésekben. Ha alias van megadva, a címzettek nem használhatják a tényleges modellnevet.

  7. Kattintson a Mentés gombra.

SQL

Futtassa a következő parancsot egy jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben:

ALTER SHARE <share-name> ADD MODEL <catalog-name>.<schema-name>.<model-name>
   [COMMENT "<comment>"]
   [AS <alias>];

A lehetőségek a következők:

  • AS <alias>: Egy másik modellnév vagy alias, amely olvashatóbbá teszi a modell nevét. Az alias az a modellnév, amelyet a címzett lát, és amelyet a lekérdezésekben használnia kell. Ha alias van megadva, a címzettek nem használhatják a tényleges modellnevet. Használja a következő formátumot: <schema-name>.<model-name>.
  • COMMENT "<comment>": A megjegyzések megjelennek a Katalóguskezelő felhasználói felületén, és amikor SQL-utasítások használatával listáz és jelenít meg modelladatokat.

A beállításokkal kapcsolatos ALTER SHARE további információkért lásd: ALTER SHARE.

CLI

Futtassa a következő parancsot a Databricks CLI 0.210 vagy újabb verziójával:

 databricks shares update <share-name> \
   --json '{
     "updates": [
       {
         "action": "ADD",
         "data_object": {
           "name": "<model-full-name>",
           "data_object_type": "MODEL",
           "string_shared_as": "<model-alias>"
         }
       }
     ]
   }'

"string_shared_as": "<model-alias>" nem kötelező, és alternatív modellnevet vagy aliast ad meg a modell nevének olvashatóbbá tétele érdekében. Az alias az a modellnév, amelyet a címzett lát, és amelyet a lekérdezésekben használnia kell. Ha alias van megadva, a címzettek nem használhatják a tényleges modellnevet. Használja a következő formátumot: <schema-name>.<model-name>.

További paraméterek megismeréséhez futtassa databricks shares update --help vagy tekintse meg a PATCH /api/2.1/unity-catalog/shares/ elemet a REST API-referenciaban.

A modellek megosztásból való eltávolításáról további információt a Megosztások frissítése című témakörben talál.

Sémák hozzáadása megosztáshoz

Ha egy megosztáshoz egy teljes sémát ad hozzá, a címzettek nem csak a megosztás létrehozásakor a séma összes adategységéhez férhetnek hozzá, hanem a sémához idővel hozzáadott összes adategységhez is. Ez magában foglalja a séma összes tábláját, nézetét és kötetét. Az így megosztott táblák mindig teljes előzményeket tartalmaznak.

Séma SQL-sel való hozzáadásához, frissítéséhez vagy eltávolításához sql-raktárra vagy databricks runtime 13.3 LTS-t vagy újabb verziót futtató számítási feladatra van szükség. A Catalog Explorer használatával végzett műveletnek nincsenek számítási követelményei.

Szükséges engedélyek: A megosztási objektum tulajdonosa és a séma tulajdonosa (vagy egy felhasználó, aki rendelkezik a sémával USE SCHEMA és SELECT jogosultságokkal).

Ha sémát szeretne hozzáadni egy megosztáshoz, kövesse a Táblák hozzáadása megosztáshoz című témakör utasításait, és figyelje meg a séma hozzáadásának módját meghatározó tartalmat.

Ha egy teljes sémát választ ki, a tábla aliasai, partíciói és kötet-aliasai nem érhetők el. Ha aliasokat vagy partíciókat hozott létre a séma bármely objektumához, ezek törlődnek, amikor a teljes sémát hozzáadja a megosztáshoz.

Ha speciális beállításokat szeretne megadni egy olyan táblához vagy kötethez, amelyet sémamegosztással oszt meg, meg kell osztania a táblát vagy kötetet az SQL használatával, és aliast kell adnia a táblának vagy kötetnek egy másik sémanévvel.

Jegyzetfüzetfájlok hozzáadása megosztáshoz

Jegyzetfüzetfájl hozzáadása megosztáshoz a Catalog Explorer használatával.

Feljegyzés

Jegyzetfüzetek megosztásához a metaadattárnak metaadattárszintű tárhellyel kell rendelkeznie.

Szükséges engedélyek: A megosztási objektum tulajdonosa és a megosztani kívánt jegyzetfüzet olvasási engedélye.

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon keresse meg azt a megosztást, amelyhez jegyzetfüzetet szeretne hozzáadni, és kattintson a nevére.

  4. Kattintson az Eszközök kezelése elemre, és válassza a Jegyzetfüzetfájl hozzáadása lehetőséget.

  5. A Jegyzetfüzet hozzáadása lapon kattintson a fájl ikonra a megosztani kívánt jegyzetfüzet megkereséséhez.

    Kattintson a megosztani kívánt fájlra, és kattintson a Kijelölés gombra.

    (Opcionálisan) adjon meg egy felhasználóbarát aliast a fájlhoz a Megosztás mint mezőben. Ezt az azonosítót fogják látni a címzettek.

  6. Kattintson a Mentés gombra.

A megosztott jegyzetfüzetfájl ekkor megjelenik az Eszközök lapon található Jegyzetfüzetfájlok listában.

Jegyzetfüzetfájlok eltávolítása a megosztásokból

Jegyzetfüzetfájl eltávolítása megosztásból:

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon keresse meg a jegyzetfüzetet tartalmazó megosztást, és kattintson a megosztás nevére.

  4. Az Eszközök lapon keresse meg a megosztásból eltávolítani kívánt jegyzetfüzetfájlt.

  5. Kattintson a Kebab menü sortól jobbra található kebab menüre, és válassza a Jegyzetfüzetfájl törlése lehetőséget.

  6. A megerősítést kérő párbeszédpanelen kattintson a Törlés gombra.

Jegyzetfüzetfájlok frissítése megosztásokban

A már megosztott jegyzetfüzet frissítéséhez újra hozzá kell adnia, és új aliast kell adni neki a Megosztás mint mezőben. A Databricks azt javasolja, hogy használjon olyan nevet, amely jelzi a jegyzetfüzet módosított állapotát, például <old-name>-update-1. Előfordulhat, hogy értesítenie kell a címzettet a módosításról. A címzettnek ki kell választania és klónoznia az új jegyzetfüzetet a frissítés előnyeinek kihasználásához.

Hozzáférés biztosítása a címzetteknek egy megosztáshoz

A címzettek megosztási hozzáférésének biztosításához használhatja a Catalog Explorert, a Databricks Unity Catalog CLI-t, vagy egy GRANT ON SHARE Azure Databricks-jegyzetfüzet vagy a Databricks SQL-lekérdezésszerkesztő SQL-parancsát.

Szükséges engedélyek: Az alábbiak egyike:

  • Metaadattár-rendszergazda.
  • Delegált engedélyek vagy tulajdonjog a megosztáson és a címzett objektumon ((USE SHARE + SET SHARE PERMISSION) vagy a megosztás tulajdonosán) ÉS (USE RECIPIENT vagy a címzett tulajdonosán).

Útmutatásért lásd: Delta Sharing-adatmegosztásokhoz való hozzáférés kezelése (szolgáltatók számára). Ez a cikk azt is ismerteti, hogyan vonhatja vissza a címzett hozzáférését egy megosztáshoz.

Megosztások és megosztások részleteinek megtekintése

A megosztások listájának vagy a megosztás részleteinek megtekintéséhez használhatja a Catalog Explorert, a Databricks Unity Catalog CLI-t vagy az SQL-parancsokat egy Azure Databricks-jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben.

Szükséges engedélyek: A visszaadott megosztások listája az Ön szerepkörétől és engedélyétől függ. A metaadattár rendszergazdái és a USE SHARE jogosultsággal rendelkező felhasználók az összes megosztást látják. Ellenkező esetben csak azokat a megosztásokat tekintheti meg, amelyeknek Ön a megosztási objektum tulajdonosa.

Az adatok a következők:

  • A megosztás tulajdonosa, létrehozója, létrehozási időbélyege, frissítője, frissített időbélyege, megjegyzései.
  • A megosztásban lévő adategységek.
  • A megosztáshoz hozzáféréssel rendelkező címzettek.

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. Nyissa meg a Megosztások lapot a megosztások listájának megtekintéséhez.

  4. Megosztás részleteinek megtekintése a Részletek lapon.

SQL

A megosztások listájának megtekintéséhez futtassa a következő parancsot egy jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben. Szükség esetén cserélje le <pattern> egy LIKE predikátumra.

SHOW SHARES [LIKE <pattern>];

Egy adott megosztás részleteinek megtekintéséhez futtassa a következő parancsot.

DESCRIBE SHARE <share-name>;

A megosztás összes táblájának, nézetének és kötetének részleteinek megtekintéséhez futtassa az alábbi parancsot.

SHOW ALL IN SHARE <share-name>;

CLI

A megosztások listájának megtekintéséhez futtassa a következő parancsot a Databricks parancssori felületével.

databricks shares list

Egy adott megosztás részleteinek megtekintéséhez futtassa a következő parancsot.

databricks shares get <share-name>

A megosztáshoz engedélyekkel rendelkező címzettek megtekintése

Azoknak a megosztásoknak a listájának megtekintéséhez, amelyekhez a címzett hozzáférést kapott, használhatja a Catalog Explorert, a Databricks Unity Catalog CLI-t, vagy az SHOW GRANTS TO RECIPIENT Sql-parancsot egy Azure Databricks-jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben.

Szükséges engedélyek: Metaadattár-rendszergazda, USE SHARE jogosultság vagy megosztási objektum tulajdonosa.

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon keresse meg és válassza ki a címzettet.

  4. A Megosztáshoz hozzáférő címzettek listájának megtekintéséhez lépjen a Címzettek lapra.

SQL

Futtassa a következő parancsot egy jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben.

SHOW GRANTS ON SHARE <share-name>;

CLI

Futtassa a következő parancsot a Databricks parancssori felületével.

databricks shares share-permissions <share-name>

Megosztások frissítése

Amellett, hogy táblákat, nézeteket, köteteket és jegyzetfüzeteket ad hozzá egy megosztáshoz, az alábbiakat is megteheti:

  • Megosztás átnevezése.
  • Táblák, nézetek, kötetek és sémák eltávolítása egy megosztásból.
  • Megjegyzés hozzáadása vagy frissítése egy megosztáshoz.
  • Engedélyezheti vagy letilthatja a tábla előzményadataihoz való hozzáférést, így a címzettek időutazási lekérdezéseket hajthatnak végre, vagy streamelhetők a táblázat olvasásai.
  • Partíciódefiníciók hozzáadása, frissítése vagy eltávolítása.
  • Módosítsa a megosztás tulajdonosát.

Ha meg szeretné osztani ezeket a frissítéseket, használhatja a Catalog Explorert, a Databricks Unity Catalog CLI-t vagy az SQL-parancsokat egy Azure Databricks-jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben. A Katalóguskezelővel nem nevezheti át a megosztást.

Szükséges engedélyek: A megosztás tulajdonosának frissítéséhez a következők egyikének kell lennie: metaadattár-rendszergazdának, a megosztási objektum tulajdonosának vagy a jogosultságokkal rendelkező USE SHARE SET SHARE PERMISSION felhasználónak. A megosztás nevének frissítéséhez metaadattár-rendszergazdának (vagy jogosultsággal rendelkező CREATE_SHARE felhasználónak) és megosztástulajdonosnak kell lennie. Az egyéb megosztási tulajdonságok frissítéséhez Önnek kell tulajdonosnak lennie.

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon keresse meg a frissíteni kívánt megosztást, és kattintson a nevére.

A megosztás részletei lapon tegye a következőket:

  • Az értékek frissítéséhez kattintson a Szerkesztés ikon Tulajdonos vagy megjegyzés mező melletti szerkesztés ikonra.
  • Az eszközsor kebabmenü Kebab menü gombjára kattintva eltávolíthatja azt.
  • Kattintson az Eszközök > kezelése eszköz szerkesztése elemre az összes többi tulajdonság frissítéséhez:
    • Egy objektum eltávolításához törölje az eszköz melletti jelölőnégyzet jelölését.
    • Partíciódefiníciók hozzáadásához, frissítéséhez vagy eltávolításához kattintson a Speciális beállítások elemre.

SQL

Futtassa a következő parancsokat egy jegyzetfüzetben vagy a Databricks SQL-szerkesztőben.

Megosztás átnevezése:

ALTER SHARE <share-name> RENAME TO <new-share-name>;

Táblák eltávolítása egy megosztásból:

ALTER SHARE share_name REMOVE TABLE <table-name>;

Kötetek eltávolítása egy megosztásból:

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

Megjegyzés hozzáadása vagy frissítése egy megosztáshoz:

COMMENT ON SHARE <share-name> IS '<comment>';

Partíciók hozzáadása vagy módosítása egy megosztás tábláihoz:

ALTER SHARE <share-name> ADD TABLE <table-name> PARTITION(<clause>);

Megosztás tulajdonosának módosítása:

ALTER SHARE <share-name> OWNER TO  '<principal>'

-- Principal must be an account-level user email address or group name.

Tábla előzménymegosztásának engedélyezése:

ALTER SHARE <share-name> ADD TABLE <table-name> WITH HISTORY;

A paraméterekkel kapcsolatos részletekért ALTER SHARE lásd: ALTER SHARE.

CLI

Futtassa a következő parancsokat a Databricks parancssori felületével.

Megosztás átnevezése:

databricks shares update <share-name> --name <new-share-name>

Táblák eltávolítása egy megosztásból:

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<table-full-name>",
          "data_object_type": "TABLE",
          "shared_as": "<table-alias>"
        }
      }
    ]
  }'

Kötetek eltávolítása egy megosztásból (a Databricks CLI 0.210 vagy újabb verziójával):

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<volume-full-name>",
          "data_object_type": "VOLUME",
          "string_shared_as": "<volume-alias>"
        }
      }
    ]
  }'

Feljegyzés

Használja a name tulajdonságot, ha nincs alias a kötethez. Használja string_shared_as , ha van alias.

Megjegyzés hozzáadása vagy frissítése egy megosztáshoz:

databricks shares update <share-name> --comment '<comment>'

Megosztás tulajdonosának módosítása:

databricks  shares update <share-name> --owner '<principal>'

Az egyszerű fióknak fiókszintű felhasználói e-mail-címnek vagy csoportnévnek kell lennie.

Megosztás törlése

Megosztás törléséhez használhatja a Catalog Explorert, a Databricks Unity Catalog CLI-t, vagy az DELETE SHARE SQL-parancsot egy Azure Databricks-jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben. A megosztás tulajdonosának kell lennie.

Megosztás törlésekor a címzettek már nem férhetnek hozzá a megosztott adatokhoz.

Szükséges engedélyek: Objektum tulajdonosának megosztása.

Katalóguskezelő

  1. Az Azure Databricks-munkaterületen kattintson a Katalógus elemre Katalógus ikon .

  2. A Katalógus panel tetején kattintson a fogaskerék ikonra, és válassza a Fogaskerék ikon Delta Sharing lehetőséget.

    Másik lehetőségként a Gyorselérési lapon kattintson a Delta Megosztás > gombra.

  3. A Velem megosztva lapon keresse meg a törölni kívánt megosztást, és kattintson a nevére.

  4. Kattintson a Kebab menükebab menüre, és válassza a Törlés lehetőséget.

  5. A megerősítést kérő párbeszédpanelen kattintson a Törlés gombra.

SQL

Futtassa a következő parancsot egy jegyzetfüzetben vagy a Databricks SQL-lekérdezésszerkesztőben.

DROP SHARE [IF EXISTS] <share-name>;

CLI

Futtassa a következő parancsot a Databricks parancssori felületével.

databricks shares delete <share-name>