SQL Labとは？
SQL Labでは、DBにあるテーブルを参照したり、
クエリ文を作成して異なるテーブルを結合したり、データ形式を変換したりするなど、テーブルを編集できます。
クエリ文を作成して実行ボタンをクリックすると、生成されたデータセットを確認できます。
実行ボタンをクリックした後に表示されるチャート作成ボタンをクリックすると、該当データセットがデータベースに仮想データセットとしてアップロードされ、
アップロードされたデータセットでチャートを作成したり、分析サービスでそのままEDAを実行したりできます。
SQL Lab画面の紹介
❶ データベース / スキーマ / テーブル
HEARTCOUNTに接続されたデータベース、スキーマ、テーブルを確認できます。SQLエディタで使用するデータベース、ス키ーマ、テーブルを先に選択します。
テーブルを選択すると、❷領域で該当テーブルのカラム情報とデータをプレビューできます。
❷ テーブルカラム情報
❶で選択したテーブルのカラム名とデータ型情報を確認できます。
❸ Text to SQL（TTS）
ユーザーの自然言語による質問をSQLクエリ文に変換する機能です。
クエリとして作成したい質問や、作成したいテーブル構造を入力し、生成 ボタンをクリックすると、該当する質問に対するクエリ文が自動で作成され、作成されたクエリの説明を確認できます。
❹ SQLエディタ
データ編集用のクエリ文を作成・編集するSQLエディタです。データベースに対応したSQL言語で作成します。
SQLを作成する際、FROM句でテーブルを呼び出す場合はスキーマを指定してください。
クエリ文にスキーマを指定していない仮想データセットの場合、後でEDA機能を利用する際に問題が発生する可能性があります。
❺ テーブル結果画面
実行されたクエリの結果が表示されます。
SQL Labボタンの紹介
❶ 実行
SQLエディタにクエリを作成した後、実行ボタンをクリックすると、上の画像の❼のように実行されたクエリの結果データセットが出力されます。
実行されたクエリ結果をDBにテーブル（Table）またはビュー（View）として保存するには？
쿼리 실행 후 実行 버튼 우측에 ∨ 버튼을 클릭하여 저장 형식을 선택합니다.
•
DB에 테이블 생성하기 : 쿼리 결과가 입력한 이름의 테이블로 DB에 저장됩니다.
•
DB에 뷰 생성하기 : 쿼리 결과가 입력한 이름의 뷰로 DB에 저장됩니다.
実行 버튼 우측에 ∨ 버튼이 없는 경우, 데이터베이스에서 테이블 및 뷰 생성을 허용해야 합니다.
테이블 및 뷰 이름 지정 가이드는 다음과 같습니다. •
영어 대문자 대신 “영어 소문자”, 띄어쓰기 대신 “_(언더바)” 사용을 권장합니다.
◦
특히 숫자와 특수문자 사용은 지양해주세요.
◦
예) customer_orders, order_items
•
DB에 이미 존재하는 물리적 테이블(Physical dataset) 또는
ABI에서 사용 중인 가상 테이블(Virtual dataset)과 같은 이름을 사용하지 않도록 유의해주세요.
생성한 테이블을 ABI에서 사용하고자 할 경우, 별도로 테이블을 ABI에 연결해주는 작업이 필요합니다. •
생성하는 테이블 및 뷰는 저장 시점의 SQL Lab 화면에 선택된 스키마에 저장됩니다.•
SQL Lab 화면에 선택된 스키마가 없는 경우, 테이블 및 뷰 생성 시 CTAS & CVAS SCHEMA에 저장됩니다.
•
스키마 설정은 설정 ▾ → 데이터베이스 연결 → 수정하기 → 고급설정 → SQL Lab ▾ → CTAS & CVAS SCHEMA 에서 가능합니다.
❷ 제한 행 수
쿼리에 대한 결과를 몇 행으로 제한할지 선택합니다.
여기서 선택된 제한 행 수는 추후 チャート作成 또는 다운로드되는 데이터셋에도 영향을 미칩니다.
❸ 쿼리 실행 시간
쿼리문이 실행되는데 걸리는 시간을 나타냅니다.
HH:MM:SS.mmm형식으로 표현됩니다.
❹ 저장하기
해당 쿼리로 ABI에 쿼리 또는 가상 테이블로 저장하려면, 저장하기 또는 우측 화살표 버튼을 클릭하세요.
•
저장하기 : 작성한 쿼리를 별도로 ABI에 저장하여 관리할 수 있습니다.
쿼리 이름을 설정하고 설명을 추가할 수 있습니다. 保存された 쿼리는 상단 메뉴바의 SQL - 保存された 쿼리에서 확인할 수 있습니다.
•
データセットを保存する : 新しい名前で保存에서 데이터셋 名前を指定して保存をクリックすると、作成したクエリで構成された仮想テーブルがABIに保存されます。 保存された 테이블은 상단 메뉴바의 데이터셋에서 확인할 수 있습니다.
데이터셋 덮어쓰기를 선택하고 저장하면 새로운 테이블이 저장되지 않고, 기존에 있는 가상 테이블을 교체할 수 있습니다.
테이블 저장 시 이름 지정 가이드
•
영어 대문자 대신 영어 소문자, 띄어쓰기 대신 _(언더바) 사용을 권장합니다.
◦
특히 숫자와 특수문자 사용은 지양해주세요.
◦
예) customer_orders, order_items
•
DB에 이미 존재하는 물리적 테이블(Physical dataset)과 같은 이름을 사용하지 않도록 유의해주세요.
❺ 링크 복사
지금 SQL 편집기에 작성된 쿼리를 다시 SQL 편집기에서 바로 실행할 수 있는 링크가 클립보드에 복사됩니다.
❻ ···
•
렌더링 HTML : HTML 태그를 사용한 랜더링 기능을 활성화/비활성화 할 수 있습니다.
•
자동 완성 : 쿼리문 자동 완성 기능을 활성화/비활성화 할 수 있습니다.
•
매개변수 : JSON을 활용하여 매개변수 세트를 지정합니다. (예: {"my_table": "foo"}), 그러면 Jinja 템플릿 문법을 사용하여 SQL에서 사용할 수 있습니다. (예: SELECT * FROM {{ my_table }})
•
SQL 포맷팅 : 작성된 SQL 쿼리를 가독성 있게 정렬해줍니다.
•
단축키 목록 : 키보드 단축키를 확인할 수 있습니다.
❼ 결과 탭
쿼리 실행 결과를 확인할 수 있습니다.
❽ 쿼리 실행 이력 탭
이 탭에서 이전에 실행했던 쿼리 내역을 확인하고, 이전 실행 쿼리를 다시 실행할 수 있습니다.
❾ 테이블 미리보기
선택한 테이블의 컬럼 정보와 최대 100개 행까지 미리보기로 제공합니다.
❿ チャート作成
쿼리 실행 결과로 차트를 생성하고,
차트 저장 시 사용된 테이블을 가상 데이터셋(Virtual dataset)으로 데이터베이스에 업로드할 수 있습니다.
차트는 기본적으로 표 형식으로 제공되나,
시각화 유형을 변경하여 막대차트나 파이차트 등의 차트를 만들 수 있습니다.
⓫ CSV 형식으로 다운로드
쿼리 결과를 csv 파일로 다운로드 받을 수 있습니다.
⓬ 클립보드에 복사하기
쿼리 결과가 클립보드에 복사되어 필요한 곳에 붙여넣을 수 있습니다.
⓭ 검색창
쿼리 결과 데이터를 검색할 수 있습니다.
