Dela via

CREATE VOLUME

  • Artikel

gäller för:markerad med ja Databricks SQL markerad med ja Databricks Runtime 13.3 LTS och senare markerad med ja Unity Catalog

Skapar en volym med det angivna namnet. Om det redan finns en volym med samma namn i schemat, utlöses VOLUME_ALREADY_EXISTS.

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

  • EXTERN

    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