SHOW GIT BRANCHES

列出指定 Snowflake Git 存储库克隆中的分支。

另请参阅：

SHOW GIT TAGS、CREATE GIT REPOSITORY、SHOW GIT REPOSITORIES

语法

SHOW GIT BRANCHES [ LIKE '<pattern>' ] IN [ GIT REPOSITORY ] <repository_name>
Copy

参数

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用 不区分大小写 的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回 相同的 结果：

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. 默认：无值（不对输出应用筛选）。

IN [ GIT REPOSITORY ] repository_name

指定包含要显示的分支的 Git 存储库克隆。

输出

命令输出在以下列中提供了 Git 分支属性：

列

描述

name

分支名称。

path

分支路径。

checkouts

目前没有显示任何数据。

commit_hash

提交分支的哈希值。

访问控制要求

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

权限

对象

备注

READ

Git 存储库

包含要显示的分支的 Git 存储库

要对架构中的任何对象执行操作，需要对父数据库和架构具有 USAGE 权限。

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

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

使用说明

  • 该命令不需要正在运行的仓库即可执行。

  • 该命令仅返回当前用户的当前角色已获授至少一项访问权限的对象。

  • MANAGE GRANTS 访问权限隐式允许其持有者查看账户中的每个对象。默认情况下，只有账户管理员（具有 ACCOUNTADMIN 角色的用户）和安全管理员（具有 SECURITYADMIN 角色的用户）才具有 MANAGE GRANTS 权限。

  • To post-process the output of this command, you can use the pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.

    此命令的输出列名称以小写形式生成。如果您通过管道运算符或 RESULT_SCAN 函数使用此命令的结果集，请在查询中对列名使用 加双引号的标识符，以确保它们与已扫描输出中的列名相匹配。例如，如果输出列的名称为 type，则为标识符指定 "type"。

示例

以下示例列出了 Git 存储库克隆 snowflake_extensions 中的分支。

SHOW GIT BRANCHES IN snowflake_extensions;
Copy

上述命令生成如下输出：

--------------------------------------------------------------------------------
| name | path           | checkouts | commit_hash                              |
--------------------------------------------------------------------------------
| main | /branches/main |           | 0f81b1487dfc822df9f73ac6b3096b9ea9e42d69 |
--------------------------------------------------------------------------------
语言: 中文