CREATE CATALOG INTEGRATION (SAP® Business Data Cloud)

Cria uma nova integração de catálogo na conta ou substitui uma integração de catálogo existente para o SAP® Business Data Cloud interagir com os produtos de dados SAP® gerenciados no armazenamento de objetos do SAP® Business Data Cloud.

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 = SAP_BDC
  TABLE_FORMAT = DELTA
  REST_CONFIG = (
    restConfigParams
  )
  ENABLED = { TRUE | FALSE }
  [ REFRESH_INTERVAL_SECONDS = <value> ]
  [ COMMENT = '<string_literal>' ]
Copy

Onde:

restConfigParams ::=

SAP_BDC_INVITATION_LINK = '<Invitation Link from SAP BDC>'
[ ACCESS_DELEGATION_MODE = { VENDED_CREDENTIALS } ]
Copy

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 = SAP_BDC

Especifica a fonte do catálogo como SAP® Business Data Cloud.

TABLE_FORMAT = DELTA

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

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.

REFRESH_INTERVAL_SECONDS = <value>

Especifica o número de segundos que o Snowflake aguarda entre as tentativas de pesquisar o catálogo do SAP® Business Data Cloud por atualizações de metadados para atualização automatizada.

Valores: 30 a 86400, inclusivo

Padrão: 30 segundos

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)

ACCESS_DELEGATION_MODE = VENDED_CREDENTIALS

Especifica o modo de delegação de acesso que será usado para acessar arquivos de tabela do SAP® Business Data Cloud. A única opção permitida é VENDED_CREDENTIALS.

SAP_BDC_INVITATION_LINK = VENDED_CREDENTIALS

Especifica o link de convite obtido do SAP for Me conforme documentado em Provisionando o SAP Business Data Cloud Connect

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.

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 e a registra com o SAP® Business Data Cloud.

CREATE OR REPLACE CATALOG INTEGRATION MY_SAP_BDC_CATALOG_INT
  CATALOG_SOURCE = SAP_BDC
  TABLE_FORMAT = DELTA
  REST_CONFIG = (
    SAP_BDC_INVITATION_LINK = '<Invitation URL from SAP BDC>'
    ACCESS_DELEGATION_MODE = VENDED_CREDENTIALS
  )
  ENABLED = TRUE
  COMMENT = 'My SAP BDC catalog integration'
  ;
Copy