DESCRIBE SERVICE

Descreve as propriedades de um serviço Snowpark Container Services.

DESCRIBE pode ser abreviado como DESC.

Consulte também:

CREATE SERVICE , ALTER SERVICE, DROP SERVICE , SHOW SERVICES

Sintaxe

DESC[RIBE] SERVICE <name>
Copy

Parâmetros

name

Especifica o identificador do serviço a ser descrito.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

Saída

A saída do comando fornece propriedades de serviço e metadados nas seguintes colunas:

Coluna

Descrição

name

Nome do serviço Snowpark Container Services.

database_name

Banco de dados no qual o serviço é criado.

schema_name

Esquema no qual o serviço é criado.

owner

Função proprietária do serviço.

compute_pool

Nome do pool de computação onde o Snowflake executa o serviço.

spec

Arquivo de especificação de serviço. A saída incluirá esta coluna somente se você estiver usando a função de proprietário do serviço ao executar o comando.

dns_name

Nome DNS atribuído pelo Snowflake do serviço. O nome DNS permite comunicações entre serviços (consulte o Tutorial 3).

min_instances

Número mínimo de instâncias de serviço que o Snowflake deve executar.

max_instances

Número máximo de instâncias de serviço que o Snowflake pode dimensionar quando necessário.

auto_resume

Se for verdadeiro, o Snowflake retoma automaticamente o serviço, se suspenso, quando a função de serviço é chamada ou quando uma solicitação de entrada (ingresso) é recebida (consulte Como usar um serviço).

external_access_integrations

Lista de integrações de acesso externo associadas ao serviço. Para obter mais informações, consulte Saída de rede.

created_on

Carimbo de data/hora em que o serviço foi criado.

updated_on

Carimbo de data/hora quando o serviço foi atualizado pela última vez.

resumed_on

Carimbo de data/hora em que o serviço foi retomado pela última vez.

comment

Comentário relacionado ao serviço.

owner_role_type

O tipo de função que possui o objeto, seja ROLE ou DATABASE_ROLE.

query_warehouse

Quando um contêiner de serviço se conecta ao Snowflake para executar uma consulta e não especifica explicitamente um warehouse para usar, o Snowflake usa esse warehouse como padrão.

Requisitos de controle de acesso

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

Privilégio

Objeto

Notas

MONITOR

Serviço

Observe que operar em qualquer objeto de um esquema também requer o privilégio USAGE no banco de dados e esquema principais.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.

Exemplos

O exemplo a seguir descreve o serviço chamado echo_service:

DESCRIBE SERVICE echo_service;
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            |
+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+