Configuração de um volume externo para o Google Cloud Storage¶

Etapa 1: criar um volume externo no Snowflake¶

Crie um volume externo usando o comando CREATE EXTERNAL VOLUME.

O exemplo a seguir cria um volume externo que define um único local de armazenamento GCS com criptografia:

CREATE EXTERNAL VOLUME my_gcs_external_volume
  STORAGE_LOCATIONS =
    (
      (
        NAME = 'my-us-west-2'
        STORAGE_PROVIDER = 'GCS'
        STORAGE_BASE_URL = 'gcs://mybucket1/path1/'
        ENCRYPTION=(TYPE='GCS_SSE_KMS' KMS_KEY_ID = '1234abcd-12ab-34cd-56ef-1234567890ab')
      )
    );

Etapa 2: Recupere a conta de serviço GCS para sua conta Snowflake¶

Para recuperar o ID da conta de serviço GCS criado automaticamente para sua conta Snowflake, use o comando DESCRIBE EXTERNAL VOLUME. Especifique o nome do volume externo criado anteriormente.

Por exemplo:

DESC EXTERNAL VOLUME my_gcs_external_volume;

Copy

Registre o valor da propriedade STORAGE_GCP_SERVICE_ACCOUNT na saída (por exemplo, service-account-id@project1-123456.iam.gserviceaccount.com).

O Snowflake fornece uma única conta de serviço GCS para toda a sua conta Snowflake. Todos volumes externos GCS usam essa conta de serviço.

Etapa 3: conceder as permissões da conta de serviço para acessar os objetos do bucket¶

Nesta etapa, você configura as permissões de acesso IAM para o Snowflake em seu Google Cloud console.

Etapa 4: verificar o acesso ao armazenamento¶

Para verificar se o Snowflake pode se autenticar com sucesso no seu provedor de armazenamento, chame a função SYSTEM$VERIFY_EXTERNAL_VOLUME.

SELECT SYSTEM$VERIFY_EXTERNAL_VOLUME('my_external_volume');

Error assuming AWS_ROLE:
STS is not activated in this region for account:<external volume id>. Your account administrator can activate STS in this region using the IAM Console.

Etapa 1: recuperar a conta de serviço do GCS para sua conta Snowflake¶

1. Faça login no Snowsight.

2. No canto inferior esquerdo, selecione seu nome » Switch role e, em seguida, ACCOUNTADMIN ou uma função com o privilégio CREATEEXTERNAL VOLUME.

   Para obter mais informações, consulte Mudar sua função primária.

3. No menu de navegação, selecione Catalog » External data.

4. Selecione a guia External volumes.

5. Selecione + Create.

6. Selecione Google Cloud Storage e depois selecione Next.

7. Na página Grant storage access, copie o valor de GCS service account em um editor de texto.

   O Snowflake fornece uma única conta de serviço GCS para toda a sua conta Snowflake. Todos volumes externos GCS usam essa conta de serviço.

Etapa 2: conceder as permissões da conta de serviço para acessar os objetos do bucket¶

Nesta etapa, você configura as permissões de acesso IAM para o Snowflake em seu Google Cloud console.

Etapa 3: criar um volume externo¶

Para criar um volume externo no Snowflake usando o Snowsight, siga estas etapas:

1. Faça login no Snowsight.

2. No canto inferior esquerdo, selecione seu nome » Switch role e, em seguida, ACCOUNTADMIN ou uma função com o privilégio CREATEEXTERNAL VOLUME.

   Para obter instruções, consulte Mudar sua função primária.

3. No menu de navegação, selecione Catalog » External data.

4. Selecione a guia External volumes.

5. Selecione + Create.

6. Selecione Google Cloud Storage e depois selecione Next.

7. Selecione Next.

   Nota

   Você já concedeu acesso ao armazenamento quando recuperou a conta de serviço do GCS para sua conta Snowflake e atribuiu a função personalizada à conta de serviço do GCS.

8. Para configurar o volume externo, na página Configure external volume, preencha os campos:

   Campo	Descrição
   External volume name	Insira um nome para seu volume externo.
   Storage base URL	Especifica o URL base para seu local de armazenamento em nuvem.
   Encryption (optional)	Especifica o tipo de criptografia utilizado. Os valores possíveis são: None (default): sem criptografia. SSE-KMS (enter key): criptografia do lado do servidor usando chaves armazenadas em KMS. Para obter mais informações, consulte chaves de criptografia gerenciadas pelo cliente.
   Access scope	Especifica se as operações de gravação são permitidas para o volume externo. Deve ser definido como Allow writes para as seguintes tabelas: Tabelas Iceberg que usam o Snowflake como catálogo. Tabelas Iceberg que usam um catálogo externo e são graváveis. As tabelas Iceberg gerenciadas externamente são graváveis quando você as acessa por meio de um banco de dados vinculado a catálogo que tem o parâmetro ALLOWED_WRITE_OPERATIONS definido como TRUE. Para tabelas Iceberg criadas de arquivos de tabela Delta, definir esse parâmetro como Allow writes permite que o Snowflake grave metadados Iceberg em seu armazenamento externo. Para obter mais informações, consulte Tabelas baseadas em Delta. O valor deste campo também deve corresponder às permissões definidas na conta de armazenamento em nuvem para cada local de armazenamento especificado. Nota Se você planeja usar o volume externo para ler tabelas Iceberg gerenciadas externamente, pode definir este campo como desativado. O Snowflake não grava dados ou arquivos de metadados Iceberg no seu armazenamento em nuvem quando você lê tabelas em um catálogo Iceberg externo.
   Scope	Escolha onde este volume externo deve se tornar o local padrão para futuras tabelas Iceberg. Os valores possíveis são: Do not set a default: não defina o volume externo como padrão em nenhum lugar. Account: defina o volume externo como padrão para tabelas Iceberg criadas no âmbito da conta. Specific database: defina o volume externo como padrão para tabelas Iceberg criadas no banco de dados que você especificar. Para especificar esse banco de dados, use o menu suspenso Database que aparece quando você seleciona Specific database. Specific schema: defina o volume externo como padrão para tabelas Iceberg criadas no esquema que você especificar. Para especificar esse esquema, use o menu suspenso Database que aparece para selecionar primeiro o banco de dados pai do esquema e, em seguida, o esquema.
   Comment (optional)	Especifica um comentário para o volume externo.
   Connectivity	Especifica se a conectividade privada de saída deve ser usada para reforçar sua postura de segurança. Para obter informações sobre como usar esse parâmetro, consulte Conectividade privada com volumes externos para Google Cloud. Os valores possíveis são: Public (default): usar a internet pública. Private (Private Service Connect): usar a conectividade privada de saída.

9. Selecione Next.

   Na página Verify connection & create volume, o Snowflake verifica sua conexão com o Google Cloud Storage e exibe uma mensagem de «conexão bem-sucedida».

   Nota

   Se o Snowflake não puder verificar a conexão, confira sua permissão ou a configuração de volume externo e selecione Verify again.

10. Selecione Create.