ALTER SHARE

Dotyczy: zaznaczone jako tak Databricks SQL Databricks Runtime 10.4 LTS i nowsze tylko Unity Catalog

Dodaje, zmienia lub usuwa schematy, tabele, materializowane widoki lub widoki z lub do udziałów. Zmienia nazwę udziału. Przenosi własność udziału do nowego podmiotu zabezpieczeń.

Wymagane uprawnienia:

Aby zaktualizować właściciela udziału, musisz być administratorem metastore.
Aby zaktualizować nazwę udziału, musisz być użytkownikiem z uprawnieniami CREATE SHAREi właścicielem udziału.
Aby dodać tabele lub widoki, musisz być właścicielem obiektu udziału, mieć USE SCHEMA w schemacie zawierającym tabelę lub widok oraz uprawnienia SELECT w tabeli lub widoku. Należy zachować uprawnienia SELECT tak długo, jak chcesz udostępnić tabelę lub widok.
Aby zaktualizować inne właściwości udziału, musisz być właścicielem.

Składnia

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 ]

Uwaga

WITH HISTORY | WITHOUT HISTORY program jest obsługiwany w środowisku zaznacz pole wyboru oznaczone jako tak Databricks Runtime 12.2 LTS i nowszym. Środowisko Databricks Runtime w wersji od 11.1 do 12.0 wymaga określenia WITH CHANGE DATA FEED [ START VERSION version ] zamiast WITH HISTORY. W usługach Databricks SQL i Databricks Runtime 16.2 i nowszych WITH HISTORY jest wartością domyślną.

WITH CHANGE DATA FEED jest przestarzały.

Należy również pamiętać, że jeśli oprócz wykonywania zapytań dotyczących podróży w czasie i odczytów przesyłanych strumieniowo klienci mają mieć możliwość wykonywania zapytań dotyczących zestawienia zmian danych (CDF) tabeli przy użyciu funkcji table_changes(), należy włączyć usługę CDF w tabeli przed jej WITH HISTORY udostępnieniem (lub WITH CHANGE DATA FEED).

Parametry

share_name

Nazwa udziału, który ma zostać zmieniony.
alter_add_materialized_view

Dotyczy: Databricks SQL Databricks Runtime 13.3 LTS i nowsze

Dodaje zmaterializowany widok do udziału lub modyfikuje istniejący udostępniony zmaterializowany widok. Aby uruchomić tę instrukcję, musisz być właścicielem udziału i mieć SELECT uprawnienia do zmaterializowanego widoku.
- ADD MATERIALIZED VIEW mat_view_name
  
  Identyfikuje zmaterializowany widok do dodania. Jeśli nie można odnaleźć zmaterializowanego widoku, usługa Azure Databricks zgłasza błąd TABLE_OR_VIEW_NOT_FOUND .
- ALTER MATERIALIZED VIEW mat_view_name
  
  Identyfikuje zmaterializowany widok do zmiany. Jeśli zmaterializowany widok nie jest jeszcze częścią udziału, usługa Azure Databricks zgłasza błąd.
- COMMENT comment
  
  Opcjonalny STRING literał dołączony do zmaterializowanego udziału widoku jako komentarz.
- AS mat_view_share_name
  
  Opcjonalnie uwidacznia zmaterializowany widok pod inną nazwą. Nazwę można określić przy użyciu nazwy schematu. Jeśli nie mat_view_share_name zostanie określony, zmaterializowany widok jest znany pod własną nazwą.
  
  Jeśli nazwa udostępniona już istnieje, usługa Azure Databricks zgłasza błąd.
- REMOVE MATERIALIZED VIEW mat_view_name
  
  Dotyczy: Databricks SQL Databricks Runtime 13.3 LTS i nowsze
  
  Usuń zmaterializowany widok zidentyfikowany przez mat_view_name z udostępniania. Aby uruchomić tę instrukcję, musisz być właścicielem udziału.
- alter_add_table
  
  Dodaje tabelę lub partycje tabeli do udziału lub modyfikuje istniejącą udostępnioną tabelę. Aby uruchomić tę instrukcję, musisz być właścicielem udziału i mieć uprawnienia SELECT w tabeli.
  - ADD [ TABLE ] table_name
    
    Identyfikuje tabelę do dodania. Tabela nie może znajdować się w Unity Catalog. Jeśli tabeli nie można odnaleźć, Azure Databricks zgłasza błąd TABLE_OR_VIEW_NOT_FOUND.
  - ALTER [ TABLE ] table_name
    
    Identyfikuje tabelę, która ma zostać zmieniona. Jeśli tabela nie jest jeszcze częścią udziału, Azure Databricks zgłasza błąd.
  - COMMENT comment
    
    Opcjonalny literał STRING dołączony jako komentarz do części tabeli.
  - PARTITION klauzula
    
    Do dodania jedna lub więcej partycji tabeli. Klucze partycji muszą być zgodne z partycjonowaniem tabeli i być skojarzone z wartościami. Jeśli PARTITION clause nie istnieje, ADD TABLE dodaje całą tabelę.
    
    Aby podzielić partycje według odwołania do właściwości adresata , użyj składni:
```
PARTITION (column_name = CURRENT_RECIPIENT().<property-key>)
```
    Partycjonowanie według odwołania do właściwości adresata Dotyczy:Databricks SQL Databricks Runtime 12.2 LTS i nowsze.
  - AS nazwa_udostępniania_tabeli
    
    Opcjonalnie uwidacznia tabelę pod inną nazwą. Nazwę można określić przy pomocy nazwy bazy danych (schematu). Jeśli nie określono table_share_name, tabela będzie znana pod własną nazwą.
  - WITH HISTORY lub WITHOUT HISTORY
    
    Dotyczy: Databricks SQL Databricks Runtime 12.2 LTS i nowsze.
    
    Po określeniu WITH HISTORY udostępnij tabelę z pełną historią, umożliwiając adresatom wykonywanie zapytań dotyczących podróży czasowych. Następnie można odwołać się do udostępnionej tabeli przy użyciu VERSION AS OF i TIMESTAMP AS OF.
    
    Jeśli oprócz wykonywania zapytań dotyczących podróży w czasie i odczytów przesyłanych strumieniowo klienci mają mieć możliwość wykonywania zapytań dotyczących zestawienia zmian danych tabeli przy użyciu funkcji table_changes(), należy włączyć usługę CDF w tabeli przed udostępnieniem jej WITH HISTORY.
    
    Domyślne zachowanie w usługach Databricks SQL i Databricks Runtime 16.2 i nowszych jest WITH HISTORY. W środowisku Databricks Runtime 16.1 lub starszym jest to WITHOUT HISTORY.
- REMOVE TABLE table_name
  
  Usuń tabelę zidentyfikowaną przez table_name z udostępnienia. Aby uruchomić tę instrukcję, musisz być właścicielem udziału.
- alter_add_schema
  
  Dotyczy: Databricks SQL Databricks Runtime 13.3 LTS i nowsze
  
  Dodaje schemat do współdzielenia lub modyfikuje istniejący współdzielony schemat. Aby uruchomić tę instrukcję, musisz być właścicielem udziału i schematu.
  - ADD SCHEMA schema_name
    
    Identyfikuje schemat do dodania. Jeśli nie można odnaleźć schematu, usługa Azure Databricks zgłasza błąd SCHEMA_NOT_FOUND.
  - ALTER SCHEMA schema_name
    
    Identyfikuje schemat do zmiany. Jeśli schemat nie jest jeszcze częścią udziału, usługa Azure Databricks zgłasza błąd.
  - COMMENT comment
    
    Opcjonalny literał STRING dołączony do udostępnienia schematu jako komentarz.
- REMOVE SCHEMA schema_name
  
  Usuń schemat zidentyfikowany przez schema_name z zasobu współdzielonego. Aby uruchomić tę instrukcję, musisz być właścicielem udziału.
- alter_add_view
  
  Dotyczy: Databricks SQL Databricks Runtime 13.3 LTS i nowsze
  
  Dodaje widok do udziału lub modyfikuje istniejący widok udostępniony. Aby uruchomić tę instrukcję, musisz być właścicielem udziału i mieć SELECT uprawnienia do widoku.
  - ADD VIEW view_name
    
    Identyfikuje widok do dodania. Jeśli nie można odnaleźć widoku usługi Azure Databricks, wystąpi błąd TABLE_OR_VIEW_NOT_FOUND .
  - ALTER VIEW view_name
    
    Identyfikuje widok, który ma zostać zmieniony. Jeśli widok nie jest jeszcze częścią udziału usługi Azure Databricks, zgłasza błąd.
  - COMMENT comment
    
    Opcjonalny STRING literał dołączony do udziału widoku jako komentarz.
  - AS view_share_name
    
    Opcjonalnie uwidacznia widok pod inną nazwą. Nazwę można określić przy użyciu nazwy schematu. Jeśli nie view_share_name zostanie określony, widok jest znany pod własną nazwą.
    
    Jeśli nazwa udostępniona już istnieje, usługa Azure Databricks zgłasza błąd.
- REMOVE VIEW view_name
  
  Usuń widok zidentyfikowany przez view_name z dzielenia. Aby uruchomić tę instrukcję, musisz być właścicielem udziału.
- alter_add_model
  
  Dotyczy: Databricks SQL Databricks Runtime 14.0 i nowsze
  
  Dodaje model do udziału lub modyfikuje istniejący model udostępniony. Aby uruchomić tę instrukcję, musisz być właścicielem udziału i mieć EXECUTE uprawnienia do modelu.
  - ADD MODEL model_name
    
    Identyfikuje model do dodania. Jeśli nie można odnaleźć modelu usługi Azure Databricks, wystąpi błąd RESOURCE_DOES_NOT_EXIST.
  - ALTER MODEL model_name
    
    Identyfikuje model, który ma zostać zmieniony. Jeśli model nie jest jeszcze częścią udziału usługi Azure Databricks, zgłasza błąd.
  - COMMENT comment
    
    Opcjonalny STRING literał dołączony do udziału modelu jako komentarz.
  - AS model_share_name
    
    Opcjonalnie uwidacznia model pod inną nazwą. Nazwę można określić przy użyciu nazwy schematu. Jeśli nie model_share_name zostanie określony, model jest znany pod własną nazwą.
    
    Jeśli nazwa udostępniona już istnieje, usługa Azure Databricks zgłasza błąd.
- REMOVE MODEL model_name
  
  Usuń model zidentyfikowany przez model_name z współdzielonego zasobu. Aby uruchomić tę instrukcję, musisz być właścicielem udziału.
- RENAME TO to_share_name
  
  Dotyczy: Databricks SQL Databricks Runtime 11.3 LTS i nowsze
  
  Zmienia nazwę udziału. Nazwa musi być unikatowa wśród wszystkich udziałów w magazynie metadanych. Aby uruchomić tę instrukcję, musisz być właścicielem udziału i mieć CREATE SHARE uprawnienia do magazynu metadanych.
- [ SET ] OWNER TO główny
  
  Przenosi własność udziału na principal. Aby uruchomić tę instrukcję, musisz być właścicielem udziału.
  
  Dotyczy: Databricks SQL Databricks Runtime 11.3 LTS i nowsze
  
  SET jest dozwolone jako opcjonalne słowo kluczowe.

Przykłady

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

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-10-24

Udostępnij za pomocą

Składnia

Parametry

Przykłady

Powiązane artykuły

Sprzężenie zwrotne

Dodatkowe zasoby