ALTER SHARE – Azure Databricks - Databricks SQL

Cikk
11/07/2024

A következőkre vonatkozik: jelölje be az igennel jelölt jelölőnégyzetet 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 SHARE SET 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 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.

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 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`

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

Szintaxis

Paraméterek

Példák

Visszajelzés

További források

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

MEGOSZTÁS MÓDOSÍTÁSA

Szintaxis

Paraméterek

Példák

Kapcsolódó cikkek

Visszajelzés

További források