Compartilhar via

CREATE VOLUME

  • Artigo

Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 13.3 LTS e versões posteriores marca de seleção positiva Somente Catálogo do Unity

Cria um volume com o nome especificado. Se já existir um volume com o mesmo nome no esquema, SCHEMA_NOT_FOUND será gerado.

Consulte Volumes para obter detalhes sobre como usar volumes.

Sintaxe

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

Parâmetros

  • EXTERNAL

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

  • IF NOT EXISTS

    Cria um volume com o nome fornecido 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.

  • LOCAL location_path

    location_path é um literal STRING que define o caminho do sistema de arquivos no qual o volume externo especificado é criado. Se o caminho especificado não existir no sistema de arquivos subjacente, um diretório será criado com o caminho. O caminho escolhido não deve se sobrepor ao local de outros volumes ou tabelas.

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

  • comment

    Uma descrição literal STRING opcional 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