ALTER GIT REPOSITORY

Modifica as propriedades de um estágio de repositório Git.

Consulte também:

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

Sintaxe

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

Parâmetros

name

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

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.

SET ...

Especifica as propriedades a serem definidas para a integração:

GIT_CREDENTIALS = secret_name

Especifica o objeto secreto que contém credenciais para autenticação no repositório Git.

O segredo que você especificar aqui deve ser um segredo especificado pelo parâmetro ALLOWED_AUTHENTICATION_SECRETS da integração da API especificada para este repositório Git.

Para obter informações de referência sobre segredos, consulte CREATE SECRET.

API_INTEGRATION = integration_name

Especifica a integração da API contendo detalhes sobre como o Snowflake deve interagir com a API do repositório.

Para obter informações de referência sobre as integrações da API, veja CREATE API INTEGRATION.

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

Especifica o nome da tag e o valor da cadeia de caracteres dela.

O valor de tag é sempre uma cadeia de caracteres, e o número máximo de caracteres do valor da tag é 256.

Para obter informações sobre como especificar tags em uma instrução, consulte Cotas de tags para objetos e colunas.

COMMENT = 'string_literal'

Especifica um comentário.

Padrão: sem valor

UNSET ...

Especifica a propriedade a ser desmarcada para a integração, o que a restaura para o valor padrão:

  • GIT_CREDENTIALS

  • COMMENT

Para desmarcar várias propriedades ou parâmetros com uma única instrução ALTER, separe cada propriedade ou parâmetro com uma vírgula.

Ao desmarcar uma propriedade ou parâmetro, especifique apenas o nome da propriedade ou parâmetro (a menos que a sintaxe acima indique que você deve especificar o valor). Especificar o valor retorna um erro.

FETCH

Busca conteúdo do repositório Git para o estágio de repositório.

O conteúdo obtido é um clone completo que busca todas as ramificações, tags e confirmações do repositório remoto. O comando também remove ramificações e confirmações que foram obtidas anteriormente, mas não existem mais no repositório remoto.

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

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

Exemplos

O exemplo a seguir atualiza o estágio do repositório snowflake_extensions com dados de sua origem Git:

ALTER GIT REPOSITORY snowflake_extensions FETCH;
Copy
Linguagem: Português