Udostępnij za pośrednictwem

CREATE VOLUME

  • Artykuł

Dotyczy:oznaczone jako tak Databricks SQL oznaczone jako tak Databricks Runtime 13.3 LTS i nowsze oznaczone jako taktylko Unity Catalog

Tworzy wolumin o określonej nazwie. Jeśli wolumin o tej samej nazwie już istnieje, zostaje zgłoszony błąd VOLUME_ALREADY_EXISTS w schemacie.

Aby uzyskać szczegółowe informacje na temat używania woluminów, odnieś się do Woluminy.

Składnia

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

Parametry

  • ZEWNĘTRZNY

    Tworzy wolumin zewnętrzny. Jeśli EXTERNAL instrukcja nie zostanie określona, tworzy wolumin zarządzany.

  • JEŚLI NIE ISTNIEJE

    Tworzy wolumin o podanej nazwie, jeśli nie istnieje. Jeśli wolumin o tej samej nazwie już istnieje, nic się nie stanie.

  • volume_name

    Nazwa woluminu do utworzenia. Woluminy można tworzyć tylko w schematach katalogu Unity.

  • LOKALIZACJA location_path

    location_path STRING to literał definiujący ścieżkę systemu plików, w którym tworzony jest określony wolumin zewnętrzny. Jeśli określona ścieżka nie istnieje w bazowym systemie plików, tworzy katalog ze ścieżką. Wybrana ścieżka nie powinna nakładać się na lokalizację żadnych innych woluminów lub tabel.

  • Ta klauzula nie dotyczy woluminów zarządzanych .

  • komentarz

    Opcjonalny STRING opis literału dla woluminu.

Przykłady


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