SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME¶

Sintaxe¶

AWS:

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME( '<provider_service_name>' , '<host_name>' )

Azure:

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME( '<provider_resource_id>' , '<host_name>' , [ , '<subresource>' ] )

Google Cloud:

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME( '<target_service_id>' , '<host_name>' )

Argumentos¶

AWS:

'provider_service_name'

Especifica o serviço ou recurso externo ao qual você deve se conectar. Por exemplo, com.amazonaws.us-west-2.execute-api para o Amazon API Gateway ou com.amazonaws.us-west-2.s3 para o Amazon S3.

Para obter informações sobre como recuperar esse valor no AWS, consulte Provisionar pontos de extremidade de conectividade privada.

'host_name'

Especifica o novo nome de host totalmente qualificado que deve ser usado para acessar o recurso em sua VPC ou VNet.

Esse valor não contém nenhum número de porta e deve corresponder ao que você especificou no objeto Snowflake que você usa para se conectar ao serviço externo.

Os exemplos incluem bedrock-runtime.us-west-2.amazonaws.com e *.s3.us-west-2.amazonaws.com.

Quando você usa a conectividade privada para estágios externos e volumes externos, o host_name deve usar um curinga em vez de especificar um bucket S3 da AWS.

Para obter informações sobre como recuperar esse valor no AWS, consulte Provisionar pontos de extremidade de conectividade privada.

Azure:

'provider_resource_id'

Especifica o identificador totalmente qualificado do recurso em sua VPC ou VNet.

'host_name'

Especifica o nome do host totalmente qualificado para acessar o recurso em sua VPC ou VNet.

Para obter exemplos do nome de host para conectividade privada de saída para funções externas, consulte o seguinte:

• Portal do Azure

• Modelo do Azure ARM.

'subresource'

Especifica o nome do sub-recurso do recurso do Azure.

Esse argumento não é necessário para o Azure Private Link Service e o Azure API Management Service.

Para todos os valores compatíveis, consulte a Tabela sub-recursos.

Google Cloud:

'target_service_id'

Especifica o ID do anexo do serviço (para um serviço personalizado) ou regional do ponto de extremidade da API do Google para se conectar.

'host_name'

Especifica o novo nome de host totalmente qualificado para acessar o recurso.

Retornos¶

Retorna uma mensagem de status informando que o nome do host do ponto de extremidade de conectividade privada foi atualizado com sucesso.

Requisitos de controle de acesso¶

Somente administradores de conta (usuários com a função ACCOUNTADMIN) podem chamar esta função.

Notas de uso¶

• Você só pode modificar o nome do host de um ponto de extremidade de conectividade privada existente.

Exemplos¶

AWS:

Atualizar o nome de host de um ponto de extremidade privado para permitir o Snowflake na Amazon Web Services para conectar-se ao serviço VPCE em sua VPC da Amazon Web Services:

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  'com.amazonaws.vpce.us-west-2.vpce-svc-01234567890abcdef',
  'my-new-service-name.com'
  );

Copy

Successfully set the host name of the privatelink endpoint ``com.amazonaws.vpce.us-west-2.vpce-svc-01234567890abcdef`` to ``my-new-service-name.com``

Azure:

Provisione um ponto de extremidade privado para permitir que o Snowflake no Microsoft Azure se conecte ao serviço Microsoft Azure API Management na sua VNet do Microsoft Azure:

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  '/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api',
  'my-new-custom-api-endpoint.net',
  'Gateway'
  );

Copy

Successfully set the host name of the privatelink endpoint ``/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api`` to ``my-new-custom-api-endpoint.net``

Google Cloud:

Atualizar o nome do host de um ponto de extremidade privado para permitir o Snowflake no Google Cloud Platform para conectar-se ao anexo de serviço em sua rede VPC do Google Cloud Platform:

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  'projects/my-project/regions/us-west2/serviceAttachments/my-http-server',
  'my-new-custom-api-endpoint.com'
  );

Copy

Successfully set the host name of the privatelink endpoint ``projects/my-project/regions/us-west2/serviceAttachments/my-http-server`` to ``my-new-custom-api-endpoint.com``