ALTER SHARE

nl-NL: Van toepassing op: Databricks SQL Databricks Runtime 10.4 LTS en hoger Alleen Unity Catalog

Hiermee kunt u schema's, tabellen, gematerialiseerde weergaven of gewone weergaven toevoegen, wijzigen of verwijderen aan of van de gedeelde bron. Hiermee wijzigt u de naam van een share. Hiermee wordt het eigendom van een share overgedragen aan een nieuwe principal.

Vereiste machtigingen:

• Als u de eigenaar van de share wilt bijwerken, moet u een van de volgende zijn: een metastore-beheerder, de eigenaar van het share-object of een gebruiker met zowel de USE SHARE als SET SHARE PERMISSION bevoegdheden.
• Als u de naam van de share wilt bijwerken, moet u een metastore-beheerder (of gebruiker met de CREATE_SHARE bevoegdheid) en eigenaar van de share zijn.
• Als u tabellen of weergaven wilt toevoegen, moet u de eigenaar van het shareobject zijn, USE SCHEMA hebben in het schema dat de tabel of weergave bevat en de SELECT bevoegdheid voor de tabel of weergave. U moet de SELECT bevoegdheid behouden zolang u de tabel of weergave wilt delen.
• Als u andere shareeigenschappen wilt bijwerken, moet u de eigenaar zijn.

Syntaxis

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 ]

Notitie

WITH HISTORY | WITHOUT HISTORY wordt ondersteund in Databricks Runtime 12.2 LTS en hoger. Voor Databricks Runtime-versies 11.1 tot en met 12.0 moet u opgeven WITH CHANGE DATA FEED [ START VERSION version ] ] in plaats van WITH HISTORY.

WITH CHANGE DATA FEED is afgeschaft.

Houd er ook rekening mee dat als u, naast het uitvoeren van tijdreizenquery's en streaming-leesbewerkingen, uw klanten een query kunnen uitvoeren op de gegevensfeed van een tabel met behulp van de functie table_changes(), moet u CDF inschakelen in de tabel voordat u deze deelt WITH HISTORY (of WITH CHANGE DATA FEED).

Parameters

• share_name

  De naam van de share die moet worden gewijzigd.

• alter_add_materialized_view

  Van toepassing op: Databricks SQL Databricks Runtime 13.3 LTS en hoger

  Belangrijk

  Deze functie is beschikbaar als beperkte preview. Als u het wilt proberen, neemt u contact op met uw contactpersoon voor Azure Databricks.

  Hiermee voegt u een gerealiseerde weergave toe aan de share of wijzigt u een bestaande gedeelde gerealiseerde weergave. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn en bevoegdheden hebben SELECT voor de gerealiseerde weergave.

  • ADD MATERIALIZED VIEW mat_view_name

    Identificeert de gerealiseerde weergave die moet worden toegevoegd. Als de gerealiseerde weergave niet kan worden gevonden, genereert Azure Databricks een TABLE_OR_VIEW_NOT_FOUND fout.

  • ALTER MATERIALIZED VIEW mat_view_name

    Identificeert de gerealiseerde weergave die moet worden gewijzigd. Als de gerealiseerde weergave nog geen deel uitmaakt van de share, treedt er een fout op in Azure Databricks.

  • COMMENT comment

    Een optionele letterlijke STRING letterlijke koppeling die is gekoppeld aan de gerealiseerde weergaveshare als opmerking.

  • AS mat_view_share_name

    U kunt desgewenst de gerealiseerde weergave onder een andere naam weergeven. De naam kan met een schemanaam worden gekwalificeerd. Als er geen mat_view_share_name is opgegeven, staat de gerealiseerde weergave onder de eigen naam bekend.

    Als de gedeelde naam al bestaat, treedt er een fout op in Azure Databricks.

  • REMOVE MATERIALIZED VIEW mat_view_name

    Van toepassing op: Databricks SQL Databricks Runtime 13.3 LTS en hoger

    Verwijder de gerealiseerde weergave die is geïdentificeerd door mat_view_name uit het aandeel. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn.

  • alter_add_table

    Hiermee voegt u een tabel of partities van een tabel toe aan de share of wijzigt u een bestaande gedeelde tabel. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de gedeelde map zijn en SELECT rechten op de tabel hebben.

    • ADD [ TABLE ] table_name

      Identificeert de tabel die moet worden toegevoegd. De tabel mag zich niet in Unity Catalog bevinden. Als de tabel niet kan worden gevonden, genereert Azure Databricks een TABLE_OR_VIEW_NOT_FOUND-fout.

    • ALTER [ TABLE ] table_name

      Hiermee wordt aangegeven welke tabel moet worden gewijzigd. Als de tabel nog geen deel uitmaakt van de share, treedt er een fout op in Azure Databricks.

    • COMMENT comment

      Een optionele STRING-letterlijke opmerking gekoppeld aan het delen van de tabel.

    • PARTITION clausule

      Een of meer partities van de tabel die moeten worden toegevoegd. De partitiesleutels moeten overeenkomen met de partitionering van de tabel en moeten worden gekoppeld aan waarden. Als er geen PARTITION clause aanwezig is, voegt ADD TABLE de hele tabel toe.

      Als u wilt partitioneren op basis van eigenschappen van geadresseerden, gebruikt u de syntaxis:

      PARTITION (column_name = CURRENT_RECIPIENT().<property-key>)
      

      Partitionering op basis van de eigenschappen van geadresseerden is van toepassing op:Databricks SQL Databricks Runtime 12.2 LTS en hoger.

    • AS table_share_name

      U kunt de tabel desgewenst onder een andere naam weergeven. De naam kan worden gekwalificeerd met een databasenaam (schema). Als er geen table_share_name is opgegeven, wordt de tabel onder de eigen naam bekend.

    • WITH HISTORY of WITHOUT HISTORY

      Van toepassing op: Databricks SQL Databricks Runtime 12.2 LTS en hoger.

      Wanneer WITH HISTORY is opgegeven, deelt u de tabel met de volledige geschiedenis, zodat ontvangers tijdreizenquery's kunnen uitvoeren. Er kan vervolgens naar de gedeelde tabel worden verwezen met VERSION AS OF en TIMESTAMP AS OF.

      Als u, naast het uitvoeren van tijdreisquery's en streaming-leesbewerkingen, wilt dat uw klanten een query kunnen uitvoeren op de gegevensfeed van een tabel met behulp van de functie table_changes(), moet u CDF inschakelen in de tabel voordat u deze deelt WITH HISTORY.

      Het standaardgedrag is WITHOUT HISTORY.

  • REMOVE TABLE table_name

    Verwijder de tabel die is geïdentificeerd door table_name uit de share. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn.

  • alter_add_schema

    Van toepassing op: Databricks SQL Databricks Runtime 13.3 LTS en hoger

    Hiermee voegt u een schema toe aan de share of wijzigt u een bestaand gedeeld schema. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share en het schema zijn.

    • ADD SCHEMA schema_name

      Identificeert het schema dat moet worden toegevoegd. Als het schema niet kan worden gevonden, genereert Azure Databricks een SCHEMA_NOT_FOUND fout.

    • ALTER SCHEMA schema_name

      Hiermee wordt het schema geïdentificeerd dat moet worden gewijzigd. Als het schema nog geen deel uitmaakt van de share, genereert Azure Databricks een fout.

    • COMMENT comment

      Een optionele STRING literal toegevoegd aan het schema-deel als opmerking.

  • REMOVE SCHEMA schema_name

    Verwijder het schema dat is geïdentificeerd door schema_name uit de share. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn.

  • alter_add_view

    Van toepassing op: Databricks SQL Databricks Runtime 13.3 LTS en hoger

    Hiermee voegt u een weergave toe aan de share of wijzigt u een bestaande gedeelde weergave. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn en bevoegd zijn SELECT voor de weergave.

    • ADD VIEW view_name

      Identificeert de weergave die moet worden toegevoegd. Als de weergave niet kan worden gevonden, wordt er een TABLE_OR_VIEW_NOT_FOUND fout gegenereerd in Azure Databricks.

    • ALTER VIEW view_name

      Identificeert de weergave die moet worden gewijzigd. Als de weergave nog geen deel uitmaakt van de share, treedt er een fout op in Azure Databricks.

    • COMMENT comment

      Een optionele letterlijke STRING letterlijke koppeling die als opmerking aan de weergaveshare is gekoppeld.

    • AS view_share_name

      U kunt de weergave desgewenst onder een andere naam weergeven. De naam kan worden gekwalificeerd met een schemanaam. Als er geen view_share_name is opgegeven, staat de weergave onder de eigen naam bekend.

      Als de gedeelde naam al bestaat, treedt er een fout op in Azure Databricks.

  • REMOVE VIEW view_name

    Verwijder de weergave die is geïdentificeerd door view_name uit de share. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn.

  • alter_add_model

    Van toepassing op: Databricks SQL Databricks Runtime 14.0 en hoger

    Hiermee voegt u een model toe aan de share of wijzigt u een bestaand gedeeld model. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn en bevoegd zijn EXECUTE voor het model.

    • ADD MODEL model_name

      Identificeert het model dat moet worden toegevoegd. Als het model niet kan worden gevonden, genereert Azure Databricks een RESOURCE_DOES_NOT_EXIST fout.

    • ALTER MODEL model_name

      Identificeert het model dat moet worden gewijzigd. Als het model nog geen deel uitmaakt van de share, treedt er een fout op in Azure Databricks.

    • COMMENT comment

      Een optionele letterlijke letterlijke STRING koppeling die als opmerking aan de modelshare is gekoppeld.

    • AS model_share_name

      Het model wordt eventueel onder een andere naam weergegeven. De naam kan worden gekwalificeerd met een schemanaam. Als er geen model_share_name is opgegeven, staat het model onder zijn eigen naam bekend.

      Als de gedeelde naam al bestaat, treedt er een fout op in Azure Databricks.

  • REMOVE MODEL model_name

    Verwijder het model dat is geïdentificeerd door model_name uit de share. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn.

  • RENAME TO to_share_name

    Van toepassing op: Databricks SQL Databricks Runtime 11.3 LTS en hoger

    Wijzigt de naam van de share. De naam moet uniek zijn voor alle shares in de metastore. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn en bevoegd zijn CREATE SHARE voor de metastore.

  • [ SET ] OWNER TO principal

    Hiermee wordt het eigendom van de share overgedragen aan principal. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn.

    Van toepassing op: Databricks SQL Databricks Runtime 11.3 LTS en hoger

    SET is toegestaan als een optioneel trefwoord.

Voorbeelden

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

Verwante artikelen:

• Gegevensfeed wijzigen
• CREATE SHARE
• DESCRIBE SHARE
• DESCRIBE HISTORY
• DROP SHARE
• SHOW SHARES
• SHOW ALL IN SHARE
• COMMENT ON DELEN