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:
Bancos de dados vinculados a catálogos e descoberta automática de tabelas
Suporte à gravação para tabelas Iceberg gerenciadas externamente
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¶
This section describes the connection options for Iceberg REST catalogs.
Vended credentials¶
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.
Private connectivity¶
Snowflake supports connecting to Iceberg REST catalogs through private connectivity.
However, when you connect to the catalog through private connectivity, you must use an external volume to connect to the catalog data.
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:
Snowflake Open Catalog. Essas instruções também se aplicam ao Apache Polaris™.
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.