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 im Schema bereits ein Volume mit demselben Namen vorhanden ist , wird VOLUME_ALREADY_EXISTS 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

  • EXTERN

    Erstellt ein externes Volume. Externe Volumes müssen einem Verzeichnis an einem externen Speicherort zugeordnet werden. Wenn EXTERNAL nicht angegeben ist, erstellt die Anweisung ein verwaltetes Volume.

  • WENN NICHT EXISTIERT

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

  • Volumenname

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

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