Partilhar via

CRIAR VOLUME

  • Artigo

Aplica-se a:Marque SimDatabricks SQL Marque Sim Databricks Runtime 13.3 LTS e superior Marque Sim somente Unity Catalog

Cria um volume com o nome especificado. Se já existir um volume com o mesmo nome no esquema VOLUME_ALREADY_EXISTS será acionado.

Consulte Volumes para obter detalhes sobre o uso de volumes.

Sintaxe

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

Parâmetros

  • EXTERNA

    Cria um volume externo. Se EXTERNAL não for especificada, a instrução criará um volume gerenciado.

  • SE NÃO EXISTIR

    Cria um volume com o nome próprio, se ele não existir. Se já existir um volume com o mesmo nome, nada acontecerá.

  • volume_name

    O nome do volume a ser criado. Os volumes só podem ser criados em esquemas do Unity Catalog.

  • LOCALIZAÇÃO location_path

    location_pathé uma STRING definição literal do caminho do sistema de arquivos no qual o volume externo especificado é criado. Se o caminho especificado não existir no sistema de arquivos subjacente, criará um diretório com o caminho. O caminho escolhido não deve sobrepor-se à localização de quaisquer outros volumes ou tabelas.

  • Esta cláusula não se aplica a volumes gerenciados.

  • comentar

    Uma descrição literal opcional STRING para o volume.

Exemplos


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