ALTER CATALOG

Van toepassing op:gemarkeerd als ja Databricks SQL gemarkeerd als ja Databricks Runtime 10.4 LTS en hoger gemarkeerd als ja alleen Unity Catalog

Hiermee wordt het eigendom van een catalogus overgedragen naar een nieuwe principal, wordt de beheerde opslaglocatie van een catalogus gewijzigd, worden tags toegepast op een catalogus, wordt voorspellende optimalisatie voor een catalogus ingeschakeld of uitgeschakeld, of wordt de herstelperiode voor verwijderde beheerde tabellen ingesteld.

Syntaxis

ALTER CATALOG [ catalog_name ]
 { DEFAULT COLLATION default_collation_name |
   [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION |
   OPTIONS (option value [, ...] ) |
   SET MANAGED LOCATION location |
   [ SET ] RETAIN DROPPED TO number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } }

Parameterwaarden

  • catalog_name

    De naam van de catalogus die moet worden gewijzigd. Als u geen naam opgeeft, is de standaardwaarde hive_metastore.

  • STANDAARDCOLLATIE default_collation_name

    Van toepassing op:controleren gemarkeerd ja Databricks SQL-controle gemarkeerd als ja Databricks Runtime 17.1 en hoger

    Hiermee wijzigt u de standaardsortering voor nieuwe schema's die in de catalogus zijn gedefinieerd. De standaardsortering van bestaande schema's en objecten in de catalogus wordt niet gewijzigd.

  • [ SET ] EIGENAAR NAAR hoofd

    Hiermee wordt het eigendom van de catalogus overgedragen aan principal.

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

    SET is toegestaan als een optioneel trefwoord.

  • SET TAGS ( { tag_name = tag_value } [, ...] )

    Tags toepassen op de catalogus. U moet USE CATALOG machtiging hebben om een tag toe te passen op een catalogus. Zie USE CATALOG.

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

  • UNSET TAGS ( tag_name [, ...] )

    Verwijder tags uit de catalogus. U moet USE CATALOG machtiging hebben om een tag toe te passen op een catalogus.

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

  • tag_name

    Een letterlijkeSTRING. De tag_name moet uniek zijn binnen de catalogus.

  • tag_value

    Een letterlijkeSTRING.

  • { INSCHAKELEN | UITSCHAKELEN | OVERERVEN VOORSPELLENDE OPTIMALISATIE }

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 12.2 LTS en hoger

    Hiermee wijzigt u de catalogus in de gewenste instelling voor voorspellende optimalisatie. Standaard wordt bij het aanmaken van catalogi de actie INHERIT vanuit het account uitgevoerd. Nieuwe objecten die in de catalogus zijn gemaakt, nemen standaard de instelling over van de catalogus.

    Als de catalogus wordt gewijzigd, wordt het gedrag trapsgewijs uitgevoerd op alle schema's en hun objecten, die voorspellende optimalisatie overnemen. Objecten in schema's die geen voorspellende optimalisatie overnemen of objecten die expliciet ENABLE of DISABLE voorspellende optimalisatie zijn, worden niet beïnvloed door de catalogusinstelling.

    Als u voorspellende optimalisatie voor een catalogus wilt instellen, moet de gebruiker CREATE machtiging voor de catalogus hebben.

    Alleen niet-OpenSharing, beheerde catalogi in Unity Catalog komen in aanmerking voor voorspellende optimalisatie.

  • OPTIES

    Hiermee stelt u catalogusspecifieke parameters in. Vervangt de bestaande lijst met opties door een nieuwe lijst met opties.

    Gebruik OPTIONS om authorized paths in te stellen voor buitenlandse catalogi die zijn gemaakt met hive-metastore-federatie.

    • optie

      De eigenschapssleutel. De sleutel kan bestaan uit een of meer identificaties, gescheiden door een punt, of een STRING letterlijk.

      Eigenschapssleutels moeten uniek en hoofdlettergevoelig zijn.

    • waarde

      De waarde voor de parameter. De waarde moet een BOOLEAN, STRINGof INTEGERDECIMALconstante expressie zijn.

      Een for value kan bijvoorbeeld password de constante expressiesecret('secrets.r.us', 'postgresPassword') gebruiken in plaats van het letterlijke wachtwoord in te voeren.

  • SET LOCATIE VAN BEHEERDE LOCATIE

    Van toepassing op:controleren gemarkeerd ja Databricks SQL-controle gemarkeerd als ja Databricks Runtime 18.1 en hoger, vink alleen ja Unity Catalog aan

    Hiermee wijzigt u de beheerde opslaglocatie voor de catalogus. Nieuwe beheerde tabellen en beheerde volumes die in de catalogus zijn gemaakt, maken gebruik van de bijgewerkte locatie. Databricks verplaatst geen bestaande objecten.

    • plaats

      Het cloudopslagpad voor de nieuwe beheerde opslaglocatie. Deze moet zich in een externe locatie bevinden.

  • [ SET ] BEHOUDEN VERWIJDERD NAAR nummer { UUR | UREN | DAG | DAGEN | WEEK | WEKEN }

    Van toepassing op:controleren gemarkeerd ja Databricks Runtime 17.3 en hoger, vink alleen ja Unity Catalog aan

    Important

    Deze functie bevindt zich in openbare preview-versie.

    Hiermee stelt u de herstelperiode in voor verwijderde beheerde tabellen in de catalogus, de periode waarin verwijderde tabellen kunnen worden hersteld met behulp van de UNDROP TABLE opdracht. Standaard is het aantal dagen 7. De waarde moet 0 uur zijn (om herstel uit te schakelen) of tussen 7 en 30 dagen, inclusief.

    Als u de herstelperiode instelt op 0, kunnen verwijderde tabellen niet worden hersteld met behulp van UNDROP en worden gegevensbestanden binnen 48 uur uit de cloudopslag verwijderd.

    Als een herstelperiode ook is ingesteld op een onderliggend schema, heeft de instelling op schemaniveau voorrang voor tabellen in dat schema. Deze instelling is alleen van toepassing op tabellen die zijn verwijderd nadat de herstelperiode is geconfigureerd. Nadat de herstelperiode is beëindigd, worden gegevensbestanden voor beheerde tabellen binnen 48 uur verwijderd uit uw cloudopslag.

    SET is toegestaan als een optioneel trefwoord. Vereist MANAGE bevoegdheden of eigendom van de catalogus. Zie ook Een beheerde tabel verwijderen.

Voorbeelden

-- Creates a catalog named `some_cat`.
> CREATE CATALOG some_cat;

-- Transfer ownership of the catalog to another user
> ALTER CATALOG some_cat OWNER TO `alf@melmak.et`;

-- Applies three tags to the catalog named `test`.
> ALTER CATALOG test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');

-- Removes three tags from the catalog named `test`.
> ALTER CATALOG test UNSET TAGS ('tag1', 'tag2', 'tag3');

-- Change the default collation of a catalog to case sensitive unicode
> ALTER CATALOG test DEFAULT COLLATION UNICODE_CS;

-- Adds an authorized path to a foreign catalog created using :re[HMS] federation.
> ALTER CATALOG my_federated_catalog OPTIONS (authorized_paths 'path/to/dir1, path/to/dir2');

–– Enables predictive optimization for catalog main
> ALTER CATALOG main ENABLE PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                        value
  ------------------------    ---------
  < other rows of describe extended >
  Predictive Optimization    ENABLE

-- Sets catalog main to inherit setting from parent object (metastore)
> ALTER CATALOG main INHERIT PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                         value
  ------------------------    ----------------------------------------
  < other rows of describe extended >
  Predictive Optimization     ENABLE (inherited from METASTORE metastore_name)

-- Change the managed storage location of a catalog
> ALTER CATALOG my_catalog SET MANAGED LOCATION 's3://my-bucket/managed/';

-- Set a 30-day recovery period for dropped managed tables in a catalog
> ALTER CATALOG my_catalog RETAIN DROPPED TO 30 DAYS;

-- Set the recovery period to 0 (tables are not recoverable after drop)
> ALTER CATALOG my_catalog SET RETAIN DROPPED TO 0 DAYS;
  • Last updated on