DROP SCHEMA

Van toepassing op:aangevinkt als ja Databricks SQL aangevinkt als ja Databricks Runtime

Hiermee wordt een schema verwijderd en wordt de map verwijderd die is gekoppeld aan het schema uit het bestandssysteem. Er wordt een uitzondering gegenereerd als het schema niet bestaat in het systeem. Als u een schema wilt verwijderen, moet u de MANAGE bevoegdheid voor het schema hebben of de eigenaar ervan zijn.

Hoewel het gebruik van SCHEMA en DATABASE uitwisselbaar is, SCHEMA heeft dit de voorkeur.

Syntaxis

DROP SCHEMA [ IF EXISTS ] schema_name [ RESTRICT | CASCADE ]

Parameterwaarden

  • ALS BESTAAT

    Als dit is opgegeven, wordt er geen uitzondering gegenereerd wanneer het schema niet bestaat.

  • schema_name

    De naam van een bestaand schema in het systeem. Als de naam niet bestaat, wordt er een uitzondering gegenereerd.

  • BEPERKEN

    Als dit is opgegeven, wordt het verwijderen van een niet-leeg schema beperkt en standaard ingeschakeld.

  • CASCADE

    Indien opgegeven, verwijdert u alle bijbehorende tabellen en functies recursief.

    Note

    In Unity Catalog verwijdert u een schema met behulp van CASCADE voorlopig verwijderen van het schema en de onderliggende objecten. Gegevensbestanden voor beheerde tabellen en volumes worden bewaard om een herstelvenster van 7 dagen mogelijk te maken. Nadat het herstelvenster is beƫindigd, worden de gegevensbestanden binnen 48 uur definitief verwijderd (verwijderd). Bestanden voor externe tabellen en externe volumes worden niet verwijderd. Zie de levenscyclus van objectopslag in Unity Catalog voor meer informatie.

    Waarschuwing! Als het schema wordt beheerd door de Hive-metastore op werkruimteniveau, zal het verwijderen van een schema met behulp van CASCADE alle bestanden op de opgegeven locatie recursief verwijderen, ongeacht het tabeltype (beheerd of extern).

Voorbeelden

-- Create `inventory_schema` Database
> CREATE SCHEMA inventory_schema COMMENT 'This schema is used to maintain Inventory';

-- Drop the schema and its tables
> DROP SCHEMA inventory_schema CASCADE;

-- Drop the schema using IF EXISTS
> DROP SCHEMA IF EXISTS inventory_schema CASCADE;