DESCRIBE GIT REPOSITORY¶

Descreve um estágio do repositório Git existente.

Consulte também:: ALTER GIT REPOSITORY, CREATE GIT REPOSITORY, DROP GIT REPOSITORY, SHOW GIT BRANCHES, SHOW GIT REPOSITORIES, SHOW GIT TAGS

Sintaxe¶

{ DESC | DESCRIBE } GIT REPOSITORY <name>

Copy

Parâmetros¶

name

Especifica o identificador do estágio do repositório a ser descrito.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

Saída¶

A saída do comando inclui propriedades nas seguintes colunas:

Coluna	Descrição
`created_on`	Data em que o estágio do repositório Git foi criado.
`name`	Nome do estágio do repositório Git.
`database_name`	Nome do banco de dados que contém este estágio do repositório Git.
`schema_name`	Nome do esquema que contém este estágio do repositório Git.
`origin`	URL da origem do Git.
`api_integration`	Nome da integração de API incluída neste estágio do repositório Git.
`git_credentials`	Nome do objeto secreto neste estágio do repositório Git.
`owner`	Função usada quando este estágio do repositório Git foi criado.
`owner_role_type`	Tipo de função que possui o objeto, seja ROLE ou DATABASE_ROLE.
`comment`	Comentário especificado quando este estágio do repositório Git foi criado.

Requisitos de controle de acesso¶

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

Privilégio	Objeto	Notas
OWNERSHIP	Repositório 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).

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 gera uma descrição do estágio do repositório snowflake_extensions:

DESCRIBE GIT REPOSITORY snowflake_extensions;

Copy

O comando anterior gera uma saída como a seguinte:

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| CREATED_ON                    | NAME                 | DATABASE_NAME | SCHEMA_NAME | ORIGIN                                                 | API_INTEGRATION     | GIT_CREDENTIALS           | OWNER        | OWNER_ROLE_TYPE | COMMENT |
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| 2023-06-28 08:46:10.886 -0700 | SNOWFLAKE_EXTENSIONS | MY_DB         | MAIN        | https://github.com/my-account/snowflake-extensions.git | GIT_API_INTEGRATION | MY_DB.MAIN.GIT_SECRET     | ACCOUNTADMIN | ROLE            |         |
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------