Configurar uma integração de catálogo para o Snowflake Open Catalog¶
Nota
Essas instruções também se aplicam à configuração de uma integração de catálogo para o Apache Polaris™.
Crie uma integração de catálogo para o Snowflake Open Catalog, que você pode usar para consultar uma tabela no Snowflake Open Catalog usando o Snowflake ou sincronizar uma tabela gerenciada pelo Snowflake com o Open Catalog. Para obter mais informações, consulte Usar tabelas Apache Iceberg™ com o Snowflake Open Catalog no Snowflake.
Uma integração de catálogo para o Open Catalog está associada a um catálogo específico e a uma conexão de serviço na sua conta Open Catalog.
Para obter mais informações sobre a criação de uma integração de catálogo para conectar o Open Catalog ao Snowflake, consulte os tópicos a seguir:
Consultar uma tabela no Snowflake Open Catalog usando o Snowflake
Sincronizar uma tabela gerenciada pelo Snowflake com Snowflake Open Catalog
Exemplo: crie uma integração de catálogo para o Open Catalog¶
Para criar uma integração de catálogo para o Open Catalog, use o comando CREATE CATALOG INTEGRATION.
Por exemplo:
CREATE OR REPLACE CATALOG INTEGRATION my_open_catalog_int
CATALOG_SOURCE = POLARIS
TABLE_FORMAT = ICEBERG
CATALOG_NAMESPACE = 'myOpenCatalogCatalogNamespace'
REST_CONFIG = (
CATALOG_URI = 'https://ABCDEFG-ACCOUNT1.snowflakecomputing.com/polaris/api/catalog'
CATALOG_NAME = 'myOpenCatalogExternalCatalogName'
)
REST_AUTHENTICATION = (
TYPE = OAUTH
OAUTH_CLIENT_ID = 'myClientId'
OAUTH_CLIENT_SECRET = 'myClientSecret'
OAUTH_ALLOWED_SCOPES = ('PRINCIPAL_ROLE:ALL')
)
ENABLED = TRUE;
O valor para CATALOG_URI é seu URL de conta Open Catalog. Para obter mais informações, consulte a descrição do parâmetro CATALOG_URI.
Se você estiver sincronizando uma tabela gerenciada pelo Snowflake com o Open Catalog, o parâmetro CATALOG_NAMESPACE não é necessário e não afeta a forma como você sincroniza a tabela com o Open Catalog. O Snowflake sincroniza a tabela com o catálogo externo no Open Catalog que você especifica na integração do catálogo, juntamente com seu namespace pai do Snowflake.
Por exemplo, se você tiver uma tabela
db1.public.table1Iceberg registrada no Snowflake e especificarcatalog1na integração do catálogo, o Snowflake sincronizará a tabela com Open Catalog com o seguinte nome totalmente qualificado:catalog1.db1.public.table1.
Nota
Para verificar sua configuração de autenticação, consulte Check a configuration for OAuth.