다음을 통해 공유

DESCRIBE VOLUME

  • 아티클

적용 대상:확인 표시 예 Databricks SQL 확인 표시 예 Databricks Runtime 13.3 LTS 이상 확인 표시 예 Unity 카탈로그만 표시

기존 볼륨의 메타데이터를 반환합니다. 메타데이터 정보에는 볼륨 이름, 스키마, 카탈로그, 형식, 주석 및 소유자가 포함됩니다. 선택적 EXTENDED 옵션을 지정하면 다른 카탈로그 속성과 함께 기본 메타데이터 정보를 반환합니다.

구문

DESCRIBE VOLUME volume_name

매개 변수

  • volume_name: Unity 카탈로그에 있는 기존 볼륨의 이름입니다. 이름이 없으면 예외가 throw됩니다.

반품

다음 열을 포함한 단일 행 결과 집합:

  • name STRING NOT NULL: 볼륨의 이름입니다. 볼륨 개체를 식별합니다.
  • catalog STRING NOT NULL: 볼륨을 포함하는 카탈로그의 이름입니다.
  • database STRING NOT NULL: 볼륨을 포함하는 스키마의 이름입니다.
  • owner STRING NOT NULL : 볼륨을 소유하는 보안 주체입니다.
  • storageLocation STRING: 외부 볼륨이 있는 외부 위치의 경로입니다. 관리 볼륨용 NULL
  • volumeType STRING NOT NULL: 볼륨의 형식, 가능한 값: 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