Sdílet prostřednictvím


ALTER RECIPIENT

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

Přejmenuje příjemce. Převede vlastnictví příjemce na nový objekt zabezpečení.

Syntaxe

ALTER RECIPIENT recipient_name
  { RENAME TO to_recipient_name |
    [ SET ] OWNER TO principal |
    SET PROPERTIES ( property_key [ = ] property_value [, ...] ) |
    UNSET PROPERTIES ( property_key [, ...] ) }

Parametry

  • recipient_name

    Jméno příjemce, který se má změnit.

  • RENAME TO to_recipient_name

    Přejmenuje příjemce. Jméno musí být jedinečné mezi všemi příjemci v metastoru. Pokud chcete tento příkaz spustit, musíte být vlastníkem příjemce a mít CREATE RECIPIENT oprávnění k metastoru.

  • [ SET ] OWNER TO hlavní

    Přenese vlastnictví příjemce do principal. Pokud chcete tento příkaz spustit, musíte být vlastníkem příjemce.

    Platí pro: zaškrtnutí označeného ano Databricks SQL SQL Warehouse verze 2022.35 nebo vyšší zaškrtnutí označeného ano databricks Runtime 11.3 LTS a vyšší

    SET je povolený jako volitelné klíčové slovo.

  • SET PROPERTIES ( property_key [ = ] property_value [, ...] )

    Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 12.2 LTS a vyšší.

    Nastaví vlastní vlastnost příjemce. Pokud chcete tento příkaz spustit, musíte být vlastníkem příjemce a mít CREATE RECIPIENT oprávnění k metastoru.

    Vlastnosti příjemce lze použít ke sdílení různých oddílů tabulky s různými příjemci pomocí stejného objektu sdílené složky. Viz Správa vlastností příjemce a Použití vlastností příjemce k filtrování oddílů.

    property_key
    { identifier [. ...] | string_literal }
    
    property_value
    { string_literal }
    
  • UNSET PROPERTIES ( '<property-key>' )

    Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 12.2 LTS a vyšší.

    Odebere vlastní vlastnost od příjemce. Pokud chcete tento příkaz spustit, musíte být vlastníkem příjemce a mít CREATE RECIPIENT oprávnění k metastoru.

    property_key
    { identifier [. ...] | string_literal }
    

Příklady

-- Rename a recipient
> ALTER RECIPIENT `Center for Disease Control` RENAME TO cdc;

-- Change ownership of the recipient
> ALTER RECIPIENT cdc OWNER TO `alf@melmak.et`;

-- Change recipient properties
> ALTER RECIPIENT cdc SET PROPERTIES ( 'country' = 'US' );