ALTER GIT REPOSITORY

修改现有 Git 存储库暂存区 的属性。

另请参阅：

CREATE GIT REPOSITORY、DESCRIBE GIT REPOSITORY、DROP GIT REPOSITORY、SHOW GIT BRANCHES、SHOW GIT REPOSITORIES、SHOW GIT TAGS

语法

ALTER GIT REPOSITORY <name> SET
  [ GIT_CREDENTIALS = <secret_name> ]
  [ API_INTEGRATION = <integration_name> ]
  [ COMMENT = '<string_literal>' ]

ALTER GIT REPOSITORY <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER GIT REPOSITORY <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER GIT REPOSITORY <name> UNSET {
  GIT_CREDENTIALS |
  COMMENT }
  [ , ... ]

ALTER GIT REPOSITORY <name> FETCH
Copy

参数

name

指定要更改的存储库暂存区的标识符。

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

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

SET ...

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

GIT_CREDENTIALS = secret_name

指定包含用于与 Git 存储库进行身份验证的凭据的密钥对象。

此处指定的密钥必须是为此 Git 存储库指定的 API 集成的 ALLOWED_AUTHENTICATION_SECRETS 参数指定的密钥。

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

API_INTEGRATION = integration_name

指定 API 集成，其中包含有关 Snowflake 如何与存储库 API 交互的详细信息。

有关 API 集成的参考信息，请参阅 CREATE API INTEGRATION。

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

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

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

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

COMMENT = 'string_literal'

指定注释。

默认：无值

UNSET ...

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

  • GIT_CREDENTIALS

  • COMMENT

要使用单个 ALTER 语句取消设置多个属性或参数，请使用逗号分隔每个属性或参数。

取消设置属性或参数时，只指定属性或参数名称（除非上述语法表明您应该指定值）。指定值会返回错误。

FETCH

将内容从 Git 存储库提取到存储库暂存区。

提取的内容是一个完整克隆，从远程存储库提取所有分支、标签和提交。此命令还会修剪之前提取但远程存储库中不再存在的分支和提交。

访问控制要求

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

权限

对象

备注

OWNERSHIP 或 WRITE

Git 存储库

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).

示例

以下示例使用 Git 来源的数据刷新 snowflake_extensions 存储库暂存区：

ALTER GIT REPOSITORY snowflake_extensions FETCH;
Copy
语言: 中文