> ## 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.

# Adobe Commerce Select

> Retrieve data from Adobe Commerce and bring it into Arc.

Select アクションは、Adobe Commerceからデータを取得してCData Arc に取り込みます。

## Tables and Columns

接続を設定してテストしたら、**Action** タブをクリックします。**Action** ドロップダウンが**Select** に設定されていることを確認します。**Add Table Structure** をクリックして、テーブルとカラムを定義します。

**Structure Type** を選択します。構造タイプは、コネクタがAdobe Commerceをクエリする方法を決定します。利用可能な構造タイプは次の通りです。

<ul><li>[Parent and Child Tables](#parent-and-child-tables)：コネクタは親子階層を使用してテーブルをクエリします。追加のテーブルを子テーブルとして追加したり、フロー内の複数のコネクタを使用して追加できます。</li>
<li>[Joined Tables](#joined-tables)：コネクタは、2つ以上の関連テーブルのデータを組み合わせる単一のJOIN クエリを発行します。</li></ul>

構造タイプについては、以降のセクションで説明します。

> [!NOTE]
>
> Joined Tables はAdobe Commerceに対して単一のクエリを発行します。これは、APIレート制限を適用するデータソースに対して、Parent and Child Tables よりも効率的です。

### Parent and Child Tables

ドロップダウンリストを使用して、Adobe Commerceからターゲットテーブルを選択します。

![Dropdown for selecting a target table in the source structure editor](https://docs.arc.cdata.com/26.4/images/dbsa_select_tableadd_263.png)

矢印を使用して子テーブルを構造に追加します。次の画像は、Bill が親テーブルとして選択され、子テーブルが選択可能な状態を示しています。選択が完了したら、**Apply** をクリックします。

![Table list with Bill selected as the parent table and a child table ready to be selected](https://docs.arc.cdata.com/26.4/images/dbsa_tablelist_263.png)

#### Results

**Apply** をクリックすると、**Items** ノードが結果構造に表示されます。クエリのカラムとフィルタを設定するには、テーブル名ノードの省略記号（**...**）をクリックして**Table Settings** を選択します。

**Edit \[table name] Settings** ダイアログが開き、**Columns** と**Filters** の2つのタブが表示されます。

![Edit table Settings dialog showing the Columns tab with source table tags](https://docs.arc.cdata.com/26.4/images/dbsa_join_results.png)

**Columns** タブには、選択したテーブルのすべてのカラムが一覧表示されます。各カラムには、ソーステーブルを示すタグが表示されます。デフォルトでは、すべてのカラムが選択されています。カラムのチェックを外すと、クエリ出力から除外されます。

> [!NOTE]
>
> **Source** テーブル名へのリンクをクリックして**Edit Source Structure** ペインに戻ることで、さらにテーブルを選択できます。詳細については、[子テーブル](https://docs.arc.cdata.com/26.4/self-hosted/ja/connectors/adobe-commerce/adobe-commerce-ac.md#child-tables)を参照してください。

**Columns** タブの下部にある**Order by** フィールドを使用して、カラムで出力をソートし、**ASC**（昇順）または**DESC**（降順）を選択します。

**Filters** タブでは、コネクタが選択する行を制限するフィルタを追加できます。詳細については、[フィルタ](#filters)を参照してください。

#### Options

**Edit Source Structure** ダイアログの右側にある**Options** パネルには、コネクタがレコードを処理する方法を制御する設定が含まれています。これらの設定はテーブルデザイナーと並べて使用でき、クエリ全体に適用されます。

<ul><li>**Only process new or changed records**：増分処理を有効にし、前回の実行以降に新しく追加または変更された行のみをコネクタが選択するようにします。</li>
<li>**Update \[column] with \[value] when rows are processed**：各行が処理された後、指定した値でカラムを更新します。</li></ul>

**Edit Source Structure** ダイアログの上部にある**Preview XML** または**Code View** を切り替えると、出力構造のプレビューや基になるXML 設定を表示することもできます。

### Joined Tables

構造タイプとして**Joined Tables** を選択すると、JOIN デザイナーが表示されます。JOIN デザイナーを使用して、Adobe Commerce内のテーブルの関連付けを定義します。コネクタはこの設定を単一のJOIN クエリに変換します。

![JOIN designer with empty join row fields](https://docs.arc.cdata.com/26.4/images/dbsa_join_designer.png)

JOIN デザイナーの各行は1つの結合関係を表し、次のフィールドが含まれます。

<ul><li>**Join Type**：実行するSQL JOIN の種類。利用可能なオプションはAdobe Commerceがサポートするものによって異なります。一般的なオプションには**Inner Join**、**Left Join**、**Right Join**、**Full Outer Join** があります。</li>
<li>**Left Table**：JOIN の左側のテーブル。最初の行の左テーブルがクエリのベーステーブルになります。</li>
<li>**Left Column**：JOIN に使用する左テーブルのカラム。</li>
<li>**Right Table**：JOIN の右側の関連テーブル。</li>
<li>**Right Column**：左カラムと一致する右テーブルのカラム。</li></ul>

次の例は、**Bill** テーブルを共有の**Id** カラムで**Bill1** テーブルに結合しています。

![JOIN designer with Bill and Bill1 tables joined on the Id column](https://docs.arc.cdata.com/26.4/images/dbsa_join_addtable.png)

これは次のクエリと同等です：

```sql theme={null}
SELECT ... FROM Bill INNER JOIN Bill1 ON Bill.Id = Bill1.Id
```

3つ以上のテーブルを結合するには、**Add Join** をクリックして別の結合行を追加します。追加した各行は、前の結合結果に新しいテーブルを結合します。

結合の設定が完了したら、**Apply** をクリックします。

#### Results

**Apply** をクリックすると、**Results** ノードが結果構造に表示されます。JOIN 出力のカラムとフィルタを設定するには、Results ノードの省略記号（**...**）をクリックして**Results Settings** を選択します。

**Edit Results Settings** ダイアログが開き、**Columns** と**Filters** の2つのタブが表示されます。

![Edit Results Settings dialog showing the Columns tab with source table tags](https://docs.arc.cdata.com/26.4/images/dbsa_join_results.png)

**Columns** タブには、すべての結合テーブルのすべてのカラムが一覧表示されます。各カラムには、ソーステーブルを示すタグが表示されます。デフォルトでは、すべてのカラムが選択されています。カラムのチェックを外すと、クエリ出力から除外されます。

> [!NOTE]
>
> 2つの結合テーブルが同じカラム名を共有する場合、コネクタは競合を避けるために重複するカラムに自動的にテーブル名のプレフィックスを付けます。

**Columns** タブの下部にある**Order by** フィールドを使用して、カラムで出力をソートし、**ASC**（昇順）または**DESC**（降順）を選択します。

**Filters** タブでは、コネクタが選択する行を制限するフィルタを追加できます。詳細については、[フィルタ](#filters)を参照してください。

#### Options

**Edit Source Structure** ダイアログの右側にある**Options** パネルには、コネクタがレコードを処理する方法を制御する設定が含まれています。これらの設定はJOIN デザイナーと並べて使用でき、JOIN クエリ全体に適用されます。

<ul><li>**Use column \[x] for processing new or changed records**：増分処理を有効にし、前回の実行以降に新しく追加または変更された行のみをコネクタが選択するようにします。Joined Tables 設定では、このカラムはベース（最左）テーブルのものである必要があります。結合テーブルのカラムはこの設定には使用できません。</li>
<li>**Update \[column] with \[value] when rows are processed**：各行が処理された後、指定した値でカラムを更新します。</li></ul>

**Edit Source Structure** ダイアログの上部にある**Preview XML** または**Code View** を切り替えると、出力構造のプレビューや基になるXML 設定を表示することもできます。

## Filters

必要に応じてフィルタを追加し、コネクタが選択するデータを制限できます。設定ダイアログの**Filters** タブをクリックしてフィルタを設定します。コネクタはフィルタをクエリ構文に変換します。

> [!NOTE]
>
> ユースケースに合わない場合は、データにフィルタを適用する必要はありません。

### Creating a Filter

フィルタを作成するには、次の手順に従います。

<ol><li>**Add Filter** をクリックします。</li>
<li>カラムのドロップダウンで、フィルタリングするカラムを選択します。</li>
<li>条件のドロップダウンで、フィルタリング条件を選択します。利用可能な条件は、選択したカラムのデータ型によって異なります。例えば、数値カラムには**Less Than or Equal To** という条件があり、文字列カラムには**Contains** があります。</li>
<li>値フィールドに値を入力します。条件に値が不要な場合（例：**Is Null**）、値フィールドは表示されません。</li></ol>

次の画像は、**Vendor** という名前のカラムに対するフィルタの例を示しています。このフィルタを設定すると、コネクタは**Vendor** カラムに**CData** を含む行のみを選択します。

![Filter configured on the Vendor column with Contains CData condition](https://docs.arc.cdata.com/26.4/images/dbsa_filter.png)

### Filter Groups

**Add Filter** をクリックしてさらにフィルタを作成することで、複数のフィルタを適用できます。デフォルトではすべてのフィルタが同じグループに属します。**Add Group** をクリックしてネストされたグループを作成し、異なるロジックでフィルタを分離します。

各グループには、上部に次のオプションがあります。

<ul><li>**NOT** トグル：グループ全体のロジックを反転します。例えば、**Amount Less Than or Equal To 5000** を含むグループでNOT を有効にすると、コネクタは金額が5000 より大きい行のみを選択するよう指示されます。</li>
<li>**And / Or** トグル：このグループが隣接するフィルタまたはグループとどのように関連するかを決定します。
<ul><li>**And** を選択した場合、このグループの条件は隣接する条件に加えて真である必要があります。</li>
<li>**Or** を選択した場合、このグループの条件は隣接する条件の代替となります。</li></ul></li></ul>

次のスクリーンショットは、複数のフィルタグループの例を示しています。

![Multiple filter groups showing AND and OR logic](https://docs.arc.cdata.com/26.4/images/dbsa_filter_group.png)

この例では、次のすべてが真である場合にフィルタ条件が満たされます。

<ul><li>**Vendor** カラムに**CData** が含まれている</li>
<li>**Status** カラムが**Active** または**Pending** に等しい</li>
<li>**Amount** カラムが**5000** 以下では*ない*（つまり、Amount が5000 より大きい）</li></ul>

このフィルタ条件が満たされると、コネクタは一致するデータをSelect してフローを下って渡します。

## Example Arc Flow

Select で構成されたAdobe Commerceコネクタのテーブルとカラムを選択したら、そのコネクタをArc フローの先頭に配置します。次のスクリーンショットは、Adobe Commerce Select コネクタ、XML Map コネクタ、CSV コネクタ、および末尾のFile コネクタから成るフローの例を示しています。

![](https://docs.arc.cdata.com/26.4/images/dbsa_select_flow.png)

このフローの例では、データは次の手順を通過します。

<ol><li>**Adobe Commerce\_Select** コネクタがAdobe Commerce接続からデータを取得します。</li>
<li>このデータは**Source File** として**XML\_Map** コネクタに渡され、**Source** ツリーにマッピングされます。</li>
<li>**CSV1** コネクタからのデータは**Destination File** として**XML\_Map** コネクタに渡され、**Destination** ツリーにマッピングされます。
![](https://docs.arc.cdata.com/26.4/images/dbsa_xmlmap_select.png)</li>
<li>**XML\_Map** コネクタは、**Source** 要素を同じ名前の**Destination** 要素に自動的にマッピングしようとします。これらは手動で変更でき、**Source** から**Destination** へ要素をドラッグすることで空のマッピングを補完できます。
![](https://docs.arc.cdata.com/26.4/images/dbsa_xmlmap_elements.png)</li>
<li>**Adobe Commerce\_Select** からのデータで変更された**CSV1** のファイルは、その後**CSV1** からフローを下って渡されます。</li></ol>


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