ALTER SHARE

A következőkre vonatkozik: igennel jelölt Databricks SQL Databricks Runtime 10.4 LTS és újabb kizárólag Unity Catalog

Sémákat, táblákat, materializált nézeteket vagy nézeteket ad hozzá a megosztáshoz, módosítja vagy eltávolítja a megosztásbó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 metaadattár-rendszergazdának kell lennie.
A megosztás nevének frissítéséhez a jogosultsággal CREATE SHARE a megosztás tulajdonosával rendelkező felhasználónak kell lennie.
Táblák vagy nézetek hozzáadásához a megosztási objektum tulajdonosának kell lennie, meg kell lennie a USE SCHEMA a táblát vagy nézetet tartalmazó sémán, valamint a SELECT jogosultsággal is a táblán vagy nézeten. Mindaddig fenn kell tartania a SELECT jogosultságot, ameddig osztani szeretné 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 } MODEL 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 jelölje be az igennel jelölt jelölőnégyzetet . A Databricks Runtime 11.1-12.0-s verzióihoz ahelyett kell megadnia WITH CHANGE DATA FEED [ START VERSION version ]WITH HISTORYa műveletet. A Databricks SQL-ben és a Databricks Runtime 16.2 és újabb verziókban a WITH HISTORY az alapértelmezett.

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

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 pontosítható. 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 mat_view_name-ként azonosított materializált nézetet a megosztásból. 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 SELECT jogosultsággal kell rendelkeznie 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 STRING literál, amely nem kötelező, megjegyzésként van csatolva a táblamegosztáshoz.
  - PARTITION záradék
    
    A táblázat hozzáadandó egy vagy több további 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, ADD TABLE hozzáadja a teljes táblát.
    
    A címzett tulajdonságairahivatkozva történő particionáláshoz használja a következő 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 megadva table_share_name, 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 van megadva, 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 AS OF és TIMESTAMP AS OFhaszná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á.WITH HISTORY
    
    A Databricks SQL és a Databricks Runtime 16.2 és újabb verziók alapértelmezett viselkedése WITH HISTORY. A Databricks Runtime 16.1 és korábbi verziókban ez WITHOUT HISTORY.
- REMOVE TABLE table_name
  
  Távolítsa el a table_name által azonosított táblát a megosztásból. 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 Önnek kell lennie a megosztás és a séma tulajdonosának.
  - 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
    
    Egy nem kötelező STRING literál, amely a sémamegosztáshoz megjegyzésként van csatolva.
- REMOVE SCHEMA schema_name
  
  Távolítsa el a schema_name által azonosított sémát a megosztásból. 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 név_megjelenítés
    
    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 név_megjelenítés
    
    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 pontosítható. 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 név_megjelenítés
  
  Távolítsa el a view_name által azonosított nézetet a megosztásból. 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 modell_megosztási_név
    
    Opcionálisan más néven teszi elérhetővé a modellt. A név sémanévvel pontosítható. 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 model_name által azonosított modellt a megosztásból. 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 megbízó
  
  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`

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-10-24

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

Szintaxis

Paraméterek

Példák

Kapcsolódó cikkek

Visszajelzés

További források