SKAPA VOLYM

  • Artikel

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

Skapar en volym med det angivna namnet. Om det redan finns en volym med samma namn i schemat SCHEMA_NOT_FOUND genereras.

Mer information om hur du använder volymer finns i Volymer .

Syntax

CREATE [ EXTERNAL ] VOLUME [ IF NOT EXISTS ] volume_name
    [ LOCATION location_path ]
    [ COMMENT comment ]

Parametrar

  • EXTERNA

    Skapar en extern volym. Om EXTERNAL inte anges skapar instruktionen en hanterad volym.

  • OM INTE FINNS

    Skapar en volym med det angivna namnet om den inte finns. Om det redan finns en volym med samma namn händer ingenting.

  • volume_name

    Namnet på volymen som ska skapas. Volymer kan bara skapas i Unity Catalog-scheman.

  • PLATS location_path

    location_path är en STRING literal som definierar sökvägen till filsystemet där den angivna externa volymen skapas. Om den angivna sökvägen inte finns i det underliggande filsystemet skapar du en katalog med sökvägen. Den valda sökvägen bör inte överlappa platsen för andra volymer eller tabeller.

  • Den här satsen gäller inte för hanterade volymer.

  • Kommentar

    En valfri STRING literalbeskrivning för volymen.

Exempel


-- Create an external volume on the specified location with comment
> CREATE EXTERNAL VOLUME my_catalog.my_schema.my_external_volume
    LOCATION 's3://my-bucket/my-location/my-path'
    COMMENT 'This is my example external volume on S3'
  OK

-- Query the data from the file in the created volume
> SELECT *
    FROM csv.`/Volumes/my_catalog/my_schema/my_external_volume/foo.csv`

-- Create a managed volume with full schema name
> CREATE VOLUME my_catalog.my_schema.my_volume
  OK

-- Create a managed volume in default catalog and schema
> CREATE VOLUME my_another_volume
  OK