쿼리 / DML / DDL에서 워크시트 사용하기

Classic Console 의 Worksheets Worksheet tab 페이지에서는 SQL 쿼리를 생성 및 제출할 뿐만 아니라 대부분의 기타 DML 및 모든 DDL 작업을 수행하고 문이 완료되면 결과를 볼 수 있는 강력하고 다양한 인터페이스를 제공합니다.

참고

이 항목에서는 Classic Console 에 대한 세부 정보를 제공합니다. Snowsight 를 사용 중이라면 Snowsight에서 워크시트 관리 및 사용하기 섹션을 참조하십시오.

이 항목의 내용:

기능의 개요

Worksheet page in the Classic Console
  1. 오브젝트 브라우저.

  2. 워크시트를 추가합니다.

  3. 드롭다운 메뉴:

    • 워크시트를 관리합니다(검색, 열기 또는 삭제, 이름 바꾸기).

    • 자습서를 엽니다.

    • 스크립트를 로드합니다.

  4. 드롭다운 메뉴:

    • 작업 손실 없이 현재 워크시트의 현재 데이터베이스, 스키마 또는 웨어하우스를 변경합니다.

    • 현재 웨어하우스를 재개/일시 중단하거나 크기를 조정합니다.

  5. 드롭다운 메뉴:

    • 스크립트를 로드합니다.

    • 텍스트 강조 표시를 활성화/비활성화합니다.

    • 실행 확인을 표시/숨깁니다.

    • 현재 워크시트를 삭제합니다.

  6. SQL 편집기.

  7. 결과를 다운로드합니다.

  8. 결과를 클립보드에 복사합니다.

  9. 결과를 최대화/복원합니다.

  10. 열을 숨기거나 표시합니다.

워크시트는 다음을 포함하여 모든 비즈니스 및 워크플로 요구 사항을 충족하도록 설계되었습니다.

  • 애드혹 쿼리 실행 및 기타 SQL 작업 수행.

  • 각각 별도의 세션이 있는 여러 개의 동시 워크시트를 열면 UI 성능이 저하되지 않고 서로 다른 컨텍스트의 서로 다른 워크시트에서 쿼리를 실행할 수 있습니다.

  • 나중에 사용할 수 있도록 워크시트 저장.

  • 저장된 워크시트 라이브러리에서 워크시트 열기.

    참고

    • 저장된 워크시트는 Classic Console 의 외부에서 액세스할 수 없습니다.

    • 현재, 저장된 워크시트는 다른 사용자와 공유할 수 없습니다.

  • 워크스테이션이나 네트워크에서 SQL 스크립트 파일을 워크시트로 로드합니다. 스크립트 파일을 로드한 후 선택적으로 편집하고 저장된 워크시트의 라이브러리에 저장할 수 있습니다.

  • 로그아웃해도 작업이 손실되지 않습니다. Snowflake에서는 각 워크시트의 정적 콘텐츠가 유지되므로, 나중에 다시 로그인하여 작업을 중단한 위치에서 재개할 수 있습니다. Snowflake는 로그아웃할 때 열려 있던 워크시트를 표시합니다.

    다음의 경우에는 크기 조정/축소된 창, 결과/데이터 미리 보기 열의 너비 변경, SQL 편집기의 커서 위치도 유지됩니다.

    • 열려 있는 워크시트 사이에서 전환할 때.

    • 동일한 개별 워크시트를 닫고 다시 열 때.

    • 사용자 세션 사이에서.

  • 각 워크시트에 대해 다른 역할을 지정하고 작업 손실 없이 역할을 전환. 워크시트에서 특정 문을 실행한 다음 동일한 워크시트에서 작업을 계속 진행하기 전에 역할을 바꿀 수 있습니다.

    참고

    현재 인터페이스 역할은 열어 볼 워크시트의 기본 역할을 결정하지만, 워크시트는 인터페이스 역할에 연결되지 않습니다. 각 워크시트에는 독립적으로 설정할 수 있는 고유한 역할이 있습니다.

  • 다른 브라우저나 탭에서 Snowflake에 로그인. 한 Snowflake 인스턴스에서 변경한 워크시트는 1~2분 후에 다른 인스턴스로 유지됩니다. 작업을 다시 입력하지 않고 다른 브라우저(또는 탭)에서 계속 작업할 수 있습니다.

  • 필요한 경우 브라우저를 새로 고칩니다. 쿼리를 실행 중인 경우에는 새로 고침이 완료되면 실행이 재개됩니다. Snowflake에서 로그아웃하면 활성 쿼리의 실행이 중지됨에 유의하십시오.

이 페이지에서는 다음을 포함한 다른 작업도 수행할 수 있습니다.

  • 쿼리 및 기타 DML 문을 실행하기 위해 사용되는 컴퓨팅 리소스를 동적으로 늘리거나 줄이기 위해 현재 웨어하우스의 크기를 조정합니다.

  • 선택한 쿼리/문에 대한 결과 내보내기(결과를 여전히 사용할 수 있는 경우). 자세한 내용은 쿼리 결과 내보내기 섹션을 참조하십시오.

워크시트 저장 및 관리하기

Snowflake는 입력할 때 자동으로 워크시트를 저장하고 사용자 세션 사이에서 워크시트의 현재 상태를 유지합니다. 워크시트를 구성하려면 탭에서 워크시트 레이블(예: Worksheet 2)을 두 번 클릭하고 워크시트에 보다 의미 있는 새 이름(예: Sales Analysis)을 입력합니다.

닫힌 워크시트를 열려면 열려 있는 워크시트 탭의 오른쪽에 있는 아래쪽 화살표를 클릭하고 Open Worksheet 를 클릭합니다. Open Worksheet 대화 상자가 열립니다.

Open Worksheet dialog in the worksheet page
  1. 레이블별로 워크시트를 검색합니다.

  2. 선택한 워크시트를 삭제합니다.

  3. 단일 워크시트를 선택하려면 행을 클릭합니다.

    CMD (Mac) 또는 CTRL (Windows) 키를 한 번 클릭한 다음 여러 행을 클릭하여 여러 워크시트를 선택합니다.

  4. 편집할 레이블을 두 번 클릭합니다.

  5. 선택한 워크시트를 엽니다.

Open Worksheet 대화 상자에서 지원되는 동작은 다음과 같습니다.

동작

단계

개별 워크시트를 레이블별로 검색합니다.

Search 필드에 텍스트를 입력합니다. 기존 워크시트의 목록이 자동으로 필터링됩니다.

워크시트 레이블을 편집합니다.

워크시트 레이블을 두 번 클릭하고 텍스트를 편집합니다. 워크시트 레이블은 255자로 제한됩니다.

1개 이상의 워크시트를 열거나 삭제합니다.

  1. 워크시트의 테이블 행을 클릭하여 워크시트를 1개 선택합니다.

    여러 워크시트를 선택하려면 CMD(Mac) 또는 CTRL(Windows) 키를 한 번 클릭한 후 여러 테이블 행을 클릭합니다.

  2. 워크시트를 별도의 탭에서 열려면 Open 버튼을 클릭하고 또는 워크시트를 삭제하려면 Delete 버튼을 클릭합니다.

오브젝트 브라우저 사용하기

Object browser in the worksheet page
  1. 테이블 데이터를 미리 봅니다.

  2. 두 번 클릭하여 이름을 SQL 편집기에 삽입합니다.

오브젝트 브라우저를 사용하면 사용자는 워크시트에서 선택한 역할이 액세스할 수 있는 모든 데이터베이스, 스키마, 테이블 및 뷰를 탐색할 수 있습니다.

데이터베이스 및 기타 오브젝트 목록은 워크시트 컨텍스트가 변경될 때 자동으로 새로 고쳐집니다. 또한, 사용자는 오브젝트 브라우저의 상단에 있는 새로 고침 버튼을 클릭하여 즉시 오브젝트 변경 사항을 살펴볼 수 있습니다.

언제라도 오브젝트 브라우저를 축소하여 SQL 편집기 및 결과/내역 창을 위한 추가 공간을 확보할 수 있습니다.

데이터베이스 오브젝트 탐색하기

데이터베이스 또는 스키마를 클릭하여 포함된 데이터베이스 오브젝트를 탐색합니다. 그러면 테이블 및 뷰 수준을 자세하게 확인할 수 있습니다.

동작

선택 사항

참고

데이터 미리 보기 창에서 테이블/뷰 데이터 미리 보기

  • 원하는 테이블/뷰를 클릭합니다. 또는

  • 원하는 테이블/뷰 위로 마우스를 커서를 올리고 다음을 클릭합니다.

    » Preview Data

  • 데이터 미리 보기는 첫 번째 100개 행으로 제한됩니다.

  • 데이터를 미리 보려면 활성 웨어하우스가 필요합니다.

  • 뷰의 데이터를 미리 볼 때 SQL Text 버튼이 데이터 미리 보기 창에 표시됩니다. 현재 뷰 설명의 SQL 문을 살펴보려면 이 버튼을 클릭합니다.

오브젝트 브라우저의 데이터베이스 또는 스키마를 워크시트에 대한 컨텍스트로 설정

  • 원하는 데이터베이스/스키마 위로 마우스를 커서를 올리고 다음을 클릭합니다.

    » Set as Context

  • 오른쪽 상단의 Context 막대를 클릭하고 드롭다운 메뉴에서 데이터베이스/스키마를 선택하기 위한 바로 가기입니다.

데이터베이스 또는 오브젝트의 정규화된 이름을 커서 위치의 SQL 편집기에 삽입

  • 데이터베이스 또는 오브젝트를 두 번 클릭, 또는

  • 데이터베이스/오브젝트 위로 마우스를 커서를 올리고 다음을 클릭합니다.

    » Place Name in SQL

데이터베이스 오브젝트 검색하기

Find database objects 필드를 사용하여 데이터베이스, 스키마, 테이블 및 뷰를 검색합니다. 검색은 《다음으로 시작》 검색이며, 검색 문자열을 큰따옴표로 묶은 경우를 제외하고 대/소문자를 구분함에 유의하십시오.

또한, 오브젝트 브라우저 위로 마우스 커서를 올릴 때 항목에 표시되는 검색 아이콘을 사용하여 데이터베이스 또는 스키마 내에서도 검색할 수 있습니다.

웨어하우스 관리하기

상황에 맞는 메뉴를 클릭하여 워크시트에 대한 다양한 활성 웨어하우스를 선택합니다. 선택한 웨어하우스를 재개 또는 일시 중단하거나 웨어하우스의 크기를 조정할 수 있습니다.

Warehouse controls in the context menu

쿼리 관리하기

중요

워크시트에 표시되는 쿼리 세부 정보 및 결과는 현재 사용자 세션에서만 유지됩니다. 사용자가 웹 인터페이스에서 로그아웃한 후 다시 로그인하면, 이전 세션의 결과는 더 이상 워크시트에 표시되지 않지만, History History tab 페이지를 사용하여 이전 세션에서 실행한 쿼리를 확인할 수 있습니다.

쿼리 실행하기

다음 옵션 중 1개를 사용하여 SQL 편집기에서 쿼리를 실행합니다.

동작

단계

키보드 단축키

단일 쿼리 실행

  1. 쿼리 내의 아무 곳에나 커서를 올립니다(선택하지 않음).

  2. Run 버튼을 클릭합니다.

쿼리의 아무 곳에나 커서를 두고 다음 키 조합을 입력합니다.

Mac

[CMD]+[RETURN]

Windows

[CTRL]+[ENTER]

모든 쿼리 실행

  1. All Queries 확인란을 선택합니다.

  2. Run 버튼을 클릭합니다.

N/A(없음)

단일/다중 쿼리 실행(확인 포함)

  1. 1개 이상의 연속 쿼리를 선택합니다.

  2. Run 버튼을 클릭합니다. Snowflake에 확인 메시지가 표시되고 선택할 쿼리를 실행할지 여부를 묻습니다.

N/A(없음)

모든 쿼리 실행(확인 포함)

  1. 모든 쿼리를 실행합니다.

  2. Run 버튼을 클릭합니다. Snowflake에 확인 메시지가 표시되고 선택할 쿼리를 실행할지 여부를 묻습니다.

쿼리를 선택하지 않으면 다음 키 조합을 입력합니다.

Mac

[SHIFT]+[CMD]+[RETURN]

Windows

[SHIFT]+[CTRL]+[ENTER]

실행 중 쿼리 중단하기

쿼리가 실행 중이면 Run 버튼이 Abort 버튼으로 바뀝니다. 실행 중인 쿼리를 중단하려면 이 버튼을 클릭합니다.

쿼리 정보 및 세부 정보 보기

쿼리가 실행될 때 상태 표시줄에 현재 총 쿼리 기간이 표시됩니다. 기간 분석을 보려면 상태 표시줄 위로 마우스 커서를 올립니다.

Duration popup in the results pane
  1. 쿼리 메트릭을 보려면 마우스 커서를 올립니다.

쿼리 세부 정보를 탐색하려면 Query ID 링크를 클릭합니다. 팝오버는 운영 체제의 임시 메모리로 쿼리 ID를 복사하거나 쿼리 내역으로 이동하기 위한 링크를 제공합니다.

Duration popup in the results pane
  1. 클릭하여 쿼리 ID를 복사합니다.

  2. 클릭하여 쿼리 내역으로 이동합니다.

키보드 단축키를 사용하여 쿼리 형식 지정하기

쿼리 및 기타 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) 키를 길게 누릅니다. 커서가 십자 기호로 변합니다. 마우스 왼쪽 버튼 또는 터치패드를 사용하여 클릭하고 드래그합니다.

텍스트 문자열 찾기 및 바꾸기

워크시트에서 텍스트 문자열을 검색하고 바꾸려면:

  1. [CMD]+[OPT]+[F] (Mac) 또는 [SHIFT]+[CTRL]+[F] (Windows) 키를 길게 누릅니다. Replace 필드가 표시됩니다.

    텍스트 문자열의 모든 인스턴스를 바꾸려면 [CMD]+[OPT]+[SHIFT]+[F] (Mac) 또는 [ALT]+[CTRL]+[SHIFT]+[F] (Windows) 키를 길게 누릅니다. Replace All 필드가 표시됩니다.

  2. 바꿀 문자열을 입력하고 Enter 키를 누릅니다. With 필드가 표시됩니다.

  3. 대체 문자열을 입력하고 Enter 키를 누릅니다. 옵션 세트가 표시됩니다.

  4. 원하는 옵션을 선택합니다.

    문자열의 현재 인스턴스를 지정된 대체 문자열로 바꾸고 다음 인스턴스로 이동합니다.

    아니요

    문자열의 현재 인스턴스를 유지하고 다음 인스턴스로 이동합니다.

    모두

    문자열의 모든 인스턴스를 지정된 대체 문자열로 바꿉니다.

    중지

    문자열의 인스턴스 검색을 중지합니다.

참고

이러한 바로 가기 키는 Classic Console 에만 적용됩니다. Snowsight 의 바로 가기 키는 바로 가기 키로 워크시트 업데이트하기 섹션을 참조하십시오.

자체 워크시트 백업하기

사용자는 다시 만들기 복잡하거나 중요한 워크시트를 백업하는 것이 좋습니다. 개별 워크시트의 내용을 복사하여 보호가 가능한 파일에 붙여넣습니다. 워크시트를 백업하면 실수로 삭제하는 것을 방지할 수 있습니다.

워크시트 메타데이터는 worksheet_data 디렉터리의 Snowflake 사용자 스테이지에 저장됩니다. REMOVE 명령을 실행하고 worksheet_data 디렉터리를 제거하면 사용자 워크시트가 삭제되며, 이는 복구할 수 없습니다.

참고

이 유의 사항은 Classic Console 의 Worksheets Worksheet tab 탭에 있는 워크시트에만 적용됩니다. Snowsight 의 워크시트는 다른 위치에 저장되며 실수로 삭제하는 것이 방지됩니다.