ALTER GIT REPOSITORY

Modifie les propriétés d’une zone de préparation de référentiel Git existante.

Voir aussi :

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

Syntaxe

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

Paramètres

name

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

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.

SET ...

Spécifie les propriétés à définir pour l’intégration :

GIT_CREDENTIALS = secret_name

Spécifie l’objet secret contenant les identifiants de connexion permettant l’authentification auprès du référentiel Git.

Le secret que vous spécifiez ici doit être un secret spécifié par le paramètre ALLOWED_AUTHENTICATION_SECRETS de l’intégration d’API spécifiée pour ce référentiel Git.

Pour des informations de référence sur les secrets, voir CREATE SECRET.

API_INTEGRATION = integration_name

Spécifie l’intégration d’API contenant des détails sur la façon dont Snowflake doit interagir avec l’API du référentiel.

Pour des informations de référence sur les intégrations d’API, voir CREATE API INTEGRATION.

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

Spécifie le nom de la balise et la valeur de la chaîne de la balise.

La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256.

Pour plus d’informations sur la spécification des balises dans une instruction, voir Quotas de balises pour les objets et les colonnes.

COMMENT = 'string_literal'

Spécifie un commentaire.

Par défaut : aucune valeur

UNSET ...

Spécifie la propriété à désactiver pour l’intégration, qui la rétablit à la valeur par défaut :

  • GIT_CREDENTIALS

  • COMMENT

Pour désactiver plusieurs propriétés ou paramètres via une seule instruction ALTER, séparez chaque propriété ou paramètre par une virgule.

Lorsque vous désactivez une propriété ou un paramètre, spécifiez uniquement le nom de propriété ou de paramètre (sauf si la syntaxe ci-dessus indique que vous devez spécifier la valeur). La spécification de la valeur renvoie une erreur.

FETCH

Récupère le contenu du référentiel Git dans la zone de préparation de référentiel.

Le contenu récupéré est un clone complet qui récupère l’ensemble des branches, balises et validations du référentiel distant. La commande supprime également les branches et les validations précédemment récupérées, mais qui n’existent plus dans le référentiel distant.

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

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

Exemples

L’exemple suivant actualise la zone de préparation de référentiel snowflake_extensions à l’aide de données provenant de son origine Git :

ALTER GIT REPOSITORY snowflake_extensions FETCH;
Copy
Langage: Français