쿼리 / DML / DDL에서 워크시트 사용하기¶
Classic Console 의 Worksheets 페이지에서는 SQL 쿼리를 생성 및 제출할 뿐만 아니라 대부분의 기타 DML 및 모든 DDL 작업을 수행하고 문이 완료되면 결과를 볼 수 있는 강력하고 다양한 인터페이스를 제공합니다.
참고
이 항목에서는 Classic Console 에 대한 세부 정보를 제공합니다. Snowsight 를 사용 중이라면 Snowsight에서 워크시트 관리 및 사용하기 섹션을 참조하십시오.
이 항목의 내용:
기능의 개요¶
![Classic Console의 워크시트 페이지](../_images/ui-sql-worksheet3.png)
오브젝트 브라우저.
워크시트를 추가합니다.
드롭다운 메뉴:
워크시트를 관리합니다(검색, 열기 또는 삭제, 이름 바꾸기).
자습서를 엽니다.
스크립트를 로드합니다.
드롭다운 메뉴:
작업 손실 없이 현재 워크시트의 현재 데이터베이스, 스키마 또는 웨어하우스를 변경합니다.
현재 웨어하우스를 재개/일시 중단하거나 크기를 조정합니다.
드롭다운 메뉴:
스크립트를 로드합니다.
텍스트 강조 표시를 활성화/비활성화합니다.
실행 확인을 표시/숨깁니다.
현재 워크시트를 삭제합니다.
SQL 편집기.
결과를 다운로드합니다.
결과를 클립보드에 복사합니다.
결과를 최대화/복원합니다.
열을 숨기거나 표시합니다.
워크시트는 다음을 포함하여 모든 비즈니스 및 워크플로 요구 사항을 충족하도록 설계되었습니다.
애드혹 쿼리 실행 및 기타 SQL 작업 수행.
각각 별도의 세션이 있는 여러 개의 동시 워크시트를 열면 UI 성능이 저하되지 않고 서로 다른 컨텍스트의 서로 다른 워크시트에서 쿼리를 실행할 수 있습니다.
나중에 사용할 수 있도록 워크시트 저장.
저장된 워크시트 라이브러리에서 워크시트 열기.
참고
저장된 워크시트는 Classic Console 의 외부에서 액세스할 수 없습니다.
현재, 저장된 워크시트는 다른 사용자와 공유할 수 없습니다.
워크스테이션이나 네트워크에서 SQL 스크립트 파일을 워크시트로 로드합니다. 스크립트 파일을 로드한 후 선택적으로 편집하고 저장된 워크시트의 라이브러리에 저장할 수 있습니다.
로그아웃해도 작업이 손실되지 않습니다. Snowflake에서는 각 워크시트의 정적 콘텐츠가 유지되므로, 나중에 다시 로그인하여 작업을 중단한 위치에서 재개할 수 있습니다. Snowflake는 로그아웃할 때 열려 있던 워크시트를 표시합니다.
다음의 경우에는 크기 조정/축소된 창, 결과/데이터 미리 보기 열의 너비 변경, SQL 편집기의 커서 위치도 유지됩니다.
열려 있는 워크시트 사이에서 전환할 때.
동일한 개별 워크시트를 닫고 다시 열 때.
사용자 세션 사이에서.
각 워크시트에 대해 다른 역할을 지정하고 작업 손실 없이 역할을 전환. 워크시트에서 특정 문을 실행한 다음 동일한 워크시트에서 작업을 계속 진행하기 전에 역할을 바꿀 수 있습니다.
참고
현재 인터페이스 역할은 열어 볼 워크시트의 기본 역할을 결정하지만, 워크시트는 인터페이스 역할에 연결되지 않습니다. 각 워크시트에는 독립적으로 설정할 수 있는 고유한 역할이 있습니다.
다른 브라우저나 탭에서 Snowflake에 로그인. 한 Snowflake 인스턴스에서 변경한 워크시트는 1~2분 후에 다른 인스턴스로 유지됩니다. 작업을 다시 입력하지 않고 다른 브라우저(또는 탭)에서 계속 작업할 수 있습니다.
필요한 경우 브라우저를 새로 고칩니다. 쿼리를 실행 중인 경우에는 새로 고침이 완료되면 실행이 재개됩니다. Snowflake에서 로그아웃하면 활성 쿼리의 실행이 중지됨에 유의하십시오.
이 페이지에서는 다음을 포함한 다른 작업도 수행할 수 있습니다.
쿼리 및 기타 DML 문을 실행하기 위해 사용되는 컴퓨팅 리소스를 동적으로 늘리거나 줄이기 위해 현재 웨어하우스의 크기를 조정합니다.
선택한 쿼리/문에 대한 결과 내보내기(결과를 여전히 사용할 수 있는 경우). 자세한 내용은 쿼리 결과 내보내기 섹션을 참조하십시오.
워크시트 저장 및 관리하기¶
Snowflake는 입력할 때 자동으로 워크시트를 저장하고 사용자 세션 사이에서 워크시트의 현재 상태를 유지합니다. 워크시트를 구성하려면 탭에서 워크시트 레이블(예: Worksheet 2
)을 두 번 클릭하고 워크시트에 보다 의미 있는 새 이름(예: Sales Analysis
)을 입력합니다.
닫힌 워크시트를 열려면 열려 있는 워크시트 탭의 오른쪽에 있는 아래쪽 화살표를 클릭하고 Open Worksheet 를 클릭합니다. Open Worksheet 대화 상자가 열립니다.
레이블별로 워크시트를 검색합니다.
선택한 워크시트를 삭제합니다.
단일 워크시트를 선택하려면 행을 클릭합니다.
CMD (Mac) 또는 CTRL (Windows) 키를 한 번 클릭한 다음 여러 행을 클릭하여 여러 워크시트를 선택합니다.
편집할 레이블을 두 번 클릭합니다.
선택한 워크시트를 엽니다.
Open Worksheet 대화 상자에서 지원되는 동작은 다음과 같습니다.
동작 |
단계 |
---|---|
개별 워크시트를 레이블별로 검색합니다. |
Search 필드에 텍스트를 입력합니다. 기존 워크시트의 목록이 자동으로 필터링됩니다. |
워크시트 레이블을 편집합니다. |
워크시트 레이블을 두 번 클릭하고 텍스트를 편집합니다. 워크시트 레이블은 255자로 제한됩니다. |
1개 이상의 워크시트를 열거나 삭제합니다. |
|
오브젝트 브라우저 사용하기¶
![워크시트 페이지의 오브젝트 브라우저](../_images/ui-sql-worksheet-object-browser.png)
테이블 데이터를 미리 봅니다.
두 번 클릭하여 이름을 SQL 편집기에 삽입합니다.
오브젝트 브라우저를 사용하면 사용자는 워크시트에서 선택한 역할이 액세스할 수 있는 모든 데이터베이스, 스키마, 테이블 및 뷰를 탐색할 수 있습니다.
데이터베이스 및 기타 오브젝트 목록은 워크시트 컨텍스트가 변경될 때 자동으로 새로 고쳐집니다. 또한, 사용자는 오브젝트 브라우저의 상단에 있는 새로 고침 버튼을 클릭하여 즉시 오브젝트 변경 사항을 살펴볼 수 있습니다.
언제라도 오브젝트 브라우저를 축소하여 SQL 편집기 및 결과/내역 창을 위한 추가 공간을 확보할 수 있습니다.
데이터베이스 오브젝트 탐색하기¶
데이터베이스 또는 스키마를 클릭하여 포함된 데이터베이스 오브젝트를 탐색합니다. 그러면 테이블 및 뷰 수준을 자세하게 확인할 수 있습니다.
동작 |
선택 사항 |
참고 |
---|---|---|
데이터 미리 보기 창에서 테이블/뷰 데이터 미리 보기 |
|
|
오브젝트 브라우저의 데이터베이스 또는 스키마를 워크시트에 대한 컨텍스트로 설정 |
|
|
데이터베이스 또는 오브젝트의 정규화된 이름을 커서 위치의 SQL 편집기에 삽입 |
|
데이터베이스 오브젝트 검색하기¶
Find database objects 필드를 사용하여 데이터베이스, 스키마, 테이블 및 뷰를 검색합니다. 검색은 “다음으로 시작” 검색이며, 검색 문자열을 큰따옴표로 묶은 경우를 제외하고 대/소문자를 구분함에 유의하십시오.
또한, 오브젝트 브라우저 위로 마우스 커서를 올릴 때 항목에 표시되는 검색 아이콘을 사용하여 데이터베이스 또는 스키마 내에서도 검색할 수 있습니다.
웨어하우스 관리하기¶
상황에 맞는 메뉴를 클릭하여 워크시트에 대한 다양한 활성 웨어하우스를 선택합니다. 선택한 웨어하우스를 재개 또는 일시 중단하거나 웨어하우스의 크기를 조정할 수 있습니다.
쿼리 관리하기¶
중요
워크시트에 표시되는 쿼리 세부 정보 및 결과는 현재 사용자 세션에서만 유지됩니다. 사용자가 웹 인터페이스에서 로그아웃한 후 다시 로그인하면, 이전 세션의 결과는 더 이상 워크시트에 표시되지 않지만, History 페이지를 사용하여 이전 세션에서 실행한 쿼리를 확인할 수 있습니다.
쿼리 실행하기¶
다음 옵션 중 1개를 사용하여 SQL 편집기에서 쿼리를 실행합니다.
동작 |
단계 |
키보드 단축키 |
---|---|---|
단일 쿼리 실행 |
|
쿼리의 아무 곳에나 커서를 두고 다음 키 조합을 입력합니다.
|
모든 쿼리 실행 |
|
N/A(없음) |
단일/다중 쿼리 실행(확인 포함) |
|
N/A(없음) |
모든 쿼리 실행(확인 포함) |
|
쿼리를 선택하지 않으면 다음 키 조합을 입력합니다.
|
실행 중 쿼리 중단하기¶
쿼리가 실행 중이면 Run 버튼이 Abort 버튼으로 바뀝니다. 실행 중인 쿼리를 중단하려면 이 버튼을 클릭합니다.
쿼리 정보 및 세부 정보 보기¶
쿼리가 실행될 때 상태 표시줄에 현재 총 쿼리 기간이 표시됩니다. 기간 분석을 보려면 상태 표시줄 위로 마우스 커서를 올립니다.
![결과 창의 기간 팝업](../_images/ui-sql-worksheet-results-duration.png)
쿼리 메트릭을 보려면 마우스 커서를 올립니다.
쿼리 세부 정보를 탐색하려면 Query ID 링크를 클릭합니다. 팝오버는 운영 체제의 임시 메모리로 쿼리 ID를 복사하거나 쿼리 내역으로 이동하기 위한 링크를 제공합니다.
![결과 창의 기간 팝업](../_images/ui-sql-worksheet-results-query-id.png)
클릭하여 쿼리 ID를 복사합니다.
클릭하여 쿼리 내역으로 이동합니다.
키보드 단축키를 사용하여 쿼리 형식 지정하기¶
쿼리 및 기타 SQL 문의 형식을 지정할 수 있도록 워크시트의 SQL 편집기에서 지원하는 키보드 및 키 조합은 다음과 같습니다.
- 탭 정지:
라인에 탭 정지(4자 간격)를 삽입하려면 [TAB] 키를 사용합니다.
커서가 라인의 시작 지점에 있는 경우 공백 4개가 삽입됩니다.
커서가 라인 내에 있는 경우 다음 탭 정지에 도달하기에 충분한 공백이 추가됩니다.
- 들여쓰기/내어쓰기:
한 라인(또는 여러 라인)을 2자 공백으로 들여쓰거나 내어쓰려면 커서를 라인의 아무 곳에나 두고(또는 원하는 라인을 강조 표시하고) [CMD] (Mac) 또는 [CTRL] (Windows) 키를 길게 누른 상태에서 다음을 1개 이상 입력합니다.
오른쪽 대괄호(
]
)는 입력된 대괄호의 수만큼 라인을 들여 씁니다.왼쪽 대괄호(
[
)는 입력된 대괄호의 수만큼 라인을 내어 씁니다.
라인이 들여쓰기 되면, 들여 쓴 라인 이후의 모든 새 라인이 동일한 공백 수만큼 자동으로 들여 써집니다.
- 주석:
한 라인(또는 여러 라인)을 주석으로 처리하려면, 커서를 라인의 아무 곳에나 두고(또는 원하는 라인을 강조 표시하고) [CMD] (Mac) 또는 [CTRL] (Windows) 키를 길게 누른 상태에서 슬래시(
/
)를 1개 입력합니다.
- 텍스트 강조 표시:
열려 있는 모든 워크시트에서 텍스트 강조 표시를 활성화 또는 비활성화려면 워크시트의 아무 곳에나 커서를 두고 [SHIFT]+[CMD] (Mac) 또는 [SHIFT]+[CTRL] (Windows) 키를 길게 누른 상태에서 문자(
K
)를 입력합니다.- 여러 커서 추가:
동일한 워크시트에 커서를 여러 개 추가하려면, [CMD] (Mac) 또는 [CTRL] (Windows) 키를 누른 상태에서 마우스 왼쪽 버튼 또는 터치패드를 사용하여 각 새 위치를 클릭합니다.
- 텍스트 영역 선택:
텍스트 영역을 선택하려면, [OPTION] (Mac) 또는 [ALT] (Windows) 키를 길게 누릅니다. 커서가 십자 기호로 변합니다. 마우스 왼쪽 버튼 또는 터치패드를 사용하여 클릭하고 드래그합니다.
- 텍스트 문자열 찾기 및 바꾸기:
워크시트에서 텍스트 문자열을 검색하고 바꾸려면:
[CMD]+[OPT]+[F] (Mac) 또는 [SHIFT]+[CTRL]+[F] (Windows) 키를 길게 누릅니다. Replace 필드가 표시됩니다.
텍스트 문자열의 모든 인스턴스를 바꾸려면 [CMD]+[OPT]+[SHIFT]+[F] (Mac) 또는 [ALT]+[CTRL]+[SHIFT]+[F] (Windows) 키를 길게 누릅니다. Replace All 필드가 표시됩니다.
바꿀 문자열을 입력하고 Enter 키를 누릅니다. With 필드가 표시됩니다.
대체 문자열을 입력하고 Enter 키를 누릅니다. 옵션 세트가 표시됩니다.
원하는 옵션을 선택합니다.
- 예:
문자열의 현재 인스턴스를 지정된 대체 문자열로 바꾸고 다음 인스턴스로 이동합니다.
- 아니요:
문자열의 현재 인스턴스를 유지하고 다음 인스턴스로 이동합니다.
- 모두:
문자열의 모든 인스턴스를 지정된 대체 문자열로 바꿉니다.
- 중지:
문자열의 인스턴스 검색을 중지합니다.
참고
이러한 바로 가기 키는 Classic Console 에만 적용됩니다. Snowsight 의 바로 가기 키는 바로 가기 키로 워크시트 업데이트하기 섹션을 참조하십시오.
자체 워크시트 백업하기¶
사용자는 다시 만들기 복잡하거나 중요한 워크시트를 백업하는 것이 좋습니다. 개별 워크시트의 내용을 복사하여 보호가 가능한 파일에 붙여넣습니다. 워크시트를 백업하면 실수로 삭제하는 것을 방지할 수 있습니다.
워크시트 메타데이터는 worksheet_data
디렉터리의 Snowflake 사용자 스테이지에 저장됩니다. REMOVE 명령을 실행하고 worksheet_data
디렉터리를 제거하면 사용자 워크시트가 삭제되며, 이는 복구할 수 없습니다.
참고
이 유의 사항은 Classic Console 의 Worksheets 탭에 있는 워크시트에만 적용됩니다. Snowsight 의 워크시트는 다른 위치에 저장되며 실수로 삭제하는 것이 방지됩니다.