Sdílet prostřednictvím

CREATE VOLUME

platí pro:označené jako Ano Databricks SQL označené jako Ano Databricks Runtime 13.3 LTS a vyšší označené jako Ano katalog Unity pouze.

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

Viz Svazky pro podrobnosti o používání svazků.

Syntaxe

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

Parametry

  • EXTERNÍ

    Vytvoří externí svazek. Externí svazky musí být registrovány v adresáři v rámci externího umístění. Pokud EXTERNAL není specifikován, 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.

  • název svazku

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