SHOW SERVICES

액세스 권한이 있는 Snowpark Container Services 서비스 를 나열합니다.

참고 항목:

CREATE SERVICE , ALTER SERVICE, DROP SERVICE , DESCRIBE SERVICE

구문

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

                  DATABASE                 |
                  DATABASE <database_name> |

                  SCHEMA                   |
                  SCHEMA <schema_name>     |
                  <schema_name>            |

                  COMPUTE POOL <compute_pool_name>
                }
           ]
           [ STARTS WITH '<name_string>' ]
           [ LIMIT <rows> [ FROM '<name_string>' ] ]
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 가 기본값입니다(즉, 이 명령은 계정에서 볼 권한이 있는 오브젝트를 반환함).

STARTS WITH 'name_string'

오브젝트 이름의 시작 부분에 나타나는 문자를 기반으로 명령 출력을 선택적으로 필터링합니다. 문자열은 작은따옴표로 묶어야 하며 대/소문자를 구분 합니다.

예를 들어, 다음 문자열은 서로 다른 결과를 반환합니다.

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

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

LIMIT rows

선택적으로, 반환되는 최대 행 수를 제한합니다. 반환되는 실제 행 수는 지정된 제한보다 적을 수 있습니다. 예를 들어 기존 오브젝트 수가 지정된 제한보다 적습니다.

기본값: 값 없음(출력에 제한이 적용되지 않음)

출력

명령 출력은 다음 열에 서비스 속성과 메타데이터를 제공합니다.

열

설명

name

Snowpark Container Services 서비스 이름입니다.

database_name

서비스가 생성되는 데이터베이스입니다.

schema_name

서비스가 생성되는 스키마입니다.

owner

서비스를 소유한 역할입니다.

compute_pool

Snowflake가 서비스를 실행하는 컴퓨팅 풀 이름입니다.

dns_name

Snowflake에서 할당한 서비스의 DNS 이름입니다. DNS 이름을 사용하면 서비스 간 통신이 가능합니다(자습서 3 참조).

min_instances

Snowflake가 실행해야 하는 최소 서비스 인스턴스 수입니다.

max_instances

Snowflake가 필요할 때 확장할 수 있는 최대 서비스 인스턴스 수입니다.

auto_resume

true 인 경우 Snowflake는 서비스가 일시 중단되거나, 서비스 함수가 호출되거나, 들어오는 요청(수신)이 수신될 때 서비스를 자동으로 재개합니다(서비스 사용하기 참조).

external_access_integrations

서비스와 연결된 외부 액세스 통합 목록입니다. 자세한 내용은 네트워크 송신 섹션을 참조하십시오.

created_on

서비스가 만들어진 날짜 및 시간입니다.

updated_on

서비스가 마지막으로 업데이트된 날짜 및 시간입니다.

resumed_on

서비스가 마지막으로 재개된 타임스탬프입니다.

comment

서비스 관련 설명입니다.

owner_role_type

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

query_warehouse

서비스 컨테이너가 쿼리를 실행하기 위해 Snowflake에 연결하고 사용할 웨어하우스를 명시적으로 지정하지 않으면 Snowflake는 이 웨어하우스를 기본값으로 사용합니다.

액세스 제어 요구 사항

이 SQL 명령을 실행하는 데 사용되는 역할 에는 다음 권한 중 최소한 하나 이상 이 있어야 합니다.

권한

오브젝트

참고

다음 권한 중 하나: OWNERSHIP, USAGE, MONITOR 또는 OPERATE

서비스

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

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

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

사용법 노트

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

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

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

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

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

예

다음 예에서는 세션에 대한 현재 데이터베이스 및 스키마의 서비스를 나열합니다.

SHOW SERVICES;
Copy

다음 예에서는 하나의 서비스를 나열합니다.

SHOW SERVICES LIMIT 1;
Copy

다음 예에서는 이름에 “echo”가 포함된 서비스를 나열합니다.

SHOW SERVICES LIKE '%echo%';
Copy

다음 예에서는 이름에 “echo”가 포함된 서비스 하나를 나열합니다.

SHOW SERVICES LIKE '%echo%' LIMIT 1;
Copy

샘플 출력:

+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+
| name               | database_name | schema_name | owner    | compute_pool          | dns_name                                                              | min_instances | max_instances | auto_resume | external_access_integrations   | created_on                    | updated_on                     | resumed_on | comment | owner_role_type | query_warehouse |
|--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------------------------+-----------------|
| ECHO_SERVICE       | TUTORIAL_DB   | DATA_SCHEMA | TST_ROLE | TUTORIAL_COMPUTE_POOL | echo-service.data-schema.tutorial-db.snowflakecomputing.internal      |             1 |             1 | true        | ["example_access_integration"] |2023-10-26 10:53:32.150 -0700  | 2023-10-31 23:56:49.041 -0700  | NULL       | NULL    | ROLE            | NULL            |
+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+
언어: 한국어