> For the complete documentation index, see [llms.txt](https://docs.dashcomb.com/dashcomb-help-center/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dashcomb.com/dashcomb-help-center/ide/query-region/dbkueri.md).

# DBクエリ

連携機能パネルのDBクエリタブから、SQLデータベースに対して送信・実行するSQLクエリを作成できます。

送信先のSQLデータベースは、データソース メニューから登録します。詳しい手順は、[Data Source接続の設定](https://github.com/dashcomb/gitbook-doc/blob/master/ide/query-region/broken-reference/README.md) を参照してください。

## **DBクエリ一覧**

編集中の管理画面で作成されたDBクエリ名が表示されます。

DBクエリ名をクリックすると、その内容が表示され、編集することができます。

### **キーワードフィルター**

入力したキーワードで、DBクエリを絞り込みできます。

（例）`employee` を入力すると、`all_employees` 、`delete_empluyee` ... などの該当するオブジェクトが表示されます。

### DBクエリの操作

操作したいDBクエリにマウスカーソルを載せると、操作アイコンが表示されます。このアイコンをクリックして、各種操作を行うことができます。

#### DBクエリの追加

キーワードフィルターの隣の<img src="/files/nnk5fNFpQzHO78sG54bM" alt="" data-size="line">をクリックすると、DBクエリが追加されます。

#### DBクエリ名の変更

<img src="/files/htponMpbKKTy4U2nYBuX" alt="" data-size="line">をクリックすると、DBクエリの名称を変更できます。

#### DBクエリの削除

<img src="/files/4Gcj3lwAm0jfyFIaV9vy" alt="" data-size="line">をクリックすると、DBクエリが削除されます。

## DBクエリの編集

DBクエリの一覧からDBクエリ名をクリックすると、内容が表示されます。

<figure><img src="/files/cwIBE7IJJE0ROqpwC8r2" alt=""><figcaption></figcaption></figure>

### DBクエリの入力

データスクリプトパネルで直接入力ができます。\
右下の拡張表示のアイコンをクリックすると、データスクリプトパネルのエディタがポップアップ表示され入力ができます。

<figure><img src="/files/gqSpBU3v7djSRoYraA9U" alt=""><figcaption></figcaption></figure>

SQLを整形をクリックするとインデントを揃えます。

<figure><img src="/files/F1seCehvrJkObh7MDqWp" alt=""><figcaption></figcaption></figure>

### データソースの選択

SQLクエリを送信・実行するSQLデータベースを選択します。

SQLデータベースは、[データソース](/dashcomb-help-center/ide/others/dtassu.md) メニューから登録します。

### 前処理

SQLクエリを送信・実行する前に実行される処理を登録できます。

<figure><img src="/files/TZxal3B6PYUGf0jli27f" alt=""><figcaption></figcaption></figure>

#### 実行前アクション

本番処理を実行する前の動作を、以下から選択できます。

<table><thead><tr><th width="198">選択内容</th><th>動作</th></tr></thead><tbody><tr><td>アクション無し</td><td>実行前アクションを設定しません。すぐに本番処理が開始されます。</td></tr><tr><td>確認</td><td>本番処理を実行する前に、ユーザー確認モーダルを表示します。<br>モーダルの「確認」ボタンをクリックすると、本番処理が実行されます。</td></tr><tr><td>承認</td><td>本番処理を実行する前に、責任者に承認を求めることができます。<br>承認要件モーダルの「提出」ボタンをクリックすると、選択されたユーザーに承認依頼が届きます。承認されると、本番処理が実行されます。</td></tr></tbody></table>

承認の設定手順については、[承認フローを作成](/dashcomb-help-center/tips-and-tricks/add-approval-flow.md) を参照してください。

#### JavaScript

前処理として、JavaScript プログラムを実行することができます。

トグルスイッチをONにすると、JavaScript プログラムの入力欄が表示されます。

前処理のJavaScriptでreturn した内容は、`{{ DBクエリ名.preData }}` を用いて、本番処理のSQLクエリ内で利用できます。

JavaScriptのテスト実行をクリックすると実行されます。

インスペクター画面のpreDataで結果の確認ができます。

### 本番処理

SQLデータベースに送信・実行するSQLクエリを入力します。`{{}}` で囲んで、JavaScriptの式を埋め込むことができます。

#### SQL AIアシスタント(β)を利用する

AI アシスタントで、SQLクエリを生成できます。

トグルスイッチをONにすると、AI アシスタント機能が有効になります。

本番処理のSQLクエリ欄に以下の書式を入力しEnterキーを押すと、SQLクエリが自動生成されます。

```
-- S: 生成したいSQLの要件

(例)
-- S: 担当者ごとの売上額を月ごとに集計する
```

### 後処理

本番処理のSQLクエリが送信・実行された後に実行する処理を登録できます。

#### JavaScript

後処理として、JavaScript プログラムを実行することができます。

トグルスイッチをONにすると、JavaScript プログラムの入力欄が表示されます。

本番処理のSQLクエリの結果は、`this.data` で利用できます。

後処理のJavaScriptでreturn した内容は、`{{ DBクエリ名.data }}` で参照できるようになります。

#### 成功時

DBクエリの処理が成功した場合のアクションを設定できます。

<img src="/files/htponMpbKKTy4U2nYBuX" alt="" data-size="line">をクリックすると、アクションエディタが開きます。

#### 失敗時

DBクエリの処理が失敗した場合のアクションを設定できます。

<img src="/files/htponMpbKKTy4U2nYBuX" alt="" data-size="line">をクリックすると、アクションエディタが開きます。

{% hint style="info" %}
アクションの設定については、[アクションエディタ](/dashcomb-help-center/ide/property-region/action-editor.md) を参照してください。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dashcomb.com/dashcomb-help-center/ide/query-region/dbkueri.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.