Conectividade privada com volumes externos para Google Cloud¶

Especificar a conectividade privada para um volume externo¶

A propriedade USE_PRIVATELINK_ENDPOINT de um volume externo determina se ele é acessado por meio de conectividade privada ou atravessando a rede pública. Para usar a conectividade privada, defina USE_PRIVATELINK_ENDPOINT = TRUE ao criar ou modificar um volume externo, conforme mostrado nos exemplos a seguir.

Use a seguinte sintaxe para criar um volume externo:

CREATE OR REPLACE EXTERNAL VOLUME <ext_volume_name>
  STORAGE_LOCATIONS =
  (
    (
      NAME = 'my-gcs-loc'
      STORAGE_PROVIDER = 'gcs'
      STORAGE_BASE_URL = 'gcs://<bucket>/<prefix>/'
      USE_PRIVATELINK_ENDPOINT = [ TRUE | FALSE ]
    )
  )
  ALLOW_WRITES=true;

Use a seguinte sintaxe para alterar um volume externo que já existe:

ALTER EXTERNAL VOLUME <ext_volume_name>
  UPDATE STORAGE_LOCATION = '<storage_location_name>'
  USE_PRIVATELINK_ENDPOINT = [ TRUE | FALSE ]

O comando DESCRIBE EXTERNAL VOLUME inclui a propriedade USE_PRIVATELINK_ENDPOINT e seu valor.

Provisionar um ponto de extremidade privado¶

Siga as etapas a seguir para provisionar um ponto de extremidade privado para seu volume do Google Cloud Storage:

1. No Snowflake, chame a função de sistema SYSTEM$PROVISION_PRIVATELINK_ENDPOINT. Forneça como argumentos um ponto de extremidade regional da API Storage e o nome do host. Por exemplo:

   USE ROLE ACCOUNTADMIN;
   
   SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
     'storage.us-east4.rep.googleapis.com',
     'storage.us-east4.rep.googleapis.com');
   

   Copy

   Nota

   O Snowflake oferece suporte apenas aos pontos de extremidade regionais da API Storage do Google Cloud. Os buckets multirregionais do|google-cloud| não são compatíveis.

   Use SYSTEM$PROVISION_PRIVATELINK_ENDPOINT para provisionar um ponto de extremidade privado no Snowflake VNet para que o Snowflake possa se conectar ao Google Cloud Storage externo pela conectividade privada. Somente os buckets referenciados por um volume externo com a propriedade USE_PRIVATELINK_ENDPOINT ativada podem ser acessados usando o ponto de extremidade.

2. No Snowflake, chame a função SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO.

   Se a saída de SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO incluir “status”: “APPROVED”, sua conexão do Snowflake com a conta de armazenamento poderá usar a conectividade privada.

   É possível continuar com as próximas etapas enquanto aguarda o status "APPROVED".

Configuração de acesso ao volume externo¶

Siga as etapas a seguir para configurar a conectividade privada com seu volume de armazenamento externo:

1. Crie o volume externo e defina a propriedade USE_PRIVATELINK_ENDPOINT como TRUE. Por exemplo:

   CREATE EXTERNAL VOLUME external_volume
     STORAGE_LOCATIONS =
     (
       (
         NAME = 'my-gcs-loc'
         STORAGE_PROVIDER = 'gcs'
         STORAGE_BASE_URL =  'gcs://<bucket>/<prefix>/'
         USE_PRIVATELINK_ENDPOINT = true
       )
     )
     ALLOW_WRITES=true;
   

   Copy

2. Use o comando CREATE ICEBERG TABLE para criar uma tabela Iceberg que faça referência ao volume externo. Por exemplo:

   CREATE ICEBERG TABLE rand_table (data STRING)
     BASE_LOCATION='table'
     EXTERNAL_VOLUME=external_volume
     CATALOG='snowflake';
   

   Copy

3. Depois que o ponto de extremidade privado tiver o status APPROVED, teste o descarregamento de dados do Snowflake para o volume externo.