MEGOSZTÁS MÓDOSÍTÁSA

A következőkre vonatkozik: Databricks SQL Databricks Runtime 10.4 LTS és a Unity Catalog felett csak

Sémákat, táblákat, materializált nézeteket vagy nézeteket ad hozzá, módosít vagy távolít el a megosztásból vagy abból. Átnevez egy megosztást. Egy részvény tulajdonjogát egy új tagra osztja át.

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 USE SHARESET SHARE PERMISSION jogosultságokkal rendelkező 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.
• Táblák vagy nézetek hozzáadásához a megosztási objektum tulajdonosának kell lennie, rendelkeznie USE SCHEMA kell a táblát vagy nézetet tartalmazó sémával, valamint a SELECT tábla vagy nézet jogosultságával. A jogosultságot SELECT mindaddig fenn kell tartania, amíg meg szeretné osztani a táblát vagy a nézetet.
• Az egyéb megosztási tulajdonságok frissítéséhez Önnek kell tulajdonosnak lennie.

Szintaxis

ALTER SHARE share_name
  { alter_add_materialized_view |
    REMOVE MATERIALIZED VIEW mat_view_name |
    alter_add_table |
    REMOVE TABLE table_name |
    alter_add_schema |
    REMOVE SCHEMA schema_name |
    alter_add_view |
    REMOVE VIEW view_name |
    alter_add_model |
    REMOVE MODEL model_name |
    RENAME TO to_share_name |
    [ SET ] OWNER TO principal }

alter_add_materialized_view
  { { ALTER | ADD } MATERIALIZED VIEW mat_view_name [ COMMENT comment ] [ AS mat_view_share_name ]

alter_add_table
  { { ALTER | ADD } [ TABLE ] table_name [ COMMENT comment ]
        [ PARTITION clause ] [ AS table_share_name ]
        [ WITH HISTORY | WITHOUT HISTORY ] }

alter_add_schema
  { { ALTER | ADD } SCHEMA schema_name [ COMMENT comment ]

alter_add_view
  { { ALTER | ADD } VIEW view_name [ COMMENT comment ] [ AS view_share_name ]

alter_add_model
  { { ALTER | ADD } VIEW model_name [ COMMENT comment ] [ AS model_share_name ]

Feljegyzés

WITH HISTORY | WITHOUT HISTORY a Databricks Runtime 12.2 LTS és újabb verziókban támogatott . A Databricks Runtime 11.1-12.0-s verzióihoz ahelyett kell megadnia WITH CHANGE DATA FEED [ START VERSION version ] ]WITH HISTORYa műveletet.

WITH CHANGE DATA FEED elavult.

Vegye figyelembe azt is, hogy 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án , mielőtt megosztaná WITH HISTORY (vagy WITH CHANGE DATA FEED).

Paraméterek

• share_name

  A módosítani kívánt megosztás neve.

• alter_add_materialized_view

  A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb

  Fontos

  A funkció privát előzetes verzióban érhető el. Ha szeretné kipróbálni, vegye fel a kapcsolatot Azure Databricks-kapcsolattartójával.

  Materializált nézetet ad hozzá a megosztáshoz, vagy módosít egy meglévő megosztott materializált nézetet. Az utasítás futtatásához a megosztás tulajdonosának kell lennie, és jogosultságokkal kell rendelkeznie SELECT a materializált nézetben.

  • ADD MATERIALIZED VIEW mat_view_name

    Azonosítja a hozzáadni kívánt materializált nézetet. Ha a materializált nézet nem található, az Azure Databricks TABLE_OR_VIEW_NOT_FOUND hibát jelez.

  • ALTER MATERIALIZED VIEW mat_view_name

    Azonosítja a módosítandó materializált nézetet. Ha a materializált nézet még nem része a megosztásnak, az Azure Databricks hibát jelez.

  • COMMENT comment

    A materializált nézetmegosztáshoz megjegyzésként csatolt opcionális STRING literál.

  • AS mat_view_share_name

    Igény szerint a materializált nézetet más néven teszi elérhetővé. A név sémanévvel minősíthető. Ha nincs mat_view_share_name megadva, a materializált nézet a saját neve alatt ismert.

    Ha a megosztott név már létezik, az Azure Databricks hibát jelez.

  • REMOVE MATERIALIZED VIEW mat_view_name

    A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb

    Távolítsa el a megosztásból mat_view_name azonosított materializált nézetet. Az utasítás futtatásához a megosztás tulajdonosának kell lennie.

  • alter_add_table

    Egy tábla tábláját vagy partícióit adja hozzá a megosztáshoz, vagy módosít egy meglévő megosztott táblát. Az utasítás futtatásához a megosztás tulajdonosának kell lennie, és jogosultsággal kell rendelkeznie SELECT a táblában.

    • ADD [ TABLE ] table_name

      Azonosítja a hozzáadni kívánt táblát. A tábla nem lehet a Unity Katalógusban. Ha a tábla nem található, az Azure Databricks TABLE_OR_VIEW_NOT_FOUND hibát jelez.

    • ALTER [ TABLE ] table_name

      Azonosítja a módosítandó táblát. Ha a tábla még nem része a megosztásnak, az Azure Databricks hibát jelez.

    • COMMENT comment

      A táblamegosztáshoz megjegyzésként csatolt opcionális STRING literál.

    • PARTITION záradék

      A hozzáadni kívánt tábla egy vagy több partíciója. A partíciókulcsnak meg kell egyeznie a tábla particionálásával, és értékekkel kell társítania. Ha nincs PARTITION clause jelen ADD TABLE , hozzáadja a teljes táblát.

      Ha egy címzett tulajdonságaira hivatkozva szeretne particionálást létrehozni, használja a szintaxist:

      PARTITION (column_name = CURRENT_RECIPIENT().<property-key>)
      

      A címzett tulajdonságaira való hivatkozással történő particionálás a következőre vonatkozik: Databricks SQL Databricks Runtime 12.2 LTS és újabb.

    • AS table_share_name

      Opcionálisan egy másik név alatt teszi elérhetővé a táblát. A név az adatbázis (séma) nevével minősíthető. Ha nincs table_share_name megadva, a tábla a saját neve alatt lesz ismert.

    • WITH HISTORY vagy WITHOUT HISTORY

      A következőkre vonatkozik: Databricks SQL Databricks Runtime 12.2 LTS és újabb.

      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 hajthatnak végre. A megosztott táblára ezután az AS OF verzió és az IDŐBÉLYEGZŐ AS OF használatával hivatkozhat.

      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.

      Az alapértelmezett viselkedés az WITHOUT HISTORY.

  • REMOVE TABLE table_name

    Távolítsa el a megosztásból azonosított table_name táblát. Az utasítás futtatásához a megosztás tulajdonosának kell lennie.

  • alter_add_schema

    A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb

    Sémát ad hozzá a megosztáshoz, vagy módosít egy meglévő megosztott sémát. Az utasítás futtatásához a megosztás és a séma tulajdonosának kell lennie.

    • ADD SCHEMA schema_name

      Azonosítja a hozzáadni kívánt sémát. Ha a séma nem található, az Azure Databricks SCHEMA_NOT_FOUND hibát jelez.

    • ALTER SCHEMA schema_name

      Azonosítja a módosítani kívánt sémát. Ha a séma még nem része a megosztásnak, az Azure Databricks hibát jelez.

    • COMMENT comment

      A sémamegosztáshoz megjegyzésként csatolt nem kötelező STRING konstans.

  • REMOVE SCHEMA schema_name

    Távolítsa el a megosztásból azonosított schema_name sémát. Az utasítás futtatásához a megosztás tulajdonosának kell lennie.

  • alter_add_view

    A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb

    Hozzáad egy nézetet a megosztáshoz, vagy módosít egy meglévő megosztott nézetet. Az utasítás futtatásához a megosztás tulajdonosának kell lennie, és jogosultsággal kell rendelkeznie SELECT a nézetben.

    • ADD VIEW view_name

      Azonosítja a hozzáadni kívánt nézetet. Ha a nézet nem található, az Azure Databricks TABLE_OR_VIEW_NOT_FOUND hibát okoz.

    • ALTER VIEW view_name

      Azonosítja a módosítandó nézetet. Ha a nézet még nem része a megosztásnak, az Azure Databricks hibát jelez.

    • COMMENT comment

      A nézetmegosztáshoz megjegyzésként csatolt opcionális STRING literál.

    • AS view_share_name

      Opcionálisan más néven teszi elérhetővé a nézetet. A név sémanévvel minősíthető. Ha nincs view_share_name megadva, a nézet a saját neve alatt ismert.

      Ha a megosztott név már létezik, az Azure Databricks hibát jelez.

  • REMOVE VIEW view_name

    Távolítsa el a megosztásból azonosított view_name nézetet. Az utasítás futtatásához a megosztás tulajdonosának kell lennie.

  • alter_add_model

    A következőkre vonatkozik: Databricks SQL Databricks Runtime 14.0 vagy újabb

    Hozzáad egy modellt a megosztáshoz, vagy módosít egy meglévő megosztott modellt. Az utasítás futtatásához a megosztás tulajdonosának kell lennie, és jogosultsággal kell rendelkeznie EXECUTE a modellen.

    • ADD MODEL model_name

      Azonosítja a hozzáadni kívánt modellt. Ha a modell nem található, az Azure Databricks RESOURCE_DOES_NOT_EXIST hibát okoz.

    • ALTER MODEL model_name

      Azonosítja a módosítandó modellt. Ha a modell még nem része a megosztásnak, az Azure Databricks hibát jelez.

    • COMMENT comment

      A modellmegosztáshoz megjegyzésként csatolt opcionális STRING literál.

    • AS model_share_name

      Opcionálisan más néven teszi elérhetővé a modellt. A név sémanévvel minősíthető. Ha nincs model_share_name megadva, a modell a saját neve alatt ismert.

      Ha a megosztott név már létezik, az Azure Databricks hibát jelez.

  • REMOVE MODEL model_name

    Távolítsa el a megosztásból model_name azonosított modellt. Az utasítás futtatásához a megosztás tulajdonosának kell lennie.

  • RENAME TO to_share_name

    A következőkre vonatkozik: Databricks SQL Databricks Runtime 11.3 LTS és újabb

    Átnevezi a megosztást. A névnek egyedinek kell lennie a metaadattárban lévő összes megosztás között. Az utasítás futtatásához a megosztás tulajdonosának kell lennie, és jogosultsággal kell rendelkeznie CREATE SHARE a metaadattárban.

  • [ SET ] OWNER TO Fő

    A megosztás tulajdonjogának átruházása a következőre principal: . Az utasítás futtatásához a megosztás tulajdonosának kell lennie.

    A következőkre vonatkozik: Databricks SQL Databricks Runtime 11.3 LTS és újabb

    SET választható kulcsszóként engedélyezett.

Példák

-- Creates a share named `some_share`.
> CREATE SHARE some_share;

-- Add a table to the share.
> ALTER SHARE some_share
     ADD TABLE my_schema.my_tab
         COMMENT 'some comment'
         PARTITION(c1_int = 5, c2_date LIKE '2021%')
         AS shared_schema.shared_tab;

-- Add a schema to the share.
> ALTER SHARE some_share
     ADD SCHEMA some_schema
         COMMENT 'some comment';

-- Add a view to the share.
> ALTER SHARE some_share
     ADD VIEW my_schema.my_view
         COMMENT 'some comment'
         AS shared_schema.shared_view;

-- Add a materialized view to the share.
> ALTER SHARE some_share
     ADD MATERIALIZED VIEW my_schema.my_mat_view
         COMMENT 'some comment'
         AS shared_schema.shared_mat_view;

-- Share a table with history
> ALTER SHARE share ADD TABLE table1 WITH HISTORY;
> ALTER SHARE share ADD TABLE table2 WITHOUT HISTORY;
> SHOW ALL IN SHARE share;
  Name    type   ... history_sharing  ...
  ------  ------ ... ----------------
  Table1  TABLE  ... ENABLED          ...
  Table2  TABLE  ... DISABLED         ...

-- Remove the table again
> ALTER SHARE some_share
    REMOVE TABLE shared_schema.shared_tab;

-- Remove the schema again
> ALTER SHARE some_share
    REMOVE SCHEMA some_schema;

-- Remove a view again
> ALTER SHARE some_share
    REMOVE VIEW shared_schema.shared_view;

-- Rename a share
> ALTER SHARE some_share
    RENAME TO new_share;

-- Change ownership of the share
> ALTER SHARE some_share
    OWNER TO `alf@melmak.et`

Kapcsolódó cikkek

• Adatcsatorna módosítása
• MEGOSZTÁS LÉTREHOZÁSA
• MEGOSZTÁS LEÍRÁSA
• DESCRIBE HISTORY
• MEGOSZTÁS ELVETÉSE
• MEGOSZTÁSOK MEGJELENÍTÉSE
• AZ ÖSSZES MEGJELENÍTÉSE MEGOSZTÁSBAN
• MEGJEGYZÉS A MEGOSZTÁSHOZ