Configuração de um volume externo¶

Criação de um volume externo¶

As etapas para criar um volume externo dependem do seu provedor de armazenamento em nuvem.

Para obter instruções, consulte os seguintes tópicos:

• Amazon S3

• Google Cloud Storage

• Azure Storage

• S3-compatible storage

Cada volume externo é associado a um Local de armazenamento ativo específico, e um único volume externo pode oferecer suporte a várias tabelas Iceberg. No entanto, o número de volumes externos necessários depende de como você deseja armazenar, organizar e proteger os dados da sua tabela.

Você pode usar um único volume externo se quiser os dados e metadados de todas as suas tabelas Snowflake-Iceberg em subdiretórios no mesmo local de armazenamento (por exemplo, no mesmo bucket S3). Para configurar esses diretórios para tabelas gerenciadas pelo Snowflake, consulte Diretórios de dados e metadados.

Como alternativa, você pode criar vários volumes externos para proteger vários locais de armazenamento de forma diferente. Por exemplo, você pode criar os seguintes volumes externos:

• Um volume externo somente leitura para tabelas Iceberg gerenciadas externamente.

• Um volume externo configurado com acesso de leitura e gravação para tabelas gerenciadas pelo Snowflake.

Verificar um volume externo¶

Verify an external volume to check that Snowflake can successfully authenticate to your storage provider using an external volume that you’ve configured. You can verify an external volume by using SQL or Snowsight.

SELECT SYSTEM$VERIFY_EXTERNAL_VOLUME('my_s3_external_volume');

Definir um volume externo padrão no nível da conta, do banco de dados ou do esquema¶

Você pode definir um volume externo existente como padrão ou definir um novo volume externo como padrão ao criá-lo.

ALTER DATABASE my_database_1
  SET EXTERNAL_VOLUME = 'my_s3_vol';

CREATE ICEBERG TABLE iceberg_reviews_table (
  id STRING,
  product_name STRING,
  product_id STRING,
  reviewer_name STRING,
  review_date DATE,
  review STRING
)
CATALOG = 'SNOWFLAKE'
BASE_LOCATION = 'my/product_reviews/';

Conceder privilégios USAGE para um volume externo usando o Snowsight¶

O privilégio USAGE permite fazer referência ao volume externo e exibir os detalhes dele. Para obter mais informações, consulte Privilégios de volume externo.

Para conceder privilégios USAGE a um volume externo usando o Snowsight, siga estas etapas:

1. Faça login no Snowsight.

2. Alterne para uma função que tenha os privilégios OWNERSHIP no volume externo ao qual deseja conceder os privilégios USAGE.

   Para obter instruções sobre como alternar de função, consulte Mudar sua função primária. Para obter mais informações sobre o privilégio OWNERSHIP, consulte Privilégios de volume externo.

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

4. Select the External volumes tab.

5. Select the external volume that you want to grant USAGE privileges on.

6. Selecione + Privilege.

7. No campo Roles, selecione a função em que deseja conceder o privilégio USAGE para o volume externo.

8. No campo Privileges, selecione USAGE.

9. Selecione Grant privileges.

Adicionar um local de armazenamento usando o Snowsight¶

Para adicionar um local de armazenamento nomeado a um volume externo usando o Snowsight, siga estas etapas:

1. Faça login no Snowsight.

2. Alterne para uma função que tenha o privilégio OWNERSHIP no volume externo para o qual deseja adicionar um local de armazenamento.

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

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

4. Select the External volumes tab.

5. Select the external volume that you want to add a storage location to.

6. Selecione … » Add storage location

7. Selecione seu provedor de armazenamento em nuvem e especifique a configuração para o local de armazenamento que você está adicionando:

   Amazon S3Microsoft AzureGoogle CloudS3 Compatible

   1. Selecione a guia Amazon S3.

   2. Especifique a configuração para o local de armazenamento que você está adicionando:

      Campo	Descrição
      Location name	Digite um nome para seu local de armazenamento adicional.
      Region type	Especifica o provedor de armazenamento em nuvem que armazena seus arquivos de dados. Standard (default): armazenamento S3 em regiões públicas da AWS fora da China. Government (GovCloud): armazenamento S3 em regiões governamentais da AWS.
      S3 role ARN	Especifica o Amazon Resource Name (ARN) que diferencia maiúsculas e minúsculas da função AWS de gerenciamento de identidade e acesso (IAM) que concede privilégios no bucket S3 que contém seus arquivos de dados. Você registrou esse valor quando criou uma função de IAM.
      Encryption (optional)	Especifica o tipo de criptografia utilizado. Os valores possíveis são: None (default): sem criptografia. SSE-S3: criptografia no lado do servidor usando chaves de criptografia gerenciadas por S3. Para obter mais informações, consulte `Como usar a criptografia no lado do servidor com chaves de criptografia gerenciadas pelo Amazon S3 (SSE-S3)<https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingServerSideEncryption.html>`_. SSE-KMS (enter key): criptografia do lado do servidor usando chaves armazenadas em KMS. Para obter mais informações, consulte Como usar criptografia no lado do servidor com o serviço de gerenciamento de chaves AWS (SSE-KMS).
      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 Amazon Web Services. Os valores possíveis são: Public (default): usar a internet pública. Private (AWS PrivateLink): usar a conectividade privada de saída.
      Storage base URL	Especifica o URL base para seu local de armazenamento adicional.

8. Selecione Add storage location.