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:

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;
Copy
  • 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.table1 Iceberg registrada no Snowflake e especificar catalog1 na 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.