Configuração de um volume externo para armazenamento compatível com S3

Para tabelas Apache Iceberg™ gerenciadas externamente ou gerenciadas pelo Snowflake com dados e metadados em armazenamento compatível com S3, você pode configurar um volume externo associado a um local de armazenamento compatível com o Amazon S3.

Pré-requisitos

Para usar o armazenamento compatível com S3 para tabelas Iceberg, você deve ter um ponto de extremidade de API compatível com S3 para o Snowflake. Para obter mais informações, consulte Requisitos para armazenamento compatível com S3.

Criação de um volume externo para armazenamento compatível com S3

Crie um volume externo que especifique um local de armazenamento compatível com S3. Para obter informações sobre os parâmetros compatíveis com S3 no comando CREATE EXTERNAL VOLUME, consulte a sintaxe do comando.

CREATE OR REPLACE EXTERNAL VOLUME ext_vol_s3_compat
  STORAGE_LOCATIONS = (
    (
      NAME = 'my_s3_compat_storage_location'
      STORAGE_PROVIDER = 'S3COMPAT'
      STORAGE_BASE_URL = 's3compat://mybucket/unload/mys3compatdata'
      CREDENTIALS = (
        AWS_KEY_ID = '1a2b3c...'
        AWS_SECRET_KEY = '4x5y6z...'
      )
      STORAGE_ENDPOINT = 'mystorage.com'
    )
  );
Copy

Importante

Se estiver configurando um volume externo para tabelas Iceberg gerenciadas externamente, você deverá adicionar ALLOW_WRITES = FALSE à sintaxe do comando. Essa linha especifica que as operações de gravação não são permitidas para o volume externo. Para obter mais informações, consulte a sintaxe do comando para o comando CREATE EXTERNAL VOLUME.

Atualização de suas credenciais de volume externo

Para alterar ou atualizar as credenciais do volume externo, é possível usar o comando ALTER EXTERNAL VOLUME … UPDATE. Especifique o nome do local de armazenamento para o qual você deseja alterar as credenciais.

ALTER EXTERNAL VOLUME ext_vol_s3_compat UPDATE
  STORAGE_LOCATION = 'my_s3_compat_storage_location'
  CREDENTIALS = (
    AWS_KEY_ID = '4d5e6f...'
    AWS_SECRET_KEY = '7g8h9i...'
  );
Copy