Configurar uma integração de catálogo para catálogos Apache Iceberg™ REST

Uma integração de catálogo |iceberg-tm| REST permite que o Snowflake acesse Tabelas Apache Iceberg™ gerenciado em um catálogo remoto que esteja em conformidade com a especificação Apache Iceberg REST OpenAPI de código aberto.

O Snowflake aceita os seguintes recursos adicionais quando você usa uma integração de catálogo Iceberg REST:

Métodos de autenticação

O Snowflake oferece suporte aos seguintes métodos de autenticação para catálogos do Iceberg REST:

  • OAuth

  • Token de portador ou token de acesso pessoal (PAT)

  • Signature Version 4 (SigV4)

Os métodos de autenticação compatíveis variam de acordo com a origem do catálogo.

Rotação de credenciais

Para girar as credenciais de uma integração de catálogo, você pode usar o comando ALTER CATALOG INTEGRATION para atualizar as credenciais que o Snowflake usa para se autenticar no catálogo remoto.

Por exemplo:

ALTER CATALOG INTEGRATION my_cat_int SET
  REST_AUTHENTICATION (
    OAUTH_CLIENT_SECRET = 'myNewSecret'
  );

Opções de conexão

Esta seção descreve as opções de conexão para catálogos Iceberg REST.

Credenciais fornecidas

Além de volumes externos, o Snowflake oferece suporte às seguintes opções de conexão para catálogos Iceberg REST:

As opções de conexão compatíveis variam de acordo com a origem do catálogo.

Conectividade privada

O Snowflake é compatível com a conexão com catálogos Iceberg REST por meio de conectividade privada.

No entanto, ao se conectar ao catálogo por meio de conectividade privada, você deve usar um volume externo para se conectar aos dados do catálogo.

As opções de conexão compatíveis variam de acordo com a origem do catálogo.

Fontes do catálogo

O Snowflake é compatível com qualquer servidor de catálogo externo que esteja em conformidade com a especificação Iceberg REST.

Os tópicos a seguir fornecem exemplos de catálogos REST comumente usados:

Navegação em um catálogo remoto

Após criar uma integração de catálogo para Iceberg REST, você pode usar as seguintes funções do sistema Snowflake para pesquisar namespaces e tabelas no catálogo:

Migração de uma tabela para uma integração de catálogo REST para Iceberg

Depois de criar uma integração de catálogo REST para Iceberg, se necessário, você pode substituir a integração de catálogo associada a uma tabela Iceberg gerenciada externamente em um banco de dados Snowflake padrão pela integração de catálogo que você criou. Para obter instruções, consulte SYSTEM$SET_CATALOG_INTEGRATION.

Criar um banco de dados vinculado a catálogo

Depois de criar uma integração de catálogo para o Iceberg REST, você pode criar um banco de dados vinculado a catálogo para trazer os dados do seu catálogo remoto do Iceberg REST para o Snowflake. Ao criar o banco de dados vinculado a catálogo, especifique o nome da integração de catálogo que você criou como o catálogo.

Um banco de dados vinculado a catálogo descobre automaticamente e permanece sincronizado com os namespaces e as tabelas do seu catálogo remoto. Você pode usar um banco de dados vinculado a catálogo para ler e gravar nas tabelas do seu catálogo remoto a partir do Snowflake, preservando a interoperabilidade completa com seu ecossistema Iceberg existente. Para obter mais informações, consulte os seguintes tópicos: