> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arc.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MySQL Lookup Configuration

> Retrieve values from MySQL and insert them into an Arc message in the flow.

Lookup アクションは、MySQL から値を取得し、それらの値をフロー内の既存のArc
メッセージに挿入します。

<ol><li>CData Arc フローで、MySQL コネクタへのインプットを行うコネクタから矢印をドラッグします。</li>
<li>必要に応じて、**Sample File** を選択します。サンプルファイルは、コネクタがファイルの構造に関する詳細なコンテキストを提供し、[フィルタ](#filters)条件を構築するのに役立つため、推奨されます。</li>
<li>以下の設定手順を完了したら、Arc フローで、MySQL コネクタから、結果のXML またはヘッダーデータを配置するコネクタに矢印をドラッグします。</li></ol>

## Lookup Configuration

このセクションで、クエリに含めるテーブルとカラムを定義します。
[デザイナーモード](#designer-mode)は、クエリをフリーフォームで作成する必要がなく、
クエリの対象としたいテーブルとカラムを選択するのに役立ちます。ただし、クエリを最初から記述したい
場合は、[クエリモード](#query-mode)を使用することができます。

### Designer Mode

以下の手順に従い、デザイナーを使用して MySQL コネクタのLookup アクションを設定します。

![Lookup デザイナー](https://docs.arc.cdata.com/26.2/images/dbsa_lookup_designer.png)

<ol><li>**Table** ドロップダウンを使用して、含めるテーブルを選択します。</li>
<li>このテーブルから含めたい**Columns** のセットを選択します。</li>
<li>**Output Destination**：クエリの応答値をXML ファイルに挿入するには **XPath** を選択し、クエリの応答値をメッセージヘッダーに挿入するには **Header** を選択します。
<ul><li>XPath：XPath を選択すると、デスティネーションは2つの部分に分かれます。**Parent-Level XPath** は、XML ドキュメントにすでに存在している必要があります。**New Node Name** は、ルックアップの結果を保持するためにXML ドキュメントに挿入されるノードの名前です。クエリの各カラムには、ここで提供されるXML 要素の中に独自のXML 要素（リーフレベル）があります。</li>
<li>Header：Header を選択すると、コネクタはクエリのカラムごとに1つのヘッダーをアウトプットメッセージに追加します。値は、データベースから返されるレコードごとにカンマで区切られます。</li></ul></li>
<li>**Record Limit** を使用して、クエリが複数の結果を返した場合の処理を指定します。
<ul><li>ドロップダウンで **Use First Result** を選択すると、**Error if multiple results** を使用して、複数の結果が返された場合にエラーを表示することができます。</li>
<li>**Custom Limit** を選択すると、表示されるフィールドで制限値を指定する必要があります。</li></ul></li>
<li>**Order by** を使用して、結果を並べ替えるカラムを選択します。</li>
<li>[フィルタ](#filters)セクションでは、インプットファイルからのヘッダーやXML への参照を含む、クエリのWHERE 句を作成するためのフィルタを作成できます。</li></ol>

### Filters

個々のフィルタやフィルタのグループを定義することで、複雑なフィルタを作成できます。見やすさのために、
バーの右側にある展開アイコン ![展開アイコン](https://docs.arc.cdata.com/26.2/images/validate_expander.png) を
クリックして、**Filters** セクションを展開します。

フィルタを追加するには、**Add Filter** または **Add Group** をクリックします。

フィルタを作成するときは、ドロップダウンを使用して選択を行い、演算子を選択します。次に、
フィルタリングする値を指定します。以下から選択できます。

<ul><li>メッセージヘッダー</li>
<li>入力XML</li>
<li>静的値</li></ul>

フィルタで入力XML を選択すると、サンプルファイルをアップロードした場合、エディタにドキュメントの
ツリー表示が現れるので、次の画像のように必要なXPath を簡単に見つけることができます。

![Lookup フィルタの設定](https://docs.arc.cdata.com/26.2/images/dbsa_lookup_filter.png)

フィルタやグループは並べ替えが可能です。ハンドル ![ハンドル](https://docs.arc.cdata.com/26.2/images/xmlmap_condition_handle.png) をクリックし、オブジェクトを新しい位置にドラッグします。

### Query Mode

以下の手順に従い、クエリモードを使用して MySQL コネクタのLookup アクションを設定します。

![Lookup クエリモード](https://docs.arc.cdata.com/26.2/images/dbsa_lookup_query.png)

<ol><li>**Output Destination**：クエリの応答値をXML ファイルに挿入するには **XPath** を選択し、クエリの応答値をメッセージヘッダーに挿入するには **Header** を選択します。
<ul><li>XPath：XPath を選択すると、デスティネーションは2つの部分に分かれます。**Parent-Level XPath** は、XML ドキュメントにすでに存在している必要があります。**New Node Name** は、ルックアップの結果を保持するためにXML ドキュメントに挿入されるノードの名前です。クエリの各カラムには、ここで提供されるXML 要素の中に独自のXML 要素（リーフレベル）があります。</li>
<li>Header：Header を選択すると、コネクタはクエリのカラムごとに1つのヘッダーをアウトプットメッセージに追加します。値は、データベースから返されるレコードごとにカンマで区切られます。</li></ul></li>
<li>**Query** に、MySQL テーブルからデータを取得するSQL クエリを入力します。
<ul><li>XPath：パスを `${XPATH:/path/to/element}` のように記述します。例：`SELECT CustomerID FROM Customers WHERE CustomerName = ${XPATH:/Items/Invoices/Customer}`。</li>
<li>Header：パスを `${HEADER:HeaderName}` のように記述します。</li></ul></li>
<li>2つのチェックボックスで、クエリが複数の結果を返した場合の処理を設定できます。
<ul><li>常に最初の結果を使用するには、**Use First Result** をオンにします。</li>
<li>複数の結果が返された場合にエラーを表示するには、**Error if multiple results** をオンにします。</li></ul></li></ol>

## Advanced

![Lookup の高度な設定](https://docs.arc.cdata.com/26.2/images/dbsa_lookup_advanced.png)
<ol><li>**No Matching Record Found Action** を使用して、クエリに一致するレコードが見つからなかった場合の動作を指定します。</li>
<li>MySQL コネクタは、各Lookup に対して直接 MySQL にクエリする代わりに、ローカルキャッシュに対して
Lookup クエリを実行できます。これにより、特に大規模なデータベースでクエリのパフォーマンスが
向上します。これを有効にするには、**Enable cache** にチェックを入れ、
残りのフィールドを設定します。
<ul><li>**Cache Tolerance**：コネクタがデータソースにクエリを発行してキャッシュをリフレッシュする頻度を制御します。</li>
<li>**Cache Tolerance Unit**：**Cache Tolerance** の単位。分、時、日から選択します。</li>
<li>**Cache Provider**：キャッシュデータベースへの接続を容易にするために使用するドライバーを選択します。</li>
<li>**Connection String**：設定すると、コネクタはここで指定したデータベースをキャッシュに使用します。</li></ul></li></ol>

> [!NOTE]
>
> <ul><li>クエリがキャッシュから結果を返さない場合、コネクタは MySQL を直接クエリします。</li>
> <li>クエリステートメントに `limit`、`offset`、`groupby` パラメータが含まれている場合、キャッシュ機能は動作しません。これらのクエリは MySQL に直接送られます。</li></ul>

## Test Lookup

**Test Lookup** ボタンを使用すると、手動でファイルを処理することなく
設定をチェックして結果を確認できます。**Save Sample Data** ボタンを使用すると、
アウトプットをサンプルとして保存し、後のフローでマッピングすることができます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.