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