SHOW ENDPOINTS¶

Lista os pontos de extremidade em um serviço do Snowpark Container Services.

Consulte também:: CREATE SERVICE , ALTER SERVICE, DROP SERVICE , SHOW SERVICES

Sintaxe¶

SHOW ENDPOINTS IN SERVICE <name>

Copy

Parâmetros¶

name

Especifica o identificador do serviço cujos pontos de extremidade serão listados.

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 de ponto de extremidade amigável que representa a porta correspondente.
`port`	A porta de rede na qual o serviço está escutando.
`protocol`	Protocolo de rede compatível (TCP, HTTP ou HTTPS). O padrão é HTTP. Pontos de extremidade públicos e funções de serviço (consulte Usando um serviço) exigem HTTP ou HTTPS.
`ingress_enabled`	Verdadeiro se o ponto de extremidade for público, acessível pela internet.
`ingress_url`	URL do ponto de extremidade acessível pela internet.

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
USAGE	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 lista os pontos de extremidade expostos pelo serviço echo_service:

SHOW ENDPOINTS IN SERVICE echo_service;

Copy

+--------------+------+----------+----------------- +------------------------------------------------------------+
| name         | port | protocol | ingress_enabled | ingress_url                                                 |
|--------------+------+----------+-----------------+-------------------------------------------------------------|
| echoendpoint | 8000 | TCP      | true            | org-id-acct-id.snowflakecomputing.app                       |
+--------------+------+----------+-----------------+-------------------------------------------------------------+