DESCRIBE VOLUME
적용 대상:
Databricks SQL Databricks Runtime 13.3 LTS 이상 Unity Catalog만
기존 볼륨의 메타데이터를 반환합니다. 메타데이터 정보에는 볼륨 이름, schema, catalog, 형식, 주석 및 소유자가 포함됩니다.
선택적 EXTENDED 옵션을 지정하면 다른 catalog 속성과 함께 기본 메타데이터 정보를 반환합니다.
구문
DESCRIBE VOLUME volume_name
Parameters
- volume_name: Unity Catalog에 있는 기존 볼륨의 이름입니다. 이름이 없으면 예외가 throw됩니다.
반품
다음 columns을 포함하는 단일 행 결과 set입니다.
-
name STRING NOT NULL: 볼륨의 이름입니다. 볼륨 개체를 식별합니다. -
catalog STRING NOT NULL: 볼륨을 포함하는 catalog 이름입니다. -
database STRING NOT NULL: schema에 포함된 볼륨의 이름입니다. -
owner STRING NOT NULL: 볼륨을 소유하는 보안 주체입니다. -
storageLocation STRING: 외부 볼륨이 있는 where 외부 위치의 경로입니다. 관리되는 volumes대한NULL. -
volumeType STRING NOT NULL: 볼륨의 유형, 가능한 values:EXTERNAL,MANAGED. -
comment STRING: 볼륨에 연결된 주석입니다.
예제
- Describe an external volume
> DESCRIBE VOLUME my_external_volume
name catalog database owner storageLocation volumeType comment
------------------ --------------- -------------- ----- ---------------------------------- ---------- ---------------
my_external_volume default_catalog default_schema Alice s3://my-bucket/my-location/my-path EXTERNAL My first volume
- Describe a managed volume
> DESCRIBE VOLUME managed_volume
name catalog database owner storageLocation volumeType comment
-------------- --------------- -------------- ----- ------------------------------------ ---------- -----------------------
managed_volume default_catalog default_schema Alice s3://<metastore-root>/volumes/<uuid> MANAGED My first managed volume