snow git setup¶

git 리포지토리 오브젝트를 설정합니다.

구문¶

snow git setup
  <repository_name>
  --connection <connection>
  --host <host>
  --port <port>
  --account <account>
  --user <user>
  --password <password>
  --authenticator <authenticator>
  --private-key-file <private_key_file>
  --token-file-path <token_file_path>
  --database <database>
  --schema <schema>
  --role <role>
  --warehouse <warehouse>
  --temporary-connection
  --mfa-passcode <mfa_passcode>
  --enable-diag
  --diag-log-path <diag_log_path>
  --diag-allowlist-path <diag_allowlist_path>
  --format <format>
  --verbose
  --debug
  --silent

Copy

인자¶

repository_name: git 리포지토리의 식별자로, 예를 들어 my_repo입니다.

선택 사항¶

--connection, -c, --environment TEXT: config.toml 파일에 정의된 연결의 이름입니다. 기본값: default.
--host TEXT: 연결을 위한 호스트 주소입니다. 연결에 지정된 값을 재정의합니다.
--port INTEGER: 연결의 포트입니다. 연결에 지정된 값을 재정의합니다.
--account, --accountname TEXT: Snowflake 계정에 할당된 이름입니다. 연결에 지정된 값을 재정의합니다.
--user, --username TEXT: Snowflake에 연결할 사용자 이름입니다. 연결에 지정된 값을 재정의합니다.
--password TEXT: Snowflake 비밀번호입니다. 연결에 지정된 값을 재정의합니다.
--authenticator TEXT: Snowflake 인증자입니다. 연결에 지정된 값을 재정의합니다.
--private-key-file, --private-key-path TEXT: Snowflake 개인 키 파일 경로입니다. 연결에 지정된 값을 재정의합니다.
--token-file-path TEXT: Snowflake에 연결할 때 사용해야 하는 OAuth 토큰이 포함된 파일 경로입니다.
--database, --dbname TEXT: 사용할 데이터베이스입니다. 연결에 지정된 값을 재정의합니다.
--schema, --schemaname TEXT: 사용할 데이터베이스 스키마입니다. 연결에 지정된 값을 재정의합니다.
--role, --rolename TEXT: 사용할 역할입니다. 연결에 지정된 값을 재정의합니다.
--warehouse TEXT: 사용할 웨어하우스입니다. 연결에 지정된 값을 재정의합니다.
--temporary-connection, -x: config에서 정의된 연결 대신, 명령줄 매개 변수로 정의된 연결을 사용합니다. 기본값: False.
--mfa-passcode TEXT: 다단계 인증(MFA)에 사용할 토큰입니다.
--enable-diag: Python 커넥터 진단 테스트를 실행합니다. 기본값: False.
--diag-log-path TEXT: 진단 보고서 경로입니다. 기본값: <temporary_directory>.
--diag-allowlist-path TEXT: 선택적 허용 목록에 대한 진단 보고서 경로입니다.
--format [TABLE|JSON]: 출력 형식을 지정합니다. 기본값: TABLE.
--verbose, -v: 로그 수준 info 이상의 로그 항목을 표시합니다. 기본값: False.
--debug: 로그 수준 디버그 이상에 대한 로그 항목을 표시하며, 디버그 로그에는 추가 정보가 포함됩니다. 기본값: False.
--silent: 콘솔로의 중간 출력을 끕니다. 기본값: False.

--help: 이 명령에 대한 도움말 텍스트를 표시합니다.

사용법 노트¶

snow git setup 명령은 다음 정보를 입력하라는 메시지를 표시합니다.

URL: git clone 작업에 사용할 리포지토리의 주소입니다.
시크릿: 인증 자격 증명이 포함된 Snowflake 시크릿입니다. 복제 및 가져오기와 같은 읽기 전용 작업에 대해 원본 리포지토리에 인증이 필요하지 않은 경우에는 필요하지 않습니다.
API 통합: Snowflake가 Git 리포지토리와 상호 작용할 수 있도록 하는 오브젝트입니다.

연결 에 지정된 역할 또는 사용자에게 권한이 부여되지 않은 경우 이 명령을 실행하면 다음과 유사한 오류가 생성됩니다.

003001 (42501): 01b2f095-0508-c66d-0001-c1be009a66ee: SQL access control error: Insufficient privileges to operate on account XXX

이런 상황에서는 연결 구성을 확인하거나 계정 관리자에게 필요한 권한을 부여하거나 통합을 만들어 달라고 요청해야 합니다. 자세한 내용은 리포지토리 API와 상호 작용하기 위한 API 통합 만들기 섹션을 참조하십시오.

예¶

시크릿과 자격 증명이 필요한 리포지토리를 만듭니다.

$ snow git setup snowcli_git
Origin url: https://github.com/snowflakedb/snowflake-cli.git
Use secret for authentication? [y/N]: y
Secret identifier (will be created if not exists) [snowcli_git_secret]: new_secret
Secret 'new_secret' will be created
username: john_doe
password/token: ****
API integration identifier (will be created if not exists) [snowcli_git_api_integration]:

Copy

Secret 'new_secret' successfully created.
API integration snowcli_git_api_integration successfully created.
+------------------------------------------------------+
| status                                               |
|------------------------------------------------------|
| Git Repository SNOWCLI_GIT was successfully created. |
+------------------------------------------------------+

시크릿이 없는 리포지토리와 기존 API 통합 ID를 생성합니다.

$ snow git setup snowcli_git
Origin url: https://github.com/snowflakedb/snowflake-cli.git
Use secret for authentication [y/N]: n
API integration identifier (will be created if not exists) [snowcli_git_api_integration]: EXISTING_INTEGRATION

Copy

Using existing API integration 'EXISTING_INTEGRATION'.
+------------------------------------------------------+
| status                                               |
|------------------------------------------------------|
| Git Repository SNOWCLI_GIT was successfully created. |
+------------------------------------------------------+