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>
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 |
---|---|
|
Nome de ponto de extremidade amigável que representa a porta correspondente. |
|
A porta de rede na qual o serviço está escutando. |
|
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. |
|
Verdadeiro se o ponto de extremidade for público, acessível pela internet. |
|
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;
+--------------+------+----------+----------------- +------------------------------------------------------------+
| name | port | protocol | ingress_enabled | ingress_url |
|--------------+------+----------+-----------------+-------------------------------------------------------------|
| echoendpoint | 8000 | TCP | true | org-id-acct-id.snowflakecomputing.app |
+--------------+------+----------+-----------------+-------------------------------------------------------------+