CREATE CATALOG INTEGRATION (Armazenamento de objeto)

Cria uma nova integração de catálogo na conta ou substitui uma integração de catálogo existente para as seguintes fontes:

  • Arquivos de metadados Apache Iceberg™

  • Arquivos de tabela Delta

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 = OBJECT_STORE
  TABLE_FORMAT = { ICEBERG | DELTA }
  ENABLED = { TRUE | FALSE }
  [ COMMENT = '<string_literal>' ]
Copy

Parâmetros obrigatórios

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"). Identificadores entre aspas duplas também diferenciam maiúsculas de minúsculas.

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

CATALOG_SOURCE = OBJECT_STORE

Especifica arquivos de metadados externos Iceberg ou arquivos Delta no armazenamento de objeto como a origem.

TABLE_FORMAT = { ICEBERG | DELTA }

Especifica o formato da tabela.

  • ICEBERG: especifica tabelas Glue Iceberg ou tabelas Iceberg de metadados em um local de armazenamento em nuvem externo.

  • DELTA: Especifica tabelas Delta.

    Recurso em versão preliminar

    As tabelas Iceberg criadas a partir de arquivos de tabelas Delta estão em versão preliminar e disponíveis para todas as contas.

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. As tabelas Iceberg existentes que fazem referência a esta integração funcionam normalmente.

  • FALSE impede que os usuários criem novas tabelas Iceberg que referenciem esta integração. As tabelas Iceberg existentes que fazem referência a esta integração não podem acessar o catálogo na definição da tabela.

Parâmetros opcionais

COMMENT = 'string_literal'

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

Padrão: sem valor

Requisitos de controle de acesso

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

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.

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.

Notas de uso

  • Não é possível modificar uma integração de catálogo existente; use uma instrução CREATE OR REPLACE CATALOG INTEGRATION.

  • Não é possível descartar ou substituir uma integração de catálogo se uma ou mais tabelas Apache Iceberg™ estiverem associadas à integração de catálogo.

    Para visualizar as tabelas que dependem de uma integração de catálogo, você pode usar o comando SHOW ICEBERG TABLES e uma consulta usando RESULT_SCAN que filtra na coluna catalog_name.

    Nota

    O identificador da coluna (catalog_name) diferencia maiúsculas de minúsculas. Especifique o identificador da coluna exatamente como ele aparece na saída SHOW ICEBERG TABLES.

    Por exemplo:

    SHOW ICEBERG TABLES;

SELECT * FROM TABLE(
  RESULT_SCAN(
      LAST_QUERY_ID()
    )
  )
  WHERE "catalog_name" = 'my_catalog_integration_1';
    Copy

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

  • Instruções CREATE OR REPLACE <object> são atômicas. Ou seja, quando um objeto é substituído, o objeto antigo é excluído e o novo objeto é criado em uma única transação.

Exemplos

O exemplo a seguir cria uma integração que usa metadados Iceberg em armazenamento externo em nuvem. OBJECT_STORE corresponde ao armazenamento de objetos associado a um volume externo.

CREATE CATALOG INTEGRATION myCatalogInt
  CATALOG_SOURCE = OBJECT_STORE
  TABLE_FORMAT = ICEBERG
  ENABLED = TRUE;
Copy
Linguagem: Português