DESCRIBE GIT REPOSITORY¶

Décrit une zone de préparation de référentiel Git existante.

Voir aussi :: ALTER GIT REPOSITORY, CREATE GIT REPOSITORY, DROP GIT REPOSITORY, SHOW GIT BRANCHES, SHOW GIT REPOSITORIES, SHOW GIT TAGS

Syntaxe¶

{ DESC | DESCRIBE } GIT REPOSITORY <name>

Copy

Paramètres¶

name

Spécifie l’identificateur de la zone de préparation de référentiel à décrire.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

Sortie¶

La sortie de la commande inclut des propriétés dans les colonnes suivantes :

Colonne	Description
`created_on`	Date de création de la zone de préparation de référentiel Git.
`name`	Nom de la zone de préparation de référentiel Git.
`database_name`	Nom de la base de données contenant cette zone de préparation de référentiel Git.
`schema_name`	Nom du schéma contenant cette zone de préparation de référentiel Git.
`origin`	URL de l’origine Git.
`api_integration`	Nom de l’intégration d’API incluse dans cette zone de préparation de référentiel Git.
`git_credentials`	Nom de l’objet secret de cette zone de préparation de référentiel Git.
`owner`	Rôle utilisé lors de la création de cette zone de préparation de référentiel Git.
`owner_role_type`	Type de rôle propriétaire de l’objet, soit ROLE, soit DATABASE_ROLE.
`comment`	Commentaire spécifié lors de la création de cette zone de préparation de référentiel Git.

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette commande SQL doit avoir les privilèges suivants définis au minimum ainsi :

Privilège	Objet	Remarques
OWNERSHIP	Référentiel 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).

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Exemples¶

L’exemple suivant génère une description de la zone de préparation de référentiel snowflake_extensions :

DESCRIBE GIT REPOSITORY snowflake_extensions;

Copy

La commande précédente génère une sortie telle que la suivante :

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