ALTER EXTERNAL ACCESS INTEGRATION

修改现有 外部访问集成 的属性。

另请参阅：

CREATE EXTERNAL ACCESS INTEGRATION、DROP INTEGRATION、SHOW INTEGRATIONS、DESCRIBE INTEGRATION

语法

ALTER EXTERNAL ACCESS INTEGRATION [ IF EXISTS ] <name> SET
  [ ALLOWED_NETWORK_RULES = (<rule_name> [ , <rule_name> ... ]) ]
  [ ALLOWED_API_AUTHENTICATION_INTEGRATIONS = ( { <integration_name_1> [, <integration_name_2>, ... ] | none } ) ]
  [ ALLOWED_AUTHENTICATION_SECRETS = ( { <secret_name> [ , <secret_name> ... ] | all | none } ) ]
  [ ENABLED = { TRUE | FALSE } ]
  [ COMMENT = '<string_literal>' ]
  [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]

ALTER EXTERNAL ACCESS INTEGRATION [ IF EXISTS ] <name> UNSET {
  ALLOWED_NETWORK_RULES |
  ALLOWED_API_AUTHENTICATION_INTEGRATIONS |
  ALLOWED_AUTHENTICATION_SECRETS |
  COMMENT |
  TAG <tag_name> }
  [ , ... ]
Copy

参数

name

要更改的外部访问集成的标识符。如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

SET ...

指定要为集成设置的属性：

ALLOWED_NETWORK_RULES = (rule_name [ , rule_name ... ])

指定允许的网络规则。只能指定出口规则。

有关网络规则的参考信息，请参阅 CREATE NETWORK RULE。

ALLOWED_API_AUTHENTICATION_INTEGRATIONS = ( integration_name_1 [, integration_name_2, ... ] | none )

指定安全集成，其 OAuth 授权服务器发布了 UDF 或程序所使用的密钥。安全集成必须是用于外部 API 集成的类型。

有关安全集成的参考信息，请参阅 CREATE SECURITY INTEGRATION（外部 API 身份验证）。

ALLOWED_AUTHENTICATION_SECRETS = (secret_name [ , secret_name ... ] | all | none )

指定 UDF 或过程可以在引用此集成时使用的密钥。

有关密钥的参考信息，请参阅 CREATE SECRET。

ENABLED = { TRUE | FALSE }

指定是启用还是禁用此集成。如果禁用了集成，则任何依赖集成的处理程序代码都将无法到达外部端点。

该值不区分大小写。

默认为 TRUE。

COMMENT = 'string_literal'

指定外部访问集成的注释。

默认：无值

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

指定 标签 名称和标签字符串值。

标签值始终为字符串，标签值的最大字符数为 256。

有关在语句中指定标签的信息，请参阅 对象和列的标签配额。

UNSET ...

指定为集成取消设置的属性，这会将其重置为默认值：

  • ALLOWED_NETWORK_RULES

  • ALLOWED_API_AUTHENTICATION_INTEGRATIONS

  • ALLOWED_AUTHENTICATION_SECRETS

  • COMMENT

  • TAG tag_name

您可以使用单个 ALTER 语句重置多个属性/参数；但是，每个属性/参数 必须 用逗号分隔。重置属性/参数时，请仅指定名称；指定属性的值将返回错误。

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限：

权限

对象

备注

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 中的元数据字段。

示例

将允许的密钥设置为 my_new_secret 密钥：

ALTER EXTERNAL ACCESS INTEGRATION IF EXISTS dev_integration
  SET ALLOWED_AUTHENTICATION_SECRETS = (my_new_secret);
Copy

禁用 dev_integration_disabled 集成：

ALTER EXTERNAL ACCESS INTEGRATION IF EXISTS dev_integration_disabled
  SET ENABLED = FALSE;

ALTER EXTERNAL ACCESS INTEGRATION IF EXISTS dev_integration_disabled
  SET COMMENT = 'Disabled until the end of the Q1.';
Copy
语言: 中文