다음을 통해 공유

CREATE VOLUME

  • 아티클

적용 대상:체크 표시 예 Databricks SQL 체크 표시 예 Databricks Runtime 13.3 LTS 이상 체크 표시 예 Unity Catalog 한정

지정된 이름의 볼륨을 만듭니다. 이름이 같은 볼륨이 이미 존재하는 경우, schemaVOLUME_ALREADY_EXISTS가 발생합니다.

volumes사용에 대한 자세한 내용은 Volumes 참조하세요.

구문

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

Parameters

  • 외부

    외부 볼륨을 만듭니다. 지정하지 않으면 EXTERNAL 문이 관리되는 볼륨을 만듭니다.

  • IF NOT EXISTS

    지정된 이름의 볼륨이 없으면 볼륨을 만듭니다. 이름이 같은 볼륨이 이미 있는 경우 아무 작업도 수행되지 않습니다.

  • volume_name

    만들 볼륨의 이름입니다. Volumes Unity Catalog 스키마에서만 만들 수 있습니다.

  • LOCATION location_path

    location_path STRING 는 지정된 외부 볼륨이 만들어지는 파일 시스템의 경로를 정의하는 리터럴입니다. 지정된 경로가 기본 파일 시스템에 존재하지 않는 경우 해당 경로가 있는 디렉터리를 만듭니다. 선택한 경로는 다른 volumes 또는 tables위치와 겹치지 않아야 합니다.

  • 로 관리되는 volumes에는 이 조항이 적용되지 않습니다.

  • comment

    볼륨에 대한 선택적 STRING 리터럴 설명입니다.

예제


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