SHOW ENDPOINTS

Nota

Esta operação não é atualmente coberta pelo nível de serviço definido na Política de suporte e Acordo de nível de serviço da Snowflake.

Lista os pontos de extremidade em um serviço do Snowpark Container Services (ou serviço de trabalho). Use o comando para listar pontos de extremidade em um serviço ou serviço em execução como um trabalho.

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. NULL, quando portRange é especificado.

port_range

O intervalo de porta de rede em que o serviço está escutando. NULL, quando port é especificado.

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.

is_public

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 | port_range | protocol | is_public | ingress_url                                                                  |
|--------------+------+------------+----------+-----------+------------------------------------------------------------------------------|
| echoendpoint | 8080 |            | HTTP     | true      | d7qoajz-orgname-acctname.pp-snowflakecomputing.app                           |
+--------------+------+------------+----------+-----------+------------------------------------------------------------------------------+
Linguagem: Português