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ファイルでダウンロードできます。
⓬ クリップボードにコピー
クエリ結果がクリップボードにコピーされ、必要な場所に貼り付けられます。
⓭ 検索ボックス
クエリ結果データを検索できます。
