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

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS¶

Restaura um ponto de extremidade de conectividade privada no Snowflake VPC ou VNet para permitir que o Snowflake se conecte a um recurso do serviço de gerenciamento de chaves (KMS) externo usando conectividade privada. O ponto de extremidade pode ser um ponto de extremidade de servidor ou um ponto de extremidade de recurso, dependendo da plataforma de nuvem que hospeda sua conta Snowflake.

É possível restaurar um ponto de extremidade privado em até 7 dias após o desprovisionamento. Após 7 dias, o ponto de extremidade não poderá ser restaurado e você precisará recriar o ponto de extremidade com a função do sistema SYSTEM$PROVISION_PRIVATELINK_ENDPOINT_TSS.

Sintaxe¶

AWS:

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  '<provider_service_name>'
  )

Azure:

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  '<provider_resource_id>'
  )

Google Cloud:

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  '<target_service_id>'
  )

Argumentos¶

AWS:

provider_service_name: Especifica o ponto de extremidade de recurso do KMS a ser restaurado.

Azure:

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

Google Cloud:

target_service_id: Specifies the service attachment ID (to a custom service), or regional Google API endpoint to connect to.

Retornos¶

Retorna uma mensagem de status informando que o ponto de extremidade, com seu identificador, foi restaurado com sucesso.

Se não for bem-sucedido, você retornará um erro – por exemplo, se o argumento fornecido não for um ponto de extremidade existente válido. Se você não souber o nome do ponto de extremidade, poderá usar a função do sistema SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO para listar todos os pontos de extremidade em sua conta Snowflake.

Requisitos de controle de acesso¶

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

Notas de uso¶

Uma mensagem de erro ocorre se um ponto de extremidade de conectividade privada não estiver associado aos argumentos especificados.

Exemplos¶

AWS:

Restaure um ponto de extremidade privado com acesso externo a um armazenamento de chaves da AWS.

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  'com.amazonaws.us-west-2.s3'
);

Azure:

Restaure um ponto de extremidade privado para permitir que o Snowflake no Microsoft Azure se conecte ao cofre de chaves do Azure em sua VNet do Azure:

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  '/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/providers/Microsoft.KeyVault/vaults/TriSecretVault'
);

"Resource Endpoint with id "/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/privatelink-test/providers/Microsoft.KeyVault/vaults/TriSecretVault/privateEndpoints/" restored successfully.

Google Cloud:

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  'cloudkms.us-west2.rep.googleapis.com'
);

Private endpoint with id 'abcd0000000000001234' restored successfully.