CREATE CATALOG INTEGRATION (Snowflake Postgres)¶

Cria uma nova integração de catálogo na conta ou substitui uma integração de catálogo existente para o Snowflake Postgres acessar tabelas Apache Iceberg™ gerenciadas por uma instância do Snowflake Postgres.

Consulte também:: ALTER CATALOG INTEGRATION, DROP CATALOG INTEGRATION, SHOW CATALOG INTEGRATIONS, DESCRIBE CATALOG INTEGRATION

Sintaxe¶

CREATE [ OR REPLACE ] CATALOG INTEGRATION [ IF NOT EXISTS ] <name>
  CATALOG_SOURCE = SNOWFLAKE_POSTGRES
  TABLE_FORMAT = ICEBERG
  [ CATALOG_NAMESPACE = '<namespace>' ]
  REST_CONFIG = (
    restConfigParams
  )
  ENABLED = { TRUE | FALSE }
  [ COMMENT = '<string_literal>' ]

Onde:

restConfigParams ::=

POSTGRES_INSTANCE = '<instance_name>'
ACCESS_DELEGATION_MODE = VENDED_CREDENTIALS
[ CATALOG_NAME = '<database_name>' ]

Parâmetros¶

name

Cadeia de caracteres que especifica o identificador (nome) para a integração de catálogo; deve ser única em sua conta.

Além disso, o identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

CATALOG_SOURCE = SNOWFLAKE_POSTGRES

Especifica que a fonte do catálogo é uma instância do Snowflake Postgres.

TABLE_FORMAT = ICEBERG

Especifica ICEBERG como o formato de tabela fornecido pelo catálogo.

CATALOG_NAMESPACE = 'namespace'

Opcionalmente, especifica o namespace do esquema padrão para tabelas descobertas por esta integração de catálogo. Por exemplo, 'public'.

ENABLED = { TRUE | FALSE }

Especifica se a integração do catálogo está disponível para uso em tabelas Iceberg.

TRUE permite que os usuários criem novas tabelas Iceberg que fazem referência a esta integração.

FALSE impede que os usuários criem novas tabelas Iceberg que referenciem esta integração.

O valor não diferencia maiúsculas e minúsculas.

O padrão é TRUE.

COMMENT = 'string_literal'

Cadeia de caracteres (literal) que especifica um comentário da integração.

Padrão: sem valor

Parâmetros de configuração REST (restConfigParams)¶

POSTGRES_INSTANCE = 'instance_name': Especifica o nome da instância do Snowflake Postgres. Obrigatório. A instância do Postgres deve estar no estado READY. Para criar uma instância do Postgres, consulte CREATE POSTGRES INSTANCE.
ACCESS_DELEGATION_MODE = VENDED_CREDENTIALS: Especifica o modo de delegação de acesso para acessar dados e metadados de tabela no armazenamento em nuvem. O único valor aceito é VENDED_CREDENTIALS.
CATALOG_NAME = 'database_name': Opcionalmente, especifica o nome do banco de dados Postgres padrão. É possível substituir esse valor por tabela ou por banco de dados vinculado a catálogo.

Requisitos de controle de acesso¶

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:


Privilégio	Objeto	Notas
CREATE INTEGRATION	Conta	Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.
USAGE	Instância do Postgres	Necessário na instância do Postgres especificada por `POSTGRES_INSTANCE`.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Exemplos¶

O exemplo a seguir cria uma integração de catálogo para uma instância do Snowflake Postgres:

CREATE CATALOG INTEGRATION my_postgres_catalog_int
  CATALOG_SOURCE = SNOWFLAKE_POSTGRES
  TABLE_FORMAT = ICEBERG
  CATALOG_NAMESPACE = 'public'
  REST_CONFIG = (
    POSTGRES_INSTANCE = 'my_pg_instance'
    ACCESS_DELEGATION_MODE = VENDED_CREDENTIALS
    CATALOG_NAME = 'my_database'
  )
  ENABLED = TRUE;