SQL Runner は、データベースに直接アクセスし、そのアクセスをさまざまな方法で活用できます。SQL Runner を使用すると、スキーマ内のテーブルの操作、SQL クエリからのアドホック Explore の使用、データに対する事前に記述されたクエリの実行、SQL Runner の履歴の参照、結果のダウンロード、クエリの共有、派生テーブルとして LookML プロジェクトへの追加など、さまざまな便利なタスクを簡単に実行できます。
このページでは、SQL Runner を使用して派生テーブルを作成する方法と、SQL Runner を使用して派生テーブルをデバッグする方法について説明します。詳細については、以下のドキュメントをご覧ください。
クエリからの派生テーブルの作成
SQL Runner のクエリから派生テーブルを作成するには、いくつかの方法があります。
LookML プロジェクトへの追加
SQL Runner は、派生テーブルの SQL をモデルに追加する前にテストするのに最適な場所です。別のツールからクエリを取得し、SQL Runner でテストして、プロジェクトに追加することもできます。
- SQL Runner を使用して、派生テーブルに使用する SQL クエリを作成します。
- 右上にある歯車メニューから [Add to Project] をクリックします。
- この派生テーブルを追加するプロジェクトを選択します。
- 派生テーブルのビュー名を入力します。
- [追加] をクリックして、クエリを派生テーブルとしてプロジェクトに追加します。
- Looker を開発モードに切り替え（まだない場合）、選択したプロジェクトで新しい派生テーブルビューを開きます。古い YAML ベースの LookML を使用するプロジェクトを選択した場合、Looker は YAML ベースの LookML で派生テーブルを提供します。新しい LookML を使用するプロジェクトを選択した場合、Looker は新しい LookML で派生テーブルを提供します。
派生テーブルの LookML の取得
SQL Runner クエリから派生テーブルを作成する別の方法として、SQL Runner の歯車メニューから [派生テーブル LookML を取得] オプションを使用することもできます。プロジェクトへの追加オプションと同様に、Looker は SQL クエリを派生テーブルに変換するために必要な LookML を提供します。そこから LookML をコピーして自分でプロジェクトに貼り付けることができます。これは、既存の派生テーブルを置き換える場合に役立ちます。
SQL Runner クエリから派生テーブルを作成するには:
- SQL Runner を使用して、派生テーブルに使用する SQL クエリを作成します。
- 歯車メニューをクリックし、[Get Derived Table LookML] を選択します。
- 生成された LookML をコピーします。または、[プロジェクトに追加] をクリックし、派生テーブルを追加するプロジェクトを選択して、[ビュー名] にビューの名前を入力します。
[プロジェクトに追加] をクリックしてプロジェクトに派生テーブルを追加していない場合は、プロジェクトを開き、Looker IDE でプロジェクト ファイル リストの上部にある [+] をクリックします。または、フォルダのメニューをクリックしてフォルダ内にファイルを作成することもできます。
[ビューを作成] を選択します。
Looker により、ビューのリストの上部に空のボックスが表示されます。新しいビューの名前を入力して、Enter キーを押します。Looker では、ファイル名に大文字、小文字、数字、アンダースコア、Unicode 文字を使用できます。ビューファイル名にLookerで使用できない文字が含まれている場合、これらの文字はアンダースコアに置き換えられます。
新しいビューが開きます。
新しいビューの内容をすべて削除し、先ほどコピーした派生テーブルLookMLを貼り付けます。
SQL Runner を使用したデバッグ
SQL Runner は、派生テーブルの定義で SQL エラーをチェックする際にも便利です。
SQL ランナーエラーのハイライト表示
SQL Runner は SQL コマンドのエラーの場所をハイライト表示し、エラー メッセージにエラーの位置を含めます。
提供される位置情報は、データベース言語によって異なります。たとえば、MySQL ではエラーを含む行番号が、Redshift ではエラーの文字位置が示されます。他のデータベース言語では、このような動作がある場合があります。
SQL Runner は、SQL コマンドの 最初の構文エラーの場所を赤で下線で示し、その行を &xt で囲みます。「x」にカーソルを合わせると、エラーの詳細が表示されます。その問題を解決したら、[実行] をクリックして、クエリにエラーがあるかどうかを確認します。
SQL Runner を使用して派生テーブルをテストする
派生テーブルからエラーが表示された場合は、SQL ステートメントを SQL Runner にコピーし、SQL のさまざまな部分をテストしてエラーの場所を絞り込むことで、エラーの原因を特定できます。詳細については、Looker コミュニティのトピックで、SQL Runner を使用した派生テーブルのテストをご覧ください。