Categorias:: Funções do sistema (Informações do sistema)

SYSTEM$ALLOWLIST_PRIVATELINK¶

Retorna nomes de host e números de porta para implementações do AWS PrivateLink, Azure Private Link e Google Cloud Private Service Connect a fim de adicioná-los à lista de permissão do seu firewall para que você possa acessar o Snowflake sem o bloqueio do seu firewall. Estes recursos fornecem conectividade privada ao serviço Snowflake em cada plataforma de nuvem suportada.

A saída desta função pode então ser passada para SnowCD para diagnosticar e solucionar problemas de sua conexão de rede com o Snowflake.

Normalmente, os clientes do Snowflake usam um firewall para impedir o acesso não autorizado. Por padrão, seu firewall pode bloquear o acesso ao Snowflake. Para atualizar a lista de permissão de seu firewall, você precisa saber os nomes de host e números de porta do URL associado ao seu identificador da conta Snowflake, estágios e outros hosts utilizados pelo Snowflake.

Para obter mais detalhes sobre as listas permitidas para os clientes do Snowflake que você utiliza, consulte Permissão de nomes de host.

Sintaxe¶

SYSTEM$ALLOWLIST_PRIVATELINK()

Copy

Argumentos¶

Nenhum.

Retornos¶

O tipo de dados do valor retornado é VARIANT. O valor é um conjunto de estruturas JSON. Cada estrutura JSON contém três pares chave/valor:

type

O Snowflake oferece suporte aos seguintes tipos:

SNOWFLAKE_DEPLOYMENT

Informações sobre o nome do host e o número da porta para sua conta Snowflake.

SNOWFLAKE_DEPLOYMENT_REGIONLESS

Informações sobre o nome do host e número de porta de sua organização.

Para obter mais informações, consulte Identificadores de conta.

STAGE

Local (ou seja, Amazon S3, Google Cloud Storage ou Microsoft Azure) onde são armazenados arquivos que o cliente Snowflake pode ler ou gravar.

SNOWSQL_REPO

Ponto de extremidade acessado por SnowSQL para realizar downloads/atualizações automáticos.

OUT_OF_BAND_TELEMETRY

Os hosts aos quais os drivers relatam métricas e incidentes fora de banda, tais como questões OCSP.

CLIENT_FAILOVER

Nome do host e porta para a URL de conexão para redirecionamento do cliente. Observe que cada linha na saída da consulta que especifica esse valor se refere à conexão primária ou secundária, dependendo de como as URLs de conexão foram configuradas.

OCSP_CACHE

Fonte alternativa de informação de certificado OCSP fornecida pelo Snowflake caso o respondente primário OCSP não possa ser alcançado. A maioria das versões mais recentes dos clientes Snowflake acessam o cache OCSP em vez de conectar-se diretamente ao respondenteOCSP.

OCSP_CACHE_REGIONLESS

Fonte alternativa de informações de certificado OCSP para sua organização fornecida pelo Snowflake. A maioria das versões mais recentes dos clientes Snowflake acessam o cache OCSP em vez de conectar-se diretamente ao respondenteOCSP.

OCSP_CLIENT_FAILOVER

Fonte alternativa fornecida pelo Snowflake de informações do certificado OCSP para redirecionamento do cliente.

DUO_SECURITY

O nome do host para o serviço Duo Security que é usado com Autenticação multifator (MFA) enquanto se autentica ao Snowflake.

OCSP_RESPONDER

Nome do host a ser contatado para verificar se o certificado OCSP TLS não foi revogado.

Observe que este valor não é necessário ao configurar a conectividade privada ao serviço Snowflake; siga as instruções no tópico correspondente para selecionar o valor OCSP a ser adicionado à sua lista de permissões.

SNOWSIGHT_DEPLOYMENT_REGIONLESS

Nome do host e número de porta de sua organização para acessar o Snowsight.

Para obter mais informações, consulte Identificadores de conta e Snowsight: a interface da Web do Snowflake.

SNOWSIGHT_DEPLOYMENT

Nome do host e porta de acesso do Snowsight para sua conta Snowflake.

host

Especifica o nome completo do nome do host para type (por exemplo, "xy12345.east-us-2.azure.snowflakecomputing.com", "ocsp.snowflakecomputing.com").

port

Especifica o número da porta para type (por exemplo, 443, 80).

Notas de uso¶

A saída pode incluir múltiplas entradas para certos tipos (STAGE etc.).

Exemplos¶

Para chamar a função:

SELECT SYSTEM$ALLOWLIST_PRIVATELINK();
Copy
Exemplo de saída:
[
  {"type":"SNOWFLAKE_DEPLOYMENT", "host":"xy12345.us-west-2.privatelink.snowflakecomputing.com","port":443},
  {"type":"STAGE",                "host":"sfc-ss-ds2-customer-stage.s3.us-west-2.amazonaws.com","port":443},
  ...
  {"type":"SNOWSQL_REPO",         "host":"sfc-repo.snowflakecomputing.com",                     "port":443},
  ...
  {"type":"OUT_OF_BAND_TELEMETRY","host":"client-telemetry.snowflakecomputing.com","port":443},
  {"type":"OCSP_CACHE",           "host":"ocsp.station00752.us-west-2.privatelink.snowflakecomputing.com","port":80}
]
Copy
Nesta exemplo de saída, observe o seguinte:

Para facilitar a leitura, foram acrescentados espaços em branco e caracteres de nova linha. Além disso, algumas entradas foram omitidas.

A ID da região (us-west-2) em alguns dos nomes de host indica que a conta está região oeste dos US; no entanto, a ID da região não é utilizada no nome do host para SNOWFLAKE_DEPLOYMENT.

Para extrair as informações na saída tabular em vez de JSON, use a função FLATTEN em conjunto com a função PARSE_JSON:

SELECT t.VALUE:type::VARCHAR as type,
       t.VALUE:host::VARCHAR as host,
       t.VALUE:port as port
FROM TABLE(FLATTEN(input => PARSE_JSON(SYSTEM$ALLOWLIST_PRIVATELINK()))) AS t;

Copy

Exemplo de saída:

+-----------------------+---------------------------------------------------+------+
| TYPE                  | HOST                                              | PORT |
+-----------------------+---------------------------------------------------+------+
| SNOWFLAKE_DEPLOYMENT  | xy12345.snowflakecomputing.com                    | 443  |
| STAGE                 | sfc-customer-stage.s3.us-west-2.amazonaws.com     | 443  |
  ...
| SNOWSQL_REPO          | sfc-repo.snowflakecomputing.com                   | 443  |
  ...
| OCSP_CACHE            | ocsp.snowflakecomputing.com                       | 80   |
  ...
+-----------------------+---------------------------------------------------+------+

Copy