DESCRIBE SHARE
DESCRIBE SHARE
공유(Share)에 포함된 데이터 객체를 설명하는 명령어입니다. DESCRIBE는 DESC로 줄여서 쓸 수 있어요.
출처: 문서
본문
DESCRIBE SHARE는 공유에 포함된 데이터 객체를 설명합니다. 관련 명령어로 DROP SHARE, ALTER SHARE, CREATE SHARE, SHOW SHARES가 있어요.
구문 (Syntax)
공급자(아웃바운드 공유):
DESC[RIBE] SHARE <name>
소비자(인바운드 공유):
DESC[RIBE] SHARE <provider_account>.<share_name>
파라미터 (Parameters)
- name — 설명할 아웃바운드 공유의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요.
- provider_account.share_name — 설명할 인바운드 공유의 정규화된 식별자를 지정합니다.
사용 참고 사항 (Usage notes)
- 공유를 설명할 권한은 ACCOUNTADMIN 역할만 가집니다. ACCOUNTADMIN 이외의 역할로 이 명령어를 실행하면 오류가 반환됩니다.
- 이 명령어의 출력을 후처리하려면 파이프 연산자(
->>)나RESULT_SCAN함수를 사용할 수 있어요. 두 방식 모두 출력을 조회 가능한 결과 집합으로 취급합니다. 예를 들어 SHOW 명령어 출력에서 원하는 컬럼만 선택하거나 행을 필터링할 수 있어요. - 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표 식별자로 사용하세요. 예를 들어 출력 컬럼
type을 선택하려면SELECT "type"처럼 지정합니다. SHOW 명령어의 출력 컬럼 이름은 소문자이므로 큰따옴표 식별자를 반드시 사용해야 해요.
출력 (Output)
명령어의 출력은 공급자인지 소비자인지에 따라 다릅니다.
- 공급자의 경우 공유에 포함된 객체 이름에 데이터베이스 이름이 접두사로 붙습니다.
- 소비자의 경우 공유로부터 데이터베이스가 생성된 경우에만 객체 이름에 데이터베이스 이름이 접두사로 붙습니다. 공유로부터 데이터베이스가 생성되지 않은 경우 객체는
<DB>로 접두사가 붙습니다. - 출력의
kind컬럼은 공유에 포함된 객체의 유형을 표시합니다.
예제 (Examples)
공급자로서 sales_s 공유의 객체를 표시합니다.
DESC SHARE sales_s;
+----------+--------------------------------------+-------------------------------+
| kind | name | shared_on |
|----------+--------------------------------------+-------------------------------|
| DATABASE | SALES_DB | 2017-06-15 17:03:16.642 -0700 |
| SCHEMA | SALES_DB.AGGREGATES_EULA | 2017-06-15 17:03:16.790 -0700 |
| TABLE | SALES_DB.AGGREGATES_EULA.AGGREGATE_1 | 2017-06-15 17:03:16.963 -0700 |
+----------+--------------------------------------+-------------------------------+
소비자로서 계정 ab67890이 제공하는 sales_s 공유의 객체를 표시합니다.
DESC SHARE ab67890.sales_s;
+----------+----------------------------------+---------------------------------+
| kind | name | shared_on |
|----------+----------------------------------+---------------------------------|
| DATABASE | <DB> | Thu, 15 Jun 2017 17:03:16 -0700 |
| SCHEMA | <DB>.AGGREGATES_EULA | Thu, 15 Jun 2017 17:03:16 -0700 |
| TABLE | <DB>.AGGREGATES_EULA.AGGREGATE_1 | Thu, 15 Jun 2017 17:03:16 -0700 |
+----------+----------------------------------+---------------------------------+