CREATE VOLUME

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. Woluminy zewnętrzne muszą być zarejestrowane w katalogu w lokalizacji zewnętrznej. Jeśli EXTERNAL nie zostanie określony, instrukcja tworzy zarządzany wolumin.

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

  • nazwa wolumenu

    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

Klauzula LOCATION dla woluminu zewnętrznego używa identyfikatora URI magazynu w chmurze:

-- Create an external volume on the specified location with comment
> CREATE EXTERNAL VOLUME my_catalog.my_schema.my_external_volume
    LOCATION 'abfss://my-container@mystorageaccount.dfs.core.windows.net/my-location/my-path'
    COMMENT 'This is my example external volume on ADLS Gen2'
  OK

Po utworzeniu woluminu zewnętrznego pozostałe kroki są takie same w każdej chmurze:

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