Snowsight에서 워크시트 관리 및 사용하기¶
워크시트는 SQL 쿼리 또는 Python 코드를 실행할 뿐 아니라 다른 Snowflake 데이터 로딩, 정의, 조작 작업을 수행하기 위한 강력하고 다목적으로 활용 가능한 방법을 제공합니다.
Snowsight 에서 워크시트를 연 후 다음 중 하나를 수행할 수 있습니다.
또한 SQL 문을 작성 하고 결과를 시각화 할 수 있습니다. Python 코드를 작성 할 수도 있습니다.
워크시트에서 다른 워크시트 찾아보기¶
워크시트를 열면 Worksheets 탐색기에서 다른 워크시트를 볼 수 있습니다. Worksheets 탐색기에서 다른 워크시트를 검색하고 워크시트를 관리할 수 있습니다.
워크시트 내용 미리 보기¶
워크시트의 내용을 미리 보려면 Worksheets 탐색기에서 워크시트의 이름을 커서로 가리키면 됩니다. 미리 보기에는 워크시트 실행에 사용되는 역할도 표시됩니다.
미리 보기에서 워크시트의 내용을 복사할 수도 있습니다. 워크시트 내용 미리 보기를 커서로 가리키고 이때 나타나는 Copy 버튼을 선택합니다.
바로 가기 키로 워크시트 업데이트하기¶
Snowsight 는 워크시트에서 쿼리를 빠르게 탐색하고 편집하는 데 도움이 되는 바로 가기 키를 제공합니다. 예를 들어 바로 가기 키를 사용하여 워크시트 내에서 커서를 이동하고, 찾기 및 바꾸기를 수행하고, 행을 복사하고, 쿼리 형식을 지정하는 등의 작업을 수행할 수 있습니다.
사용 가능한 바로 가기 키를 전부 보려면 워크시트를 열고 Mac 키보드에서는 [CMD]+[SHIFT]+[?], Windows 키보드에서는 [CTRL]+[SHIFT]+[?] 를 누르십시오.
워크시트의 탭을 마우스로 가리키고 
를 선택한 다음, Show Shortcuts 를 선택하여 바로 가기를 볼 수도 있습니다.
워크시트의 세션 컨텍스트 변경하기¶
워크시트의 내용을 실행하는 데 사용할 역할과 웨어하우스를 정의하려면 워크시트의 세션 컨텍스트를 설정하십시오. 워크시트 컨텍스트는 향후 세션을 위해 보존됩니다.
참고
여러 역할을 선택할 수는 없습니다. 컨텍스트 선택기는 보조 역할을 지원하지 않습니다. SQL 워크시트에서 보조 역할을 활성화하려면 USE SECONDARY ROLES 를 실행하십시오.
워크시트의 역할 컨텍스트는 역할에 부여된 액세스 제어 권한에 따라 Snowflake 오브젝트에서 수행할 수 있는 작업을 결정합니다.
워크시트의 세션 컨텍스트를 설정하려면 다음을 수행하십시오.
Snowsight 에 로그인합니다.
Projects » Worksheets 를 선택하여 워크시트 목록을 엽니다.
워크시트를 엽니다.
컨텍스트 선택기를 엽니다.
워크시트를 실행할 역할을 선택합니다.
해당 역할에 사용할 권한이 있는 웨어하우스를 선택합니다.
드롭다운 외부의 아무 곳이나 선택하면 컨텍스트 선택기가 닫힙니다.
참고
각 워크시트는 고유한 세션이며 계정 메뉴에서 선택한 역할(자신의 활성 역할)과 다른 역할을 사용할 수 있습니다. 활성 역할을 변경해도 컨텍스트 선택기가 있는 워크시트에 할당된 역할은 변경되지 않습니다.
웨어하우스 다시 시작 및 크기 조정하기¶
워크시트를 실행하기 전후에 웨어하우스를 재개하거나 크기를 조정해야 할 수도 있습니다.
웨어하우스 세부 정보를 변경하려면 웨어하우스에 대한 MODIFY 또는 OWNERSHIP 권한이 있어야 합니다.
컨텍스트 선택기를 사용하여 웨어하우스 세부 정보를 보고 조정하려면 다음을 수행하십시오.
Snowsight 에 로그인합니다.
Projects » Worksheets 를 선택하여 워크시트 목록을 엽니다.
워크시트를 엽니다.
컨텍스트 선택기를 엽니다.
Show warehouse details 아이콘을 선택합니다.
Status 옵션의 경우 상태를 선택하고 웨어하우스가 일시 중단된 경우 Resume 을 선택합니다.
Size 옵션의 경우 크기를 선택하고 다른 크기를 선택합니다.
드롭다운 외부의 아무 곳이나 선택하면 컨텍스트 선택기가 닫힙니다.
열린 워크시트 관리하기¶
워크시트를 연 후 워크시트의 탭을 마우스로 가리키면 나타나는 을 선택하여 다음과 같은 방법으로 열려 있는 워크시트를 관리합니다.
워크시트의 이름을 바꿉니다.
워크시트를 복제합니다.
워크시트를 삭제합니다.
워크시트가 열려 있을 때 Worksheets 탐색기에서 다른 워크시트를 보고 관리할 수도 있습니다.
다른 워크시트를 검색합니다.
워크시트 이름을 마우스로 가리킬 때 나타나는
을 사용하여 워크시트의 이름 바꾸기, 복제, 삭제 또는 이동을 수행합니다.워크시트 아이콘을 사용하여 탭에서 열려 있는 워크시트를 식별합니다. 아이콘이 채워져 있으면 탭에서 워크시트가 열려 있다는 의미입니다.
폴더에서 워크시트 구성하기¶
Snowsight 를 사용하여 폴더에서 워크시트를 구성하고 관리할 수 있습니다.
Snowsight 에 로그인합니다.
Projects » Worksheets 를 선택합니다.
워크시트를 선택하여 엽니다.
워크시트의 탭을 마우스로 가리키고
을 선택합니다.드롭다운 목록에서 Move 를 선택한 다음 워크시트를 이동할 폴더 또는 대시보드를 선택하거나 새로 생성합니다.
워크시트 기록 및 버전 관리하기¶
변경 작업을 하고 SQL 쿼리이나 코드를 워크시트에서 실행하면 새 버전의 워크시트가 저장됩니다.
워크시트를 변경하고 워크시트 버전을 관리할 때 다음 사항을 고려하십시오.
워크시트를 다른 사용자와 공유하면 편집 권한을 가진 사용자는 워크시트의 과거 버전을 볼 수 있습니다. 워크시트를 함께 공유하는 모든 사용자가 가장 최신 버전의 워크시트에 대한 결과를 볼 수 있습니다.
권한이 있는 사람이 워크시트를 실행할 때마다 새 버전의 워크시트가 저장됩니다.
워크시트를 변경했는데 해당 워크시트가 사라진 것 같으면 버전 기록을 사용하여 변경 내용을 포함하여 저장된 초안을 여십시오.
공동 작업자에게는 가장 최근에 실행된 워크시트 버전이 표시됩니다.
워크시트를 공유한 사용자에게 표시되도록 워크시트를 변경하는 경우 워크시트를 실행해야 합니다.
여러 사용자가 동시에 공유 워크시트를 편집하고 실행하는 경우 워크시트를 실행할 때마다 새 버전이 생성됩니다. 워크시트를 열거나 새로 고치면 가장 최근에 실행된 워크시트 버전이 표시됩니다.
워크시트 버전 전환하기¶
과거 버전의 워크시트를 보려면 다음을 수행하십시오.
Snowsight 에 로그인합니다.
Projects » Worksheets 를 선택하여 워크시트 목록을 엽니다.
워크시트를 엽니다.
워크시트의 Code Versions 을 선택합니다.
워크시트 버전의 목록에서 보려는 버전의 타임스탬프를 선택합니다.
해당 버전에 대한 워크시트 세부 정보를 검토하고 선택적으로 복사합니다.
워크시트의 현재 버전으로 돌아가려면 Close 를 선택합니다.
과거 워크시트 실행 결과를 보려면 해당 워크시트의 쿼리 기록을 확인하십시오. 쿼리 기록 보기 섹션을 참조하십시오.
과거 워크시트 버전에 대해 저장된 결과¶
워크시트에서 실행된 쿼리의 결과는 최대 90일 또는 25개의 워크시트 버전 중 더 큰 결과에 대해 캐시됩니다. 이 캐시는 계정의 데이터 저장소 사용에 포함됩니다.
삭제된 사용자가 소유한 워크시트 복구하기¶
사용자를 삭제하면 해당 사용자가 소유한 워크시트를 최대 500개까지 복구할 수 있습니다. 워크시트를 복구하려면 다음을 수행하십시오.
삭제된 사용자가 소유한 복구된 워크시트를 다운로드합니다.
SQL 파일에서 워크시트를 생성하여 복구된 워크시트를 Snowflake에 다시 추가합니다.
사용자를 삭제하기 전에 소유권을 변경하거나 워크시트에 대한 액세스 권한을 유지하려면 해당 사용자에게 워크시트를 공유하도록 요청하십시오. 워크시트 및 폴더 공유하기 섹션을 참조하십시오.
삭제된 사용자가 소유한 복구된 워크시트 다운로드하기¶
삭제된 사용자가 소유한 워크시트를 복구하려면 해당 사용자가 소유한 최대 500개의 워크시트로 구성된 .tar.gz 보관 파일을 다운로드하십시오.
참고
삭제된 사용자의 워크시트를 복구하려면 ACCOUNTADMIN 역할을 부여받아야 합니다.
Snowsight 에 로그인합니다.
Projects » Worksheets 를 선택합니다.
» Recover Worksheets from Dropped User 를 선택합니다.대화 상자에 계정에서 삭제된 사용자의 사용자 이름을 입력합니다.
중요
사용자 이름의 대/소문자 및 철자는 Snowflake에 저장된 사용자 이름과 정확히 일치해야 합니다.
Recover 를 선택합니다.
웹 브라우저는 최대 500개의 워크시트가 포함된
.tar파일을 다운로드합니다. 삭제된 사용자에게 500개 이상의 워크시트가 있는 경우 가장 최근에 수정된 워크시트 500개만 다운로드됩니다.
삭제된 사용자가 소유한 워크시트를 다운로드한 후 SQL 파일에서 워크시트를 생성하여 복구된 워크시트를 Snowsight 에 추가하십시오.
복구된 워크시트를 Snowsight 에 추가하려면 먼저 다운로드한 .tar 파일을 .sql 파일 폴더로 확장해야 합니다. Snowsight 에는 한 번에 하나의 워크시트만 추가할 수 있으며, 복구된 워크시트를 Snowsight 에 추가하는 사용자가 워크시트의 새 소유자가 됩니다.
자세한 내용은 SQL 파일에서 워크시트 만들기 섹션을 참조하십시오.
삭제된 사용자가 소유한 워크시트 복구에 대한 고려 사항¶
워크시트 복구 시 고려 사항:
가장 최근에 실행된 워크시트 버전의 제목과 내용만 복구됩니다. 워크시트 버전 기록, 수신자 및 권한 공유, 쿼리 결과, 워크시트 메타데이터는 복구되지 않습니다.
최대 500개의 워크시트가 복구됩니다. 500개 이상의 워크시트가 있는 삭제된 사용자의 경우 가장 최근에 수정된 워크시트 500개만 복구됩니다.
Snowsight 의 워크시트만 복구됩니다. 삭제된 사용자가 소유한 Classic Console 의 워크시트는 이 방법으로 복구할 수 없습니다.
삭제된 여러 사용자의 사용자 이름이 동일한 경우 해당 사용자 이름을 가진 삭제된 모든 사용자가 소유한 워크시트가 복구됩니다.
예기치 않은 이유로 워크시트 복구가 실패하면 Snowflake 지원 에 문의하십시오.
워크시트용 내부 Snowflake 오브젝트¶
Snowflake는 Snowsight 에서 워크시트 사용을 지원하기 위해 다음과 같은 내부 오브젝트를 만듭니다.
오브젝트 타입 |
이름 |
|---|---|
보안 통합 |
WORKSHEETS |
Blob |
WORKSHEETS_APP |
데이터베이스 |
WORKSHEETS_APP |
사용자 |
WORKSHEETS_APP_USER |
역할 |
APPADMIN, WORKSHEETS_APP_RL |
이러한 내부 오브젝트는 계정의 내부 스테이지에서 쿼리 결과를 캐시하기 위해 사용됩니다. 이 캐시된 데이터는 계정의 키 계층 구조에 의해 암호화되고 보호됩니다.
내부 역할에 부여된 제한된 권한은 Snowsight 가 이러한 결과를 저장하기 위해 내부 스테이지에 액세스하는 것만 허용합니다. 역할은 계정의 오브젝트를 나열하거나 테이블의 데이터에 액세스할 수 없습니다.
Snowsight 사용자 및 역할은 사용자가 SNOWFLAKE 공유 데이터베이스의 ACCOUNT_USAGE 스키마에서 각각 USERS 및 ROLES 뷰를 쿼리할 때 반환됩니다. SHOW <오브젝트> 문은 이러한 내부 오브젝트를 반환하지 않습니다.