SQL Runner를 사용하여 쿼리 및 탐색 만들기

SQL Runner를 사용하면 데이터베이스에 직접 액세스하고 이를 다양한 방식으로 활용할 수 있습니다. SQL Runner를 사용하면 스키마의 테이블을 쉽게 탐색하고, SQL 쿼리에서 임시 탐색을 사용하고, 데이터에 미리 작성된 설명 쿼리를 실행하고, SQL Runner 기록을 확인하고, 결과를 다운로드하고, 쿼리를 공유하고, LookML 프로젝트를 파생 테이블로 추가하고, 기타 유용한 작업을 수행할 수 있습니다.

이 페이지에서는 SQL Runner에서 쿼리를 실행하는 방법, 임시 탐색을 만드는 방법, SQL Runner를 사용하여 쿼리를 디버그하는 방법을 설명합니다. 다음에 대한 다른 문서 페이지를 참조하세요.

• SQL Runner 기본사항
• SQL Runner를 사용하여 파생 테이블 만들기
• SQL Runner로 데이터베이스 함수 관리

SQL Runner에서 쿼리 실행

데이터베이스에서 쿼리를 실행하려면 SQL 쿼리를 처음부터 작성하거나 탐색을 사용하여 쿼리를 만들거나 LookML 모델에 대해 쿼리를 실행하면 됩니다. 기록을 사용하여 이전 쿼리를 다시 실행할 수도 있습니다.

SQL 쿼리를 처음부터 작성

SQL Runner를 사용하여 데이터베이스에 자체 SQL 쿼리를 작성하고 실행할 수 있습니다. 사용자가 작성한 대로 Looker에서 데이터베이스에 쿼리를 전달하므로 데이터베이스 쿼리에 SQL 쿼리 구문이 유효한지 확인해야 합니다. 예를 들어 각 언어에는 함수에 전달해야 하는 특정 매개변수가 있는 SQL 함수가 약간 다릅니다.

1. SQL 쿼리 영역을 클릭하고 SQL 명령어를 입력합니다.
2. 원하는 경우 필드 목록에서 테이블 이름 또는 필드를 더블클릭하여 쿼리에 쿼리 위치에 포함합니다.
3. 실행을 클릭하여 데이터베이스에 대한 쿼리를 실행합니다.
4. 결과 영역에서 결과를 확인합니다. SQL Runner는 쿼리 결과 세트의 최대 5,000개 행을 로드합니다. 스트리밍을 지원하는 SQL 언어의 경우 결과를 다운로드하여 전체 결과 집합을 확인할 수 있습니다.

일부 SQL 프로그램에서는 일련의 쿼리를 여러 번 실행할 수 있습니다. 그러나 SQL Runner에서는 한 번에 하나의 쿼리만 실행할 수 있습니다. 또한 SQL Runner는 공백을 포함하여 쿼리에 65,535자(영문 기준)로 제한됩니다.

원하는 쿼리가 있으면 프로젝트에 쿼리를 추가하거나 파생 테이블의 LookML을 가져오거나 쿼리를 공유할 수 있습니다.

SQL Runner를 사용하여 새 쿼리를 사용하거나 기존 쿼리를 테스트할 수도 있습니다. SQL Runner 오류 강조표시를 사용하면 쿼리를 테스트하고 디버그할 수 있습니다.

탐색을 사용하여 SQL 쿼리 만들기

탐색을 사용하여 쿼리를 만든 다음 해당 쿼리에 대한 SQL 명령어를 SQL Runner에서 사용할 수도 있습니다.

1. 탐색의 데이터 바에서 SQL 탭을 클릭합니다.
2. SQL 쿼리 텍스트를 선택하여 SQL Runner로 복사합니다.
3. SQL Runner에서 열기 또는 SQL Runner에서 설명을 클릭하여 SQL Runner에서 쿼리를 엽니다.

SQL Runner의 SQL 쿼리 영역에 쿼리가 추가되면 실행을 클릭하여 데이터베이스를 쿼리할 수 있습니다. 또는 쿼리를 수정한 다음 새 쿼리를 실행할 수 있습니다.

SQL Runner로 시각화 만들기

Looker 관리자가 SQL Runner Vis Labs 기능을 사용 설정한 경우 SQL Runner에서 직접 시각화를 만들 수 있습니다.

SQL Runner Vis가 사용 설정되면 SQL Runner 패널이 재구성됩니다. 시각화 패널은 상단에 표시되고 결과 패널은 가운데에 있으며 쿼리 패널은 하단에 표시됩니다.

1. SQL 쿼리를 만들고 실행한 후에 시각화 탭을 열어 시각화를 확인하고 탐색 페이지에서와 마찬가지로 시각화 유형을 선택할 수 있습니다.
2. 설정 메뉴를 사용하여 시각화를 수정할 수 있습니다.
3. URL을 공유하여 SQL Runner로 만든 시각화를 공유할 수 있습니다. 시각화의 설정 메뉴를 사용하여 맞춤설정한 내용이 저장되고 링크가 변경되지 않습니다.

SQL Runner 시각화의 작동 방식에 유의해야 할 몇 가지 사항이 있습니다.

• 결과 표와 시각화는 모든 숫자 필드를 측정값으로 해석합니다.
• 결과표와 시각화에는 항상 전체 필드 이름이 사용됩니다. 따라서 설정 메뉴의 전체 입력란 이름 표시 옵션이 비활성화됩니다.
• 커스텀 필드, 테이블 계산, 피봇, 열 총계, 소계를 사용하려면 SQL 러너 쿼리를 살펴보세요.
• 정적 지도 (리전) 시각화는 SQL Runner 시각화에서 지원되지 않지만 위도 및 경도 데이터 (지도 및 정적 지도 (점) 시각화)를 사용하는 지도는 지원됩니다.
• 타임라인 시각화는 SQL Runner 실행에서 지원되지 않습니다.

피봇 측정기준

SQL Runner 시각화에서 하나 이상의 측정기준으로 피봇하도록 쿼리 결과를 수정할 수 있습니다. 필드를 피봇하려면 다음 단계를 따르세요.

1. 결과 영역에서 열의 톱니바퀴 아이콘을 클릭하여 열 옵션을 표시합니다.
2. 피봇 열을 클릭합니다.

피봇팅된 결과는 SQL Runner 시각화에 표시됩니다.

결과 영역의 결과는 피봇으로 표시되지 않습니다.

검색결과를 피봇 해제하려면 피봇된 열 톱니바퀴 메뉴를 클릭하고 열 피봇 해제를 선택합니다.

필드 유형 변경

쿼리 결과와 시각화를 표시할 때 SQL Runner는 숫자 필드를 측정값으로, 숫자가 아닌 필드를 측정기준으로 자동 해석합니다. 다음과 같은 방법으로 기본 필드 유형을 재정의하고 측정기준을 측정값으로 또는 그 반대로 변환할 수 있습니다.

1. 결과 영역에서 열의 톱니바퀴 아이콘을 클릭하여 열 옵션을 표시합니다.
2. 측정기준으로 변환 또는 측정으로 변환을 클릭하여 필드 유형을 변경합니다.

시각화에 다음과 같은 새 필드 유형이 표시됩니다.

LookML 모델에 대한 쿼리 실행

SQL Runner를 사용하면 데이터베이스에 직접 연결하는 대신 LookML 모델에 SQL 쿼리를 작성하고 실행할 수 있습니다. 모델에 대한 쿼리를 구성할 때 ${view_name.field_name} 또는 ${view_name.SQL_TABLE_NAME}과 같은 LookML 대체 연산자를 사용할 수 있습니다. 이를 통해 파생된 테이블 문제를 해결하는 쿼리를 작성할 때 시간을 절약할 수 있습니다.

Looker가 LookML 대체 항목을 해결한 후 데이터베이스에 쿼리를 전달하므로 쿼리가 데이터베이스 언어에 유효한 SQL로 작성되어야 합니다. 예를 들어 각 언어에는 함수에 전달해야 하는 특정 매개변수가 있는 SQL 함수가 약간 다릅니다.

SQL Runner에서 LookML 모델을 대상으로 쿼리를 실행하려면 다음 안내를 따르세요.

1. 모델 탭을 클릭합니다.
2. 쿼리할 모델을 선택합니다.
3. SQL 쿼리 영역을 클릭하고 LookML 필드를 사용하여 SQL 쿼리를 입력합니다.
4. 원하는 경우 뷰 목록에서 뷰를 더블클릭하여 쿼리의 뷰를 커서 위치에 포함합니다.
5. 뷰에서 필드 목록을 보려면 뷰 섹션에서 뷰를 클릭합니다. 원하는 경우 필드 목록의 필드를 더블클릭하여 커서 위치의 쿼리에 포함할 수 있습니다.
6. 준비된 SQL 쿼리 영역에서 LookML 대체가 SQL로 변환된 후 생성된 SQL 쿼리를 볼 수 있습니다.
7. 실행을 클릭하여 모델에 대해 쿼리를 실행합니다.
8. 결과 영역에서 결과를 확인합니다. SQL Runner는 쿼리 결과 세트의 행을 최대 5,000개 로드합니다. 스트리밍을 지원하는 SQL 언어의 경우 결과를 다운로드하여 전체 결과 집합을 확인할 수 있습니다.

원하는 쿼리가 있으면 프로젝트에 쿼리를 추가하거나 파생 테이블의 LookML을 가져오거나 쿼리를 공유할 수 있습니다.

SQL Runner를 사용하여 새 쿼리를 재생하거나 기존 쿼리를 테스트하거나 결과에서 새 탐색을 열 수도 있습니다. SQL Runner 오류 강조표시를 사용하면 쿼리를 테스트하고 디버그할 수 있습니다.

SQL Runner에서 필드 LookML 보기

모델 탭의 필드 목록에서 필드의 LookML도 볼 수 있습니다. 필드 목록의 필드 위로 마우스를 가져간 후 필드 이름 오른쪽에 있는 Looker 아이콘을 클릭합니다.

Looker가 LookML IDE를 열고 필드가 정의된 파일을 로드합니다.

SQL 러너 기록

SQL Runner에서 실행한 모든 쿼리의 최근 기록도 확인할 수 있습니다.

기록을 보려면 탐색 창 상단의 기록 탭을 클릭합니다. SQL Runner는 데이터베이스 연결에서 실행되는 모든 쿼리를 표시합니다. 빨간색은 오류로 인해 실행되지 않은 쿼리를 나타냅니다.

기록에서 쿼리를 클릭하여 SQL Runner로 쿼리를 채우고 Run(실행)을 클릭하여 쿼리를 다시 실행합니다.

쿼리 정렬

표 정렬 순서는 결과가 오름차순인지 내림차순으로 있는지에 따라 정렬된 필드 이름 옆에 위쪽 또는 아래쪽 화살표로 표시됩니다. Shift 키를 누른 상태에서 열 헤더를 클릭하여 원하는 순서로 정렬하면 여러 열을 기준으로 정렬할 수 있습니다. 또한 다른 필드와 비교하여 정렬 순서를 구분하는 숫자, 정렬 방향 (오름차순 또는 내림차순)을 나타내는 필드 이름 옆의 화살표, 필드 이름 위로 마우스를 가져가면 나타나는 팝업으로 필드의 정렬 순서가 표시됩니다.

자세한 내용과 예시는 Looker의 데이터 탐색 문서 페이지의 데이터 정렬 섹션을 참고하세요.

검색어 공유

SQL Runner에서 SQL Runner 액세스 권한이 있는 다른 사용자와 쿼리를 공유할 수 있습니다. 검색어를 공유하려면 URL 입력란에 URL을 복사하세요.

결과 다운로드 중

SQL 쿼리를 실행한 후 다양한 형식으로 결과를 다운로드할 수 있습니다.

1. SQL 쿼리 상자에 쿼리를 작성합니다. 이 시점에서는 SQL Runner에서 쿼리를 실행할 필요가 없습니다.
2. 오른쪽 상단의 톱니바퀴 메뉴에서 다운로드를 선택합니다.
3. 다운로드의 파일 형식 (텍스트 파일, CSV, JSON 등)을 선택합니다.

4. 브라우저에서 열기를 클릭하여 새 브라우저 창에서 결과를 보거나 다운로드를 클릭하여 결과를 컴퓨터에 파일로 다운로드합니다.

   브라우저에서 열기 또는 다운로드를 클릭하면 Looker에서 쿼리를 다시 실행한 다음 다운로드를 실행합니다.

스트리밍을 지원하는 SQL 언어의 경우 SQL 러너 다운로드 옵션은 전체 결과 세트를 다운로드합니다. 스트리밍을 지원하지 않는 SQL 언어의 경우 SQL Runner Download 옵션은 Results 섹션에 표시되는 쿼리의 행만 (최대 5,000행) 다운로드합니다.

열 값 복사

SQL Runner의 Results 섹션에서 열 값을 복사할 수 있습니다. 열의 톱니바퀴 메뉴를 클릭하여 값을 클립보드에 복사합니다. 여기에서 열 값을 텍스트 파일, Excel 문서 또는 다른 위치에 붙여넣을 수 있습니다.

Looker 관리자가 SQL Runner Vis Labs 기능을 사용 설정한 경우 열 톱니바퀴 메뉴에도 다른 옵션이 있습니다.

• 고정 및 고정 취소
• 모든 열 자동 크기 조절
• 모든 열 너비 재설정

결과 표에서 열을 수동으로 이동, 고정, 크기 조절할 수도 있습니다.

SQL Runner 쿼리의 예상 비용

BigQuery, MySQL, MySQL용 Amazon RDS, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL for PostgreSQL, Microsoft Azure PostgreSQL 연결의 경우 SQL Runner가 예상 쿼리 비용을 제공합니다. SQL 쿼리를 입력하면 SQL Runner가 쿼리에 필요한 데이터 양을 계산하여 Run 버튼 근처에 정보를 표시합니다.

BigQuery, MySQL, MySQL용 Amazon RDS 연결의 경우 예상 비용은 항상 사용 설정되어 있습니다. Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL for PostgreSQL, Microsoft Azure PostgreSQL 데이터베이스 연결의 경우 연결에 비용 예측 옵션을 사용 설정해야 합니다. 연결을 생성할 때 비용 예측을 사용 설정할 수 있습니다. 기존 연결의 경우 Looker 관리자 패널의 데이터베이스 섹션에 있는 연결 페이지에서 연결을 수정할 수 있습니다.

임시 탐색 만들기

SQL 러너 또는 데이터베이스 테이블에 임시 탐색 기능을 만들어 SQL Runner에서 데이터에 대한 유용한 정보를 빠르게 얻을 수 있습니다. Looker Explore를 사용하여 필드를 선택하고, 필터를 추가하고, 결과를 시각화하고, SQL 쿼리를 만들 수 있습니다.

SQL 러너에서 임시 Explore를 여는 방법에는 두 가지가 있습니다.

• SQL 러너의 쿼리 결과에서 탐색
• SQL 러너의 테이블 목록에서 탐색

SQL Runner 쿼리 결과 탐색

SQL Runner를 사용하면 SQL 쿼리에서 탐색을 열 수 있습니다. 이렇게 하면 SQL Runner로 작성된 쿼리에서 임시 탐색이 생성됩니다. 이를 통해 쿼리에서 반환하는 내용을 테스트하고 결과를 시각화할 수 있습니다. 모든 쿼리에 사용할 수 있지만 파생 테이블에 사용할 쿼리를 테스트하는 데 특히 유용합니다.

Looker 관리자가 SQL Runner Vis Labs 기능을 사용 설정한 경우 SQL Runner에서 직접 시각화를 생성할 수 있습니다.

1. SQL Runner를 사용하여 사용하려는 SQL 쿼리를 생성합니다.
2. 오른쪽 상단의 톱니바퀴 메뉴에서 탐색을 클릭합니다. 이렇게 하면 SQL 쿼리가 모델에 저장된 테이블인 것처럼 탐색할 수 있는 새 탐색 탭으로 이동합니다.
3. 이 탐색 분석에 URL을 복사하여 공유할 수 있습니다.
4. 이 쿼리를 여기에서 프로젝트의 파생 테이블로 직접 추가하려면 프로젝트에 뷰 추가를 클릭하세요.

SQL Runner에서 탐색하는 동안 커스텀 필드 생성

커스텀 필드 기능에 대한 액세스 권한이 있으면 커스텀 필드를 사용하여 SQL Runner에서 모델링되지 않은 필드를 시각화할 수 있습니다. 이전 섹션에서 설명한 대로 톱니바퀴 메뉴에서 탐색을 클릭합니다. 그런 다음 필드 선택 도구에서 다음을 수행합니다.

• 맞춤 입력란 섹션을 클릭하여 열고 추가를 클릭하여 맞춤 측정기준, 맞춤 측정 항목 또는 표 계산을 만듭니다. 맞춤 입력란 섹션이 없는 경우 맞춤 입력란을 만들 수 있는 권한이 없는 것입니다.
• 측정의 점 3개로 된 옵션 메뉴](/exploring-data/exploring-data#three-dot_options_menu)를 클릭하고 필터 측정을 선택하여 기존 측정값에서 필터링된 맞춤 측정을 생성합니다.
• 측정기준의 점 3개로 된 옵션 메뉴를 클릭하고 측정 유형 (예: 합계 또는 개수)을 선택하여 측정기준에서 맞춤 측정을 만듭니다.

SQL Runner에 나열된 테이블 탐색

데이터베이스 탭에 있는 테이블 탐색 옵션을 사용하여 연결의 임시 테이블을 만듭니다. 이렇게 하면 모델링하기 전에 테이블에서 Looker를 사용하여 LookML 뷰처럼 테이블을 탐색할 수 있습니다.

표의 '탐색' 메뉴를 열고 프로젝트에 테이블을 추가할지 결정할 수 있습니다. 탐색의 SQL 탭을 사용하여 Looker가 데이터베이스로 전송하는 SQL 쿼리를 확인한 다음 SQL Runner에서 열기 버튼을 사용해 쿼리를 SQL Runner로 다시 가져올 수도 있습니다.

1. 데이터베이스 탭을 클릭합니다.
2. SQL Runner에서 테이블의 톱니바퀴를 클릭하고 테이블 탐색을 선택합니다.
3. Looker는 테이블 뷰가 포함된 임시 모델을 생성한 다음 탐색을 표시합니다.
4. Looker는 테이블의 각 열에 측정기준 필드를 제공합니다. 이는 Looker에서 프로젝트 시작 시 모델을 생성하는 방식과 동일합니다.
5. Looker에는 모든 날짜 필드의 기간이 자동으로 포함됩니다.
6. Looker에는 개수 측정도 포함되어 있습니다.

테이블 탐색 옵션을 사용하면 탐색과 연결된 LookML 파일이 없으며 이 파일은 테이블의 임시 보기일 뿐입니다.

SQL Runner를 사용하여 디버깅

SQL Runner는 쿼리 내 SQL 오류 검사에도 유용한 도구입니다.

SQL Runner 오류 강조표시

SQL Runner가 SQL 명령어에서 오류 위치를 강조표시하고 오류 메시지에 오류 위치를 포함합니다.

제공되는 위치 정보는 데이터베이스 언어에 따라 다릅니다. 예를 들어 MySQL은 오류가 포함된 줄 번호를 제공하지만 Redshift는 오류의 문자 위치를 제공합니다. 다른 데이터베이스 언어에는 이러한 동작이나 다른 동작 중 하나가 있을 수 있습니다.

SQL Runner는 또한 SQL 명령어에서 첫 번째 구문 오류의 위치를 빨간색으로 밑줄을 그리고 행을 "x"로 표시합니다. 'x' 위에 마우스를 가져가면 오류에 대한 자세한 정보를 확인할 수 있습니다. 문제를 해결한 후 실행을 클릭하여 쿼리에 오류가 있는지 확인합니다.

SQL Runner를 사용하여 Explore에서 오류 확인

탐색에서 SQL 구문 오류가 발생하는 경우 SQL Runner를 사용하여 오류 위치 및 맞춤법 오류나 명령어 누락과 같은 오류 유형을 확인할 수 있습니다.

1. 탐색의 데이터 바에서 SQL 탭을 클릭합니다.
2. SQL Runner에서 열기를 클릭하여 SQL Runner에서 쿼리를 엽니다.

이렇게 하면 Explore의 생성된 SQL이 SQL Runner로 복사됩니다. 위에서와 같이 SQL Runner가 SQL 명령어의 오류 위치를 강조표시하고 오류 메시지에 오류의 위치를 포함합니다. 그런 다음 오류를 수정하고 SQL Runner에서 쿼리를 수정하고 다시 실행할 수 있습니다.

SQL Runner를 사용하여 파생 테이블의 오류 확인

SQL Runner를 사용하여 파생 테이블에서 SQL 오류를 확인하는 방법은 SQL Runner를 사용하여 파생 테이블 테스트 Looker 커뮤니티 도움말을 참조하세요.