- データソースが正しく接続されているかどうかを確認する
- データソースで利用できるカラムとデータ型を調べる
- SQL Editor、Query Builder、またはAI Generator を使用して、データソースから特定のデータを検索する
SQL Editor の使用
SQL Editor を使って、クエリを作成・編集・保存することができます。Note: Query Builder を使用してクエリを作成する手順については、Query Builder を参照してください。
SQL Editor でのクエリの作成
Data Explorer でSQL Editor を使用してクエリを実行するには、次の手順に従います。1
Select a Connection をクリックして、コネクションのドロップダウンメニューを表示します。
2
コネクションを選択します。利用可能なすべての項目が左のカラムに表示されます。
- 実線のテーブルアイコンは、テーブルを示します。
- 破線の四角いアイコンは、ビューを示します。
- アイテムの右側にある青い二重ドキュメントアイコンは、アイテムがキャッシュされていることを示します。詳しくは、Caching を参照してください。
3
クエリしたいデータを選択します。AI クエリジェネレータを使用する場合は、AI Generator ヘルプを参照してください。
- テーブルやビュー全体を選択するクエリを作成するには、左のカラムからクエリエディタに項目をドラッグします。あるいは、テーブルまたはビューの横にある三点リーダー（縦）をクリックして、結果の場合はQuery を、メタデータ情報の場合はView Details を選択します。
- 特定のカラムを選択するには、クエリを実行する項目の横にある展開矢印をクリックします。続いてカラムをクエリエディタにドラッグします。
- 一部のデータソースタイプには、よく使用されるクエリ用のSQL テンプレートが含まれています。これらのクエリは、接続名を展開するとCommon Queries の下に表示されます。クエリ名の横にある三点リーダー（縦）をクリックし、Query をクリックしてクエリを表示します。必要に応じて、クエリを編集することも可能です。Execute をクリックしてクエリを実行します。 また、SQL Editor でSQL 構文を使って手動でクエリを入力することも可能です。Connect AI には、SQL 構文の入力をサポートするオートコンプリート機能があります。
4
Limit フィールドに、返したい結果の数を設定します。デフォルトではリミットは100です。リミットは自由に設定できますが、このフィールドには必ず値を入力してください。（SQL LIMIT 句は使用しないでください。）
5
クエリを実行するには、Execute をクリックします。
クエリの編集
クエリの実行後、次のタスクを実行できます。- クエリエディタにクエリパラメータを入力し、手動でクエリを変更。
- Clear を選択し、表示されるプロンプトでOK をクリックしてクエリエディタをクリア。
- 新しいテーブルまたはカラムをクエリエディタにドラッグし、表示されるプロンプトでOK をクリックして、新しいクエリを作成。
クエリの保存
Data Explorer では、クエリを保存しておくことができ、後からクエリパラメータを再入力することなくクエリを呼び出すことができます。 クエリを作成し正常に実行すると、Data Explorer ペインの上部にあるSave ボタンが利用可能になります。クエリを保存して後でアクセスするには、以下の手順に従います。1
Save > Save as Saved Query をクリックします。Save Query ダイアログが表示されます。
2
クエリの名前を入力し、Confirm をクリックします。
3
Data Explorer Saved Queries メニューが開き、新しく保存したクエリがリストに表示されます。
保存されたクエリの使用
保存されたクエリは、Data Explorer のナビゲーションペインにあるSaved Queries フォルダから利用でき、保存されたDerived View はDerived Views フォルダで利用できます。保存されたクエリを実行するには、クエリ名の横にある三点リーダー（縦）をクリックし、Query を選択します。保存されたクエリの内容がQuery Editor に入力され、Execute をクリックして結果を取得できます。Note：メタデータを含むDetails タブは、保存されたクエリの実行時には使用できません。
Derived View の設定
Data Explorer のDerived Views 機能を使用すると、コネクションから動的に入力されたデータ結果を返すクエリを作成して保存できます。保存したDerived View はインテグレーションからクエリでき、コネクション内のデータが変更されると結果が自動的に更新されます。Note: Derived View を作成または変更できるのはConnect AI の管理者のみです。クエリユーザーは、管理者が作成した保存済みのDerived View をクエリできます。
Derived View の作成
新しいDerived View を作成するには、次の手順に従ってください。1
Query Builder またはSQL Editor でクエリを作成します。クエリを実行すると、Save ボタンが表示されます。Save > Save as Derived View をクリックします。Create Derived View ダイアログが表示されます。
2
View Name フィールドにDerived View の名前を入力します。これは、保存されたDerived Views のリストに表示される名前です。
3
Confirm をクリックし、Derived View を保存します。
インテグレーションからDerived View へのアクセス
インテグレーションツールからDerived View にクエリを発行する場合、Connection またはDatabase の値をCData に設定します。次の構文は、Derived View にアクセスするための正しい完全修飾構文を示しています。Data Explorer からDerived View へのアクセス
Derived View を作成すると、Data Explorer のDerived Views のリストに表示されます。リスト内のエントリの横にある三点リーダー（縦）をクリックして、オプションのリストを開くことができます。
- クエリを実行するにはQuery をクリックします。Derived View の内容がData Explorer のクエリビューに表示され、Execute をクリックしてクエリ結果を表示できます。
- メタデータを返すにはView Details をクリックします。このアクションは自動的に実行され、結果がDetails タブに表示されます。
- Derived View の名前を変更するにはRename を、リストから削除するにはDelete をクリックします。
Derived View の編集
Derived View のクエリを編集するには、上記で説明した方法のいずれかを使用してアクセスします。Derived View を開いた状態で、クエリフィールド内のテキストを必要に応じて編集し、Data Explorer 上部のSave Changes をクリックします。 Derived View の名前を変更するには、リスト内のエントリの横にある三点リーダー（縦）をクリックしてRename を選択します。表示されたダイアログに新しい名前を入力し、Confirm をクリックします。Derived View の削除
Derived View を削除するには、リスト内のエントリの横にある三点リーダー（縦）をクリックしてDelete を選択します。表示される確認ダイアログで、再びDelete をクリックします。Note: Derived View を削除しても、ソース内のデータには影響ありません。
スケジュールクエリの作成
クエリをスケジュールクエリとして保存できます。スケジュールクエリは、ユーザーが定義した間隔で実行されます。 スケジュールクエリを作成するには：1
Query Builder またはSQL Editor を使用して、クエリを作成します。
2
Save > Save as Scheduled Query をクリックします。
3
次に、実行頻度など、スケジュールクエリの詳細を入力します。詳しくは、Scheduled Queries を参照してください。