ALTER GIT REPOSITORY

既存の Gitリポジトリステージ のプロパティを変更します。

こちらもご参照ください。

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

構文

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

パラメーター

name

変更するリポジトリステージの識別子を指定します。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

SET ...

統合に設定するプロパティを指定します。

GIT_CREDENTIALS = secret_name

Gitリポジトリ認証用の認証情報を含むシークレットオブジェクトを指定します。

ここで指定するシークレットは、このGitリポジトリ用に指定した API 統合の ALLOWED_AUTHENTICATION_SECRETS パラメーターで指定したシークレットにする必要があります。

シークレットに関する参照情報については、 CREATE SECRET をご参照ください。

API_INTEGRATION = integration_name

Snowflakeがリポジトリ API とどのように相互作用すべきかの詳細を含む API 統合を指定します。

API 統合に関する参考情報については、 CREATE API INTEGRATION をご参照ください。

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

タグ の名前とタグ文字列の値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。

ステートメントでのタグの指定に関する情報については、 オブジェクトおよび列のタグクォータ をご参照ください。

COMMENT = 'string_literal'

コメントを指定します。

デフォルト: 値なし

UNSET ...

統合の設定を解除するプロパティを指定し、デフォルト値にリセットします。

  • GIT_CREDENTIALS

  • COMMENT

1つの ALTER ステートメントで複数のプロパティまたはパラメーターの設定を解除するには、各プロパティまたはパラメーターをコンマで区切ります。

プロパティまたはパラメーターの設定を解除する場合は、プロパティ名またはパラメーター名のみを指定します（上記の構文で値を指定するように指示されている場合を除く）。値を指定するとエラーが返されます。

FETCH

Gitリポジトリからリポジトリステージにコンテンツをフェッチします。

フェッチされるコンテンツは、リモートリポジトリからすべてのブランチ、タグ、コミットをフェッチするフルクローンです。このコマンドは、以前にフェッチしたブランチやコミットで、リモートリポジトリにもう存在しないものも削除します。

アクセス制御の要件

この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

メモ

OWNERSHIP または WRITE

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

例

次の例は、 snowflake_extensions リポジトリステージをGitが原点のデータでリフレッシュします。

ALTER GIT REPOSITORY snowflake_extensions FETCH;
Copy
言語: 日本語