Delen via


VOLUME MAKEN

Van toepassing op:vinkje als ja aan Alleen Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger vinkje als ja aan dan Unity Catalog

Hiermee maakt u een volume met de opgegeven naam. Als er al een volume met dezelfde naam bestaat in het schema SCHEMA_NOT_FOUND wordt verhoogd.

Zie Volumes voor meer informatie over het gebruik van volumes.

Syntaxis

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

Parameters

  • EXTERN

    Hiermee maakt u een extern volume. Als EXTERNAL de instructie niet is opgegeven, wordt een beheerd volume gemaakt.

  • ALS DEZE NIET BESTAAT

    Hiermee maakt u een volume met de opgegeven naam als het niet bestaat. Als er al een volume met dezelfde naam bestaat, gebeurt er niets.

  • volume_name

    De naam van het volume dat moet worden gemaakt. Volumes kunnen alleen worden gemaakt in Unity Catalog-schema's.

  • PLAATS location_path

    location_path is een STRING letterlijke definitie van het pad van het bestandssysteem waarin het opgegeven externe volume wordt gemaakt. Als het opgegeven pad niet bestaat in het onderliggende bestandssysteem, maakt u een map met het pad. Het gekozen pad mag niet overlappen met de locatie van andere volumes of tabellen.

  • Deze component is niet van toepassing op beheerde volumes.

  • commentaar

    Een optionele letterlijke STRING beschrijving voor het volume.

Voorbeelden


-- 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