ALTER SHARE

Článek
04/18/2024

Platí pro: zaškrtnutí označeného ano Databricks SQL Databricks Runtime 10.4 LTS a vyšší pouze katalog Unity

Přidá, změní nebo odebere schémata, tabulky, materializovaná zobrazení nebo zobrazení do nebo ze sdílené složky. Přejmenuje sdílenou složku. Převede vlastnictví sdílené složky na nový objekt zabezpečení.

Požadovaná oprávnění:

Pokud chcete aktualizovat vlastníka sdílené složky, musíte být jedním z následujících: správce metastoru, vlastníkem objektu sdílené složky nebo uživatelem s oprávněnímiUSE SHARE.SET SHARE PERMISSION
Pokud chcete aktualizovat název sdílené složky, musíte být správcem metastoru CREATE_SHARE (nebo uživatelem s oprávněním) a vlastníkem sdílené složky.
Pokud chcete přidat tabulky nebo zobrazení, musíte být vlastníkem objektu sdílené složky, mít USE SCHEMA schéma obsahující tabulku nebo zobrazení a SELECT oprávnění k tabulce nebo zobrazení. Oprávnění musíte zachovat SELECT , dokud chcete sdílet tabulku nebo zobrazení.
Pokud chcete aktualizovat všechny ostatní vlastnosti sdílené složky, musíte být vlastníkem.

Syntaxe

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 ]

Poznámka:

WITH HISTORY | WITHOUT HISTORY podporuje databricks zaškrtnutí označeného ano Runtime 12.2 LTS a vyšší. Databricks Runtime verze 11.1 až 12.0 vyžadují, abyste místo WITH CHANGE DATA FEED [ START VERSION version ] ]WITH HISTORY.

WITH CHANGE DATA FEED je zastaralý.

Upozorňujeme také, že pokud kromě dotazů na cestování s časem a čtení streamování chcete, aby vaši zákazníci mohli dotazovat datový kanál změn tabulky (CDF) pomocí funkce table_changes(), musíte před sdílením WITH HISTORY povolit cdF v tabulce (neboWITH CHANGE DATA FEED).

Parametry

share_name

Název sdílené složky, která se má změnit.
alter_add_materialized_view

Platí pro: Databricks SQL Databricks Runtime 13.3 LTS a vyšší

Důležité

Tato funkce je v privátní verzi Preview. Pokud ji chcete vyzkoušet, obraťte se na svou kontaktní osobu pro Azure Databricks.

Přidá materializované zobrazení do sdílené složky nebo upraví existující sdílené materializované zobrazení. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky a mít SELECT oprávnění k materializovanému zobrazení.
- ADD MATERIALIZED VIEW mat_view_name
  
  Identifikuje materializované zobrazení, které se má přidat. Pokud materializované zobrazení nenajdete, Azure Databricks vyvolá TABLE_OR_VIEW_NOT_FOUND chybu.
- ALTER MATERIALIZED VIEW mat_view_name
  
  Identifikuje materializované zobrazení, které se má změnit. Pokud materializované zobrazení ještě není součástí sdílené složky, Azure Databricks vyvolá chybu.
- COMMENT comment
  
  Volitelný STRING literál připojený k materializované sdílené složce zobrazení jako komentář.
- AS mat_view_share_name
  
  Volitelně zpřístupní materializované zobrazení pod jiným názvem. Název může být kvalifikovaný názvem schématu. Pokud není zadána žádná mat_view_share_name , materializované zobrazení je známo pod vlastním názvem.
  
  Pokud sdílený název již existuje, Azure Databricks vyvolá chybu.
- REMOVE MATERIALIZED VIEW mat_view_name
  
  Platí pro: Databricks SQL Databricks Runtime 13.3 LTS a vyšší
  
  Odeberte materializované zobrazení identifikované mat_view_name ze sdílené složky. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky.
- alter_add_table
  
  Přidá tabulku nebo oddíly tabulky do sdílené složky nebo upraví existující sdílenou tabulku. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky a mít SELECT oprávnění k tabulce.
  - ADD [ TABLE ] Table_name
    
    Identifikuje tabulku, která se má přidat. Tabulka nesmí být umístěna v katalogu Unity. Pokud tabulku nenajdete, Azure Databricks vyvolá TABLE_OR_VIEW_NOT_FOUND chybu.
  - ALTER [ TABLE ] Table_name
    
    Identifikuje tabulku, která se má změnit. Pokud tabulka ještě není součástí sdílené složky Azure Databricks, dojde k chybě.
  - COMMENT comment
    
    Volitelný STRING literál připojený ke sdílené složce tabulky jako komentář.
  - Klauzule PARTITION
    
    Jeden nebo více oddílů tabulky, které se mají přidat. Klíče oddílů musí odpovídat dělení tabulky a musí být přidružené k hodnotám. Pokud není k dispoziciADD TABLE, PARTITION clause přidá se celá tabulka.
    
    Pokud chcete oddíl rozdělit podle odkazu na vlastnosti příjemce, použijte syntaxi:
```
PARTITION (column_name = CURRENT_RECIPIENT().<property-key>)
```
    Dělení podle odkazu na vlastnosti příjemce platí pro: Databricks SQL Databricks Runtime 12.2 LTS a vyšší.
  - AS table_share_name
    
    Volitelně zpřístupní tabulku pod jiným názvem. Název může být kvalifikovaný názvem databáze (schématu). Pokud není zadána žádná table_share_name tabulka, bude známa pod vlastním názvem.
  - WITH HISTORY nebo WITHOUT HISTORY
    
    Platí pro: Databricks SQL Databricks Runtime 12.2 LTS a vyšší.
    
    Po WITH HISTORY zadání nasdílejte tabulku s úplnou historií, která příjemcům umožňuje provádět dotazy na časovou cestu. Na sdílenou tabulku se pak dá odkazovat pomocí funkce VERSION AS OF a TIMESTAMP AS OF.
    
    Pokud chcete, aby vaši zákazníci kromě dotazů časového cestování a streamovaných čtení mohli dotazovat datový kanál změn tabulky (CDF) pomocí funkce table_changes(), musíte před sdílením WITH HISTORYpovolit cdF v tabulce .
    
    Výchozí chování je WITHOUT HISTORY.
- REMOVE TABLE Table_name
  
  Odeberte tabulku identifikovanou table_name ze sdílené složky. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky.
- alter_add_schema
  
  Platí pro: Databricks SQL Databricks Runtime 13.3 LTS a vyšší
  
  Přidá do sdílené složky schéma nebo upraví existující sdílené schéma. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky a schématu.
  - ADD SCHEMA Schema_name
    
    Identifikuje schéma, které se má přidat. Pokud schéma nejde najít, Azure Databricks vyvolá SCHEMA_NOT_FOUND chybu.
  - ALTER SCHEMA Schema_name
    
    Identifikuje schéma, které se má změnit. Pokud schéma ještě není součástí sdílené složky, Azure Databricks vyvolá chybu.
  - COMMENT comment
    
    Volitelný STRING literál připojený ke sdílené složce schématu jako komentář.
- REMOVE SCHEMA Schema_name
  
  Odeberte schéma identifikované schema_name ze sdílené složky. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky.
- alter_add_view
  
  Platí pro: Databricks SQL Databricks Runtime 13.3 LTS a vyšší
  
  Přidá zobrazení do sdílené složky nebo upraví existující sdílené zobrazení. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky a mít SELECT oprávnění k zobrazení.
  - ADD VIEW view_name
    
    Identifikuje zobrazení, které se má přidat. Pokud se zobrazení nenašlo, Azure Databricks vyvolá chybu TABLE_OR_VIEW_NOT_FOUND .
  - ALTER VIEW view_name
    
    Identifikuje zobrazení, které se má změnit. Pokud zobrazení ještě není součástí sdílené složky Azure Databricks, zobrazí se chyba.
  - COMMENT comment
    
    Volitelný STRING literál připojený ke sdílené složce zobrazení jako komentář.
  - AS view_share_name
    
    Volitelně zobrazí zobrazení pod jiným názvem. Název může být kvalifikovaný názvem schématu. Pokud není zadáno žádné view_share_name , je zobrazení známé pod vlastním názvem.
    
    Pokud sdílený název již existuje, Azure Databricks vyvolá chybu.
- REMOVE VIEW view_name
  
  Odeberte zobrazení identifikované view_name ze sdílené složky. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky.
- alter_add_model
  
  Platí pro: Databricks SQL Databricks Runtime 14.0 a vyšší
  
  Přidá do sdílené složky model nebo upraví existující sdílený model. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky a mít EXECUTE oprávnění k modelu.
  - ADD MODEL model_name
    
    Identifikuje model, který se má přidat. Pokud model nenajdete, Azure Databricks vyvolá RESOURCE_DOES_NOT_EXIST chybu.
  - ALTER MODEL model_name
    
    Identifikuje model, který se má změnit. Pokud model ještě není součástí sdílené složky Azure Databricks, zobrazí se chyba.
  - COMMENT comment
    
    Volitelný STRING literál připojený ke sdílené složce modelu jako komentář.
  - AS model_share_name
    
    Volitelně zpřístupňuje model pod jiným názvem. Název může být kvalifikovaný názvem schématu. Pokud není zadán žádný model_share_name , model je známý pod vlastním názvem.
    
    Pokud sdílený název již existuje, Azure Databricks vyvolá chybu.
- REMOVE MODEL model_name
  
  Odeberte model identifikovaný model_name ze sdílené složky. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky.
- RENAME TO to_share_name
  
  Platí pro: Databricks SQL Databricks Runtime 11.3 LTS a vyšší
  
  Přejmenuje sdílenou složku. Název musí být jedinečný mezi všemi sdílenými složkami v metastoru. Abyste mohli tento příkaz spustit, musíte být vlastníkem sdílené složky a mít CREATE SHARE oprávnění k metastoru.
- [ SET ] OWNER TO Hlavní
  
  Převede vlastnictví sdílené složky na principal. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky.
  
  Platí pro: Databricks SQL Databricks Runtime 11.3 LTS a vyšší
  
  SET je povolený jako volitelné klíčové slovo.

Příklady

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

Share via

Syntaxe

Parametry

Příklady

Další materiály

Share via

Syntaxe

Parametry

Příklady

Související články

Další materiály