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.

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

Permissions

Als u een schema in Unity Catalog wilt verwijderen, moet u de MANAGE bevoegdheid voor het schema hebben of de eigenaar zijn, plus USE SCHEMA in het schema en USE CATALOG in de catalogus waarin het schema zich bevindt.

Volgens de objecthiërarchie kunnen de eigenaar van de bovenliggende catalogus en gebruikers met MANAGE op de bovenliggende catalogus ook deze bewerking uitvoeren.

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;
  • Last updated on