SHOW SHARES

SHOW SHARES

시스템에서 사용 가능한 모든 공유(share)를 나열하는 명령이에요: 계정에서(프로바이더로서) 생성된 아웃바운드 공유(컨슈머에게)와 계정이 소비할 수 있는 인바운드 공유(프로바이더로부터)가 포함돼요.

출처: 문서

본문

참고: 프로바이더 공유는 모든 계정에서 활성화되지 않아요. 프로바이더 공유는 대부분의 계정에서 기본으로 활성화되지만 모든 계정이 그런 것은 아니에요. 컨슈머와 데이터를 공유하려 할 때 오류가 발생하면 그 기능이 계정에서 활성화되지 않았을 수 있어요. 활성화 문의는 Snowflake 지원팀에 연락해요.

시스템에서 사용 가능한 모든 공유를 나열해요:

  • 계정에서(프로바이더로서) 생성된 아웃바운드 공유(컨슈머에게).
  • 계정이 소비할 수 있는 인바운드 공유(프로바이더로부터).

구문

SHOW SHARES [ LIKE '<pattern>' ]
            [ LIMIT <rows> [ FROM '<name_string>' ] ]

매개변수

LIKE 'pattern'

선택적으로 객체 이름으로 명령 출력을 필터링해요. 필터는 SQL 와일드카드 문자(%와 _)를 지원하며 대소문자를 구분하지 않는 패턴 매칭을 사용해요. 예를 들어 다음 패턴들은 같은 결과를 반환해요:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

기본값: 값 없음(출력에 필터링이 적용되지 않음).

STARTS WITH 'name_string'

선택적으로 객체 이름의 시작 부분에 나타나는 문자를 기준으로 명령 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하고 대소문자를 구분해요. 예를 들어 다음 문자열들은 다른 결과를 반환해요:

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

기본값: 값 없음(출력에 필터링이 적용되지 않음).

LIMIT [ FROM 'name_string' ]

선택적으로 반환되는 최대 행 수를 제한하면서 결과의 "페이지 매김"도 가능하게 해요. 반환되는 실제 행 수는 지정된 제한보다 적을 수 있어요. 선택적 FROM 'name_string' 하위 절은 결과의 "커서" 역할을 해요. 지정된 문자열과 일치하는 객체 이름을 가진 첫 행 다음부터 지정된 수의 행을 가져올 수 있게 해줘요. 문자열은 작은따옴표로 묶어야 하고 대소문자를 구분해요. 전체 객체 이름을 포함할 필요는 없고 부분 이름도 지원돼요. 기본값: 값 없음(출력에 제한이 적용되지 않음).

참고: FROM 'name_string'과 STARTS WITH 'name_string' 절을 모두 지원하는 SHOW 명령에서는 같은 문장에서 두 절을 모두 조합할 수 있어요. 그러나 두 조건이 모두 충족되어야 하며, 그렇지 않으면 서로 상쇄되어 결과가 반환되지 않아요. 또한 객체는 이름으로 사전순으로 반환되므로 FROM 'name_string'은 STARTS WITH 'name_string'이 반환한 행보다 사전순 값이 더 높은 행만 반환해요.

사용 메모

  • 이 명령은 IMPORT SHARE 권한이 있는 역할을 가진 사용자에게만 공유를 나열해요. 기본적으로 ACCOUNTADMIN 역할이 이 권한을 가져요.
  • ACCOUNTADMIN 역할의 경우 이 명령은 계정에서 생성된 모든 아웃바운드 공유를 나열해요.
  • IMPORT SHARE 권한이 있는 다른 역할의 경우 이 명령은 세션의 활성 역할이 소유한 아웃바운드 공유만 나열해요.
  • ACCOUNTADMIN 역할을 가진 사용자는 이 권한을 위임할 수 있어요. 비-ACCOUNTADMIN 역할이 데이터 공유 작업을 수행하도록 설정(Enable non-ACCOUNTADMIN roles to perform data sharing tasks)을 참고해요.
  • 충분한 권한 없이 이 명령을 실행하면 빈 결과가 반환돼요.
  • 이 명령은 실행에 웨어하우스가 필요하지 않아요.
  • 이 명령은 현재 사용자의 현재 역할에 액세스 권한이 하나 이상 부여된 객체만 반환해요.
  • MANAGE GRANTS 액세스 권한은 보유자에게 계정의 모든 객체를 볼 수 있는 권한을 암묵적으로 부여해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할)와 보안 관리자(SECURITYADMIN 역할)만 MANAGE GRANTS 권한을 가져요.
  • 이 명령의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요.
  • 출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어 type 출력 컬럼을 선택하려면 SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.
  • 이 명령은 명령을 실행하는 역할의 액세스 권한에 따라 지정한 객체 유형에 대해 최대 1만 개의 레코드를 반환해요. 1만 개를 초과하는 결과를 보려면 Snowflake 정보 스키마의 해당 뷰(존재하는 경우)를 쿼리해요.

출력

kind 컬럼은 다음을 표시해요:

  • INBOUND: 공유가 계정이 소비할 수 있음을 나타내요(즉 공유에서 데이터베이스를 만들 수 있음).
  • OUTBOUND: 계정이 다른 계정과 데이터를 공유 중이고 이 공유가 계정에서 생성되었음을 나타내요.

OUTBOUND 공유의 경우, 공유에 계정이 추가되었으면 to 컬럼이 그 계정들을 표시해요. 이 컬럼에 표시되는 최대 계정 수는 3개지만, 공유에 추가할 수 있는 계정 수에는 하드 제한이 없어요.

예제

계정에서 생성되었거나 계정이 소비할 수 있는 모든 공유 표시:

SHOW SHARES;

+-------------------------------+----------+----------------------+---------------+-----------------------+------------------+--------------+----------------------------------------+---------------------+
| created_on                    | kind     | owner_account        | name          | database_name         | to               | owner        | comment                                | listing_global_name |                  |
|-------------------------------+----------+----------------------+---------------+-----------------------+------------------+--------------+----------------------------------------|---------------------|
| 2016-07-09 19:18:09.821 -0700 | INBOUND  | SNOW.MY_TEST_ACCOUNT | SAMPLE_DATA   | SNOWFLAKE_SAMPLE_DATA |                  |              | Sample data sets provided by Snowflake |                     |
| 2017-06-15 17:02:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT | SALES_S       | SALES_DB              | XY12345, YZ23456 | ACCOUNTADMIN |                                        |                     |
+-------------------------------+----------+----------------------+---------------+-----------------------+------------------+--------------+----------------------------------------+---------------------+

계정에서 생성되었거나 계정이 소비할 수 있는, 문자열 'SNOW'를 포함하는 모든 공유 표시:

SHOW SHARES LIMIT 5 FROM 'SNOW';

+-------------------------------+----------+-------------------------+-----------------+----------------+------------------+--------------+---------+---------------------+
| created_on                    | kind     | owner_account           | name            | database_name  | to               | owner        | comment | listing_global_name |
|-------------------------------+----------+-------------------------+-----------------+----------------+------------------+--------------+---------+---------------------|
| 2020-07-07 19:18:09.821 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT    | SNOW_DATA       | EXAMPLE        |                  | ACCOUNTADMIN |         |                     |
| 2020-07-10 19:18:09.821 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT    | DATA_SNOWS      | EXAMPLE        |                  | ACCOUNTADMIN |         |                     |
| 2022-08-18 12:02:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT    | SNOW_DATA       | ALFALFA_DB     | AB12345, YZ23456 | ACCOUNTADMIN |         |                     |
| 2022-08-18 13:04:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT    | SNOW_SHARE      | SALES_DB       | AB12345          | ACCOUNTADMIN |         |                     |
| 2022-08-18 14:02:40.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT    | SNOWIER_SHARE   | SALES_DB       |                  | ACCOUNTADMIN |         |                     |
+-------------------------------+----------+-------------------------+-----------------+----------------+------------------+--------------+---------+---------------------+

계정에서 생성되었거나 계정이 소비할 수 있는, SNOW로 시작하는 모든 공유를 사전순으로 표시:

SHOW SHARES STARTS WITH 'SNOW' LIMIT 5 FROM 'A';

+-------------------------------+----------+------------------------+------------------------+----------------+------------------+--------------+---------+---------------------+
| created_on                    | kind     | owner_account          |  name                  | database_name  | to               | owner        | comment | listing_global_name |
|-------------------------------+----------+------------------------+------------------------+----------------+------------------+--------------+---------+---------------------|
| 2020-07-07 19:18:09.821 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT   | SNOW_DATA              | EXAMPLE        |                  | ACCOUNTADMIN |         |                     |
| 2022-08-18 12:02:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT   | SNOW_DATA              | ALFALFA_DB     | AB12345, YZ23456 | ACCOUNTADMIN |         |                     |
| 2022-08-18 14:02:40.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT   | SNOWIER_SHARE          | SALES_DB       |                  | ACCOUNTADMIN |         |                     |
| 2022-08-20 15:03:50.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT   | SNOWY_SHARE            | SALES_DB       |                  | ACCOUNTADMIN |         |                     |
| 2022-08-18 13:04:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT   | SNOW_SHARE             | SALES_DB       | AB12345          | ACCOUNTADMIN |         |                     |
+-------------------------------+----------+------------------------+------------------------+----------------+------------------+--------------+---------+---------------------+

더 알아보기 (Learn more)