Freigeben über


CREATE VOLUME

Gilt für: Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 13.3 LTS und höher durch Häkchen mit „Ja“ markiert Nur Unity Catalog

Erstellt ein Volume mit dem angegebenen Namen. Wenn ein Volume mit demselben Namen bereits im Schema vorhanden ist, wird SCHEMA_NOT_FOUND ausgelöst.

Ausführliche Informationen zur Verwendung von Volumes finden Sie unter Volumes.

Syntax

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

Parameter

  • EXTERNAL

    Erstellt ein externes Volume. Wenn EXTERNAL nicht angegeben ist, erstellt die Anweisung ein verwaltetes Volume.

  • IF NOT EXISTS

    Erstellt ein Volume mit dem angegebenen Namen, wenn keins vorhanden ist. Wenn bereits ein Volume mit demselben Namen vorhanden ist, geschieht nichts.

  • volume_name

    Der Name des zu erstellenden Volumes. Volumes können nur in Unity Catalog-Schemas erstellt werden.

  • LOCATION location_path

    location_path ist ein STRING-Literal, das den Pfad des Dateisystems definiert, in dem das angegebene externe Volume erstellt wird Wenn der angegebene Pfad im zugrunde liegenden Dateisystem nicht vorhanden ist, wird ein Verzeichnis mit dem Pfad erstellt. Der ausgewählte Pfad darf sich nicht mit dem Speicherort anderer Volumes oder Tabellen überschneiden.

  • Diese Klausel gilt nicht für verwaltete Volumes.

  • Kommentar

    Eine optionale STRING-Literalbeschreibung für das Volume.

Beispiele


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