SHOW GIT REPOSITORIES

SHOW GIT REPOSITORIES

SHOW GIT REPOSITORIES 명령은 접근 권한(privilege)이 있는 Git 리포지토리 클론 목록을 보여주는 명령이에요.

출처: 문서

본문

이 명령은 접근 권한이 있는 Git 리포지토리 클론을 나열해요. SHOW STAGES 명령도 Snowflake Git 리포지토리를 나열하는데, SHOW STAGES 출력에서 Snowflake Git 리포지토리는 type 컬럼에 GIT REPOSITORY 값을 가져요.

관련 명령: ALTER GIT REPOSITORY, CREATE GIT REPOSITORY, DESCRIBE GIT REPOSITORY, DROP GIT REPOSITORY, SHOW GIT BRANCHES, SHOW GIT TAGS.

구문 (Syntax)

SHOW GIT REPOSITORIES [ LIKE '<pattern>' ]
  [ IN
      {
        ACCOUNT                  |

        DATABASE                 |
        DATABASE <database_name> |

        SCHEMA                   |
        SCHEMA <schema_name>     |
        <schema_name>
      }
  ]
  [ LIMIT <rows> [ FROM '<name_string>' ] ]

파라미터 (Parameters)

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

  • [ IN ... ] — 명령의 범위를 선택적으로 지정해요:

    • ACCOUNT — 전체 계정의 레코드 반환.
    • DATABASE 또는 DATABASE db_name — 현재 또는 지정한 데이터베이스의 레코드 반환.
    • SCHEMA 또는 SCHEMA schema_name — 현재 또는 지정한 스키마의 레코드 반환.
    • IN ...을 생략하면 범위는 세션의 현재 데이터베이스 유무에 따라 달라져요: 있으면 IN DATABASE와 같은 효과, 없으면 IN ACCOUNT와 같은 효과.

  • LIMIT <rows> [ FROM <name_string> ] — 최대 행 수를 제한하면서 결과의 "페이지네이션"을 가능하게 해요.

출력 (Output)

명령 출력은 Git 리포지토리 클론 속성을 다음 컬럼으로 제공해요:

  • created_on — Git 리포지토리 클론이 생성된 날짜.
  • name — Git 리포지토리 클론 이름.
  • database_name — 이 Git 리포지토리 클론이 있는 데이터베이스 이름.
  • schema_name — 이 Git 리포지토리 클론이 있는 스키마 이름.
  • origin — 원격 Git 리포지토리의 origin URL.
  • api_integration — 이 Git 리포지토리 클론에 포함된 API 통합 이름.
  • git_credentials — 이 Git 리포지토리 클론의 시크릿(secret) 객체 이름.
  • owner — 이 Git 리포지토리 클론을 만들 때 사용된 역할.
  • owner_role_type — 객체를 소유한 역할 유형(ROLE 또는 DATABASE_ROLE).
  • comment — 이 Git 리포지토리 클론을 만들 때 지정된 주석.

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

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

권한 (Privilege) 객체 (Object) 비고
OWNERSHIP Git 리포지토리 객체에 대한 특별 권한으로, 객체를 만든 역할에 자동 부여되며 GRANT OWNERSHIP으로 다른 역할에 이전할 수 있어요.
USAGE 스키마

사용 참고 사항 (Usage notes)

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

예제 (Examples)

현재 스키마의 리포지토리를 나열해요:

SHOW GIT REPOSITORIES;

더 알아보기 (Learn more)