SHOW SERVICES

액세스 권한이 있는 Snowpark Container Services 서비스 (작업 서비스 포함)를 나열합니다.

  • SHOW SERVICES 출력에는 작업으로 실행되는 서비스도 포함됩니다(EXECUTE JOB SERVICE 참조).

  • SHOW JOB SERVICES는 작업으로 실행 중인 서비스 목록만 제공합니다.

  • SHOW SERVICES EXCLUDE JOBS 출력에는 작업으로 실행 중인 서비스가 포함되지 않습니다.

참고 항목:

CREATE SERVICE , ALTER SERVICE, DROP SERVICE , DESCRIBE SERVICE, SHOW SERVICE INSTANCES IN SERVICE, SHOW SERVICE CONTAINERS IN SERVICE

구문

SHOW [ JOB ] SERVICES [ EXCLUDE JOBS ] [ 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 서비스 이름입니다.

status

다음 값 중 하나로, 서비스의 현재 상태를 나타냅니다.

  • PENDING

  • RUNNING

  • FAILED

  • DONE

  • SUSPENDING

  • SUSPENDED

  • DELETING

  • DELETED

  • INTERNAL_ERROR

database_name

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

schema_name

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

owner

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

compute_pool

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

dns_name

service-name.unique-id.svc.spcs.internal 형식으로 Snowflake에서 할당한 서비스의 DNS 이름입니다.

unique-id 는 데이터베이스 스키마의 특정 인스턴스에 고유한 4~8자의 영숫자 식별자입니다. 스키마에 대한 고유 ID를 찾으려면 SYSTEM$GET_SERVICE_DNS_DOMAIN 함수를 호출합니다. 예:

SELECT SYSTEM$GET_SERVICE_DNS_DOMAIN('mydb.myschema');
Copy

다음 사항을 참고하십시오.

  • 스키마의 이름을 변경해도 식별자는 변경되지 않습니다.

  • 동일한 이름의 스키마를 삭제한 후 다시 생성하면 식별자가 변경됩니다.

DNS 이름을 사용하면 서비스 간 통신이 가능합니다(자습서 3 참조).

current_instances

서비스의 현재 인스턴스 수입니다.

target_instances

Snowflake에서 결정한 대로 실행해야 하는 서비스 인스턴스의 목표 수입니다.

current_instances 값이 target_instances 값과 같지 않을 경우 Snowflake는 서비스 인스턴스를 종료하거나 시작하는 과정에 있는 것입니다.

예를 들어, 다음을 생각해 보겠습니다.

  • MIN_INSTANCES = 1 및 MAX_INSTANCES = 3인 서비스를 생성한다고 가정해 보겠습니다. 서비스가 실행되는 동안 Snowflake는 1개의 인스턴스로는 충분하지 않다고 판단할 수 있습니다. 이 경우 target_instances 의 값이 증가하여 Snowflake가 추가 인스턴스를 시작하는 과정에 있음을 나타냅니다.

    target_instances 값이 current_instances 값보다 작을 가능성도 있는데, 이는 Snowflake가 실행 중인 인스턴스 수를 줄이는 과정에 있음을 나타냅니다.

  • 서비스를 만들지만 요청한 최소 인스턴스 수에 알맞은 용량이 컴퓨팅 풀에 없는 경우 target_instances 의 값은 min_instances 의 값과 같아집니다. current_instances 의 값이 target_instances 의 값보다 작을 것입니다.

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는 이 웨어하우스를 기본값으로 사용합니다.

is_job

해당 서비스가 작업 서비스인 경우 true, 그렇지 않으면 false. SHOW JOB SERVICES 및 SHOW SERVICES EXCLUDE JOBS는 이 열을 출력에 포함하지 않습니다.

spec_digest

서비스 사양 내용을 나타내는 고유하고 변경 불가능한 식별자입니다.

시간에 따른 spec_digest 열 값의 변화를 관찰하기 위해 서비스 사용자가 SHOW SERVICES 명령을 주기적으로 실행할 수 있습니다. 서비스 사용자가 값의 변경을 발견하면 서비스가 업그레이드되었다고 유추할 수 있습니다.

is_upgrading

Snowflake가 서비스를 업그레이드하는 중인 경우 TRUE.

managing_object_domain

관리 오브젝트의 도메인(예: 서비스를 관리하는 노트북의 도메인). 서비스가 Snowflake 엔터티에 의해 관리되지 않는 경우 NULL.

managing_object_name

관리하는 오브젝트의 이름(예: 서비스를 관리하는 노트북의 이름)입니다. 서비스가 Snowflake 엔터티에 의해 관리되지 않는 경우 NULL.

액세스 제어 요구 사항

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

권한

오브젝트

참고

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

서비스

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

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

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

사용법 노트

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

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

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

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

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

예

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

SHOW SERVICES;
Copy

샘플 출력:

+----------------------------+-----------+---------------+-------------+-----------+-----------------------+--------------------------------------------------------------------------------+-------------------+------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+------------------------------------------------------------------+--------------+------------------------+----------------------+
| name                       | status    | database_name | schema_name | owner     | compute_pool          | dns_name                                                                       | current_instances | target_instances | min_instances | max_instances | auto_resume | external_access_integrations | created_on                    | updated_on                    | resumed_on | comment | owner_role_type | query_warehouse | is_job | spec_digest                                                      | is_upgrading | managing_object_domain | managing_object_name |
|----------------------------+-----------+---------------+-------------+-----------+-----------------------+--------------------------------------------------------------------------------+-------------------+------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+------------------------------------------------------------------+--------------+------------------------+----------------------|
| ECHO_SERVICE               | RUNNING   | TUTORIAL_DB   | DATA_SCHEMA | TEST_ROLE | TUTORIAL_COMPUTE_POOL | echo-service.fsvv.svc.spcs.internal                                            |                 1 |                1 |             1 |             1 | true        | NULL                         | 2024-08-16 19:05:45.537 -0700 | 2024-08-16 19:05:46.354 -0700 | NULL       | NULL    | ROLE            | NULL            | false  | 58447f146a9591df5a69668f73ea35be9aa1b2829ace05d1c97c6f999246ac31 | false        | NULL                   | NULL                 |
| ECHO_SERVICE2              | RUNNING   | TUTORIAL_DB   | DATA_SCHEMA | TEST_ROLE | TUTORIAL_COMPUTE_POOL | echo-service2.fsvv.svc.spcs.internal                                           |                 1 |                1 |             1 |             1 | true        | NULL                         | 2024-08-16 19:03:46.893 -0700 | 2024-08-16 19:03:47.895 -0700 | NULL       | NULL    | ROLE            | NULL            | false  | 58447f146a9591df5a69668f73ea35be9aa1b2829ace05d1c97c6f999246ac31 | false        | NULL                   | NULL                 |
+----------------------------+-----------+---------------+-------------+-----------+-----------------------+--------------------------------------------------------------------------------+-------------------+------------------+---------------+---------------+-------------+------------------------------+-------------------------------+-------------------------------+------------+---------+-----------------+-----------------+--------+------------------------------------------------------------------+--------------+------------------------+----------------------+

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

SHOW SERVICES LIMIT 1;
Copy

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

SHOW SERVICES LIKE '%echo%';
Copy

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

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

다음 예제에서는 작업으로 실행되는 서비스만 나열합니다.

SHOW JOB SERVICES;
Copy
언어: 한국어