SHOW GIT BRANCHES

SHOW GIT BRANCHES

SHOW GIT BRANCHES 명령은 지정한 Snowflake Git 리포지토리 클론의 브랜치(branch) 목록을 보여주는 명령이에요.

출처: 문서

본문

이 명령은 지정한 Snowflake Git 리포지토리 클론의 브랜치를 나열해요.

관련 명령: SHOW GIT TAGS, CREATE GIT REPOSITORY, SHOW GIT REPOSITORIES.

구문 (Syntax)

SHOW GIT BRANCHES [ LIKE '<pattern>' ] IN [ GIT REPOSITORY ] <repository_name>

파라미터 (Parameters)

  • LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.

  • IN [ GIT REPOSITORY ] <repository_name> — 브랜치를 표시할 Git 리포지토리 클론을 지정해요.

출력 (Output)

명령 출력은 Git 브랜치 속성을 다음 컬럼으로 제공해요:

  • name — 브랜치 이름.
  • path — 브랜치 경로.
  • checkouts — 현재 데이터를 표시하지 않음.
  • commit_hash — 브랜치의 커밋 해시.

접근 제어 요구 사항 (Access control requirements)

이 작업을 실행하는 역할은 최소한 다음 권한을 가져야 해요:

권한 (Privilege) 객체 (Object) 비고
READ Git 리포지토리 브랜치를 표시할 Git 리포지토리 클론

스키마의 객체를 조작하려면 상위 데이터베이스에 최소 하나, 상위 스키마에 최소 하나의 권한이 필요해요.

사용 참고 사항 (Usage notes)

  • 실행에 실행 중인 웨어하우스를 요구하지 않아요.
  • 현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
  • MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.

예제 (Examples)

snowflake_extensions Git 리포지토리 클론의 브랜치를 나열해요:

SHOW GIT BRANCHES IN snowflake_extensions;

앞 명령은 다음과 같은 출력을 생성해요:

--------------------------------------------------------------------------------
| name | path           | checkouts | commit_hash                              |
--------------------------------------------------------------------------------
| main | /branches/main |           | 0f81b1487dfc822df9f73ac6b3096b9ea9e42d69 |
--------------------------------------------------------------------------------

더 알아보기 (Learn more)