작업 공간¶

파일 관리하기¶

워크스페이스, 파일, 폴더의 이름을 바꾸고, 삭제하고, 옮기고, 조직화할 수 있습니다.

워크스페이스, 파일 또는 폴더의 이름을 바꾸거나 삭제하려면 다음과 같이 하십시오.

1. 대상 위로 마우스를 가져가 세로 줄임표 (추가 작업)를 선택합니다.

2. Rename 또는 Delete 를 선택합니다. 삭제를 선택하면 확인 메시지가 표시됩니다.

• 워크스페이스에 폴더를 생성하려면 워크스페이스 옆의 + 또는 기존 폴더를 선택합니다.

• 파일과 폴더를 조직하려면 파일이나 폴더를 같은 워크스페이스의 다른 위치로 끌어서 놓습니다. 워크시트를 워크스페이스으로 끌어서 놓을 수도 있습니다.

1개의 레이아웃에서 여러 파일 또는 결과 보기¶

탭과 분할 창으로 여러 파일을 관리하면 여러 가지 장점이 있습니다.

• 코드 또는 결과를 나란히 비교하십시오. 다른 워크시트에서 작업하는 동안 한 워크시트 쿼리를 빠르게 참조할 수 있습니다.

• 더 효율적으로 멀티태스킹하십시오. 변환을 줄이면서 여러 셀, 출력 또는 파일을 한 번에 볼 수 있습니다.

워크스페이스 레이아웃을 조정하려면 Workspaces 창에서 세로 줄임표 (추가 작업)를 선택하고 적절한 옵션을 선택합니다.

1. Split right

2. Split down

3. Close others

Git 워크스페이스 생성하기¶

Snowsight 에서 직접 파일을 개발하고 관리하기 위해 Git 리포지토리에 연결된 워크스페이스을 생성할 수 있습니다.

Git 동기화된 새 워크스페이스를 생성하려면 다음과 같이 하십시오.

1. Snowsight 에 로그인합니다.

2. 탐색 메뉴에서 Projects » Workspaces 를 선택합니다.

3. Workspaces 메뉴에서 From Git repository 를 선택합니다.

4. Git 리포지토리(예: https://www.github.com/my-user/my-repo-name)에서 URL 복사본을 복사한 다음 Repository URL 필드에 붙여넣습니다.

5. 선택 사항입니다. 새 Git 동기화 워크스페이스의 이름을 바꿉니다.

6. API Integration 메뉴에서 API 통합을 선택합니다.

   API 통합은 계정 관리자가 생성하며 4단계에서 사용 중인 Git 리포지토리 URL에 대한 액세스를 허용해야 합니다. 자세한 내용은 Git을 사용하기 위해 Snowflake 설정하기 섹션을 참조하세요.

   또한 GitHub 를 Git 공급자로 사용하고 인증에 OAuth 를 선호하는 경우 계정 관리자는 API 통합을 생성하여 OAuth 를 지원해야 합니다. 예:

   CREATE OR REPLACE API INTEGRATION api_integration_name
      API_PROVIDER = git_https_api
      API_ALLOWED_PREFIXES = ('https://github.com/')
      API_USER_AUTHENTICATION = (
         TYPE = snowflake_github_app
      )
      ENABLED = TRUE;
   

   Copy

7. API 통합에서 인증 방법을 선택합니다.

   • OAuth2 - GitHub 리포지토리로 인증하려면 Sign in 을 선택합니다. 로그인한 후에는 이후 세션에서 자격 증명을 제공할 필요가 없습니다. PrivateLink 환경에서는 OAuth2 를 사용할 수 없습니다.

   • Personal access token - 토큰이 포함된 오브젝트가 저장된 데이터베이스와 스키마를 선택합니다. 새 시크릿을 생성하려면 + Secret 을 선택하고 필수 권한을 입력합니다. API 통합은 이 시크릿 또는 모든 시크릿에 대한 액세스를 허용하도록 구성해야 합니다.

   • Public repository - 인증이 필요 없는 공개 리포지토리를 사용하는 경우 이 옵션을 선택합니다. 워크스페이스에서 이 공개 리포지토리로 변경 내용을 커밋하거나 푸시할 수 없습니다.

8. Create 를 선택합니다.

분기에 대한 작성기 세부 정보 및 자격 증명 업데이트하기¶

기본적으로 Snowflake 이메일과 사용자 이름은 Git 리포지토리에 변경 사항을 커밋하는 데 사용됩니다. 언제든지 업데이트할 수 있습니다.

1. Snowsight 에 로그인합니다.

2. 탐색 메뉴에서 Projects » Workspaces 를 선택합니다.

3. Changes 탭을 선택합니다.

4. 줄임표를 선택한 다음 Edit credentials 을 선택합니다.

5. 작성기 이름과 이메일을 지정합니다.

6. Update 를 선택합니다.

새 분기 생성하기¶

현재 분기에서 새 분기를 생성해 독립적으로 변경 작업을 할 수 있습니다.

1. Snowsight 에 로그인합니다.

2. 탐색 메뉴에서 Projects » Workspaces 를 선택합니다.

3. Changes 탭을 선택합니다.

4. 리포지토리 드롭다운을 선택합니다.

5. + New 를 선택합니다.

6. 새 분기 이름을 지정한 다음 Create 를 선택합니다.

다른 지점으로 변환¶

저장했지만 커밋하지 않은 변경 내용이 있는 경우 분기를 변환하기 전에 해당 변경 내용을 처리하는 방법을 선택해야 합니다.

1. Snowsight 에 로그인합니다.

2. 탐색 메뉴에서 Projects » Workspaces 를 선택합니다.

3. Git 워크스페이스 뷰에서 Changes 를 선택합니다.

4. 분기 메뉴에서 변환하려는 분기를 선택합니다.

   팁: 목록을 필터링하려면 분기 이름을 입력하십시오.

원격 분기 가져오기¶

Snowsight 외부에서 새 분기를 만든 경우(예: Git 공급자에서 만든 분기) Fetch All 옵션을 사용하여 Git 동기화 작업 영역으로 가져올 수 있습니다. 그러면 사용 가능한 원격 지점 목록이 업데이트됩니다.

1. Snowsight 에 로그인합니다.

2. 탐색 메뉴에서 Projects » Workspaces 를 선택합니다.

3. Git 워크스페이스 뷰에서 Changes 를 선택합니다.

4. Pull 메뉴 옆의 아래쪽 화살표를 선택한 다음 Fetch All 을 선택합니다. 가져오기가 완료되면 새로 생성된 원격 분기가 분기 목록에 나타나고 체크아웃에 사용할 수 있습니다.

업데이트된 파일 보기¶

마지막으로 커밋 및 푸시에 성공한 이후 추가, 삭제 또는 수정된 모든 파일을 뷰로 볼 수 있습니다.

1. Snowsight 에 로그인합니다.

2. 탐색 메뉴에서 Projects » Workspaces 를 선택합니다.

3. 폴더 뷰 상단에서 Changes 를 선택합니다. 수정된 파일은 M, 추가된 파일은 A, 삭제된 파일은 D 로 표시됩니다 .

4. 편집기에서 변경 사항의 시각적 차이를 보려면 파일을 선택합니다.

업데이트 커밋 및 푸시¶

변경 내용을 검토한 후에는 워크스페이스 내에서 원격 Git 리포지토리에 커밋하고 푸시할 수 있습니다.

업데이트된 파일을 원격 Git 리포지토리에 커밋하고 푸시합니다.

1. Snowsight 에 로그인합니다.

2. 탐색 메뉴에서 Projects » Workspaces 를 선택합니다.

3. 폴더 뷰 상단에서 Changes 를 선택합니다.

4. Commit message 필드에 커밋 메시지를 작성합니다.

5. Push 을 선택합니다.

6. 커밋 메시지를 작성하고 Push 를 선택하여 업데이트를 Git 리포지토리에 푸시합니다.

   참고

   충돌이 감지되면 먼저 끌어오라는 메시지가 표시됩니다. Pull 을 선택하여 충돌이 있는 파일 목록을 검토합니다.

충돌 보기 및 해결하기¶

푸시 중에 충돌이 발생하면 다시 커밋하기 전에 워크스페이스에서 직접 충돌을 확인하고 해결할 수 있습니다.

1. 워크스페이스의 폴더 뷰 상단에서 Changes 를 선택합니다. 1개 이상의 파일에 충돌이 있는 경우 뷰 상단에 메시지가 표시됩니다. 충돌이 있는 파일은 빨간색 M 으로 표시됩니다.

2. 편집기에서 충돌의 시각적 차이를 보려면 파일을 선택합니다. File with conflicts 에서 차이점은 인라인으로 강조 표시되어 있습니다.

3. 현재 변경 사항, 수신되는 변경 사항 또는 두 가지 변경 사항을 모두 수락합니다. 병합 결과가 표시됩니다.

4. Diff View 에서 현재 버전과 원격 버전을 나란히 볼 수 있습니다.

5. Accept all current 또는 Accept all remote 를 선택합니다.

6. 충돌을 해결한 후 Push 를 선택합니다.

7. 커밋 메시지를 작성합니다.

8. Push 을 선택합니다.

기본 편집기 설정 또는 되돌리기¶

계정 전체 기본 편집기를 모든 사용자의 작업 공간으로 설정하려면 다음을 수행합니다.

ALTER ACCOUNT SET USE_WORKSPACES_FOR_SQL = 'always';

이 설정을 되돌리고 이전 기본 편집기를 사용하되, 작업 공간을 기본 편집기로 설정하는 모든 Snowflake 관리형 BCR을 유지하려면 다음을 수행합니다.

ALTER ACCOUNT UNSET USE_WORKSPACES_FOR_SQL;

이전 편집기로 되돌리고 작업 공간을 기본 편집기로 설정하는 모든 Snowflake 관리형 BCR을 일시적으로 무시하려면 다음을 수행합니다.

ALTER ACCOUNT SET USE_WORKSPACES_FOR_SQL = 'never';

작업 공간 비활성화¶

워크스페이스를 비활성화하려면 ENABLE_PERSONAL_DATABASE 계정 수준 매개 변수를 FALSE 로 설정합니다.

ALTER ACCOUNT SET ENABLE_PERSONAL_DATABASE = FALSE;

이 매개 변수를 사용하려면 ACCOUNTADMIN 권한이 필요합니다. FALSE 로 설정한 후에는 워크스페이스가 함수 함수를 수행하지 않지만 Snowsight 탐색 메뉴에는 워크스페이스가 계속 목록에 표시됩니다.

보조 역할을 워크스페이스에 사용하도록 설정할 필요는 없지만, 보조 역할을 명시적으로 차단하는 세션 정책이 있는 경우 현재 제한으로 인해 세션 정책이 제거될 때까지 워크스페이스가 함수할 수 없습니다.

삭제된 사용자의 작업 공간 복구¶

사용자가 삭제되더라도 PDB(개인 데이터베이스) 및 해당 작업 공간 내의 모든 파일은 유지됩니다. 그런 다음, PDB의 이름이 :code:`DROPPED_USER$<dropped_user_name>_<timestamp>`로 바뀝니다.

삭제된 사용자의 PDB에서 작업 공간을 복구하려면 다음 단계를 따릅니다.

1. 삭제된 사용자의 PDB를 찾습니다. LIKE 함수와 함께 SHOW DATABASES 명령을 사용하여 특정 데이터베이스를 찾습니다.

   SHOW DATABASES LIKE 'dropped_user%';
   

   Copy

2. PDB에서 작업 공간을 확인합니다. SHOW WORKSPACES IN DATABASE 명령을 사용하여 사용 가능한 작업 공간을 나열합니다.

   SHOW WORKSPACES IN DATABASE DROPPED_USER$dropped_user_1754344912;
   

   Copy

3. 복구된 작업 공간에서 새 작업 공간을 만듭니다. CREATE WORKSPACE … FROM 명령을 사용하여 복구된 작업 공간에서 새 작업 공간을 만듭니다.

   그러면 콘텐츠가 새 위치에 복사되어 액세스할 수 있게 됩니다.

   참고

   USER$ 한정자를 사용하여 작업 공간을 자신의 개인 데이터베이스에 넣어야 합니다. 그렇지 않으면 오류가 발생합니다. 데이터베이스 이름 끝에 있는 타임스탬프는 각기 다릅니다.

   FROM 'snow://workspace/DROPPED_USER$dropped_user_1754344912.PUBLIC."to_be_recovered"/versions/head';
   

   Copy