Snowsight에서 워크시트로 작업하기¶
워크시트는 Snowflake 플랫폼 내에서 SQL 쿼리 또는 Python 코드를 실행하고 다른 Snowflake 데이터 로드, 정의 및 조작 작업을 수행할 수 있는 강력하고 다양한 방법을 제공합니다.
Snowsight 에서 워크시트를 연 후 다음 중 하나를 수행할 수 있습니다.
Python 코드를 작성 합니다.
워크시트의 컨텍스트를 변경 합니다.
워크시트를 업데이트하고 폴더로 정리 합니다.
워크시트를 공유 합니다.
워크시트 찾아보기 및 열기¶
워크시트를 열면 Worksheets explorer 에서 다른 워크시트를 보고 관리할 수 있습니다. Worksheets explorer 를 사용하면 특정 워크시트를 검색할 수도 있습니다.
워크시트 내용 미리 보기¶
워크시트의 내용을 미리 보려면 Worksheets explorer 에서 워크시트 이름 위로 마우스를 가져가면 됩니다. 미리 보기에는 워크시트 실행에 사용되는 역할도 표시됩니다.
미리 보기에서 워크시트의 내용을 복사할 수도 있습니다. 워크시트 내용 미리 보기를 커서로 가리키고 이때 나타나는 Copy 버튼을 선택합니다.
키보드 단축키를 사용하여 작업 수행¶
Snowsight 는 워크시트에서 쿼리를 빠르게 탐색하고 편집하는 데 도움이 되는 바로 가기 키를 제공합니다. 예를 들어 바로 가기 키를 사용하여 워크시트 내에서 커서를 이동하고, 찾기 및 바꾸기를 수행하고, 행을 복사하고, 쿼리 형식을 지정하는 등의 작업을 수행할 수 있습니다.
사용 가능한 바로 가기 키를 전부 보려면 워크시트를 열고 Mac 키보드에서는 CMD + SHIFT + / 를 누르고, Windows 키보드에서는 CTRL + SHIFT + / 를 누르십시오.
워크시트의 컨텍스트 변경하기¶
워크시트를 생성할 때 워크시트의 내용을 실행하는 데 사용되는 역할과 웨어하우스를 지정합니다. 이 정보를 워크시트 컨텍스트 라고 하며, 향후 세션을 위해 보존되며, 동일한 워크시트의 모든 사용자와 공유됩니다.
참고
역할 선택기를 사용하면 기본 역할을 선택할 수 있습니다. SQL 워크시트에서 보조 역할을 활성화하려면 USE SECONDARY ROLES 를 실행하십시오. 현재 세션에서 보조 역할이 활성화되어 있는지 확인하려면 CURRENT_SECONDARY_ROLES 함수 CURRENT_SECONDARY_ROLES 를 호출합니다.
워크시트의 역할 컨텍스트는 역할에 부여된 액세스 제어 권한에 따라 Snowflake 오브젝트에서 수행할 수 있는 작업을 결정합니다.
워크시트의 컨텍스트를 설정하려면 다음을 수행합니다.
Snowsight 에 로그인합니다.
Projects » Worksheets 를 선택하여 워크시트 목록을 엽니다.
워크시트를 엽니다.
컨텍스트 선택기를 엽니다.
워크시트를 실행할 역할을 선택합니다.
해당 역할에 사용할 권한이 있는 웨어하우스를 선택합니다.
드롭다운 외부의 아무 곳이나 선택하면 컨텍스트 선택기가 닫힙니다.
참고
각 워크시트에는 고유한 세션이 있으며 사용자 메뉴에서 선택한 역할(사용자의 활성 역할)과 다른 역할을 사용할 수 있습니다. 활성 역할을 변경해도 컨텍스트 선택기가 있는 워크시트에 할당된 역할은 변경되지 않습니다.
웨어하우스 재개 또는 크기 조정¶
워크시트를 실행하기 전후에 웨어하우스를 재개하거나 크기를 조정해야 할 수도 있습니다.
참고
웨어하우스 세부 정보를 변경하려면 웨어하우스에 대한 MODIFY 또는 OWNERSHIP 권한이 있어야 합니다.
컨텍스트 선택기를 사용하여 웨어하우스 세부 정보를 보거나 조정하려면 다음을 수행합니다.
Snowsight 에 로그인합니다.
Projects » Worksheets 를 선택하여 워크시트 목록을 엽니다.
워크시트를 엽니다.
컨텍스트 선택기를 엽니다.
Show warehouse details 아이콘을 선택합니다.
Status 옵션의 경우 상태를 선택하고 웨어하우스가 일시 중단된 경우 Resume 을 선택합니다.
Size 옵션의 경우 크기를 선택하고 다른 크기를 선택합니다.
드롭다운 외부의 아무 곳이나 선택하면 컨텍스트 선택기가 닫힙니다.
워크시트 관리¶
Snowsight 의 워크시트는 워크시트 탭 또는 Worksheets explorer 에서 관리할 수 있습니다. 워크시트 탭 메뉴에 액세스하려면 워크시트를 열고 탭 위로 마우스를 가져간 다음 를 선택합니다. Worksheets explorer 에 액세스하려면 워크시트 이름에 마우스를 가져간 다음
를 선택합니다.
각 메뉴에서 사용할 수 있는 작업은 현재 역할에 따라 다릅니다. 사용자의 권한에 따라 다음 작업을 수행할 수 있습니다.
워크시트의 이름을 바꾸거나 삭제하거나 이동합니다(편집 또는 소유권 권한 필요).
워크시트를 폴더나 대시보드로 이동하여 정리합니다.
외부 파일에서 SQL을 가져옵니다.
쿼리 형식 지정하기
다른 워크시트를 검색합니다.
워크시트를 복제합니다(모든 역할).
팁
워크시트 위에 마우스를 올리면 내용을 미리 볼 수 있습니다.
워크시트 아이콘을 참조하여 탭에서 열려 있는 워크시트를 식별할 수 있습니다. 단색 아이콘은 워크시트가 현재 열려 있음을 나타냅니다. 메뉴 옵션에 액세스하려면 워크시트 이름에 마우스를 갖다 대고 표시된 줄임표를 선택합니다.
워크시트 기록 및 버전 관리¶
워크시트에 대한 모든 로컬 편집 내용은 3초마다 자동으로 저장되지만 본인만 볼 수 있습니다. 워크시트에서 SQL 쿼리를 실행하거나 코드를 실행하면 최신 버전이 업데이트되어 모든 공동 작업자에게 공유됩니다. 워크시트의 이전 버전을 보고 원하는 버전의 세부 정보를 복사할 수도 있습니다. 자세한 내용은 워크시트 버전 전환 섹션을 참조하십시오.
워크시트를 변경하고 워크시트 버전을 관리할 때 다음 사항을 고려하십시오.
워크시트를 다른 사용자와 공유하면 편집 권한을 가진 사용자는 워크시트의 과거 버전을 볼 수 있습니다. 워크시트를 공유하는 모든 사용자는 워크시트의 가장 최근 버전에 대한 결과를 최대 10,000개 행까지 볼 수 있습니다.
권한이 있는 사람이 워크시트를 실행할 때마다 새 버전의 워크시트가 저장됩니다.
워크시트를 변경했는데 해당 워크시트가 사라진 것 같으면 버전 기록을 사용하여 변경 내용을 포함하여 저장된 초안을 여십시오.
공동 작업자에게는 가장 최근에 실행된 워크시트 버전이 표시됩니다.
워크시트를 공유한 사용자에게 표시되도록 워크시트를 변경하는 경우 워크시트를 실행해야 합니다.
여러 사용자가 동시에 공유 워크시트를 편집하고 실행하는 경우 워크시트를 실행할 때마다 새 버전이 생성됩니다. 워크시트를 열거나 새로 고치면 가장 최근에 실행된 워크시트 버전이 표시됩니다.
워크시트 버전 전환¶
과거 버전의 워크시트를 보려면 다음을 수행합니다.
Snowsight 에 로그인합니다.
Projects » Worksheets 를 선택하여 워크시트 목록을 엽니다.
워크시트를 엽니다.
워크시트의 Code Versions 을 선택합니다.
워크시트 버전의 목록에서 보려는 버전의 타임스탬프를 선택합니다.
해당 버전에 대한 워크시트 세부 정보를 검토하고 선택적으로 복사합니다.
워크시트의 현재 버전으로 돌아가려면 Close 를 선택합니다.
과거 워크시트 실행 결과를 보려면 워크시트의 Query History 를 확인합니다. 쿼리 기록 보기 섹션을 참조하십시오.
과거 워크시트 버전에 대해 저장된 결과¶
참고
대부분의 계정에서 사용 가능합니다. 미국 정부 리전의 계정, Virtual Private Snowflake(VPS)를 사용하는 계정, 비공개 연결을 사용하여 Snowflake에 액세스하는 계정은 계속해서 10,000개 행으로 제한되는 쿼리 결과를 볼 수 있습니다.
워크시트에서 실행된 쿼리에 대한 모든 결과는 최대 24시간 동안 확인할 수 있습니다. 24시간 후에는 결과를 보려면 다시 쿼리를 실행해야 합니다.
상황에 맞는 통계와 워크시트 결과 공유를 지원하기 위해 25개의 최신 쿼리 결과가 최대 90일 동안 캐시됩니다. 이 캐시는 계정의 데이터 저장소 사용에 포함됩니다.
삭제된 사용자가 소유한 워크시트 복구하기¶
사용자를 삭제하면 해당 사용자가 소유한 워크시트를 최대 500개까지 복구할 수 있습니다. 워크시트를 복구하려면 다음을 수행하십시오.
삭제된 사용자가 소유한 복구된 워크시트를 다운로드합니다.
SQL 파일에서 워크시트를 생성하여 복구된 워크시트를 Snowflake에 다시 추가합니다.
사용자를 삭제하기 전에 소유권을 변경하거나 워크시트에 대한 액세스 권한을 유지하려면 해당 사용자에게 워크시트를 공유하도록 요청하십시오. 워크시트 및 폴더 공유 섹션을 참조하십시오.
삭제된 사용자가 소유한 복구된 워크시트 다운로드하기¶
삭제된 사용자가 소유한 워크시트를 복구하려면 해당 사용자가 소유한 최대 500개의 워크시트로 구성된 .tar.gz
보관 파일을 다운로드하십시오.
참고
삭제된 사용자의 워크시트를 복구하려면 ACCOUNTADMIN 역할을 부여받아야 합니다.
Snowsight 에 로그인합니다.
Projects » Worksheets 를 선택합니다.
대화 상자에 계정에서 삭제된 사용자의 사용자 이름을 입력합니다.
중요
사용자 이름의 대/소문자 및 철자는 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 <오브젝트> 문은 이러한 내부 오브젝트를 반환하지 않습니다.