SHOW IMAGE REPOSITORIES

Snowflake logo in black (no text) 미리 보기 기능 — 공개

Snowpark Container Services 는 일부 AWS 리전 의 모든 계정에서 사용할 수 있습니다. 자세한 내용은 Snowflake 담당자에게 문의하십시오.

액세스 권한이 있는 이미지 리포지토리 를 나열합니다.

이 명령을 사용하여 세션, 지정된 데이터베이스나 스키마 또는 전체 계정에 대한 현재 데이터베이스 및 스키마의 리포지토리를 나열할 수 있습니다.

참고 항목:

CREATE IMAGE REPOSITORY , DROP IMAGE REPOSITORY

구문

SHOW IMAGE REPOSITORIES [ LIKE '<pattern>' ]
           [ IN
                {
                  ACCOUNT                  |

                  DATABASE                 |
                  DATABASE <database_name> |

                  SCHEMA                   |
                  SCHEMA <schema_name>     |
                  <schema_name>
                }
           ]
Copy

매개 변수

LIKE 'pattern'

오브젝트 이름으로 명령 출력을 선택적으로 필터링합니다. 이 필터는 SQL 와일드카드 문자(% 및 _) 지원과 함께 대/소문자를 구분하지 않는 패턴 일치를 사용합니다.

예를 들어, 다음 패턴은 같은 결과를 반환합니다.

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

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

[ IN ... ]

선택적으로 명령의 범위를 지정합니다. 다음 중 하나를 지정합니다.

ACCOUNT

전체 계정의 레코드를 반환합니다.

DATABASE, . DATABASE db_name

현재 사용 중인 데이터베이스 또는 지정된 데이터베이스(db_name)의 레코드를 반환합니다.

db_name 없이 DATABASE 를 지정하고 사용 중인 데이터베이스가 없는 경우 키워드는 출력에 아무런 영향도 주지 않습니다.

SCHEMA, . SCHEMA schema_name, . schema_name

현재 사용 중인 스키마 또는 지정된 스키마(schema_name)의 레코드를 반환합니다.

데이터베이스가 사용 중이거나 정규화된 schema_name (예: db.schema)을 지정하는 경우 SCHEMA 는 선택 사항입니다.

사용 중인 데이터베이스가 없으면 SCHEMA 를 지정해도 출력에 아무런 영향도 주지 않습니다.

기본값: 세션에 현재 사용 중인 데이터베이스가 있는지 여부에 따라 다릅니다.

  • 데이터베이스: DATABASE 가 기본값입니다(즉, 이 명령은 데이터베이스에서 볼 권한이 있는 오브젝트를 반환함).

  • 데이터베이스 없음: ACCOUNT 가 기본값입니다(즉, 이 명령은 계정에서 볼 권한이 있는 오브젝트를 반환함).

액세스 제어 요구 사항

다음 리포지토리 권한은 SHOW IMAGE REPOSITORIES 출력에서 리포지토리를 볼 수 있는 권한을 부여합니다. 이러한 권한이 없으면 SHOW IMAGE REPOSITORIES는 빈 결과를 반환합니다.

권한

오브젝트

참고

READ

이미지 리포지토리

리포지토리에서 이미지를 끌어오려면 역할에 이 권한이 필요합니다.

WRITE

이미지 리포지토리

리포지토리에 이미지를 푸시하려면 역할에 이 권한이 필요합니다.

OWNERSHIP

이미지 리포지토리

리포지토리를 생성하려면 역할에 이 권한이 필요합니다.

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

출력

명령 출력은 다음 열에 리포지토리 속성과 메타데이터를 제공합니다.

열

설명

created_on

리포지토리가 생성된 날짜 및 시간입니다.

database_name

리포지토리가 생성된 데이터베이스입니다.

schema_name

리포지토리가 생성된 스키마입니다.

repository_url

이미지 리포지토리의 URL입니다. 리포지토리에서 이미지를 푸시(예: docker push)하거나 끌어오려면(예: docker pull) 이 URL가 필요합니다.

owner

리포지토리를 소유한 역할입니다.

owner_role_type

오브젝트를 소유하는 역할의 유형(ROLE 또는 DATABASE_ROLE)입니다.

삭제된 오브젝트에 대한 소유자 역할이 없으므로 오브젝트를 삭제하면 Snowflake는 NULL을 반환합니다.

comment

리포지토리에 대한 설명입니다.

사용법 노트

  • 접두사 is_ 로 시작하는 열은 Y (예) 또는 N (아니요)을 반환합니다.

  • 이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.

  • 이 명령은 명령을 실행하는 데 사용되는 역할에 대한 액세스 권한에 따라 지정된 오브젝트 유형에 대해 최대 10,000개의 레코드를 반환합니다. 필터가 적용된 경우에도 10,000개의 제한을 초과하는 레코드는 반환되지 않습니다.

    10,000개 이상의 레코드가 존재하는 결과를 보려면 Snowflake Information Schema 에서 해당 뷰(있는 경우)를 쿼리하십시오.

  • 이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.

예

다음 두 가지 예에서는 현재 데이터베이스와 현재 스키마의 리포지토리를 나열합니다.

SHOW IMAGE REPOSITORIES;
Copy
SHOW IMAGE REPOSITORIES IN SCHEMA;
Copy

다음 예에서는 현재 데이터베이스와 지정된 스키마의 리포지토리를 나열합니다.

SHOW IMAGE REPOSITORIES IN SCHEMA sc1;
Copy

다음 예에서는 현재 데이터베이스와 모든 스키마의 리포지토리를 나열합니다.

SHOW IMAGE REPOSITORIES IN DATABASE;
Copy

다음 예에서는 지정된 데이터베이스와 모든 스키마의 리포지토리를 나열합니다.

SHOW IMAGE REPOSITORIES IN DATABASE db1;
Copy

다음 예에서는 현재 계정(모든 데이터베이스와 모든 스키마)의 리포지토리를 나열합니다.

SHOW IMAGE REPOSITORIES IN ACCOUNT;
Copy

샘플 출력:

+-------------------------------+---------------------+---------------+-------------+-----------------------------------------------------------------------------------------------------------------+-----------+-----------------+---------+
| created_on                    | name                | database_name | schema_name | repository_url                                                                                                  | owner     | owner_role_type | comment |
|-------------------------------+---------------------+---------------+-------------+-----------------------------------------------------------------------------------------------------------------+-----------+-----------------+---------|
| 2023-05-09 14:27:19.459 -0700 | TUTORIAL_REPOSITORY | TUTORIAL_DB   | DATA_SCHEMA | orgname-acctname.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository | TEST_ROLE | ROLE            |         |
+-------------------------------+---------------------+---------------+-------------+-----------------------------------------------------------------------------------------------------------------+-----------+-----------------+---------+
언어: 한국어