ALTER CATALOG INTEGRATION

修改现有 目录集成 的属性。

另请参阅：

CREATE CATALOG INTEGRATION、DESCRIBE CATALOG INTEGRATION、DROP CATALOG INTEGRATION、SHOW CATALOG INTEGRATIONS

语法

ALTER CATALOG INTEGRATION [ IF EXISTS ] <name> SET
  REST_AUTHENTICATION = (
    restAuthenticationParams
  )
  [ REFRESH_INTERVAL_SECONDS = <value> ]
  [ COMMENT = '<string_literal>' ]
Copy

restAuthenticationParams 如下，具体取决于您的身份验证方法：

OAuth

restAuthenticationParams (for OAuth) ::=

  OAUTH_CLIENT_SECRET = '<oauth_client_secret>'
Copy

持有者令牌

restAuthenticationParams (for Bearer token) ::=

  BEARER_TOKEN = '<bearer_token>'
Copy

参数

name

指定要更改的目录集成的标识符。

如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅 标识符要求。

SET ...

为目录集成设置一个或多个指定的属性或参数：

REFRESH_INTERVAL_SECONDS = value

指定 Snowflake 在尝试轮询外部 Iceberg 目录期间等待的秒数，该轮询旨在获取用于 自动刷新 的元数据更新。

对于基于 Delta 的表，指定 Snowflake 在两次尝试轮询外部云存储以获取新的元数据之间等待的秒数。

值：30 到 86,400（含）

默认值：30 秒

COMMENT = 'string_literal'

字符串（字面量），用于指定集成注释。

默认：无值

REST 身份验证参数 (restAuthenticationParams)

OAuth

OAUTH_CLIENT_SECRET = oauth_client_secret

您的 OAuth2 客户端密钥。

持有者令牌

BEARER_TOKEN = bearer_token

您的身份提供商的持有者令牌。您也可以指定个人访问令牌 (PAT)。

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限

对象

备注

OWNERSHIP

集成（目录）

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 关于元数据：

    注意

    客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

示例

以下示例将自动刷新的刷新间隔时间更新为 30 秒：

ALTER CATALOG INTEGRATION myCatalogIntegration SET REFRESH_INTERVAL_SECONDS = 30;
Copy
语言: 中文