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 detalhes, 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            |
+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+