ALTER SCHEMA

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Ändrar ägaren av ett schema, ändrar den hanterade lagringsplatsen för ett schema, anger beteende för förutsägande optimering , ändrar metadata som är associerade med ett schema genom att ange DBPROPERTIESeller anger återställningsperioden för borttagna hanterade tabeller. De angivna egenskapsvärdena åsidosätter alla befintliga värden med samma egenskapsnamn.

Även om användning av SCHEMA och DATABASE är utbytbar, SCHEMA är att föredra.

Syntax

ALTER SCHEMA schema_name
    { DEFAULT COLLATION default_collation_name |
      SET DBPROPERTIES ( { key = val } [, ...] ) |
      [ SET ] OWNER TO principal
      SET TAGS ( { tag_name = tag_value } [, ...] ) |
      UNSET TAGS ( tag_name [, ...] ) |
      { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION |
      SET MANAGED LOCATION location |
      [ SET ] RETAIN DROPPED TO number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } }

Parametrar

  • schema_name

    Namnet på schemat som ska ändras. Om schemat inte kan hittas genererar Azure Databricks ett SCHEMA_NOT_FOUND fel.

  • STANDARDSORTERING default_collation_name

    Gäller för:check markerad ja Databricks SQL-kontroll markerad ja Databricks Runtime 17.1 och senare

    Ändrar standardsortering för nya objekt som definierats i schemat. Standardsortering av befintliga objekt i schemat ändras inte.

  • DBPROPERTIES ( nyckel = val [, ...] )

    De schemaegenskaper som ska anges eller tas bort.

  • [ SET ] ÄGARE TILL huvudman

    Överför ägarskapet för schemat till principal.

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 11.3 LTS och senare

    SET tillåts som ett valfritt nyckelord.

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

    Tillämpa taggar på schemat. Du måste ha USE SCHEMA för att applicera en tagg på schemat.

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 13.3 LTS och senare

  • AVSTÄLL TAGGAR ( tag_name [, ...] )

    Ta bort taggar från schemat. Du måste ha USE SCHEMA för att ta bort en tagg från schemat.

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 13.3 LTS och senare

  • tag_name

    En bokstavlig STRING. tag_name måste vara unikt i schemat.

  • tag_value

    En bokstavlig STRING.

  • { AKTIVERA | AVAKTIVERA | ÄRVA } FÖRUTSÄGANDE OPTIMERING

    gäller för:markerad som ja Databricks SQL markerad som ja Databricks Runtime 12.2 LTS och senare markerad som ja endast Unity Catalog

    Ändrar schemat till önskad inställning för förutsägelseoptimering. När scheman skapas är standardbeteendet att INHERIT från katalogen. Som standard ärver nya objekt som skapats i schemat inställningen från schemat.

    Om schemat ändras kommer beteendet att påverka alla objekt som ärver prediktiv optimering. Objekt som uttryckligen använder ENABLE- eller DISABLE-prediktiv optimering påverkas inte av schemainställningen.

    Om du vill ange förutsägelseoptimering för ett schema måste användaren ha CREATE behörighet för schemat.

    Endast scheman i icke-OpenSharing, hanterade kataloger i Unity Catalog är berättigade till förutsägelseoptimering.

  • SET HANTERAD PLATS

    Gäller för:check markerad ja Databricks SQL-kontroll markerad ja Databricks Runtime 18.1 och ovan markerad ja Endast Unity Catalog

    Ändrar den hanterade lagringsplatsen för ett standardschema. Nya hanterade tabeller och hanterade volymer som skapats i schemat använder den uppdaterade platsen. Databricks flyttar inte befintliga objekt.

    • Plats / Ort

      Molnlagringssökvägen för den nya hanterade lagringsplatsen. Den måste finnas på en extern plats.

  • [ SET ] BEHÅLL TAPPADE TILL nummer { TIMME | TIMMAR | DAG | DAYS | VECKA | VECKOR }

    Gäller för:check markerad ja Databricks Runtime 17.3 och senare markerad som ja Endast Unity-katalog

    Important

    Den här funktionen finns som allmänt tillgänglig förhandsversion.

    Anger återställningsperioden för borttagna hanterade tabeller i schemat, den period under vilken borttagna UNDROP TABLE tabeller kan återställas med kommandot . Standardvärdet ärver från den överordnade katalogen (7 dagar om det inte anges). Värdet måste vara 0 timmar (för att inaktivera återställning) eller mellan 7–30 dagar, inklusive.

    Om återställningsperioden anges till 0 innebär det att borttagna tabeller inte kan återställas med hjälp av UNDROP och att datafiler tas bort från molnlagringen inom 48 timmar.

    Återställningsperioden på schemanivå har företräde framför alla inställningar på katalognivå för tabeller i schemat. Den här inställningen gäller endast för tabeller som släppts efter att återställningsperioden har konfigurerats. När återställningsperioden är slut tas datafiler för hanterade tabeller bort från molnlagringen inom 48 timmar.

    SET tillåts som ett valfritt nyckelord. Kräver MANAGE behörighet eller ägarskap i schemat. Se även Släpp en hanterad tabell.

Exempel

-- Creates a schema named `inventory`.
> CREATE SCHEMA inventory;

-- Alters the schema to set properties `Edited-by` and `Edit-date`.
> ALTER SCHEMA inventory SET DBPROPERTIES ('Edited-by' = 'John', 'Edit-date' = '01/01/2001');

-- Verify that properties are set.
> DESCRIBE SCHEMA EXTENDED inventory;
 database_description_item                 database_description_value
 ------------------------- ------------------------------------------
             Database Name                                  inventory
               Description
                  Location    file:/temp/spark-warehouse/inventory.db
                Properties ((Edit-date,01/01/2001), (Edited-by,John))

-- Transfer ownership of the schema to another user
> ALTER SCHEMA inventory OWNER TO `alf@melmak.et`

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

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

-- Enables predictive optimization for objects in schema my_schema
> ALTER SCHEMA my_schema ENABLE PREDICTIVE OPTIMIZATION;

-- Alter the default collation of a schema
> ALTER SCHEMA my_schema DEFAULT COLLATION UNICODE_CI_AI;

-- Change the managed storage location of a schema
> ALTER SCHEMA my_catalog.my_schema SET MANAGED LOCATION 's3://my-bucket/schemas/my_schema/';

-- Set a 14-day recovery period for dropped managed tables in a schema
> ALTER SCHEMA my_catalog.my_schema RETAIN DROPPED TO 14 DAYS;

-- Set a 7-day recovery period (overrides any catalog-level setting)
> ALTER SCHEMA my_catalog.my_schema SET RETAIN DROPPED TO 7 DAYS;
  • Last updated on