watsonx.data 照会履歴について

## はじめに
watsonx.data の 照会履歴 (Query history) をご紹介します。　
照会履歴 (Query history)は、watsonx.data で実行されたクエリー(Query 紹介)に関連する詳細情報を表示します。
また　クエリーの検索やフィルタリング、表示列をカスタマイズすることができます。照会履歴 (Query history)のページでクエリーをクリックするとSQL文の詳細を表示したりコピーしたりEXPLAINの結果を表示することができます。　
具体的な例をwatsonx.data 2.1.2を使用してご紹介します。

## 照会履歴 (Query history) 
watsonx.data の Web Consoleから　照会履歴にへ入ります。　
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/991ab313-81a9-429b-8d6b-cf62df7937eb.png)


照会履歴は次のように クエリーID(query_id) や照会(query), 状態(status)などが表示されています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/6ba96a67-9c33-4844-86f8-3d7955181e1c.png)

watsonx.data ならではなのが エンジン(engine)です。 複数のPrestoエンジンへのクエリーが一覧で表示されています。

### <img src=https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/6be71120-55d3-4ff9-b515-746a1f7cf3b7.png width="5%"> クエリー検索
次は CANADAを含むクエリーを検索した例です。<img src=https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/6be71120-55d3-4ff9-b515-746a1f7cf3b7.png width="5%"> に `CANADA`と入力すると `and n_name = 'CANADA'`を含むSQLが検索されました。　
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/285a3694-1e01-4566-806a-d94a049aaace.png)

### <img src=https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/ff86c50f-6617-4fa8-894b-a300b7b2e0c1.png width="5%"> フィルター　
フィルターを作成するために<img src=https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/ff86c50f-6617-4fa8-894b-a300b7b2e0c1.png width="5%"> をクリックします。　するとフィルターの候補になる項目が表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/affd0141-a35f-44e2-a607-99faa438dc23.png)
ここでは `user02`にチェックをいれると　user02が実行したクエリーのみが表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/a9290bcc-f5d5-41f9-800e-8eedfdbbd1ad.png)

### <img src=https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/c4444ca1-a208-4ca0-b669-168e3a9435b0.png width="5%"> 列のカスタマイズ

表示する列をカスタマイズすることができます。

### <img src=https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/9a94852d-01ce-41e7-ba00-2a458f8d987a.png width="5%"> 最新表示
最新表示するには　<img src=https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/9a94852d-01ce-41e7-ba00-2a458f8d987a.png width="5%">　をクリックします。

### <img src=https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/4599c2dd-f9e3-4f54-9622-e93f33836ce1.png width="20%"> CSVにエクスポート
`CSVにエクスポート`で表示されている結果をCSVファイル(utf-8)に保存することができます。

## 照会履歴で実行計画(EXPLAINの実行結果)の表示
照会履歴 (Query history)では簡単にSQL文(照会・ステートメント)を表示したり、実行計画(EXPLAINの結果)を表示したりすることができます。残念なことに、照会履歴で実行計画を表示するためには、表名などに完全修飾名(catalog.schema.tableの形式)を使用する必要があります。
1. 詳細を見たいクエリーの右側のトリコロンをクリックします。    
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/b5d6d831-279d-47e0-9312-f8bf964aebf6.png)
2. 右側のトリコロンをクリックすると　`実行計画の表示`と`照会ワークスペースで開く`が表示されます。今回は`実行計画の表示`を選択します。
3. するとクエリーの情報が表示されます。
　- 次は照会ステートメント(SQL文)を表示させています。
　- 表名はたとえば"hive_data"."hs_no_oart".partとcatalog.schema.tableの形式の完全修飾名で指定されています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/234e048b-ec88-45d8-ba56-d5977db3fc6a.png)
　- `論理実行計画タブ`を選択すると`EXPLAIN SQL文`の結果が表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/2bcf208c-1e06-4914-b74f-796075917ec3.png)
　- `分散実行計画タブ`を選択すると `EXPLAIN (TYPE DISTRIBUTED) SQL文`の結果が表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/0999016f-17c1-454f-8019-d502ebf2fb38.png)
  - `実行計画分析`を選択すると `EXPLAIN ANALYZE SQL文`の結果が表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/74d950f9-6337-49a9-a94f-4c46acaf2165.png)
　



## 環境
環境のご紹介です。今回ご紹介した例は次の環境で実行しています。
- OCP Version : 4.16
- CP4D 5.1.2 
    - watsonx.data 2.1.2
- 構成済みのPresto エンジンについて
    - P01(Presto Java)
        - タイプ :  Presto (Java) v0.286
        - サイズ :  スターター
        - コーディネーター・ノード : 1
        - ワーカー・ノード : 0
    - PCpp (Presto(C++))
        - タイプ :   Presto (C++) v0.286
        - サイズ : スターター
        - コーディネーター・ノード : 1
        - ワーカー・ノード : 3 

次は今回使用したwatsonx.dataのWeb　Consoleのインフラストラクチャー・マネージャーのイメージです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/855502/f6ca3373-36a5-4b45-8b55-c47e52962668.png)

## まとめ
watsonx.data 照会履歴の使い方をご紹介しました。