ALTER SHARE

Artykuł
04/22/2024

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL Databricks Runtime 10.4 LTS i nowszy tylko wykaz aparatu Unity

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

Wymagane uprawnienia:

Aby zaktualizować właściciela udziału, musisz być jednym z następujących elementów: administrator magazynu metadanych, właściciel obiektu udziału lub użytkownik z uprawnieniami USE SHARE i SET SHARE PERMISSION .
Aby zaktualizować nazwę udziału, musisz być administratorem magazynu metadanych (lub użytkownikiem z CREATE_SHARE uprawnieniami) i 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 SELECT uprawnienia do tabeli lub widoku. Należy zachować SELECT uprawnienia 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 } VIEW 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.

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

Ważne

Ta funkcja jest dostępna w prywatnej wersji zapoznawczej. Aby ją wypróbować, skontaktuj się z osobą kontaktową usługi Azure Databricks.

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 zakwalifikować 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 udział. 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ć SELECT uprawnienia do tabeli.
  - ADD [ TABLE ] Nazwa_tabeli
    
    Identyfikuje tabelę do dodania. Tabela nie może znajdować się w wykazie aparatu Unity. Jeśli nie można odnaleźć tabeli usługi Azure Databricks, wystąpi błąd TABLE_OR_VIEW_NOT_FOUND .
  - ALTER [ TABLE ] Nazwa_tabeli
    
    Identyfikuje tabelę, która ma zostać zmieniona. Jeśli tabela 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 tabeli jako komentarz.
  - KLAUZULA PARTITION
    
    Do dodania co najmniej jednej partycji tabeli. Klucze partycji muszą być zgodne z partycjonowaniem tabeli i być skojarzone z wartościami. Jeśli nie PARTITION clause jest obecny 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 table_share_name
    
    Opcjonalnie uwidacznia tabelę pod inną nazwą. Nazwę można zakwalifikować przy użyciu nazwy bazy danych (schematu). Jeśli nie table_share_name zostanie określona, tabela będzie znana pod własną nazwą.
  - WITH HISTORY lub WITHOUT HISTORY
    
    Dotyczy: Databricks SQL Databricks Runtime 12.2 LTS i nowsze.
    
    Gdy WITH HISTORY zostanie określona, 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 OPCJI VERSION AS 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 danych zmiany 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 to WITHOUT HISTORY.
- REMOVE TABLE Nazwa_tabeli
  
  Usuń tabelę zidentyfikowaną przez udział table_name . 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 udziału lub modyfikuje istniejący schemat udostępniony. 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 STRING literał dołączony do udziału schematu jako komentarz.
- REMOVE SCHEMA Schema_name
  
  Usuń schemat zidentyfikowany przez schema_name program z udziału. 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 zakwalifikować 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 udział. 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 zakwalifikować 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 udziału. 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`

Składnia

Parametry

Przykłady

Powiązane artykuły

Dodatkowe zasoby