Sdílet prostřednictvím

VYTVOŘIT SVAZEK

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 13.3 LTS a vyšší zaškrtnutí označeného ano pouze katalog Unity

Vytvoří svazek se zadaným názvem. Pokud již ve schématu existuje svazek se stejným názvem, je vyvolán VOLUME_ALREADY_EXISTS.

Podrobnosti o používání svazků najdete v tématu Svazky .

Syntaxe

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

Parametry

  • EXTERNÍ

    Vytvoří externí svazek. Pokud EXTERNAL není zadaný příkaz, vytvoří spravovaný svazek.

  • POKUD NEEXISTUJE

    Vytvoří svazek s daným názvem, pokud neexistuje. Pokud svazek se stejným názvem již existuje, nic se nestane.

  • volume_name

    Název svazku, který se má vytvořit. Svazky lze vytvářet pouze ve schématech katalogu Unity.

  • UMÍSTĚNÍ location_path

    location_path STRING je literál definující cestu systému souborů, ve kterém je vytvořen zadaný externí svazek. Pokud zadaná cesta v základním systému souborů neexistuje, vytvoří adresář s cestou. Zvolená cesta by se neměla překrývat s umístěním jiných svazků nebo tabulek.

  • Tato klauzule se nevztahuje na spravované svazky.

  • komentář

    Volitelný STRING popis literálu svazku.

Příklady


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