# mulesoft Database Connector (db-connector) - Full Documentation

<!-- document id=148d46d0a7728343234f3fa3d39d2a28ac4ab6a3a5182ebe505c21b16f6e6569 url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-acb.md -->

# Anypoint Code Builder を使用した Database Connector の設定

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\]

## [](#新しいインテグレーションプロジェクトの作成)新しいインテグレーションプロジェクトの作成

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\]

## [](#インテグレーションプロジェクトへのコネクタの追加)インテグレーションプロジェクトへのコネクタの追加

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\]

## [](#configuring-trigger)フローのトリガーの設定

トリガー (ソース) は、指定された条件が満たされたときにフローを開始します。 次のトリガーのいずれかを設定して、Database Connector で使用できます。

- **\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​  
    一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成して、フローを開始します。
- **\[HTTP\] > \[Listener\]**​  
    設定されたホストとポートで要求を受信するたびにフローを開始する
- **Scheduler (スケジューラー)**​  
    時間ベースの条件が満たされたときにフローを開始します。
    
    [anypoint-code-builder::acb-component-scheduler.adoc](https://docs.mulesoft.com/jp/anypoint-code-builder/acb-component-scheduler)を参照してください。

たとえば、​**On Table Row**​ ソースを設定する手順は、次のとおりです。

1. **\[On Table Row\]**​ コンポーネントをキャンバスに追加します。
2. キャンバスで ​**\[On Table Row\]**​ コンポーネントをクリックします。
3. **\[General (一般)\]**​ タブで、次の属性を設定します。
    
    <table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">UI 項目</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Table (テーブル)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">選択元のデータベーステーブルの名前。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Watermark column (ウォーターマーク列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">この列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが処理されます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Id column (ID 列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>[Watermark column (ウォーターマーク列)]</strong>​ と組み合わせて使用されます。これは行 ID とみなす列の名前です。提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回処理されていないことが確認されます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Scheduling strategy (スケジュール戦略)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">時間ベースの条件に基づいてフローの実行をトリガーします。この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。​<a href="#scheduling-strategy">XML でのスケジュール戦略の設定</a>​ を参照してください。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
</tbody>
</table>
4. **\[Advanced (詳細)\]**​ タブを選択して、次の属性を設定します。
    
    <table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">UI 項目</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Transactional action (トランザクションアクション)</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションの操作で使用できる結合アクションの種別:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NONE (デフォルト)</p>
</li>
<li>
<p>ALWAYS_BEGIN</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Transaction type (トランザクション種別)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">作成するトランザクションの種別 ([XA] または [Local (ローカル)])。使用できるかどうかは、Mule Runtime バージョンによって決まります。  <strong>[Local (ローカル)]</strong>​ がデフォルトです。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Primary node only (プライマリノードのみ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">このオプションを選択すると、クラスターで実行されるときに ​<strong>On Table Row</strong>​ トリガーがプライマリノード上でのみ実行されます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Redelivery policy (再配信ポリシー)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。​<a href="https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation#RedeliveryPolicy" class="xref page">「Redelivery Policy (再配信ポリシー)」</a>​を参照してください。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Query timeout (クエリタイムアウト)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません (​<code>0</code>​)。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Query timeout unit (クエリタイムアウト単位)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">使用する時間の単位を選択します。デフォルトは [SECONDS (秒)] です。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Fetch size (フェッチサイズ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">行が ​<code>ResultSet</code>​ から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Max rows (最大行数)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">このメッセージプロセッサーで生成される ​<code>ResultSet</code>​ オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Reconnection strategy (再接続戦略)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。​<a href="https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation#reconnect" class="xref page">「Reconnect (再接続)」</a>​、​<a href="https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation#reconnect-forever" class="xref page">「Reconnect Forever (繰り返し再接続)」</a>​、および​<a href="#configuring-reconnection-strategy">XML での再接続戦略の設定</a>​を参照してください。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
</tbody>
</table>

## [](#configuring-connector-in-xml)XML でのコネクタの設定

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-xml-maven-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-xml-maven-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-xml-maven-partial.adoc\[\]

## [](#configuring-database-connection)データベース接続の設定

Database (Database Connector) は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。次の XML の例は、最も一般的なデータベース (Derby、Microsoft SQL Server、MySQL、Oracle、汎用データベースなど) に接続する方法を示しています。

### [](#configuring-derby)Derby データベース接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config" >
	<db:derby-connection database="derbyDB" />
</db:config>
```

### [](#configuring-generic)汎用接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="org.h2.Driver"
    url="jdbc:h2:file:/tmp/datasenseDB"/>
</db:config>
```

### [](#configuring-microsoft-sql)Microsoft SQL Server 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:mssql-connection
    host="0.0.0.0"
    port="553"
    user="Max"
    password="password"
    databaseName="microsoftDB" />
</db:config>
```

### [](#configuring-mysql)MySQL データベース接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:my-sql-connection
  host="0.0.0.0"
  port="3306"
  user="Max"
  password="POWERS"
  database="mysqlDB"/>
</db:config>
```

### [](#configuring-oracle)Oracle 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:oracle-connection
  host="192.168.99.100"
  port="1521" instance="xe"
  user="system"
  password="oracle" />
</db:config>
```

## [](#configuring-jdbc)JDBC ドライバーの設定

接続を設定したら、JDBC ドライバーを追加します。次の例は、MySQL データベースのドライバーを追加する方法を示しています。

1. Maven 連動関係をプロジェクトの ​`pom.xml`​ ファイルに追加します。
    
    ```xml
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.48</version>
    </dependency>
    ```
2. Mule でドライバーの連動関係を Database Connector に公開するように ​`pom.xml`​ ファイルを設定します。
    
    ```xml
    <build>
        <plugins>
            <!-- Only used to declare the shared libraries-->
            <plugin>
                <groupId>org.mule.tools.maven</groupId>
                <artifactId>mule-maven-plugin</artifactId>
                <version>1.0.0</version>
                <configuration>
                    <sharedLibraries>
                        <sharedLibrary>
                            <groupId>mysql</groupId>
                            <artifactId>mysql-connector-java</artifactId>
                        </sharedLibrary>
                    </sharedLibraries>
                </configuration>
            </plugin>
        </plugins>
    </build>
    ```

## [](#adding-components-to-project)プロジェクトへのコンポーネントの追加

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\]

## [](#configuring-component-attributes)コンポーネント属性の設定

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\]

### [](#configuring-bulk-delete)Bulk Delete 操作の設定

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も削除操作を実行できます。

1. **\[Bulk delete\]**​ 操作をキャンバスに追加します。
2. キャンバスで ​**\[Bulk delete\]**​ コンポーネントをクリックします。
    
    Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]
3. **\[Advanced (詳細)\]**​ タブを選択して、次の属性を設定します。
    
    <table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">UI 項目</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Transactional action (トランザクションアクション)</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​ (デフォルト)</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Query timeout (クエリタイムアウト)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません (​<code>0</code>​)。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Query timeout unit (クエリタイムアウト単位)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">使用する時間の単位を選択します。デフォルトは [SECONDS (秒)] です。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Fetch size (フェッチサイズ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">行が ​<code>ResultSet</code>​ から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Max rows (最大行数)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">このメッセージプロセッサーで生成される ​<code>ResultSet</code>​ オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">パラメーターの型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation#ParameterType" class="xref page">[Parameter Type (パラメーター種別)</a>]​ の配列。このパラメーターを使用して、必要に応じて (1 つまたは複数の) パラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
</tbody>
</table>

### [](#configure-bulk-insert)Bulk Insert 操作の設定

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も挿入を実行できます。これにより、1 つの挿入操作を何度も実行する場合よりもパフォーマンスが向上します。

1. **\[Bulk insert\]**​ 操作をキャンバスに追加します。
2. キャンバスで ​**\[Bulk insert\]**​ コンポーネントをクリックします。 Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\] Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]

### [](#configuring-bulk-update)Bulk Update 操作の設定

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も更新を実行できます。これにより、1 つの更新操作を何度も実行する場合よりもパフォーマンスが向上します。

1. **\[Bulk update\]**​ 操作をキャンバスに追加します。
2. キャンバスで ​**\[Bulk update\]**​ コンポーネントをクリックします。 Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\] Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]

### [](#configuring-delete)Delete 操作の設定

この操作は、データベースのデータを削除します。

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\] Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]

### [](#configuring-execute-ddl)Execute DDL 操作の設定

この操作は、データベースに対して DDL クエリを実行できます。

1. **\[Execute DDL\]**​ 操作をキャンバスに追加します。
2. キャンバスで ​**\[Execute DDL\]**​ コンポーネントをクリックします。
3. **\[General (一般)\]**​ タブの ​**\[SQL Query Text (SQL クエリテキスト)\]**​ で、実行する SQL クエリのテキストを追加します。 Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]

### [](#configuring-execute-script)Execute Script 操作の設定

この操作は、1 つのデータベースステートメントで SQL スクリプトを実行します。スクリプトは提供された場合、パラメーターバインドなしで実行されます。

1. **\[Execute Script\]**​ 操作をキャンバスに追加します。
2. キャンバスで ​**\[Execute Script\]**​ コンポーネントをクリックします。
3. **\[General (一般)\]**​ タブで、次の属性を設定します。
    
    <table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">UI 項目</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SQL Query Text (SQL クエリテキスト)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">実行する SQL クエリのテキスト。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Script path (スクリプトパス)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">読み込むファイルの場所を指定します。ファイルはクラスパスまたはディスク上のリソースを参照できます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
</tbody>
</table>

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]

### [](#configuring-insert)Insert 操作の設定

この操作は、データベースにデータを挿入します。

1. **\[Insert\]**​ 操作をキャンバスに追加します。
2. キャンバスで ​**\[Insert\]**​ コンポーネントをクリックします。 Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\] Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]

### [](#configuring-query-single)Query Single 操作の設定

この操作は、データベースレコードから 1 つのデータレコードを選択します。複数の行を返す SQL クエリを指定した場合、最初のレコードのみが処理されて返されます。この操作ではストリーミングは使用されません。つまり、​**Query Single**​ 操作の実行直後に、選択したレコードの完全なコンテンツがメモリに読み込まれます。

1. **\[Query Single\]**​ 操作をキャンバスに追加します。
2. キャンバスで ​**\[Query Single\]**​ コンポーネントをクリックします。 Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\] Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]

### [](#configuring-select-operation)Select 操作の設定

この操作は、データベースからデータを照会します。すべての結果が一度に読み込まれることでパフォーマンスとメモリの問題が発生することを防止するため、結果は自動的にストリーミングされます。つまり、必要に応じて ​_fetchSize_​ 行分のページが読み込まれます。この操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

1. **\[Select\]**​ 操作をキャンバスに追加します。
2. キャンバスで ​**\[Select\]**​ コンポーネントをクリックします。 Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\] Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]

### [](#configuring-stored-procedure)Stored Procedure 操作の設定

この操作は、データベースでストアドプロシージャーを呼び出します。ストアドプロシージャーが 1 つ以上の ​`ResultSet`​ インスタンスを返した場合、結果はすべて一度には読み込まれません。パフォーマンスとメモリの問題が発生することを防止するため、結果は自動的にストリーミングされます。この動作は、​`_fetchSize_`​ 行分のページが必要に応じて遅延して読み込まれることを意味します。​**Stored procedure**​ 操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

1. **\[Stored Procedure\]**​ 操作をキャンバスに追加します。
2. キャンバスで ​**\[Stored Procedure\]**​ コンポーネントをクリックします。
3. **\[General (一般)\]**​ タブで、次の属性を設定します。
    
    <table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">UI 項目</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SQL Query Text (SQL クエリテキスト)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">実行する SQL クエリのテキスト。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Input Parameters (入力パラメーター)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: <code>where id = :myParamName</code>​)。マップの値には、各パラメーターの実際の割り当てが含まれます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Input-Output Parameters (入力-出力パラメーター)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。​<a href="https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation#storedProcedure" class="xref page">「Stored Procedure」</a>​を参照してください。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Output Parameters (出力パラメーター)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。​<a href="https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation#storedProcedure" class="xref page">「Stored Procedure」</a>​を参照してください。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
</tbody>
</table>
    
    Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]

### [](#configuring-update-operation)Update 操作の設定

この操作は、データベースのデータを更新します。

1. **\[Update\]**​ 操作をキャンバスに追加します。
2. キャンバスで ​**\[Update\]**​ コンポーネントをクリックします。 Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\] Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-config-db-general-tab.adoc\[\]

## [](#xml-examples)XML の例

### [](#configuring-reconnection-strategy)XML での再接続戦略の設定

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-xml-examples.adoc\[\]

### [](#configuring-streaming-strategy)XML でのストリーミング戦略の設定

ストリーミング戦略を使用して、Mule によるストリームの処理方法を設定できます。

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-xml-examples.adoc\[\]

### [](#scheduling-strategy)XML でのスケジュール戦略の設定

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$acb-xml-examples.adoc\[\]

## [](#create-new-config-xml)新しい設定 XML ファイルの作成

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\]

## [](#関連情報)関連情報

Unresolved include directive in modules/ROOT/pages/database-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] \* [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation) \* [ストリーミング戦略の設定](https://docs.mulesoft.com/mule-runtime/latest/streaming-about)

<!-- document id=42096434feb7cbeb08449e767b04318041e1d226f62e13053a1a15b44c7b7ed4 url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-studio.md -->

# Anypoint Studio を使用した Database Connector 1.10 の設定

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

1. [Mule プロジェクトを作成します](#create-mule-project)​。
2. [コネクタを Mule プロジェクトに追加します](#add-connector-to-project)​。
3. [コネクタのフローのソースを設定します](#configure-input-source)​。
4. [フローにコネクタの操作を追加します](#add-connector-operation)​。
5. [コネクタのグローバル要素を設定します](#configure-global-element)​。

[「アプリケーションログの表示」](#view-app-log)​で説明されているように、コネクタを実行するときに、アプリケーションログを表示して問題を確認できます。

Studio で初めてコネクタを設定する場合は、​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​[「Database Connector リファレンス」](https://docs.mulesoft.com/jp/db-connector/1.10/database-documentation)​を参照してください。

## [](#create-mule-project)Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

1. Studio で、​**\[File (ファイル)\] > \[New (新規)\] > \[Mule Project (Mule プロジェクト)\]**​ を選択します。
2. Mule プロジェクトの名前を入力して、​**\[Finish (完了)\]**​ をクリックします。

## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する

Database Connector を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​`pom.xml`​ ファイルに必須の連動関係を追加します。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。
2. **\[Add Dependencies to Project (連動関係をプロジェクトに追加)\]**​ ウィンドウで、検索項目に「​`database`​」と入力します。
3. **\[Available modules (使用可能なモジュール)\]**​ で ​**\[Database Connector\]**​ をクリックします。
4. **\[Add (追加)\]**​ をクリックします。
5. **\[Finish (完了)\]**​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

## [](#configure-input-source)ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。 次の入力元のいずれかを Database Connector で使用するように設定できます。

- **\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​  
    一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成して、フローを開始します。
- **\[HTTP\] > \[Listener\]**​  
    設定されたホストとポートで要求を受信するたびにフローを開始する
- **Scheduler**​  
    時間ベースの条件が満たされたときにフローを開始する

たとえば、​**\[On Table Row (テーブルの行)\]**​ ソースを設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​ を選択します。
2. **\[On Table Row (テーブルの行)\]**​ を Studio キャンバスにドラッグします。
3. **\[On Table Row (テーブルの行)\]**​ 設定画面で、必要に応じて ​**\[Display Name (表示名)\]**​ 項目の値を変更します。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックして、アプリケーション内のすべてのソースのインスタンスで使用できるグローバル要素を設定します。
5. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックして、ウィンドウを閉じます。
6. **\[On Table Row (テーブルの行)\]**​ 設定画面の ​**\[Table (テーブル)\]**​ で、選択元のテーブルの名前を指定します。

## [](#add-connector-operation)フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

Database Connector の操作を追加する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database Connector\]**​ を選択し、目的の操作を選択します。
2. その操作を Studio キャンバスの入力元の右にドラッグします。

次のスクリーンショットは、Anypoint Studio の \[Mule Palette (Mule パレット)\] ビューの Database Connector の操作を示しています。

![Database Connector の操作](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-operations.png)

Figure 1. Database Connector の操作

## [](#configure-global-element)コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することをお勧めします。Database Connector は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。最も一般的なデータベース (MySQL、Oracle、および Microsoft SQL Server) に容易に接続できるように、このコネクタにはさまざまな接続種別が含まれます。

Database Connector のグローバル要素を設定する手順は、次のとおりです。

1. Studio キャンバスで操作を選択します。
2. 操作の設定画面で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Anypoint Studio の Database Connector の ​**\[Global Element Configuration (グローバル要素設定)\]**​ ウィンドウを示しています。

![Database Connector の \[Global Element Configuration (グローバル要素設定)\]](_images/database-global-configuration.png)

Figure 2. Database Connector の \[Global Element Configuration (グローバル要素設定)\]

## [](#view-app-log)アプリケーションログの表示

問題を確認するため、アプリケーションログを次の方法で表示できます。

- アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。
- コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログは OS コンソールに表示される。

アプリケーションのログファイル (​`log4j2.xml`​) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​`MULE_HOME/logs/<app-name>.log`​ でアプリケーションログを表示することもできます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Anypoint Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)
- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.10/database-documentation)
- [Mule Maven プラグインを使用したドライバー表示の設定](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-driver-configuration)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=bc583f7891483722b9160b27e847303cd57de4fc495b1b58d319778f1c3482fe url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-studio.md -->

# Anypoint Studio を使用した Database Connector 1.12 の設定

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

1. [Mule プロジェクトを作成します](#create-mule-project)​。
2. [コネクタを Mule プロジェクトに追加します](#add-connector-to-project)​。
3. [コネクタのフローのソースを設定します](#configure-input-source)​。
4. [フローにコネクタの操作を追加します](#add-connector-operation)​。
5. [コネクタのグローバル要素を設定します](#configure-global-element)​。

[「アプリケーションログの表示」](#view-app-log)​で説明されているように、コネクタを実行するときに、アプリケーションログを表示して問題を確認できます。

Studio で初めてコネクタを設定する場合は、​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​[「Database Connector リファレンス」](https://docs.mulesoft.com/jp/db-connector/1.12/database-documentation)​を参照してください。

## [](#create-mule-project)Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

1. Studio で、​**\[File (ファイル)\] > \[New (新規)\] > \[Mule Project (Mule プロジェクト)\]**​ を選択します。
2. Mule プロジェクトの名前を入力して、​**\[Finish (完了)\]**​ をクリックします。

## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する

Database Connector を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​`pom.xml`​ ファイルに必須の連動関係を追加します。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。
2. **\[Add Dependencies to Project (連動関係をプロジェクトに追加)\]**​ ウィンドウで、検索項目に「​`database`​」と入力します。
3. **\[Available modules (使用可能なモジュール)\]**​ で ​**\[Database Connector\]**​ をクリックします。
4. **\[Add (追加)\]**​ をクリックします。
5. **\[Finish (完了)\]**​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

## [](#configure-input-source)ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。 次の入力元のいずれかを Database Connector で使用するように設定できます。

- **\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​  
    一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成して、フローを開始します。
- **\[HTTP\] > \[Listener\]**​  
    設定されたホストとポートで要求を受信するたびにフローを開始する
- **Scheduler**​  
    時間ベースの条件が満たされたときにフローを開始する

たとえば、​**\[On Table Row (テーブルの行)\]**​ ソースを設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​ を選択します。
2. **\[On Table Row (テーブルの行)\]**​ を Studio キャンバスにドラッグします。
3. **\[On Table Row (テーブルの行)\]**​ 設定画面で、必要に応じて ​**\[Display Name (表示名)\]**​ 項目の値を変更します。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックして、アプリケーション内のすべてのソースのインスタンスで使用できるグローバル要素を設定します。
5. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックして、ウィンドウを閉じます。
6. **\[On Table Row (テーブルの行)\]**​ 設定画面の ​**\[Table (テーブル)\]**​ で、選択元のテーブルの名前を指定します。

## [](#add-connector-operation)フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

Database Connector の操作を追加する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database Connector\]**​ を選択し、目的の操作を選択します。
2. その操作を Studio キャンバスの入力元の右にドラッグします。

次のスクリーンショットは、Anypoint Studio の \[Mule Palette (Mule パレット)\] ビューの Database Connector の操作を示しています。

![Database Connector の操作](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-operations.png)

Figure 1. Database Connector の操作

## [](#configure-global-element)コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することをお勧めします。Database Connector は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。最も一般的なデータベース (MySQL、Oracle、および Microsoft SQL Server) に容易に接続できるように、このコネクタにはさまざまな接続種別が含まれます。

Database Connector のグローバル要素を設定する手順は、次のとおりです。

1. Studio キャンバスで操作を選択します。
2. 操作の設定画面で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Anypoint Studio の Database Connector の ​**\[Global Element Configuration (グローバル要素設定)\]**​ ウィンドウを示しています。

![Database Connector の \[Global Element Configuration (グローバル要素設定)\]](_images/database-global-configuration.png)

Figure 2. Database Connector の \[Global Element Configuration (グローバル要素設定)\]

## [](#view-app-log)アプリケーションログの表示

問題を確認するため、アプリケーションログを次の方法で表示できます。

- アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。
- コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログは OS コンソールに表示される。

アプリケーションのログファイル (​`log4j2.xml`​) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​`MULE_HOME/logs/<app-name>.log`​ でアプリケーションログを表示することもできます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Anypoint Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)
- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.12/database-documentation)
- [Mule Maven プラグインを使用したドライバー表示の設定](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-driver-configuration)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=093c3c0dde22ffa4f80950ce175cf0386e3c67d4b7173ffaa174b7f9df601736 url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-studio.md -->

# Anypoint Studio を使用した Database Connector 1.13 の設定

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

1. [Mule プロジェクトを作成する](#create-mule-project)​。
2. [コネクタを Mule プロジェクトに追加します](#add-connector-to-project)​。
3. [コネクタのフローのソースを設定します](#configure-input-source)​。
4. [フローにコネクタの操作を追加します](#add-connector-operation)​。
5. [コネクタのグローバル要素を設定します](#configure-global-element)​。

[「アプリケーションログの表示」](#view-app-log)​で説明されているように、コネクタを実行するときに、アプリケーションログを表示して問題を確認できます。

Studio で初めてコネクタを設定する場合は、​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​[「Database Connector リファレンス」](https://docs.mulesoft.com/jp/db-connector/1.13/database-documentation)​を参照してください。

## [](#create-mule-project)Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

1. Studio で、​**\[File (ファイル)\] > \[New (新規)\] > \[Mule Project (Mule プロジェクト)\]**​ を選択します。
2. Mule プロジェクトの名前を入力して、​**\[Finish (完了)\]**​ をクリックします。

## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する

Database Connector を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​`pom.xml`​ ファイルに必須の連動関係を追加します。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。
2. **\[Add Dependencies to Project (連動関係をプロジェクトに追加)\]**​ ウィンドウで、検索項目に「​`database`​」と入力します。
3. **\[Available modules (使用可能なモジュール)\]**​ で ​**\[Database Connector\]**​ をクリックします。
4. **\[Add (追加)\]**​ をクリックします。
5. **\[Finish (完了)\]**​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

## [](#configure-input-source)ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。 次の入力元のいずれかを Database Connector で使用するように設定できます。

- **\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​  
    一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成して、フローを開始します。
- **\[HTTP\] > \[Listener\]**​  
    設定されたホストとポートで要求を受信するたびにフローを開始する
- **Scheduler**​  
    時間ベースの条件が満たされたときにフローを開始する

たとえば、​**\[On Table Row (テーブルの行)\]**​ ソースを設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​ を選択します。
2. **\[On Table Row (テーブルの行)\]**​ を Studio キャンバスにドラッグします。
3. **\[On Table Row (テーブルの行)\]**​ 設定画面で、必要に応じて ​**\[Display Name (表示名)\]**​ 項目の値を変更します。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックして、アプリケーション内のすべてのソースのインスタンスで使用できるグローバル要素を設定します。
5. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックして、ウィンドウを閉じます。
6. **\[On Table Row (テーブルの行)\]**​ 設定画面の ​**\[Table (テーブル)\]**​ で、選択元のテーブルの名前を指定します。

## [](#add-connector-operation)フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

Database Connector の操作を追加する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database Connector\]**​ を選択し、目的の操作を選択します。
2. その操作を Studio キャンバスの入力元の右にドラッグします。

次のスクリーンショットは、Anypoint Studio の \[Mule Palette (Mule パレット)\] ビューの Database Connector の操作を示しています。

![Database Connector の操作](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-operations.png)

Figure 1. Database Connector の操作

## [](#configure-global-element)コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することをお勧めします。Database Connector は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。最も一般的なデータベース (MySQL、Oracle、および Microsoft SQL Server) に容易に接続できるように、このコネクタにはさまざまな接続種別が含まれます。

Database Connector のグローバル要素を設定する手順は、次のとおりです。

1. Studio キャンバスで操作を選択します。
2. 操作の設定画面で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Anypoint Studio の Database Connector の ​**\[Global Element Configuration (グローバル要素設定)\]**​ ウィンドウを示しています。

![Database Connector の \[Global Element Configuration (グローバル要素設定)\]](_images/database-global-configuration.png)

Figure 2. Database Connector の \[Global Element Configuration (グローバル要素設定)\]

## [](#view-app-log)アプリケーションログの表示

問題を確認するため、アプリケーションログを次の方法で表示できます。

- アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。
- コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログは OS コンソールに表示される。

アプリケーションのログファイル (​`log4j2.xml`​) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​`MULE_HOME/logs/<app-name>.log`​ でアプリケーションログを表示することもできます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Anypoint Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)
- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.13/database-documentation)
- [Mule Maven プラグインを使用したドライバー表示の設定](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-driver-configuration)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=483d963da0c40bf75f034d83020df0ffd2e98c90c90f37c8d4a707bb378dc97d url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-studio.md -->

# Anypoint Studio を使用した Database Connector 1.14 の設定

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

1. [Mule プロジェクトを作成する](#create-mule-project)​。
2. [コネクタを Mule プロジェクトに追加します](#add-connector-to-project)​。
3. [コネクタのフローのソースを設定します](#configure-input-source)​。
4. [フローにコネクタの操作を追加します](#add-connector-operation)​。
5. [コネクタのグローバル要素を設定します](#configure-global-element)​。

[「アプリケーションログの表示」](#view-app-log)​で説明されているように、コネクタを実行するときに、アプリケーションログを表示して問題を確認できます。

Studio で初めてコネクタを設定する場合は、​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​[「Database Connector リファレンス」](https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation)​を参照してください。

## [](#create-mule-project)Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

1. Studio で、​**\[File (ファイル)\] > \[New (新規)\] > \[Mule Project (Mule プロジェクト)\]**​ を選択します。
2. Mule プロジェクトの名前を入力して、​**\[Finish (完了)\]**​ をクリックします。

## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する

Database Connector を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​`pom.xml`​ ファイルに必須の連動関係を追加します。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。
2. **\[Add Dependencies to Project (連動関係をプロジェクトに追加)\]**​ ウィンドウで、検索項目に「​`database`​」と入力します。
3. **\[Available modules (使用可能なモジュール)\]**​ で ​**\[Database Connector\]**​ をクリックします。
4. **\[Add (追加)\]**​ をクリックします。
5. **\[Finish (完了)\]**​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

## [](#configure-input-source)ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。 次の入力元のいずれかを Database Connector で使用するように設定できます。

- **\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​  
    一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成して、フローを開始します。
- **\[HTTP\] > \[Listener\]**​  
    設定されたホストとポートで要求を受信するたびにフローを開始する
- **Scheduler**​  
    時間ベースの条件が満たされたときにフローを開始する

たとえば、​**\[On Table Row (テーブルの行)\]**​ ソースを設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​ を選択します。
2. **\[On Table Row (テーブルの行)\]**​ を Studio キャンバスにドラッグします。
3. **\[On Table Row (テーブルの行)\]**​ 設定画面で、必要に応じて ​**\[Display Name (表示名)\]**​ 項目の値を変更します。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックして、アプリケーション内のすべてのソースのインスタンスで使用できるグローバル要素を設定します。
5. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックして、ウィンドウを閉じます。
6. **\[On Table Row (テーブルの行)\]**​ 設定画面の ​**\[Table (テーブル)\]**​ で、選択元のテーブルの名前を指定します。

## [](#add-connector-operation)フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

Database Connector の操作を追加する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database Connector\]**​ を選択し、目的の操作を選択します。
2. その操作を Studio キャンバスの入力元の右にドラッグします。

次のスクリーンショットは、Anypoint Studio の \[Mule Palette (Mule パレット)\] ビューの Database Connector の操作を示しています。

![Database Connector の操作](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-operations.png)

Figure 1. Database Connector の操作

## [](#configure-global-element)コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することをお勧めします。Database Connector は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。最も一般的なデータベース (MySQL、Oracle、および Microsoft SQL Server) に容易に接続できるように、このコネクタにはさまざまな接続種別が含まれます。

Database Connector のグローバル要素を設定する手順は、次のとおりです。

1. Studio キャンバスで操作を選択します。
2. 操作の設定画面で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Anypoint Studio の Database Connector の ​**\[Global Element Configuration (グローバル要素設定)\]**​ ウィンドウを示しています。

![Database Connector の \[Global Element Configuration (グローバル要素設定)\]](_images/database-global-configuration.png)

Figure 2. Database Connector の \[Global Element Configuration (グローバル要素設定)\]

## [](#view-app-log)アプリケーションログの表示

問題を確認するため、アプリケーションログを次の方法で表示できます。

- アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。
- コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログは OS コンソールに表示される。

アプリケーションのログファイル (​`log4j2.xml`​) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​`MULE_HOME/logs/<app-name>.log`​ でアプリケーションログを表示することもできます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Anypoint Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)
- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation)
- [Mule Maven プラグインを使用したドライバー表示の設定](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-driver-configuration)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=dec1a13f58b9fa0a23cf24c338aa3dd25080b3f47e8350b347c2d80b5b537f6a url=/mulesoft/current/ja-jp/db-connector/1.8/database-connector-studio.md -->

# Anypoint Studio を使用した Database Connector 1.8 の設定

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

1. [Mule プロジェクトを作成します](#create-mule-project)​。
2. [コネクタを Mule プロジェクトに追加します](#add-connector-to-project)​。
3. [コネクタのフローのソースを設定します](#configure-input-source)​。
4. [フローにコネクタの操作を追加します](#add-connector-operation)​。
5. [コネクタのグローバル要素を設定します](#configure-global-element)​。

[「アプリケーションログの表示」](#view-app-log)​で説明されているように、コネクタを実行するときに、アプリケーションログを表示して問題を確認できます。

Studio で初めてコネクタを設定する場合は、​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​[「Database Connector リファレンス」](https://docs.mulesoft.com/jp/db-connector/1.8/database-documentation)​を参照してください。

## [](#create-mule-project)Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

1. Studio で、​**\[File (ファイル)\] > \[New (新規)\] > \[Mule Project (Mule プロジェクト)\]**​ を選択します。
2. Mule プロジェクトの名前を入力して、​**\[Finish (完了)\]**​ をクリックします。

## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する

Database Connector を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​`pom.xml`​ ファイルに必須の連動関係を追加します。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。
2. **\[Add Dependencies to Project (連動関係をプロジェクトに追加)\]**​ ウィンドウで、検索項目に「​`database`​」と入力します。
3. **\[Available modules (使用可能なモジュール)\]**​ で ​**\[Database Connector\]**​ をクリックします。
4. **\[Add (追加)\]**​ をクリックします。
5. **\[Finish (完了)\]**​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

## [](#configure-input-source)ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。 次の入力元のいずれかを Database Connector で使用するように設定できます。

- **\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​  
    一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成して、フローを開始します。
- **\[HTTP\] > \[Listener\]**​  
    設定されたホストとポートで要求を受信するたびにフローを開始する
- **Scheduler**​  
    時間ベースの条件が満たされたときにフローを開始する

たとえば、​**\[On Table Row (テーブルの行)\]**​ ソースを設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​ を選択します。
2. **\[On Table Row (テーブルの行)\]**​ を Studio キャンバスにドラッグします。
3. **\[On Table Row (テーブルの行)\]**​ 設定画面で、必要に応じて ​**\[Display Name (表示名)\]**​ 項目の値を変更します。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックして、アプリケーション内のすべてのソースのインスタンスで使用できるグローバル要素を設定します。
5. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックして、ウィンドウを閉じます。
6. **\[On Table Row (テーブルの行)\]**​ 設定画面の ​**\[Table (テーブル)\]**​ で、選択元のテーブルの名前を指定します。

## [](#add-connector-operation)フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

Database Connector の操作を追加する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database Connector\]**​ を選択し、目的の操作を選択します。
2. その操作を Studio キャンバスの入力元の右にドラッグします。

次のスクリーンショットは、Anypoint Studio の \[Mule Palette (Mule パレット)\] の Database Connector の操作を示しています。

![Database Connector の操作](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-operations.png)

Figure 1. Database Connector の操作

## [](#configure-global-element)コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することをお勧めします。Database Connector は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。最も一般的なデータベース (MySQL、Oracle、および Microsoft SQL Server) に容易に接続できるように、このコネクタにはさまざまな接続種別が含まれます。

Database Connector のグローバル要素を設定する手順は、次のとおりです。

1. Studio キャンバスで操作を選択します。
2. 操作の設定画面で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Anypoint Studio の Database Connector の \[Global Element Configuration (グローバル要素設定)\] ウィンドウを示しています。

![Database Connector の \[Global Element Configuration (グローバル要素設定)\]](_images/database-global-configuration.png)

Figure 2. Database Connector の \[Global Element Configuration (グローバル要素設定)\]

## [](#view-app-log)アプリケーションログの表示

問題を確認するため、アプリケーションログを次の方法で表示できます。

- アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。
- コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログは OS コンソールに表示される。

アプリケーションのログファイル (​`log4j2.xml`​) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​`MULE_HOME/logs/<app-name>.log`​ でアプリケーションログを表示することもできます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Anypoint Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)
- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.8/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=338c506908391b00c8ae49c2e943f842434d516d2094f27a92e1dcf27b49b6a7 url=/mulesoft/current/ja-jp/db-connector/1.9/database-connector-studio.md -->

# Anypoint Studio を使用した Database Connector 1.9 の設定

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

1. [Mule プロジェクトを作成します](#create-mule-project)​。
2. [コネクタを Mule プロジェクトに追加します](#add-connector-to-project)​。
3. [コネクタのフローのソースを設定します](#configure-input-source)​。
4. [フローにコネクタの操作を追加します](#add-connector-operation)​。
5. [コネクタのグローバル要素を設定します](#configure-global-element)​。

[「アプリケーションログの表示」](#view-app-log)​で説明されているように、コネクタを実行するときに、アプリケーションログを表示して問題を確認できます。

Studio で初めてコネクタを設定する場合は、​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​[「Database Connector リファレンス」](https://docs.mulesoft.com/jp/db-connector/1.9/database-documentation)​を参照してください。

## [](#create-mule-project)Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

1. Studio で、​**\[File (ファイル)\] > \[New (新規)\] > \[Mule Project (Mule プロジェクト)\]**​ を選択します。
2. Mule プロジェクトの名前を入力して、​**\[Finish (完了)\]**​ をクリックします。

## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する

Database Connector を Mule プロジェクトに追加して、XML コードにコネクタの名前空間およびスキーマの場所を自動的に入力し、プロジェクトの ​`pom.xml`​ ファイルに必須の連動関係を追加します。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。
2. **\[Add Dependencies to Project (連動関係をプロジェクトに追加)\]**​ ウィンドウで、検索項目に「​`database`​」と入力します。
3. **\[Available modules (使用可能なモジュール)\]**​ で ​**\[Database Connector\]**​ をクリックします。
4. **\[Add (追加)\]**​ をクリックします。
5. **\[Finish (完了)\]**​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

## [](#configure-input-source)ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。 次の入力元のいずれかを Database Connector で使用するように設定できます。

- **\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​  
    一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成して、フローを開始します。
- **\[HTTP\] > \[Listener\]**​  
    設定されたホストとポートで要求を受信するたびにフローを開始する
- **Scheduler**​  
    時間ベースの条件が満たされたときにフローを開始する

たとえば、​**\[On Table Row (テーブルの行)\]**​ ソースを設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database (データベース)\] > \[On Table Row (テーブルの行)\]**​ を選択します。
2. **\[On Table Row (テーブルの行)\]**​ を Studio キャンバスにドラッグします。
3. **\[On Table Row (テーブルの行)\]**​ 設定画面で、必要に応じて ​**\[Display Name (表示名)\]**​ 項目の値を変更します。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックして、アプリケーション内のすべてのソースのインスタンスで使用できるグローバル要素を設定します。
5. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックして、ウィンドウを閉じます。
6. **\[On Table Row (テーブルの行)\]**​ 設定画面の ​**\[Table (テーブル)\]**​ で、選択元のテーブルの名前を指定します。

## [](#add-connector-operation)フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

Database Connector の操作を追加する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Database Connector\]**​ を選択し、目的の操作を選択します。
2. その操作を Studio キャンバスの入力元の右にドラッグします。

次のスクリーンショットは、Anypoint Studio の \[Mule Palette (Mule パレット)\] ビューの Database Connector の操作を示しています。

![Database Connector の操作](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-operations.png)

Figure 1. Database Connector の操作

## [](#configure-global-element)コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することをお勧めします。Database Connector は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。最も一般的なデータベース (MySQL、Oracle、および Microsoft SQL Server) に容易に接続できるように、このコネクタにはさまざまな接続種別が含まれます。

Database Connector のグローバル要素を設定する手順は、次のとおりです。

1. Studio キャンバスで操作を選択します。
2. 操作の設定画面で、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で、この設定に指定する接続種別を選択します。
    
    - **Data Source Reference Connection (データソース参照接続)**
    - **Derby Connection (Derby 接続)**
    - **Generic Connection (汎用接続)**
    - **Microsoft SQL Server Connection (Microsoft SQL Server 接続)**
    - **MySQL Connection (MySQL 接続)**
    - **Oracle Connection (Oracle 接続)**

1. **\[General (一般)\]**​ タブで、コネクタのデータベース接続情報を指定します。
2. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
3. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
4. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたデータベースに接続できることを確認します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Anypoint Studio の Database Connector の ​**\[Global Element Configuration (グローバル要素設定)\]**​ ウィンドウを示しています。

![Database Connector の \[Global Element Configuration (グローバル要素設定)\]](_images/database-global-configuration.png)

Figure 2. Database Connector の \[Global Element Configuration (グローバル要素設定)\]

## [](#view-app-log)アプリケーションログの表示

問題を確認するため、アプリケーションログを次の方法で表示できます。

- アプリケーションを Anypoint Platform から実行している場合、出力は Anypoint Studio のコンソールウィンドウに表示される。
- コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログは OS コンソールに表示される。

アプリケーションのログファイル (​`log4j2.xml`​) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​`MULE_HOME/logs/<app-name>.log`​ でアプリケーションログを表示することもできます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Anypoint Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)
- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.9/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=a7755038ea86c95da52ea206ef0faba8518eb8f7c461f1e0e16a98edf10e7f81 url=/mulesoft/current/ja-jp/db-connector/1.10/index.md -->

# Database Connector 1.10

データベース用 Anypoint Connector (Database Connector) は、Mule アプリケーションとリレーショナルデータベース間の通信を確立します。Database Connector は、ほぼすべての Java Database Connectivity (JDBC) リレーショナルデータベースに接続し、SQL 操作を実行できます。アプリケーションは、同じ設定要素を使用し、たとえば各要求からの情報に基づいて接続属性を変更することで、マルチテナントシナリオに対応できます。

Database Connector には、ドライバークラス名を自動的に設定し、次のデータベースに指定されたパラメーターで JDBC URL を作成する接続プロバイダーがあります。

- Derby
- Microsoft SQL Server
- MySQL
- Oracle、

汎用の JDBC 設定を使用して、他の JDBC データベースをセットアップできます。Database Connector は JDBC に準拠しています。互換性の問題を回避するために、接続設定で JDBC に準拠しているドライバーが使用されていることを確認してください。また、Spring を使用して Anypoint Studio 内にオブジェクトを作成することで、XA トランザクションで必要とされる JDBC ​`DataSource`​ オブジェクトや ​`XADataSource`​ オブジェクトを参照することができます。

## [](#始める前に)始める前に

このコネクタを使用するには、以下に精通している必要があります。

- Anypoint Connector
- Mule Runtime Engine (Mule)
- Mule フローの要素とグローバル要素
- Anypoint Studio (Studio) を使用した Mule アプリケーションの作成

アプリケーションを作成する前に、データベースの対象リソースと Anypoint Platform へのアクセス権を持っていて、データベースの適切なデータベースドライバーをダウンロードしている必要があります。

## [](#コネクタの一般的なユースケース)コネクタの一般的なユースケース

Database Connector では、次の操作を実行できます。

- 定義済みのクエリ、動的に作成されたクエリ、および独自にカスタマイズ可能なテンプレートクエリを実行する。
- 使用するデータベース設定に応じて、コネクタ項目で DataWeave 式を指定し、属性を動的に設定する。
- source listener 操作を使用して、フローのデータソースセクション内のデータベースから読み取る。
- 他の操作を実行して、プロセスセクションの任意の場所でデータベースの読み取りと書き込む。
- 1 回の一括更新で複数の SQL 要求を実行する。
- データ自体ではなくデータ構造を変更するデータ定義言語 (DDL) 要求を実行する。
- ストアドプロシージャーおよび SQL スクリプトを実行する。

例については、​[「例」](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)​を参照してください。

## [](#対象者)対象者

- 新規ユーザー: 以下を参照
    
    - Mule アプリケーションを作成するための​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-studio)
    - [「例」](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)​には、コネクタのユースケースが 1 つ以上用意されています。
- 高度なユーザー: 以下を参照
    
    - [XML と Maven のサポート](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-xml-maven)
    - [「例」](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)​には、コネクタのユースケースが 1 つ以上用意されています。

## [](#exchange-のテンプレートと例の使用)Exchange のテンプレートと例の使用

[Anypoint Exchange](https://www.mulesoft.com/exchange/)​ は、アプリケーションのスタートポイントとして使用できるテンプレートと、完全なソリューションを具体的に示した例を提供しています。

- [Database Connector の例](https://www.mulesoft.com/exchange/?search=database&type=example)
- [Database Connector テンプレート](https://www.mulesoft.com/exchange/?search=database&type=template)

## [](#次のステップ)次のステップ

前提条件を満たし、テンプレートおよびサンプルを試したら、​[Anypoint Studio](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-studio)​ で独自のアプリケーションを作成してコネクタを設定できます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=62c3dd5c5a55d1d70c528d2485460511b98cf0e1f1595ac6e187cade4abaa465 url=/mulesoft/current/ja-jp/db-connector/1.12/index.md -->

# Database Connector 1.12

データベース用 Anypoint Connector (Database Connector) は、Mule アプリケーションとリレーショナルデータベース間の通信を確立します。Database Connector は、ほぼすべての Java Database Connectivity (JDBC) リレーショナルデータベースに接続し、SQL 操作を実行できます。アプリケーションは、同じ設定要素を使用し、たとえば各要求からの情報に基づいて接続属性を変更することで、マルチテナントシナリオに対応できます。

Database Connector には、ドライバークラス名を自動的に設定し、次のデータベースに指定されたパラメーターで JDBC URL を作成する接続プロバイダーがあります。

- Derby
- Microsoft SQL Server
- MySQL
- Oracle

汎用の JDBC 設定を使用して、他の JDBC データベースをセットアップできます。Database Connector は JDBC に準拠しています。互換性の問題を回避するために、接続設定で JDBC に準拠しているドライバーが使用されていることを確認してください。また、Spring を使用して Anypoint Studio 内にオブジェクトを作成することで、XA トランザクションで必要とされる JDBC ​`DataSource`​ オブジェクトや ​`XADataSource`​ オブジェクトを参照することができます。

## [](#始める前に)始める前に

このコネクタを使用するには、以下に精通している必要があります。

- Anypoint Connector
- Mule Runtime Engine (Mule)
- Mule フローの要素とグローバル要素
- Anypoint Studio (Studio) を使用した Mule アプリケーションの作成

アプリケーションを作成する前に、データベースの対象リソースと Anypoint Platform へのアクセス権を持っていて、データベースの適切なデータベースドライバーをダウンロードしている必要があります。

## [](#コネクタの一般的なユースケース)コネクタの一般的なユースケース

Database Connector では、次の操作を実行できます。

- 定義済みのクエリ、動的に作成されたクエリ、および独自にカスタマイズ可能なテンプレートクエリを実行する。
- 使用するデータベース設定に応じて、コネクタ項目で DataWeave 式を指定し、属性を動的に設定する。
- source listener 操作を使用して、フローのデータソースセクション内のデータベースから読み取る。
- 他の操作を実行して、プロセスセクションの任意の場所でデータベースの読み取りと書き込む。
- 1 回の一括更新で複数の SQL 要求を実行する。
- データ自体ではなくデータ構造を変更するデータ定義言語 (DDL) 要求を実行する。
- ストアドプロシージャーおよび SQL スクリプトを実行する。

例については、​[「例」](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)​を参照してください。

## [](#exchange-のテンプレートと例の使用)Exchange のテンプレートと例の使用

[Anypoint Exchange](https://www.mulesoft.com/exchange/)​ は、アプリケーションのスタートポイントとして使用できるテンプレートと、完全なソリューションを具体的に示した例を提供しています。

- [Database Connector の例](https://www.mulesoft.com/exchange/?search=database&type=example)
- [Database Connector テンプレート](https://www.mulesoft.com/exchange/?search=database&type=template)

## [](#次のステップ)次のステップ

前提条件を満たし、テンプレートおよびサンプルを試したら、​[Anypoint Studio](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-studio)​ で独自のアプリケーションを作成してコネクタを設定できます。

## [](#database-connector-および-runtime-fabric-tls-設定)Database Connector および Runtime Fabric TLS 設定

Database Connector 操作を使用する Mule アプリケーションを作成し、Runtime Fabric を介して Mule アプリケーションをデプロイする場合、設定できる TLS バージョンは、JDK またはランタイムによって制限されます。ドライバーでは、TLS で保護されたソケットを使用して接続する JDK 機能が使用されます。Runtime Fabric 設定でセットアップされた TLS バージョンを確認します。

これは、Java セキュリティメカニズム上に構築されていないライブラリや、何らかのネイティブ実装 (JNI) がドライバーの実装で使用される場合は考慮されません。そのような場合は、ドライバーの実装でセットアップされた TLS バージョンを確認します。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=7cff161d1dd917043a52945776b3c55e49db460fb022e22967211fc1e8ae1c9d url=/mulesoft/current/ja-jp/db-connector/1.13/index.md -->

# Database Connector 1.13

データベース用 Anypoint Connector (Database Connector) は、Mule アプリケーションとリレーショナルデータベース間の通信を確立します。Database Connector は、ほぼすべての Java Database Connectivity (JDBC) リレーショナルデータベースに接続し、SQL 操作を実行できます。アプリケーションは、同じ設定要素を使用し、たとえば各要求からの情報に基づいて接続属性を変更することで、マルチテナントシナリオに対応できます。

Database Connector には、ドライバークラス名を自動的に設定し、次のデータベースに指定されたパラメーターで JDBC URL を作成する接続プロバイダーがあります。

- Derby
- Microsoft SQL Server
- MySQL
- Oracle

汎用の JDBC 設定を使用して、他の JDBC データベースをセットアップできます。Database Connector は JDBC に準拠しています。互換性の問題を回避するために、接続設定で JDBC に準拠しているドライバーが使用されていることを確認してください。また、Spring を使用して Anypoint Studio 内にオブジェクトを作成することで、XA トランザクションで必要とされる JDBC ​`DataSource`​ オブジェクトや ​`XADataSource`​ オブジェクトを参照することができます。

## [](#始める前に)始める前に

このコネクタを使用するには、以下に精通している必要があります。

- Anypoint Connector
- Mule Runtime Engine (Mule)
- Mule フローの要素とグローバル要素
- Anypoint Studio (Studio) を使用した Mule アプリケーションの作成

アプリケーションを作成する前に、データベースの対象リソースと Anypoint Platform へのアクセス権を持っていて、データベースの適切なデータベースドライバーをダウンロードしている必要があります。

## [](#コネクタの一般的なユースケース)コネクタの一般的なユースケース

Database Connector では、次の操作を実行できます。

- 定義済みのクエリ、動的に作成されたクエリ、および独自にカスタマイズ可能なテンプレートクエリを実行する。
- 使用するデータベース設定に応じて、コネクタ項目で DataWeave 式を指定し、属性を動的に設定する。
- source listener 操作を使用して、フローのデータソースセクション内のデータベースから読み取る。
- 他の操作を実行して、プロセスセクションの任意の場所でデータベースの読み取りと書き込む。
- 1 回の一括更新で複数の SQL 要求を実行する。
- データ自体ではなくデータ構造を変更するデータ定義言語 (DDL) 要求を実行する。
- ストアドプロシージャーおよび SQL スクリプトを実行する。

例については、​[「例」](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)​を参照してください。

## [](#対象者)対象者

- 新規ユーザー: 以下を参照
    
    - Mule アプリケーションを作成するための​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-studio)
    - [「例」](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)​には、コネクタのユースケースが 1 つ以上用意されています。
- 高度なユーザー: 以下を参照
    
    - [XML と Maven のサポート](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-xml-maven)
    - [「例」](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)​には、コネクタのユースケースが 1 つ以上用意されています。

## [](#exchange-のテンプレートと例の使用)Exchange のテンプレートと例の使用

[Anypoint Exchange](https://www.mulesoft.com/exchange/)​ は、アプリケーションのスタートポイントとして使用できるテンプレートと、完全なソリューションを具体的に示した例を提供しています。

- [Database Connector の例](https://www.mulesoft.com/exchange/?search=database&type=example)
- [Database Connector テンプレート](https://www.mulesoft.com/exchange/?search=database&type=template)

## [](#次のステップ)次のステップ

前提条件を満たし、テンプレートおよびサンプルを試したら、​[Anypoint Studio](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-studio)​ で独自のアプリケーションを作成してコネクタを設定できます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=201b9327a95ab3d52b0ceb6581b3c5cc17c4b2579eae786acac586941558660e url=/mulesoft/current/ja-jp/db-connector/1.14/index.md -->

# Database Connector 1.14

データベース用 Anypoint Connector (Database Connector) は、Mule アプリケーションとリレーショナルデータベース間の通信を確立します。Database Connector は、ほぼすべての Java Database Connectivity (JDBC) リレーショナルデータベースに接続し、SQL 操作を実行できます。アプリケーションは、同じ設定要素を使用し、たとえば各要求からの情報に基づいて接続属性を変更することで、マルチテナントシナリオに対応できます。

Database Connector には、ドライバークラス名を自動的に設定し、次のデータベースに指定されたパラメーターで JDBC URL を作成する接続プロバイダーがあります。

- Derby
- Microsoft SQL Server
- MySQL
- Oracle

汎用の JDBC 設定を使用して、他の JDBC データベースをセットアップできます。Database Connector は JDBC に準拠しています。互換性の問題を回避するために、接続設定で JDBC に準拠しているドライバーが使用されていることを確認してください。また、Spring を使用して Anypoint Studio 内にオブジェクトを作成することで、XA トランザクションで必要とされる JDBC ​`DataSource`​ オブジェクトや ​`XADataSource`​ オブジェクトを参照することができます。

## [](#始める前に)始める前に

このコネクタを使用するには、以下に精通している必要があります。

- Anypoint Connector
- Mule Runtime Engine (Mule)
- Mule フローの要素とグローバル要素
- Anypoint Studio (Studio) を使用した Mule アプリケーションの作成

アプリケーションを作成する前に、データベースの対象リソースと Anypoint Platform へのアクセス権を持っていて、データベースの適切なデータベースドライバーをダウンロードしている必要があります。

## [](#コネクタの一般的なユースケース)コネクタの一般的なユースケース

Database Connector では、次の操作を実行できます。

- 定義済みのクエリ、動的に作成されたクエリ、および独自にカスタマイズ可能なテンプレートクエリを実行する。
- 使用するデータベース設定に応じて、コネクタ項目で DataWeave 式を指定し、属性を動的に設定する。
- source listener 操作を使用して、フローのデータソースセクション内のデータベースから読み取る。
- 他の操作を実行して、プロセスセクションの任意の場所でデータベースの読み取りと書き込む。
- 1 回の一括更新で複数の SQL 要求を実行する。
- データ自体ではなくデータ構造を変更するデータ定義言語 (DDL) 要求を実行する。
- ストアドプロシージャーおよび SQL スクリプトを実行する。

例については、​[「例」](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)​を参照してください。

## [](#対象者)対象者

- 新規ユーザー: 以下を参照
    
    - Mule アプリケーションを作成するための​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-studio)
    - [「例」](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)​には、コネクタのユースケースが 1 つ以上用意されています。
- 高度なユーザー: 以下を参照
    
    - [XML と Maven のサポート](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-xml-maven)
    - [「例」](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)​には、コネクタのユースケースが 1 つ以上用意されています。

## [](#exchange-のテンプレートと例の使用)Exchange のテンプレートと例の使用

[Anypoint Exchange](https://www.mulesoft.com/exchange/)​ は、アプリケーションのスタートポイントとして使用できるテンプレートと、完全なソリューションを具体的に示した例を提供しています。

- [Database Connector の例](https://www.mulesoft.com/exchange/?search=database&type=example)
- [Database Connector テンプレート](https://www.mulesoft.com/exchange/?search=database&type=template)

## [](#次のステップ)次のステップ

前提条件を満たし、テンプレートおよびサンプルを試したら、​[Anypoint Studio](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-studio)​ で独自のアプリケーションを作成してコネクタを設定できます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=09685dec3944f1692ed1468c2c761c5be680247d0abe1749563b8ab9fb798460 url=/mulesoft/current/ja-jp/db-connector/1.8/index.md -->

# Database Connector 1.8

データベース用 Anypoint Connector (Database Connector) は、Mule アプリケーションとリレーショナルデータベース間の通信を確立します。Database Connector は、ほぼすべての Java Database Connectivity (JDBC) リレーショナルデータベースに接続し、SQL 操作を実行できます。アプリケーションは、同じ設定要素を使用し、たとえば各要求からの情報に基づいて接続属性を変更することで、マルチテナントシナリオに対応できます。

Database Connector には、ドライバークラス名を自動的に設定し、次のデータベースに指定されたパラメーターで JDBC URL を作成する接続プロバイダーがあります。

- Derby
- Microsoft SQL Server
- MySQL
- Oracle

汎用の JDBC 設定を使用して、他の JDBC データベースをセットアップできます。また、Spring を使用して Anypoint Studio 内にオブジェクトを作成することで、XA トランザクションで必要とされる JDBC ​`DataSource`​ オブジェクトや ​`XADataSource`​ オブジェクトを参照することができます。

## [](#始める前に)始める前に

このコネクタを使用するには、以下に精通している必要があります。

- Anypoint Connector
- Mule Runtime Engine (Mule)
- Mule フローの要素とグローバル要素
- Anypoint Studio (Studio) を使用した Mule アプリケーションの作成

アプリケーションを作成する前に、データベースの対象リソースと Anypoint Platform へのアクセス権を持っていて、データベースの適切なデータベースドライバーをダウンロードしている必要があります。

## [](#コネクタの一般的なユースケース)コネクタの一般的なユースケース

Database Connector では、次の操作を実行できます。

- 定義済みのクエリ、動的に作成されたクエリ、および独自にカスタマイズ可能なテンプレートクエリを実行する。
- 使用するデータベース設定に応じて、コネクタ項目で DataWeave 式を指定し、属性を動的に設定する。
- source listener 操作を使用して、フローのデータソースセクション内のデータベースから読み取る。
- 他の操作を実行して、プロセスセクションの任意の場所でデータベースの読み取りと書き込む。
- 1 回の一括更新で複数の SQL 要求を実行する。
- データ自体ではなくデータ構造を変更するデータ定義言語 (DDL) 要求を実行する。
- ストアドプロシージャーおよび SQL スクリプトを実行する。

例については、​[「例」](https://docs.mulesoft.com/jp/db-connector/1.8/database-connector-examples)​を参照してください。

## [](#対象者)対象者

- 新規ユーザー: 以下を参照
    
    - Mule アプリケーションを作成するための​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/jp/db-connector/1.8/database-connector-studio)
    - [「例」](https://docs.mulesoft.com/jp/db-connector/1.8/database-connector-examples)​には、コネクタのユースケースが 1 つ以上用意されています。
- 高度なユーザー: 以下を参照
    
    - [XML と Maven のサポート](https://docs.mulesoft.com/jp/db-connector/1.8/database-connector-xml-maven)
    - [「例」](https://docs.mulesoft.com/jp/db-connector/1.8/database-connector-examples)​には、コネクタのユースケースが 1 つ以上用意されています。

## [](#exchange-のテンプレートと例の使用)Exchange のテンプレートと例の使用

[Anypoint Exchange](https://www.mulesoft.com/exchange/)​ は、アプリケーションのスタートポイントとして使用できるテンプレートと、完全なソリューションを具体的に示した例を提供しています。

- [Database Connector の例](https://www.mulesoft.com/exchange/?search=database&type=example)
- [Database Connector テンプレート](https://www.mulesoft.com/exchange/?search=database&type=template)

## [](#次のステップ)次のステップ

前提条件を満たし、テンプレートおよびサンプルを試したら、​[Anypoint Studio](https://docs.mulesoft.com/jp/db-connector/1.8/database-connector-studio)​ で独自のアプリケーションを作成してコネクタを設定できます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=cec86295c3841f8d12374be8b5a74a597c7afd2d1c9437c346ab664799673b98 url=/mulesoft/current/ja-jp/db-connector/1.9/index.md -->

# Database Connector 1.9

データベース用 Anypoint Connector (Database Connector) は、Mule アプリケーションとリレーショナルデータベース間の通信を確立します。Database Connector は、ほぼすべての Java Database Connectivity (JDBC) リレーショナルデータベースに接続し、SQL 操作を実行できます。アプリケーションは、同じ設定要素を使用し、たとえば各要求からの情報に基づいて接続属性を変更することで、マルチテナントシナリオに対応できます。

Database Connector には、ドライバークラス名を自動的に設定し、次のデータベースに指定されたパラメーターで JDBC URL を作成する接続プロバイダーがあります。

- Derby
- Microsoft SQL Server
- MySQL
- Oracle

汎用の JDBC 設定を使用して、他の JDBC データベースをセットアップできます。Database Connector は JDBC に準拠しています。互換性の問題を回避するために、接続設定で JDBC に準拠しているドライバーが使用されていることを確認してください。また、Spring を使用して Anypoint Studio 内にオブジェクトを作成することで、XA トランザクションで必要とされる JDBC ​`DataSource`​ オブジェクトや ​`XADataSource`​ オブジェクトを参照することができます。

## [](#始める前に)始める前に

このコネクタを使用するには、以下に精通している必要があります。

- Anypoint Connector
- Mule Runtime Engine (Mule)
- Mule フローの要素とグローバル要素
- Anypoint Studio (Studio) を使用した Mule アプリケーションの作成

アプリケーションを作成する前に、データベースの対象リソースと Anypoint Platform へのアクセス権を持っていて、データベースの適切なデータベースドライバーをダウンロードしている必要があります。

## [](#コネクタの一般的なユースケース)コネクタの一般的なユースケース

Database Connector では、次の操作を実行できます。

- 定義済みのクエリ、動的に作成されたクエリ、および独自にカスタマイズ可能なテンプレートクエリを実行する。
- 使用するデータベース設定に応じて、コネクタ項目で DataWeave 式を指定し、属性を動的に設定する。
- source listener 操作を使用して、フローのデータソースセクション内のデータベースから読み取る。
- 他の操作を実行して、プロセスセクションの任意の場所でデータベースの読み取りと書き込む。
- 1 回の一括更新で複数の SQL 要求を実行する。
- データ自体ではなくデータ構造を変更するデータ定義言語 (DDL) 要求を実行する。
- ストアドプロシージャーおよび SQL スクリプトを実行する。

例については、​[「例」](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)​を参照してください。

## [](#対象者)対象者

- 新規ユーザー: 以下を参照
    
    - Mule アプリケーションを作成するための​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-studio)
    - [「例」](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)​には、コネクタのユースケースが 1 つ以上用意されています。
- 高度なユーザー: 以下を参照
    
    - [XML と Maven のサポート](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-xml-maven)
    - [「例」](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)​には、コネクタのユースケースが 1 つ以上用意されています。

## [](#exchange-のテンプレートと例の使用)Exchange のテンプレートと例の使用

[Anypoint Exchange](https://www.mulesoft.com/exchange/)​ は、アプリケーションのスタートポイントとして使用できるテンプレートと、完全なソリューションを具体的に示した例を提供しています。

- [Database Connector の例](https://www.mulesoft.com/exchange/?search=database&type=example)
- [Database Connector テンプレート](https://www.mulesoft.com/exchange/?search=database&type=template)

## [](#次のステップ)次のステップ

前提条件を満たし、テンプレートおよびサンプルを試したら、​[Anypoint Studio](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-studio)​ で独自のアプリケーションを作成してコネクタを設定できます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=09e4f8ee3ef099f0fbcd0e62682ace0f2959920dfa29198ca93edccf371c69a9 url=/mulesoft/current/ja-jp/db-connector/1.13/database-configure-usebulkcopy.md -->

# Database Connector SQL サーバー接続での \[Use Bulk Copy (一括コピーを使用)\] の設定

Microsoft SQL Server 接続のためのデータベース用 Anypoint Connector (Database Connector) では一括挿入で一括コピーを設定できます。この機能を使用すると、一括挿入操作の実行時に一括コピー操作を行うためのドライバーを有効にすることができます。この機能を \[Database Connector Configuration (Database Connector 設定)\] 画面で接続プロパティとして設定します。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ タブに移動します。
2. **\[Create (作成)\]**​ をクリックします。
3. 検索バーに「​`database`​」(データベース) と入力します。
4. **\[Database config (データベース設定)\]**​ を選択します。
5. **\[OK\]**​ をクリックします。
6. **\[Global Elements Properties (グローバル要素プロパティ)\]**​ 画面で、​**\[Connection (接続)\]**​ を ​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ に設定します。
7. **\[Advanced (詳細)\]**​ タブをクリックします。
8. **\[Connection properties (接続プロパティ)\]**​ を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. プラス記号をクリックして、新規プロパティを追加します。
10. **\[Connection property (接続プロパティ)\]**​ 画面で、​**\[Key (キー)\]**​ を ​`useBulkCopyforBatchInsert`​ に設定します。
11. **\[Value (値)\]**​ を ​`true`​ に設定します。

![「Connection property (接続プロパティ)」 セクションで作成された useBulkCopyforBatchInsert プロパティ](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-bulkcopy.png)

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=a303abb826eea1d4be226514bc02b1e27be253f516fee4c4f50062780e72c8cb url=/mulesoft/current/ja-jp/db-connector/1.14/database-configure-usebulkcopy.md -->

# Database Connector SQL サーバー接続での \[Use Bulk Copy (一括コピーを使用)\] の設定

Microsoft SQL Server 接続のためのデータベース用 Anypoint Connector (Database Connector) では一括挿入で一括コピーを設定できます。この機能を使用すると、一括挿入操作の実行時に一括コピー操作を行うためのドライバーを有効にすることができます。この機能を \[Database Connector Configuration (Database Connector 設定)\] 画面で接続プロパティとして設定します。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ タブに移動します。
2. **\[Create (作成)\]**​ をクリックします。
3. 検索バーに「​`database`​」(データベース) と入力します。
4. **\[Database config (データベース設定)\]**​ を選択します。
5. **\[OK\]**​ をクリックします。
6. **\[Global Elements Properties (グローバル要素プロパティ)\]**​ 画面で、​**\[Connection (接続)\]**​ を ​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ に設定します。
7. **\[Advanced (詳細)\]**​ タブをクリックします。
8. **\[Connection properties (接続プロパティ)\]**​ を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. プラス記号をクリックして、新規プロパティを追加します。
10. **\[Connection property (接続プロパティ)\]**​ 画面で、​**\[Key (キー)\]**​ を ​`useBulkCopyForBatchInsert`​ に設定します。
11. **\[Value (値)\]**​ を ​`true`​ に設定します。

![「Connection property (接続プロパティ)」 セクションで作成された useBulkCopyforBatchInsert プロパティ](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-bulkcopy.png)

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=b177747839bdfb454fa324278df3808be016abc7dd75cddff4abb0113199627a url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-xa-transactions.md -->

# Database Connector での XA トランザクションの使用

Database Connector のグローバル設定で ​**\[Use XA Transactions (XA トランザクションを使用)\]**​ 項目を有効にすると、データベース用 Anypoint Connector (Database Connector) では拡張アーキテクチャトランザクション (XA トランザクション) を使用するオプションが提供されます。

## [](#始める前に)始める前に

始める前に、​[XA トランザクション](https://docs.mulesoft.com/mule-runtime/latest/xa-transactions)​について理解していることを確認します。

## [](#use-xa-transactions-xa-トランザクションを使用)Use XA Transactions (XA トランザクションを使用)

**\[Use XA Transactions (XA トランザクションを使用)\]**​ 項目は、​**\[Derby Connection (Derby 接続)\]**​、​**\[Generic Connection (汎用接続)\]**​、​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​、​**\[MySQL Connection (MySQL 接続)\]**​、および ​**\[Oracle Connection (Oracle 接続)\]**​ のデータベースグローバルコネクタ設定で有効にすることができます。 **データソース参照接続**​については、​[「XA トランザクションモードでのデータソース参照接続」](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-connection#data-source-connection-xa)​を参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content"><strong>[Use XA Transactions (XA トランザクションを使用)]</strong>​ を有効にすると、接続プーリングも作成されます。</td></tr></tbody></table>

次の例は、Anypoint Studio で ​**\[MySQL Connection (MySQL 接続)\]**​ の ​**\[Use XA Transactions (XA トランザクションを使用)\]**​ を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ タブに移動します。
2. **\[Create (作成)\]**​ をクリックします。
3. 検索バーに「​`database`​」(データベース) と入力します。
4. **\[Database Config (データベース設定)\]**​ を選択します。
5. **\[OK\]**​ をクリックします。
6. **\[Global Element Properties (グローバル要素のプロパティ)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
7. **\[Transactions (トランザクション)\]**​ タブを選択します。
8. **\[Use XA Transactions (XA トランザクションを使用)\]**​ を選択します。これは、作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。  
    この実装により Enhydra XADatasource が作成されます。
9. **\[General (一般)\]**​ および ​**\[Advanced (詳細)\]**​ タブで他の必須のデータベース設定を定義します。
10. **\[OK\]**​ をクリックします。

![選択した \[XA Transactions (XA トランザクション)\] 項目の使用](_images/database-connector-xatransactions.png)

**設定 XML**​ エディターウィンドウでは、設定は次のように記述されます。

```xml
<db:config name="Database_Config" doc:name="Database Config" >
		<db:derby-connection useXaTransactions="true" />
	</db:config>
```

## [](#関連情報)関連情報

- [Bitronix トランザクションマネージャーの設定](https://docs.mulesoft.com/mule-runtime/latest/using-bitronix-to-manage-transactions#configuring-the-bitronix-transaction-manager)

<!-- document id=acd5cb9b95de5d1ca42512749cfd4e514c8d0c403d64e678a16d23b180c2533a url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-xa-transactions.md -->

# Database Connector での XA トランザクションの使用

Database Connector のグローバル設定で ​**\[Use XA Transactions (XA トランザクションを使用)\]**​ 項目を有効にすると、データベース用 Anypoint Connector (Database Connector) では拡張アーキテクチャトランザクション (XA トランザクション) を使用するオプションが提供されます。

## [](#始める前に)始める前に

始める前に、​[XA トランザクション](https://docs.mulesoft.com/mule-runtime/latest/xa-transactions)​について理解していることを確認します。

## [](#use-xa-transactions-xa-トランザクションを使用)Use XA Transactions (XA トランザクションを使用)

**\[Use XA Transactions (XA トランザクションを使用)\]**​ 項目は、​**\[Derby Connection (Derby 接続)\]**​、​**\[Generic Connection (汎用接続)\]**​、​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​、​**\[MySQL Connection (MySQL 接続)\]**​、および ​**\[Oracle Connection (Oracle 接続)\]**​ のデータベースグローバルコネクタ設定で有効にすることができます。 **データソース参照接続**​については、​[「XA トランザクションモードでのデータソース参照接続」](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-connection#data-source-connection-xa)​を参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content"><strong>[Use XA Transactions (XA トランザクションを使用)]</strong>​ を有効にすると、接続プーリングも作成されます。</td></tr></tbody></table>

次の例は、Anypoint Studio で ​**\[MySQL Connection (MySQL 接続)\]**​ の ​**\[Use XA Transactions (XA トランザクションを使用)\]**​ を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ タブに移動します。
2. **\[Create (作成)\]**​ をクリックします。
3. 検索バーに「​`database`​」(データベース) と入力します。
4. **\[Database Config (データベース設定)\]**​ を選択します。
5. **\[OK\]**​ をクリックします。
6. **\[Global Element Properties (グローバル要素のプロパティ)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
7. **\[Transactions (トランザクション)\]**​ タブを選択します。
8. **\[Use XA Transactions (XA トランザクションを使用)\]**​ を選択します。これは、作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。  
    この実装により Enhydra XADatasource が作成されます。
9. **\[General (一般)\]**​ および ​**\[Advanced (詳細)\]**​ タブで他の必須のデータベース設定を定義します。
10. **\[OK\]**​ をクリックします。

![選択した \[XA Transactions (XA トランザクション)\] 項目の使用](_images/database-connector-xatransactions.png)

**設定 XML**​ エディターウィンドウでは、設定は次のように記述されます。

```xml
<db:config name="Database_Config" doc:name="Database Config" >
		<db:derby-connection useXaTransactions="true" />
	</db:config>
```

## [](#関連情報)関連情報

- [Bitronix トランザクションマネージャーの設定](https://docs.mulesoft.com/mule-runtime/latest/using-bitronix-to-manage-transactions#configuring-the-bitronix-transaction-manager)

<!-- document id=cfe643f1033d0c16ea2435e1202cb4fdb966782b4b9f5738f628471278800a2b url=/mulesoft/current/ja-jp/db-connector/1.8/database-connector-troubleshooting.md -->

# Database Connector トラブルシューティング

データベース用 Anypoint Connector (Database Connector) をトラブルシューティングするには、原因と可能な解決策を確認します。

## [](#プーリングプロファイル接続によるフローのハング)プーリングプロファイル接続によるフローのハング

フローで使用されるよりも少ない接続を提供するプーリングプロファイルを使用すると、フロー全体がハングする可能性があります。

### [](#解決策)解決策

解決策の 1 つとして、プールのサイズを増やすことが挙げられます。ただし、この方法が使用できないこともあります。その場合、別の解決策として、VM メッセージの有効期間と同じになるように、VM Connector を使用して接続の有効期間を短くします。こうすることで、​**Stored procedure**​ 操作へのすべてのコールが実行されて、その結果がコンシュームされ、操作に関連付けられている接続が終了してプールに戻ります。

次の例は、​**Stored procedure**​ 操作と VM Connector でプーリングプロファイルを使用する方法を示しています。​`foreach`​ 要素が 11 番目の反復に到達すると、プールで接続を提供できるようになるため、​**Stored procedure**​ 操作がハングしなくなります。

```xml
	<db:config name="Database_Config">
		<db:generic-connection url="someUrl" user="someUser" password="somePassword" driverClassName="someDriver">
			<db:pooling-profile maxPoolSize="10">
			</db:pooling-profile>
		</db:generic-connection>
	</db:config>

	<vm:config name="VM_Config">
		<vm:queues >
			<vm:queue queueName="testQueue" />
		</vm:queues>
	</vm:config>

	<flow name="processingFlow">
		<foreach collection="#[1 to 11]">
			<logger level="INFO" message="#['Starting Iteration ' ++ payload as String]" />
			<vm:publish config-ref="VM_Config" queueName="testQueue"/>
			<logger level="INFO" message="#['Finishing Iteration ' ++ payload as String]"/>
		</foreach>
	</flow>

	<flow name="coolFlow">
		<vm:listener config-ref="VM_Config" queueName="testQueue" numberOfConsumers="1"/>
		<db:stored-procedure config-ref="Database_Config">
				<db:sql><![CDATA[{call testProc2()}]]></db:sql>
			</db:stored-procedure>
		<logger level="INFO" message="#[output application/json --- payload.resultSet1]" />
	</flow>
```

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=da5439ba34bcd6dfb7410c251e5c54666b9efbfd1137884ad8e066192f1dc1de url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-xml-maven.md -->

# Database Connector の XML と Maven のサポート

XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Studio を使用した方が効率的です。

Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。

コネクタを Studio に追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。

## [](#コネクタの名前空間の追加)コネクタの名前空間の追加

次のコードを設定 XML のヘッダーの ​`<mule>`​ タグ内に貼り付けます。

```xml
http://www.mulesoft.org/schema/mule/db
http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
```

次の例は、​`<mule>`​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。

```xml
<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/file
	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
	http://www.mulesoft.org/schema/mule/database
	http://www.mulesoft.org/schema/mule/database/current/mule-db.xsd">
```

## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加

Apache Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします:

```xml
<dependency>
  <groupId>org.mule.connectors</groupId>
  <artifactId>mule-db-connector</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`database`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#次のステップ)次のステップ

名前空間および ​`pom.xml`​ ファイルを完了したら、​[例](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)​を試すことができます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=70ffb0b1472447899df1ce2c198b57f244456d4f804d8170d5c31099e17023b5 url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-xml-maven.md -->

# Database Connector の XML と Maven のサポート

XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Studio を使用した方が効率的です。

Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。

コネクタを Studio に追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。

## [](#コネクタの名前空間の追加)コネクタの名前空間の追加

次のコードを設定 XML のヘッダーの ​`<mule>`​ タグ内に貼り付けます。

```xml
http://www.mulesoft.org/schema/mule/db
http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
```

次の例は、​`<mule>`​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。

```xml
<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/file
	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
	http://www.mulesoft.org/schema/mule/database
	http://www.mulesoft.org/schema/mule/database/current/mule-db.xsd">
```

## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加

Apache Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします:

```xml
<dependency>
  <groupId>org.mule.connectors</groupId>
  <artifactId>mule-db-connector</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`database`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#次のステップ)次のステップ

名前空間および ​`pom.xml`​ ファイルを完了したら、​[例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)​を試すことができます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=9d192f587c7db0d1445ad0f7baaa92680b54c63c6b2c83c571eb1d0823098a14 url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-xml-maven.md -->

# Database Connector の XML と Maven のサポート

XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Studio を使用した方が効率的です。

Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。

コネクタを Studio に追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。

## [](#コネクタの名前空間の追加)コネクタの名前空間の追加

次のコードを設定 XML のヘッダーの ​`<mule>`​ タグ内に貼り付けます。

```xml
http://www.mulesoft.org/schema/mule/db
http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
```

次の例は、​`<mule>`​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。

```xml
<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/file
	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
	http://www.mulesoft.org/schema/mule/database
	http://www.mulesoft.org/schema/mule/database/current/mule-db.xsd">
```

## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加

Apache Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします:

```xml
<dependency>
  <groupId>org.mule.connectors</groupId>
  <artifactId>mule-db-connector</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`database`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#次のステップ)次のステップ

名前空間および ​`pom.xml`​ ファイルを完了したら、​[例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)​を試すことができます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=97f7480b77141aa3b4f01ebbf5e0fcfe4732c46fbc9654756bd197cd37123436 url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-xml-maven.md -->

# Database Connector の XML と Maven のサポート

XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Studio を使用した方が効率的です。

Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。

コネクタを Studio に追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。

## [](#コネクタの名前空間の追加)コネクタの名前空間の追加

次のコードを設定 XML のヘッダーの ​`<mule>`​ タグ内に貼り付けます。

```xml
http://www.mulesoft.org/schema/mule/db
http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
```

次の例は、​`<mule>`​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。

```xml
<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/file
	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
	http://www.mulesoft.org/schema/mule/database
	http://www.mulesoft.org/schema/mule/database/current/mule-db.xsd">
```

## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加

Apache Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします:

```xml
<dependency>
  <groupId>org.mule.connectors</groupId>
  <artifactId>mule-db-connector</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`database`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#次のステップ)次のステップ

名前空間および ​`pom.xml`​ ファイルを完了したら、​[例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)​を試すことができます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=feeb86683c74ba663317a248c915a264998d43fb13df363c58f321ec4d5cfffd url=/mulesoft/current/ja-jp/db-connector/1.8/database-connector-xml-maven.md -->

# Database Connector の XML と Maven のサポート

XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Studio を使用した方が効率的です。

Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。

コネクタを Studio に追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。

## [](#コネクタの名前空間の追加)コネクタの名前空間の追加

次のコードを設定 XML のヘッダーの ​`<mule>`​ タグ内に貼り付けます。

```xml
http://www.mulesoft.org/schema/mule/db
http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
```

次の例は、​`<mule>`​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。

```xml
<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/file
	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
	http://www.mulesoft.org/schema/mule/database
	http://www.mulesoft.org/schema/mule/database/current/mule-db.xsd">
```

## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加

Apache Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします:

```xml
<dependency>
  <groupId>org.mule.connectors</groupId>
  <artifactId>mule-db-connector</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`database`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#次のステップ)次のステップ

名前空間および ​`pom.xml`​ ファイルを完了したら、​[例](https://docs.mulesoft.com/jp/db-connector/1.8/database-connector-examples)​を試すことができます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=f2ddfdb1b21aed0006042b4ac878359bc5ad44a0e7512478a741912f418df8ae url=/mulesoft/current/ja-jp/db-connector/1.9/database-connector-xml-maven.md -->

# Database Connector の XML と Maven のサポート

XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Studio を使用した方が効率的です。

Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。

コネクタを Studio に追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。

## [](#コネクタの名前空間の追加)コネクタの名前空間の追加

次のコードを設定 XML のヘッダーの ​`<mule>`​ タグ内に貼り付けます。

```xml
http://www.mulesoft.org/schema/mule/db
http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
```

次の例は、​`<mule>`​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。

```xml
<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/file
	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
	http://www.mulesoft.org/schema/mule/database
	http://www.mulesoft.org/schema/mule/database/current/mule-db.xsd">
```

## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加

Apache Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします:

```xml
<dependency>
  <groupId>org.mule.connectors</groupId>
  <artifactId>mule-db-connector</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`database`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#次のステップ)次のステップ

名前空間および ​`pom.xml`​ ファイルを完了したら、​[例](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)​を試すことができます。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=e1c60e58292a33ea8810dd6b1c831a465dc27da08d3887c206f8ca84f5ef87a7 url=/mulesoft/current/ja-jp/db-connector/1.10/database-configure-data-types.md -->

# Database Connector のデータ型の設定の例

次の例は、クエリの各入力パラメーターの型を指定する ​**\[Parameters types (パラメーターの型)\]**​ 項目と、特定のデータベースプロバイダーに接続されたときにカスタムデータ型を設定する ​**\[Column types (列の型)\]**​ 項目を使用して、データベース用 Anypoint Connector (Database Connector) のデータ型を設定する方法を示しています。

## [](#studio-で-parameter-types-パラメーターの型-項目を設定する)Studio で \[Parameter Types (パラメーターの型)\] 項目を設定する

JDBC ドライバーで入力のデータ型を特定できない場合や、パラメーターがカスタムデータ型の場合、​**\[Parameter types (パラメーターの型)\]**​ 項目を設定して、各入力パラメーターの型を指定します。次の例は、​**Bulk insert**​ 操作の ​**\[Parameter types (パラメーターの型)\]**​ 項目を設定する方法を示しています。

1. Studio のフローで、​**\[Bulk insert\]**​ 操作を選択します。
2. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
4. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)`​)。
5. 操作設定画面で、​**\[Advanced (詳細)\]**​ タブをクリックします。
6. **\[Parameter types (パラメーターの型)\]**​ 項目を \[​`Edit inline`​ (インライン編集)\] に設定します。
7. 緑のプラス記号 (​**+**​) をクリックして、新しいパラメーターの型を作成します。
8. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Key (キー)\]**​ 項目を ​`name`​、​**\[Type (型)\]**​ 項目を ​`VARCHAR`​ に設定します。
9. **\[Finish (完了)\]**​ をクリックします。
10. ステップ 7 を繰り返します。
11. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Key (キー)\]**​ 項目を ​`position`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。
12. **\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Parameter types (パラメーターの型)」 項目を 「Edit Inline (インライン編集)」 に設定し、プラス記号をクリックして新しいパラメーターを作成します。](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-parameter-types.png)

Figure 1. \[Parameter Types (パラメーターの型)\] 項目の設定

XML エディターでは、​`<db:parameter-types>`​ 設定は次のように記述されます。

```xml
<db:bulk-insert queryTimeout="0" queryTimeoutUnit="SECONDS">
     <db:sql>INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)</db:sql>
     <db:parameter-types>
         <db:parameter-type key="name" type="VARCHAR" />
         <db:parameter-type key="position" type="INTEGER" />
     </db:parameter-types>
 </db:bulk-insert>
```

## [](#studio-で-column-types-列の型-項目を設定する)Studio で \[Column Types (列の型)\] 項目を設定する

各接続プロバイダーは、専用パラメーターと共通パラメーターを使用します (Derby や Oracle など)。接続プロバイダー要素の子要素で、特定のプロバイダーに接続している場合に使用できるカスタムデータ型のパラメーターを定義します。

次の表には、カスタムメタデータ型を定義するために使用できる JDBC データ型のコードと ID が記載されています。

<table class="tableblock frame-all grid-all" style="width: 80%;">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">JDBC データ型のコード</th>
<th class="tableblock halign-left valign-top">id</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ARRAY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2003</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BIGINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-5</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BIT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-7</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2004</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BOOLEAN</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2005</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DATALINK</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">70</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DATE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">91</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DECIMAL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DISTINCT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2001</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DOUBLE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">FLOAT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">INTEGER</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">JAVA_OBJECT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2000</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGNVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-16</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGVARBINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-4</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-15</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NCLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2011</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NULL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NUMERIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-9</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">OTHER</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1111</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REAL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">7</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REF</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2006</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REF_CURSOR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2012</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ROWID</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SMALLINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SQLXML</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2009</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">STRUCT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2002</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIME</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">92</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIME_WITH_TIMEZONE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2013</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIMESTAMP</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">93</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIMESTAMP_WITH_TIMEZONE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2014</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TINYINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-6</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">VARBINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-3</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">VARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">12</p></td>
</tr>
</tbody>
</table>

次の例は、Derby グローバル設定接続要素の ​**\[Column types (列の型)\]**​ 項目を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ タブに移動します。
2. **\[Create (作成)\]**​ をクリックします。
3. **\[Global Type (グローバル種別)\]**​ ウィンドウで、「​`database`​」と入力して絞り込みます。
4. **\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
5. **\[Connection (接続)\]**​ 項目を \[​`Derby Connection`​ (Derby 接続)\] に設定します。
6. Derby JDBC ドライバーの必須ライブラリと追加の接続項目を設定します。
7. **\[Advanced (詳細)\]**​ タブをクリックします。
8. **\[Column types (列の型)\]**​ 項目を \[​`Edit inline`​ (インライン編集)\] に設定します。
9. 緑のプラス記号 (​**+**​) をクリックして、カスタム列型を作成します。
10. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Id (ID)\]**​ 項目を ​`2000`​、​**\[Type (型)\]**​ 項目を ​`CONTACT_DETAILS`​ に設定します。
11. **\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Column types (列の型)」 項目を 「edit inline (インライン編集)」 に設定し、プラス記号をクリックして列の型を作成します。](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-column-types.png)

Figure 2. \[Column Types (列の型)\] 項目の設定

XML エディターでは、​`<db:column-type>`​ 設定は次のように記述されます。

```xml
<db:config name="dbConfig">
   <db:derby-connection url="jdbc:derby:muleEmbeddedDB;create=true">
       <db:column-types>
           <!-- Derby uses JAVA_OBJECT for UDT-->
           <db:column-type typeName="CONTACT_DETAILS" id="2000"/>
       </db:column-types>
   </db:derby-connection>
</db:config>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=f3506a0820afe9915a73d20d2baebaf641b9c9992ad33ffa26690780e8f7d46d url=/mulesoft/current/ja-jp/db-connector/1.12/database-configure-data-types.md -->

# Database Connector のデータ型の設定の例

次の例は、クエリの各入力パラメーターの型を指定する ​**\[Parameters types (パラメーターの型)\]**​ 項目と、特定のデータベースプロバイダーに接続されたときにカスタムデータ型を設定する ​**\[Column types (列の型)\]**​ 項目を使用して、データベース用 Anypoint Connector (Database Connector) のデータ型を設定する方法を示しています。

## [](#studio-で-parameter-types-パラメーターの型-項目を設定する)Studio で \[Parameter Types (パラメーターの型)\] 項目を設定する

JDBC ドライバーで入力のデータ型を特定できない場合や、パラメーターがカスタムデータ型の場合、​**\[Parameter types (パラメーターの型)\]**​ 項目を設定して、各入力パラメーターの型を指定します。次の例は、​**Bulk insert**​ 操作の ​**\[Parameter types (パラメーターの型)\]**​ 項目を設定する方法を示しています。

1. Studio のフローで、​**\[Bulk insert\]**​ 操作を選択します。
2. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
4. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)`​)。
5. 操作設定画面で、​**\[Advanced (詳細)\]**​ タブをクリックします。
6. **\[Parameter types (パラメーターの型)\]**​ 項目を \[​`Edit inline`​ (インライン編集)\] に設定します。
7. 緑のプラス記号 (​**+**​) をクリックして、新しいパラメーターの型を作成します。
8. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Key (キー)\]**​ 項目を ​`name`​、​**\[Type (型)\]**​ 項目を ​`VARCHAR`​ に設定します。
9. **\[Finish (完了)\]**​ をクリックします。
10. ステップ 7 を繰り返します。
11. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Key (キー)\]**​ 項目を ​`position`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。
12. **\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Parameter types (パラメーターの型)」 項目を 「Edit Inline (インライン編集)」 に設定し、プラス記号をクリックして新しいパラメーターを作成します。](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-parameter-types.png)

Figure 1. \[Parameter Types (パラメーターの型)\] 項目の設定

XML エディターでは、​`<db:parameter-types>`​ 設定は次のように記述されます。

```xml
<db:bulk-insert queryTimeout="0" queryTimeoutUnit="SECONDS">
     <db:sql>INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)</db:sql>
     <db:parameter-types>
         <db:parameter-type key="name" type="VARCHAR" />
         <db:parameter-type key="position" type="INTEGER" />
     </db:parameter-types>
 </db:bulk-insert>
```

## [](#studio-で-column-types-列の型-項目を設定する)Studio で \[Column Types (列の型)\] 項目を設定する

各接続プロバイダーは、専用パラメーターと共通パラメーターを使用します (Derby や Oracle など)。接続プロバイダー要素の子要素で、特定のプロバイダーに接続している場合に使用できるカスタムデータ型のパラメーターを定義します。

次の表には、カスタムメタデータ型を定義するために使用できる JDBC データ型のコードと ID が記載されています。

<table class="tableblock frame-all grid-all" style="width: 80%;">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">JDBC データ型のコード</th>
<th class="tableblock halign-left valign-top">id</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ARRAY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2003</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BIGINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-5</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BIT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-7</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2004</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BOOLEAN</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2005</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DATALINK</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">70</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DATE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">91</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DECIMAL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DISTINCT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2001</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DOUBLE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">FLOAT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">INTEGER</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">JAVA_OBJECT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2000</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGNVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-16</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGVARBINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-4</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-15</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NCLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2011</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NULL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NUMERIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-9</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">OTHER</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1111</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REAL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">7</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REF</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2006</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REF_CURSOR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2012</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ROWID</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SMALLINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SQLXML</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2009</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">STRUCT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2002</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIME</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">92</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIME_WITH_TIMEZONE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2013</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIMESTAMP</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">93</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIMESTAMP_WITH_TIMEZONE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2014</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TINYINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-6</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">VARBINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-3</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">VARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">12</p></td>
</tr>
</tbody>
</table>

次の例は、Derby グローバル設定接続要素の ​**\[Column types (列の型)\]**​ 項目を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ タブに移動します。
2. **\[Create (作成)\]**​ をクリックします。
3. **\[Global Type (グローバル種別)\]**​ ウィンドウで、「​`database`​」と入力して絞り込みます。
4. **\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
5. **\[Connection (接続)\]**​ 項目を \[​`Derby Connection`​ (Derby 接続)\] に設定します。
6. Derby JDBC ドライバーの必須ライブラリと追加の接続項目を設定します。
7. **\[Advanced (詳細)\]**​ タブをクリックします。
8. **\[Column types (列の型)\]**​ 項目を \[​`Edit inline`​ (インライン編集)\] に設定します。
9. 緑のプラス記号 (​**+**​) をクリックして、カスタム列型を作成します。
10. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Id (ID)\]**​ 項目を ​`2000`​、​**\[Type (型)\]**​ 項目を ​`CONTACT_DETAILS`​ に設定します。
11. **\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Column types (列の型)」 項目を 「edit inline (インライン編集)」 に設定し、プラス記号をクリックして列の型を作成します。](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-column-types.png)

Figure 2. \[Column Types (列の型)\] 項目の設定

XML エディターでは、​`<db:column-type>`​ 設定は次のように記述されます。

```xml
<db:config name="dbConfig">
   <db:derby-connection url="jdbc:derby:muleEmbeddedDB;create=true">
       <db:column-types>
           <!-- Derby uses JAVA_OBJECT for UDT-->
           <db:column-type typeName="CONTACT_DETAILS" id="2000"/>
       </db:column-types>
   </db:derby-connection>
</db:config>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=a256ecc98fd48761653feb51c53222e28a5b738e6017cc8ea6016938345123c8 url=/mulesoft/current/ja-jp/db-connector/1.13/database-configure-data-types.md -->

# Database Connector のデータ型の設定の例

次の例は、クエリの各入力パラメーターの型を指定する ​**\[Parameters types (パラメーターの型)\]**​ 項目と、特定のデータベースプロバイダーに接続されたときにカスタムデータ型を設定する ​**\[Column types (列の型)\]**​ 項目を使用して、データベース用 Anypoint Connector (Database Connector) のデータ型を設定する方法を示しています。

## [](#studio-で-parameter-types-パラメーターの型-項目を設定する)Studio で \[Parameter Types (パラメーターの型)\] 項目を設定する

JDBC ドライバーで入力のデータ型を特定できない場合や、パラメーターがカスタムデータ型の場合、​**\[Parameter types (パラメーターの型)\]**​ 項目を設定して、各入力パラメーターの型を指定します。次の例は、​**Bulk insert**​ 操作の ​**\[Parameter types (パラメーターの型)\]**​ 項目を設定する方法を示しています。

1. Studio のフローで、​**\[Bulk insert\]**​ 操作を選択します。
2. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
4. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)`​)。
5. 操作設定画面で、​**\[Advanced (詳細)\]**​ タブをクリックします。
6. **\[Parameter types (パラメーターの型)\]**​ 項目を \[​`Edit inline`​ (インライン編集)\] に設定します。
7. 緑のプラス記号 (​**+**​) をクリックして、新しいパラメーターの型を作成します。
8. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Key (キー)\]**​ 項目を ​`name`​、​**\[Type (型)\]**​ 項目を ​`VARCHAR`​ に設定します。
9. **\[Finish (完了)\]**​ をクリックします。
10. ステップ 7 を繰り返します。
11. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Key (キー)\]**​ 項目を ​`position`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。
12. **\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Parameter types (パラメーターの型)」 項目を 「Edit Inline (インライン編集)」 に設定し、プラス記号をクリックして新しいパラメーターを作成します。](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-parameter-types.png)

Figure 1. \[Parameter Types (パラメーターの型)\] 項目の設定

XML エディターでは、​`<db:parameter-types>`​ 設定は次のように記述されます。

```xml
<db:bulk-insert queryTimeout="0" queryTimeoutUnit="SECONDS">
     <db:sql>INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)</db:sql>
     <db:parameter-types>
         <db:parameter-type key="name" type="VARCHAR" />
         <db:parameter-type key="position" type="INTEGER" />
     </db:parameter-types>
 </db:bulk-insert>
```

## [](#studio-で-column-types-列の型-項目を設定する)Studio で \[Column Types (列の型)\] 項目を設定する

各接続プロバイダーは、専用パラメーターと共通パラメーターを使用します (Derby や Oracle など)。接続プロバイダー要素の子要素で、特定のプロバイダーに接続している場合に使用できるカスタムデータ型のパラメーターを定義します。

次の表には、カスタムメタデータ型を定義するために使用できる JDBC データ型のコードと ID が記載されています。

<table class="tableblock frame-all grid-all" style="width: 80%;">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">JDBC データ型のコード</th>
<th class="tableblock halign-left valign-top">id</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ARRAY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2003</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BIGINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-5</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BIT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-7</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2004</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BOOLEAN</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2005</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DATALINK</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">70</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DATE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">91</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DECIMAL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DISTINCT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2001</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DOUBLE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">FLOAT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">INTEGER</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">JAVA_OBJECT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2000</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGNVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-16</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGVARBINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-4</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-15</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NCLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2011</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NULL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NUMERIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-9</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">OTHER</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1111</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REAL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">7</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REF</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2006</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REF_CURSOR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2012</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ROWID</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SMALLINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SQLXML</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2009</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">STRUCT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2002</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIME</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">92</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIME_WITH_TIMEZONE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2013</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIMESTAMP</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">93</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIMESTAMP_WITH_TIMEZONE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2014</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TINYINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-6</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">VARBINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-3</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">VARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">12</p></td>
</tr>
</tbody>
</table>

次の例は、Derby グローバル設定接続要素の ​**\[Column types (列の型)\]**​ 項目を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ タブに移動します。
2. **\[Create (作成)\]**​ をクリックします。
3. **\[Global Type (グローバル種別)\]**​ ウィンドウで、「​`database`​」と入力して絞り込みます。
4. **\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
5. **\[Connection (接続)\]**​ 項目を \[​`Derby Connection`​ (Derby 接続)\] に設定します。
6. Derby JDBC ドライバーの必須ライブラリと追加の接続項目を設定します。
7. **\[Advanced (詳細)\]**​ タブをクリックします。
8. **\[Column types (列の型)\]**​ 項目を \[​`Edit inline`​ (インライン編集)\] に設定します。
9. 緑のプラス記号 (​**+**​) をクリックして、カスタム列型を作成します。
10. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Id (ID)\]**​ 項目を ​`2000`​、​**\[Type (型)\]**​ 項目を ​`CONTACT_DETAILS`​ に設定します。
11. **\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Column types (列の型)」 項目を 「edit inline (インライン編集)」 に設定し、プラス記号をクリックして列の型を作成します。](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-column-types.png)

Figure 2. \[Column Types (列の型)\] 項目の設定

XML エディターでは、​`<db:column-type>`​ 設定は次のように記述されます。

```xml
<db:config name="dbConfig">
   <db:derby-connection url="jdbc:derby:muleEmbeddedDB;create=true">
       <db:column-types>
           <!-- Derby uses JAVA_OBJECT for UDT-->
           <db:column-type typeName="CONTACT_DETAILS" id="2000"/>
       </db:column-types>
   </db:derby-connection>
</db:config>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=11a238bd3622330ea445a016775a37c4d67c2efbf3659cd1856507988803b65c url=/mulesoft/current/ja-jp/db-connector/1.14/database-configure-data-types.md -->

# Database Connector のデータ型の設定の例

次の例は、クエリの各入力パラメーターの型を指定する ​**\[Parameters types (パラメーターの型)\]**​ 項目と、特定のデータベースプロバイダーに接続されたときにカスタムデータ型を設定する ​**\[Column types (列の型)\]**​ 項目を使用して、データベース用 Anypoint Connector (Database Connector) のデータ型を設定する方法を示しています。

## [](#studio-で-parameter-types-パラメーターの型-項目を設定する)Studio で \[Parameter Types (パラメーターの型)\] 項目を設定する

JDBC ドライバーで入力のデータ型を特定できない場合や、パラメーターがカスタムデータ型の場合、​**\[Parameter types (パラメーターの型)\]**​ 項目を設定して、各入力パラメーターの型を指定します。次の例は、​**Bulk insert**​ 操作の ​**\[Parameter types (パラメーターの型)\]**​ 項目を設定する方法を示しています。

1. Studio のフローで、​**\[Bulk insert\]**​ 操作を選択します。
2. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
4. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)`​)。
5. 操作設定画面で、​**\[Advanced (詳細)\]**​ タブをクリックします。
6. **\[Parameter types (パラメーターの型)\]**​ 項目を \[​`Edit inline`​ (インライン編集)\] に設定します。
7. 緑のプラス記号 (​**+**​) をクリックして、新しいパラメーターの型を作成します。
8. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Key (キー)\]**​ 項目を ​`name`​、​**\[Type (型)\]**​ 項目を ​`VARCHAR`​ に設定します。
9. **\[Finish (完了)\]**​ をクリックします。
10. ステップ 7 を繰り返します。
11. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Key (キー)\]**​ 項目を ​`position`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。
12. **\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Parameter types (パラメーターの型)」 項目を 「Edit Inline (インライン編集)」 に設定し、プラス記号をクリックして新しいパラメーターを作成します。](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-parameter-types.png)

Figure 1. \[Parameter Types (パラメーターの型)\] 項目の設定

XML エディターでは、​`<db:parameter-types>`​ 設定は次のように記述されます。

```xml
<db:bulk-insert queryTimeout="0" queryTimeoutUnit="SECONDS">
     <db:sql>INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)</db:sql>
     <db:parameter-types>
         <db:parameter-type key="name" type="VARCHAR" />
         <db:parameter-type key="position" type="INTEGER" />
     </db:parameter-types>
 </db:bulk-insert>
```

## [](#studio-で-column-types-列の型-項目を設定する)Studio で \[Column Types (列の型)\] 項目を設定する

各接続プロバイダーは、専用パラメーターと共通パラメーターを使用します (Derby や Oracle など)。接続プロバイダー要素の子要素で、特定のプロバイダーに接続している場合に使用できるカスタムデータ型のパラメーターを定義します。

次の表には、カスタムメタデータ型を定義するために使用できる JDBC データ型のコードと ID が記載されています。

<table class="tableblock frame-all grid-all" style="width: 80%;">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">JDBC データ型のコード</th>
<th class="tableblock halign-left valign-top">id</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ARRAY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2003</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BIGINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-5</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BIT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-7</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2004</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BOOLEAN</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2005</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DATALINK</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">70</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DATE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">91</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DECIMAL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DISTINCT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2001</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DOUBLE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">FLOAT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">INTEGER</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">JAVA_OBJECT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2000</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGNVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-16</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGVARBINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-4</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-15</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NCLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2011</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NULL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NUMERIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-9</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">OTHER</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1111</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REAL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">7</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REF</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2006</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REF_CURSOR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2012</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ROWID</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SMALLINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SQLXML</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2009</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">STRUCT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2002</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIME</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">92</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIME_WITH_TIMEZONE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2013</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIMESTAMP</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">93</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIMESTAMP_WITH_TIMEZONE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2014</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TINYINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-6</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">VARBINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-3</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">VARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">12</p></td>
</tr>
</tbody>
</table>

次の例は、Derby グローバル設定接続要素の ​**\[Column types (列の型)\]**​ 項目を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ タブに移動します。
2. **\[Create (作成)\]**​ をクリックします。
3. **\[Global Type (グローバル種別)\]**​ ウィンドウで、「​`database`​」と入力して絞り込みます。
4. **\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
5. **\[Connection (接続)\]**​ 項目を \[​`Derby Connection`​ (Derby 接続)\] に設定します。
6. Derby JDBC ドライバーの必須ライブラリと追加の接続項目を設定します。
7. **\[Advanced (詳細)\]**​ タブをクリックします。
8. **\[Column types (列の型)\]**​ 項目を \[​`Edit inline`​ (インライン編集)\] に設定します。
9. 緑のプラス記号 (​**+**​) をクリックして、カスタム列型を作成します。
10. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Id (ID)\]**​ 項目を ​`2000`​、​**\[Type (型)\]**​ 項目を ​`CONTACT_DETAILS`​ に設定します。
11. **\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Column types (列の型)」 項目を 「edit inline (インライン編集)」 に設定し、プラス記号をクリックして列の型を作成します。](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-column-types.png)

Figure 2. \[Column Types (列の型)\] 項目の設定

XML エディターでは、​`<db:column-type>`​ 設定は次のように記述されます。

```xml
<db:config name="dbConfig">
   <db:derby-connection url="jdbc:derby:muleEmbeddedDB;create=true">
       <db:column-types>
           <!-- Derby uses JAVA_OBJECT for UDT-->
           <db:column-type typeName="CONTACT_DETAILS" id="2000"/>
       </db:column-types>
   </db:derby-connection>
</db:config>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=2fe22aaf9da966529b0114e8cc0f84b524071b2f825758dd2fa18e4f593af30b url=/mulesoft/current/ja-jp/db-connector/1.9/database-configure-data-types.md -->

# Database Connector のデータ型の設定の例

次の例は、クエリの各入力パラメーターの型を指定する ​**\[Parameters types (パラメーターの型)\]**​ 項目と、特定のデータベースプロバイダーに接続されたときにカスタムデータ型を設定する ​**\[Column types (列の型)\]**​ 項目を使用して、データベース用 Anypoint Connector (Database Connector) のデータ型を設定する方法を示しています。

## [](#studio-で-parameter-types-パラメーターの型-項目を設定する)Studio で \[Parameter Types (パラメーターの型)\] 項目を設定する

JDBC ドライバーでエラーのない入力のデータ型を特定できない場合や、パラメーターがカスタムデータ型の場合、​**\[Parameter types (パラメーターの型)\]**​ 項目を設定して、各入力パラメーターの型を指定します。次の例は、​**Bulk insert**​ 操作の ​**\[Parameter types (パラメーターの型)\]**​ 項目を設定する方法を示しています。

1. Studio のフローで、​**\[Bulk insert\]**​ 操作を選択します。
2. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
3. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
4. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)`​)。
5. 操作設定画面で、​**\[Advanced (詳細)\]**​ タブをクリックします。
6. **\[Parameter types (パラメーターの型)\]**​ 項目を \[​`Edit inline`​ (インライン編集)\] に設定します。
7. 緑のプラス記号 (​**+**​) をクリックして、新しいパラメーターの型を作成します。
8. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Key (キー)\]**​ 項目を ​`name`​、​**\[Type (型)\]**​ 項目を ​`VARCHAR`​ に設定します。
9. **\[Finish (完了)\]**​ をクリックします。
10. ステップ 7 を繰り返します。
11. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Key (キー)\]**​ 項目を ​`position`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。
12. **\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Parameter types (パラメーターの型)」 項目を 「Edit Inline (インライン編集)」 に設定し、プラス記号をクリックして新しいパラメーターを作成します。](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-parameter-types.png)

Figure 1. \[Parameter Types (パラメーターの型)\] 項目の設定

XML エディターでは、​`<db:parameter-types>`​ 設定は次のように記述されます。

```xml
<db:bulk-insert queryTimeout="0" queryTimeoutUnit="SECONDS">
     <db:sql>INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)</db:sql>
     <db:parameter-types>
         <db:parameter-type key="name" type="VARCHAR" />
         <db:parameter-type key="position" type="INTEGER" />
     </db:parameter-types>
 </db:bulk-insert>
```

## [](#studio-で-column-types-列の型-項目を設定する)Studio で \[Column Types (列の型)\] 項目を設定する

各接続プロバイダーは、専用パラメーターと共通パラメーターを使用します (Derby や Oracle など)。接続プロバイダー要素の子要素で、特定のプロバイダーに接続している場合に使用できるカスタムデータ型のパラメーターを定義します。

次の表には、カスタムメタデータ型を定義するために使用できる JDBC データ型のコードと ID が記載されています。

<table class="tableblock frame-all grid-all" style="width: 80%;">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">JDBC データ型のコード</th>
<th class="tableblock halign-left valign-top">id</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ARRAY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2003</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BIGINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-5</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BIT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-7</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2004</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BOOLEAN</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">16</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2005</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DATALINK</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">70</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DATE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">91</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DECIMAL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DISTINCT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2001</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DOUBLE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">FLOAT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">INTEGER</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">JAVA_OBJECT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2000</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGNVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-16</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGVARBINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-4</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">LONGVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-1</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-15</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NCLOB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2011</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NULL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NUMERIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">NVARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-9</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">OTHER</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1111</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REAL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">7</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REF</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2006</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">REF_CURSOR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2012</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ROWID</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SMALLINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SQLXML</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2009</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">STRUCT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2002</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIME</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">92</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIME_WITH_TIMEZONE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2013</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIMESTAMP</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">93</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TIMESTAMP_WITH_TIMEZONE</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2014</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TINYINT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-6</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">VARBINARY</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-3</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">VARCHAR</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">12</p></td>
</tr>
</tbody>
</table>

次の例は、Derby グローバル設定接続要素の ​**\[Column types (列の型)\]**​ 項目を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ タブに移動します。
2. **\[Create (作成)\]**​ をクリックします。
3. **\[Global Type (グローバル種別)\]**​ ウィンドウで、「​`database`​」と入力して絞り込みます。
4. **\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
5. **\[Connection (接続)\]**​ 項目を \[​`Derby Connection`​ (Derby 接続)\] に設定します。
6. Derby JDBC ドライバーの必須ライブラリと追加の接続項目を設定します。
7. **\[Advanced (詳細)\]**​ タブをクリックします。
8. **\[Column types (列の型)\]**​ 項目を \[​`Edit inline`​ (インライン編集)\] に設定します。
9. 緑のプラス記号 (​**+**​) をクリックして、カスタム列型を作成します。
10. \[parameter type (パラメーターの型)\] ウィンドウで、​**\[Id (ID)\]**​ 項目を ​`2000`​、​**\[Type (型)\]**​ 項目を ​`CONTACT_DETAILS`​ に設定します。
11. **\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Column types (列の型)」 項目を 「edit inline (インライン編集)」 に設定し、プラス記号をクリックして列の型を作成します。](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-column-types.png)

Figure 2. \[Column Types (列の型)\] 項目の設定

XML エディターでは、​`<db:column-type>`​ 設定は次のように記述されます。

```xml
<db:config name="dbConfig">
   <db:derby-connection url="jdbc:derby:muleEmbeddedDB;create=true">
       <db:column-types>
           <!-- Derby uses JAVA_OBJECT for UDT-->
           <db:column-type typeName="CONTACT_DETAILS" id="2000"/>
       </db:column-types>
   </db:derby-connection>
</db:config>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=395c8a18dbef8b4be6641c5c2c5ae6b85afb31c5d2ca76719b3bd87b3142d40f url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-troubleshooting.md -->

# Database Connector のトラブルシューティング

データベース用 Anypoint Connector (Database Connector) をトラブルシューティングするために、冗長ログの有効化、プーリングプロファイル接続のトラブルシューティング、Snowflake JDBC ドライバーのトラブルシューティング、スローされる一般的なメッセージの解釈に関する情報について説明します。

Database Connector は、JDBC ライブラリ (Java SE JDK 1.8 を使用) に記載されている標準およびガイドラインに従います。

## [](#冗長ログの有効化)冗長ログの有効化

アプリケーションとデータベースのやりとりが失敗する理由の理解を深めるには、Database Connector の冗長ログを一時的に有効にします。  
手動で ​`log4j2.xml`​ ファイルを変更するか、CloudHub API を使用している場合は Anypoint Runtime Manager を使用して、冗長ログを有効にします。  
Mule アプリケーションのパフォーマンスに影響するため、トラブルシューティングが完了したら、必ず拡張された冗長性を無効にしてください。

設定ファイルで冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。
2. アプリケーションのプロジェクト名を開きます。
3. `src/main/resources`​ パスフォルダーを開きます。
4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。
5. `<Loggers>`​ タグ内に ​`<AsyncLogger>`​ タグを追加します。
    
    ```xml
    			<Loggers>
    				...
    				<AsyncLogger name="org.mule.extension.db" level="DEBUG"/>
    				<AsyncLogger name="org.mule.db.commons" level="DEBUG"/>
    				...
    			</Loggers>
    ```
6. アプリケーションの変更を保存します。
7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。

Anypoint Runtime Manager で冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Runtime Manager にアクセスします。
2. \[API configuration (API 設定)\] に移動します。
3. **\[Logging (ログ)\]**​ サブタブで、DEBUG レベルで ​`org.mule.extension.db`​ および ​`org.mule.db.commons`​ パッケージを追加します。
4. 変更を適用します。

## [](#プーリングプロファイル接続によるフローのハングのトラブルシューティング)プーリングプロファイル接続によるフローのハングのトラブルシューティング

フローで必要とされる接続数よりも少ない接続を提供するプーリングプロファイルを使用すると、フロー全体がハングする可能性があります。

この問題を解決する手順は、次のとおりです。

解決策の 1 つとして、プールのサイズを増やすことが挙げられます。この方法が使用できない場合、仮想マシン用 Anypoint Connector (VM Connector) を使用して、VM メッセージの有効期間に一致するように接続の有効期間を短くします。こうすることで、​**Stored procedure**​ 操作へのすべてのコールが実行されて、その結果がコンシュームされ、操作に関連付けられている接続が終了してプールに戻ります。

次の例は、​**Stored procedure**​ 操作と VM Connector でプーリングプロファイルを使用する方法を示しています。この例では、​`foreach`​ 要素が 11 番目の反復に到達しても、プールで接続を提供できるため、​**Stored procedure**​ 操作はハングしません。

```xml
	<db:config name="Database_Config">
		<db:generic-connection url="someUrl" user="someUser" password="somePassword" driverClassName="someDriver">
			<db:pooling-profile maxPoolSize="10">
			</db:pooling-profile>
		</db:generic-connection>
	</db:config>

	<vm:config name="VM_Config">
		<vm:queues >
			<vm:queue queueName="testQueue" />
		</vm:queues>
	</vm:config>

	<flow name="processingFlow">
		<foreach collection="#[1 to 11]">
			<logger level="INFO" message="#['Starting Iteration ' ++ payload as String]" />
			<vm:publish config-ref="VM_Config" queueName="testQueue"/>
			<logger level="INFO" message="#['Finishing Iteration ' ++ payload as String]"/>
		</foreach>
	</flow>

	<flow name="coolFlow">
		<vm:listener config-ref="VM_Config" queueName="testQueue" numberOfConsumers="1"/>
		<db:stored-procedure config-ref="Database_Config">
				<db:sql><![CDATA[{call testProc2()}]]></db:sql>
			</db:stored-procedure>
		<logger level="INFO" message="#[output application/json --- payload.resultSet1]" />
	</flow>
```

## [](#select-操作と-stored-procedure-操作の警告例外について)Select 操作と Stored Procedure 操作の警告例外について

Database Connector の ​**Select**​ および ​**Stored procedure**​ 操作が適切に実行され、結果が返されない場合、Mule Runtime Engine (Mule) では、例外がスローされるのではなく ​`WARN`​ 例外メッセージが返されます。

**Select**​ 操作では、この動作は無効な SQL ステートメントが実行された場合に発生します。​**Store procedure**​ 操作では、プロシージャーを崩す可能性があるエラーが一連のステートメント内にある場合に発生します。実際には、JDBC で一連の ​`ResultSets`​、​`UpdateCounts`​、および ​`Exceptions`​ が返されます。

根本原因がドライバーの動作にあるため、Mule ではフローでキャッチされる例外はスローされません。一部のドライバーは JDBC に厳格に準拠して実行時にスローを適切にスローしますが、そうでないドライバーもあります。このため、例外をスローする動作をコネクタのコードに追加すると、例外を想定していない Mule アプリケーションの後方互換性が失われることになります。

**Select**​ 操作の場合、サブクエリで複数の値が返され、その結果が絞り込みや式として使用される場合、Mule で ​`WARN`​ 例外が記録されます。Mule は、操作が実行されたときではなく、操作の結果がページ分割されるとすぐに警告を返します。

たとえば、次の SQL ステートメントがあるとします。

```xml
		<db:select doc:name="Select" config-ref="Database_Config">
			<db:sql ><![CDATA[
						SELECT *
						FROM SomeTable
						WHERE SomeColumn = (SELECT DISTINCT SomeColumn2 from SomeTable2)
					 ]]>
			</db:sql>
		</db:select>
```

Mule で次の ​`WARN`​ 例外が記録されます。

```xml
	WARN  2021-06-01 10:04:33,323 [[MuleRuntime].io.10: [some-mule-app].some-mule-app.BLOCKING @...] [event: ...] org.mule.extension.db.internal.result.resultset.ResultSetIterator: Unable to determine if there are more records
	com.microsoft.sqlserver.jdbc.SQLServerException: Subquery returned more than 1 value. This is not permitted when the subquery follows =, !=, <, <= , >, >= or when the subquery is used as an expression.
```

**Stored procedure**​ 操作の場合、ストアドプロシージャーに複数のステートメントが含まれ、その 1 つ以上が失敗すると、Mule で ​`WARN`​ 例外が記録されます。Mule は、操作が実行されたときではなく、操作の結果がコンシュームされるとすぐに警告を返します。たとえば、次の SQL ストアドプロシージャーがあるとします。

```xml
CREATE PROCEDURE dbo.SomeProcedure
AS
BEGIN
	BEGIN TRY
	select 1/0;
	END TRY
	BEGIN CATCH
	THROW 50000, 'Divide by zero error encountered.', 255;
	END CATCH
END
```

Mule で次の ​`WARN`​ 例外が記録されます。

```xml
	WARN  2021-06-02 09:38:14,624 [[MuleRuntime].io.10: [some-mule-app].some-mule-app.BLOCKING @...] [event: ...] org.mule.extension.db.internal.result.statement.StatementResultIterator: Unable to determine if there are more statement results
	com.microsoft.sqlserver.jdbc.SQLServerException: 'The record does not exist.'
```

## [](#ストアドプロシージャーの例外をスローする-snowflake-jdbc-ドライバーのトラブルシューティング)ストアドプロシージャーの例外をスローする Snowflake JDBC ドライバーのトラブルシューティング

一部のドライバーには、ストアドプロシージャーをコールするときの独自の仕様があります。中括弧 (​`{`​ および ​`}`​) を使用してコール可能なステートメントを設定している場合 (例: `{call doubleMyInt(:myInt)}`​)、アプリケーションを実行すると Snowflake JDBC ドライバーで次の例外がスローされます。

`net.snowflake.client.jdbc.SnowflakeSQLException: Unsupported feature 'call'`

この問題を解決する手順は、次のとおりです。

Snowflake JDBC ドライバーでは、中括弧 ​`{`​ および ​`}`​ を使用せずにコール可能なステートメントを設定します。例:

`call doubleMyInt(:myInt)`

## [](#デプロイ時における静的-ip-を使用する-cloudhub-の失敗のトラブルシューティング)デプロイ時における静的 IP を使用する CloudHub の失敗のトラブルシューティング

静的 IP を使用する CloudHub アプリケーションをデプロイすると、データベーステスト接続エラーがスローされ、プロセスが失敗します。これは、静的 IP が割り当てられる前にテストが実行されているために発生します。

次のスタックトレースにテスト接続エラー ​`Could not obtain connection from data source`​ が示されています。

```xml
[2021-03-05 00:26:11.262] INFO    org.mule.runtime.module.extension.internal.runtime.config.LifecycleAwareConfigurationInstance [[MuleRuntime].uber.02: [iagsatellite-snowflake-sys-api-v1-dev].uber@org.mule.runtime.module.extension.internal.runtime.config.LifecycleAwareConfigurationInstance.testConnectivity:179 @10f9d7dc]: Connectivity test failed for config 'Database_Config'. Application deployment will continue. Error was: Could not obtain connection from data source
org.mule.runtime.api.connection.ConnectionException: Could not obtain connection from data source
```

この問題を解決する手順は、次のとおりです。

次のシステムプロパティをデプロイメントに設定します: `-DdoTestConnectivity=false`

## [](#oracle-の-null-値のトラブルシューティング)Oracle の NULL 値のトラブルシューティング

`NULL`​ 値を Oracle データベースに送信しようとすると、問題が発生することがあります。

この問題を解決する手順は、次のとおりです。

Oracle では、空の文字列は ​`NULL`​ となるため、代わりに ​`''`​ を送信します。

## [](#システムプロパティを使用した-oracle-の-xml-拡張機能のトラブルシューティング)システムプロパティを使用した Oracle の XML 拡張機能のトラブルシューティング

Oracle XML 拡張機能を使用するには、Oracle jar ファイルを連動関係として追加する必要があります。これらの jar ファイルの 1 つに ​`xmlparserv2.jar`​ があります。このファイルは、Java SPI (サービスプロバイダーインターフェース) 経由で XML パーサー機能をエクスポートします。Mule の内部でこのパーサーを使用していると、Mule コンポーネントの想定と一致しなくなるため、次のような XML 解析エラーとなる場合があります。

```xml
	<Line 43, Column 57>: XML-24509: (Error) Duplicated definition for: 'identifiedType' <Line 60, Column 28>: XML-24509: (Error) Duplicated definition for: 'beans' <Line 140, Column 34>: XML-24509: (Error) Duplicated definition for: 'description'
```

この問題には、次のいずれかの方法で対処できます。

- `xmlparserv2.jar`​ ファイルを Database Connector の追加のプラグイン連動関係として追加し、連動関係がコネクタ内でのみ表示されるようにします。  
    ただし、データソースを Spring で設定された Bean として提供するために Oracle 接続をモジュール間で共有する必要がある場合には、この方法は使用できません。
- Mule の内部コンポーネントが常に想定する XML パーサーを取得するように、次のシステムプロパティを設定して XML パーサー SPI ルックアップを無効にします。

システムプロパティ:

```xml
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl
```

これらのプロパティにより、Oracle .jar ファイルを共有ライブラリとしてセットアップする場合などには問題を回避できます。

システムプロパティの設定方法についての詳細は、​[システムプロパティ](https://docs.mulesoft.com/mule-runtime/latest/mule-app-properties-system)​のドキュメントを参照してください。

## [](#一般的なスローの理解)一般的なスローの理解

スローされる一般的なメッセージのリストとその解釈方法を次に示します。

- DB:BAD\_SQL\_SYNTAX
    
    指定された SQL クエリの構文が無効です。
- DB:CANNOT\_LOAD\_DRIVER
    
    Database Connector で JDBC ドライバーを読み込むことができません。
- DB:CANNOT\_REACH
    
    Database Connector で RDBMS との接続を確立できません。
- DB:CONNECTIVITY
    
    いくつかの考えられる接続の問題 (不適切な接続の設定、行のフェッチ結果を待機しているときのデータベース応答の欠落、データベース接続の切断など)。
- DB:INVALID\_DATABASE
    
    RDBMS への接続は確立されましたが、データベースが存在していません。
- DB:INVALID\_CREDENTIALS
    
    データベースで指定されたログイン情報が拒否されました。
- DB:QUERY\_EXECUTION
    
    クエリの実行に失敗しました。
- DB:RETRY\_EXHAUSTED
    
    すべての再接続の試行に失敗しました。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=bc62de83e1bab501927ae6497ed37d34426e0bc873a5f2d8dee9cee5732a79f4 url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-troubleshooting.md -->

# Database Connector のトラブルシューティング

データベース用 Anypoint Connector (Database Connector) をトラブルシューティングするために、冗長ログの有効化、プーリングプロファイル接続のトラブルシューティング、Snowflake JDBC ドライバーのトラブルシューティング、スローされる一般的なメッセージの解釈に関する情報について説明します。

Database Connector は、JDBC ライブラリ (Java SE JDK 1.8 を使用) に記載されている標準およびガイドラインに従います。

## [](#冗長ログの有効化)冗長ログの有効化

アプリケーションとデータベースのやりとりが失敗する理由の理解を深めるには、Database Connector の冗長ログを一時的に有効にします。  
手動で ​`log4j2.xml`​ ファイルを変更するか、CloudHub API を使用している場合は Anypoint Runtime Manager を使用して、冗長ログを有効にします。  
Mule アプリケーションのパフォーマンスに影響するため、トラブルシューティングが完了したら、必ず拡張された冗長性を無効にしてください。

設定ファイルで冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。
2. アプリケーションのプロジェクト名を開きます。
3. `src/main/resources`​ パスフォルダーを開きます。
4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。
5. `<Loggers>`​ タグ内に ​`<AsyncLogger>`​ タグを追加します。
    
    ```xml
    			<Loggers>
    				...
    				<AsyncLogger name="org.mule.extension.db" level="DEBUG"/>
    				<AsyncLogger name="org.mule.db.commons" level="DEBUG"/>
    				...
    			</Loggers>
    ```
6. アプリケーションの変更を保存します。
7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。

Anypoint Runtime Manager で冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Runtime Manager にアクセスします。
2. \[API configuration (API 設定)\] に移動します。
3. **\[Logging (ログ)\]**​ サブタブで、DEBUG レベルで ​`org.mule.extension.db`​ および ​`org.mule.db.commons`​ パッケージを追加します。
4. 変更を適用します。

## [](#プーリングプロファイル接続によるフローのハングのトラブルシューティング)プーリングプロファイル接続によるフローのハングのトラブルシューティング

フローで必要とされる接続数よりも少ない接続を提供するプーリングプロファイルを使用すると、フロー全体がハングする可能性があります。

この問題を解決する手順は、次のとおりです。

解決策の 1 つとして、プールのサイズを増やすことが挙げられます。この方法が使用できない場合、仮想マシン用 Anypoint Connector (VM Connector) を使用して、VM メッセージの有効期間に一致するように接続の有効期間を短くします。こうすることで、​**Stored procedure**​ 操作へのすべてのコールが実行されて、その結果がコンシュームされ、操作に関連付けられている接続が終了してプールに戻ります。

次の例は、​**Stored procedure**​ 操作と VM Connector でプーリングプロファイルを使用する方法を示しています。この例では、​`foreach`​ 要素が 11 番目の反復に到達しても、プールで接続を提供できるため、​**Stored procedure**​ 操作はハングしません。

```xml
	<db:config name="Database_Config">
		<db:generic-connection url="someUrl" user="someUser" password="somePassword" driverClassName="someDriver">
			<db:pooling-profile maxPoolSize="10">
			</db:pooling-profile>
		</db:generic-connection>
	</db:config>

	<vm:config name="VM_Config">
		<vm:queues >
			<vm:queue queueName="testQueue" />
		</vm:queues>
	</vm:config>

	<flow name="processingFlow">
		<foreach collection="#[1 to 11]">
			<logger level="INFO" message="#['Starting Iteration ' ++ payload as String]" />
			<vm:publish config-ref="VM_Config" queueName="testQueue"/>
			<logger level="INFO" message="#['Finishing Iteration ' ++ payload as String]"/>
		</foreach>
	</flow>

	<flow name="coolFlow">
		<vm:listener config-ref="VM_Config" queueName="testQueue" numberOfConsumers="1"/>
		<db:stored-procedure config-ref="Database_Config">
				<db:sql><![CDATA[{call testProc2()}]]></db:sql>
			</db:stored-procedure>
		<logger level="INFO" message="#[output application/json --- payload.resultSet1]" />
	</flow>
```

## [](#select-操作と-stored-procedure-操作の警告例外について)Select 操作と Stored Procedure 操作の警告例外について

Database Connector の ​**Select**​ および ​**Stored procedure**​ 操作が適切に実行され、結果が返されない場合、Mule Runtime Engine (Mule) では、例外がスローされるのではなく ​`WARN`​ 例外メッセージが返されます。

**Select**​ 操作では、この動作は無効な SQL ステートメントが実行された場合に発生します。​**Store procedure**​ 操作では、プロシージャーを崩す可能性があるエラーが一連のステートメント内にある場合に発生します。実際には、JDBC で一連の ​`ResultSets`​、​`UpdateCounts`​、および ​`Exceptions`​ が返されます。

根本原因がドライバーの動作にあるため、Mule ではフローでキャッチされる例外はスローされません。一部のドライバーは JDBC に厳格に準拠して実行時にスローを適切にスローしますが、そうでないドライバーもあります。このため、例外をスローする動作をコネクタのコードに追加すると、例外を想定していない Mule アプリケーションの後方互換性が失われることになります。

**Select**​ 操作の場合、サブクエリで複数の値が返され、その結果が絞り込みや式として使用される場合、Mule で ​`WARN`​ 例外が記録されます。Mule は、操作が実行されたときではなく、操作の結果がページ分割されるとすぐに警告を返します。

たとえば、次の SQL ステートメントがあるとします。

```xml
		<db:select doc:name="Select" config-ref="Database_Config">
			<db:sql ><![CDATA[
						SELECT *
						FROM SomeTable
						WHERE SomeColumn = (SELECT DISTINCT SomeColumn2 from SomeTable2)
					 ]]>
			</db:sql>
		</db:select>
```

Mule で次の ​`WARN`​ 例外が記録されます。

```xml
	WARN  2021-06-01 10:04:33,323 [[MuleRuntime].io.10: [some-mule-app].some-mule-app.BLOCKING @...] [event: ...] org.mule.extension.db.internal.result.resultset.ResultSetIterator: Unable to determine if there are more records
	com.microsoft.sqlserver.jdbc.SQLServerException: Subquery returned more than 1 value. This is not permitted when the subquery follows =, !=, <, <= , >, >= or when the subquery is used as an expression.
```

**Stored procedure**​ 操作の場合、ストアドプロシージャーに複数のステートメントが含まれ、その 1 つ以上が失敗すると、Mule で ​`WARN`​ 例外が記録されます。Mule は、操作が実行されたときではなく、操作の結果がコンシュームされるとすぐに警告を返します。たとえば、次の SQL ストアドプロシージャーがあるとします。

```xml
CREATE PROCEDURE dbo.SomeProcedure
AS
BEGIN
	BEGIN TRY
	select 1/0;
	END TRY
	BEGIN CATCH
	THROW 50000, 'Divide by zero error encountered.', 255;
	END CATCH
END
```

Mule で次の ​`WARN`​ 例外が記録されます。

```xml
	WARN  2021-06-02 09:38:14,624 [[MuleRuntime].io.10: [some-mule-app].some-mule-app.BLOCKING @...] [event: ...] org.mule.extension.db.internal.result.statement.StatementResultIterator: Unable to determine if there are more statement results
	com.microsoft.sqlserver.jdbc.SQLServerException: 'The record does not exist.'
```

## [](#ストアドプロシージャーの例外をスローする-snowflake-jdbc-ドライバーのトラブルシューティング)ストアドプロシージャーの例外をスローする Snowflake JDBC ドライバーのトラブルシューティング

一部のドライバーには、ストアドプロシージャーをコールするときの独自の仕様があります。中括弧 (​`{`​ および ​`}`​) を使用してコール可能なステートメントを設定している場合 (例: `{call doubleMyInt(:myInt)}`​)、アプリケーションを実行すると Snowflake JDBC ドライバーで次の例外がスローされます。

`net.snowflake.client.jdbc.SnowflakeSQLException: Unsupported feature 'call'`

この問題を解決する手順は、次のとおりです。

Snowflake JDBC ドライバーでは、中括弧 ​`{`​ および ​`}`​ を使用せずにコール可能なステートメントを設定します。例:

`call doubleMyInt(:myInt)`

## [](#デプロイ時における静的-ip-を使用する-cloudhub-の失敗のトラブルシューティング)デプロイ時における静的 IP を使用する CloudHub の失敗のトラブルシューティング

静的 IP を使用する CloudHub アプリケーションをデプロイすると、データベーステスト接続エラーがスローされ、プロセスが失敗します。これは、静的 IP が割り当てられる前にテストが実行されているために発生します。

次のスタックトレースにテスト接続エラー ​`Could not obtain connection from data source`​ が示されています。

```xml
[2021-03-05 00:26:11.262] INFO    org.mule.runtime.module.extension.internal.runtime.config.LifecycleAwareConfigurationInstance [[MuleRuntime].uber.02: [iagsatellite-snowflake-sys-api-v1-dev].uber@org.mule.runtime.module.extension.internal.runtime.config.LifecycleAwareConfigurationInstance.testConnectivity:179 @10f9d7dc]: Connectivity test failed for config 'Database_Config'. Application deployment will continue. Error was: Could not obtain connection from data source
org.mule.runtime.api.connection.ConnectionException: Could not obtain connection from data source
```

この問題を解決する手順は、次のとおりです。

次のシステムプロパティをデプロイメントに設定します: `-DdoTestConnectivity=false`

## [](#システムプロパティを使用した-oracle-の-xml-拡張機能のトラブルシューティング)システムプロパティを使用した Oracle の XML 拡張機能のトラブルシューティング

Oracle XML 拡張機能を使用するには、Oracle jar ファイルを連動関係として追加する必要があります。これらの jar ファイルの 1 つに ​`xmlparserv2.jar`​ があります。このファイルは、Java SPI (サービスプロバイダーインターフェース) 経由で XML パーサー機能をエクスポートします。Mule の内部でこのパーサーを使用していると、Mule コンポーネントの想定と一致しなくなるため、次のような XML 解析エラーとなる場合があります。

```xml
	<Line 43, Column 57>: XML-24509: (Error) Duplicated definition for: 'identifiedType' <Line 60, Column 28>: XML-24509: (Error) Duplicated definition for: 'beans' <Line 140, Column 34>: XML-24509: (Error) Duplicated definition for: 'description'
```

この問題には、次のいずれかの方法で対処できます。

- `xmlparserv2.jar`​ ファイルを Database Connector の追加のプラグイン連動関係として追加し、連動関係がコネクタ内でのみ表示されるようにします。  
    ただし、データソースを Spring で設定された Bean として提供するために Oracle 接続をモジュール間で共有する必要がある場合には、この方法は使用できません。
- Mule の内部コンポーネントが常に想定する XML パーサーを取得するように、次のシステムプロパティを設定して XML パーサー SPI ルックアップを無効にします。

システムプロパティ:

```xml
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl
```

これらのプロパティにより、Oracle .jar ファイルを共有ライブラリとしてセットアップする場合などには問題を回避できます。

システムプロパティの設定方法についての詳細は、​[システムプロパティ](https://docs.mulesoft.com/mule-runtime/latest/mule-app-properties-system)​のドキュメントを参照してください。

## [](#一般的なスローを理解する)一般的なスローを理解する

スローされる一般的なメッセージのリストとその解釈方法を次に示します。

- DB:BAD\_SQL\_SYNTAX
    
    指定された SQL クエリの構文が無効です。
- DB:CANNOT\_LOAD\_DRIVER
    
    Database Connector で JDBC ドライバーを読み込むことができません。
- DB:CANNOT\_REACH
    
    Database Connector で RDBMS との接続を確立できません。
- DB:CONNECTIVITY
    
    いくつかの考えられる接続の問題 (不適切な接続の設定、行のフェッチ結果を待機しているときのデータベース応答の欠落、データベース接続の切断など)。
- DB:INVALID\_DATABASE
    
    RDBMS への接続は確立されましたが、データベースが存在していません。
- DB:INVALID\_CREDENTIALS
    
    データベースで指定されたログイン情報が拒否されました。
- DB:QUERY\_EXECUTION
    
    クエリの実行に失敗しました。
- DB:RETRY\_EXHAUSTED
    
    すべての再接続の試行に失敗しました。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=dbcb2972682bdac49c850f96ba8d6769fb63fc2bd0b486e9d2e13cf53c4ecb7d url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-troubleshooting.md -->

# Database Connector のトラブルシューティング

データベース用 Anypoint Connector (Database Connector) をトラブルシューティングするために、冗長ログの有効化、プーリングプロファイル接続のトラブルシューティング、Snowflake JDBC ドライバーのトラブルシューティング、スローされる一般的なメッセージの解釈に関する情報について説明します。

Database Connector は、JDBC ライブラリ (Java SE JDK 1.8 を使用) に記載されている標準およびガイドラインに従います。

## [](#冗長ログの有効化)冗長ログの有効化

アプリケーションとデータベースのやりとりが失敗する理由の理解を深めるには、Database Connector の冗長ログを一時的に有効にします。  
手動で ​`log4j2.xml`​ ファイルを変更するか、CloudHub API を使用している場合は Anypoint Runtime Manager を使用して、冗長ログを有効にします。  
Mule アプリケーションのパフォーマンスに影響するため、トラブルシューティングが完了したら、必ず拡張された冗長性を無効にしてください。

設定ファイルで冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。
2. アプリケーションのプロジェクト名を開きます。
3. `src/main/resources`​ パスフォルダーを開きます。
4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。
5. `<Loggers>`​ タグ内に ​`<AsyncLogger>`​ タグを追加します。
    
    ```xml
    			<Loggers>
    				...
    				<AsyncLogger name="org.mule.extension.db" level="DEBUG"/>
    				<AsyncLogger name="org.mule.db.commons" level="DEBUG"/>
    				...
    			</Loggers>
    ```
6. アプリケーションの変更を保存します。
7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。

Anypoint Runtime Manager で冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Runtime Manager にアクセスします。
2. \[API configuration (API 設定)\] に移動します。
3. **\[Logging (ログ)\]**​ サブタブで、DEBUG レベルで ​`org.mule.extension.db`​ および ​`org.mule.db.commons`​ パッケージを追加します。
4. 変更を適用します。

## [](#プーリングプロファイル接続によるフローのハングのトラブルシューティング)プーリングプロファイル接続によるフローのハングのトラブルシューティング

フローで必要とされる接続数よりも少ない接続を提供するプーリングプロファイルを使用すると、フロー全体がハングする可能性があります。

この問題を解決する手順は、次のとおりです。

解決策の 1 つとして、プールのサイズを増やすことが挙げられます。この方法が使用できない場合、仮想マシン用 Anypoint Connector (VM Connector) を使用して、VM メッセージの有効期間に一致するように接続の有効期間を短くします。こうすることで、​**Stored procedure**​ 操作へのすべてのコールが実行されて、その結果がコンシュームされ、操作に関連付けられている接続が終了してプールに戻ります。

次の例は、​**Stored procedure**​ 操作と VM Connector でプーリングプロファイルを使用する方法を示しています。この例では、​`foreach`​ 要素が 11 番目の反復に到達しても、プールで接続を提供できるため、​**Stored procedure**​ 操作はハングしません。

```xml
	<db:config name="Database_Config">
		<db:generic-connection url="someUrl" user="someUser" password="somePassword" driverClassName="someDriver">
			<db:pooling-profile maxPoolSize="10">
			</db:pooling-profile>
		</db:generic-connection>
	</db:config>

	<vm:config name="VM_Config">
		<vm:queues >
			<vm:queue queueName="testQueue" />
		</vm:queues>
	</vm:config>

	<flow name="processingFlow">
		<foreach collection="#[1 to 11]">
			<logger level="INFO" message="#['Starting Iteration ' ++ payload as String]" />
			<vm:publish config-ref="VM_Config" queueName="testQueue"/>
			<logger level="INFO" message="#['Finishing Iteration ' ++ payload as String]"/>
		</foreach>
	</flow>

	<flow name="coolFlow">
		<vm:listener config-ref="VM_Config" queueName="testQueue" numberOfConsumers="1"/>
		<db:stored-procedure config-ref="Database_Config">
				<db:sql><![CDATA[{call testProc2()}]]></db:sql>
			</db:stored-procedure>
		<logger level="INFO" message="#[output application/json --- payload.resultSet1]" />
	</flow>
```

## [](#select-操作と-stored-procedure-操作の警告例外について)Select 操作と Stored Procedure 操作の警告例外について

Database Connector の ​**Select**​ および ​**Stored procedure**​ 操作が適切に実行され、結果が返されない場合、Mule Runtime Engine (Mule) では、例外がスローされるのではなく ​`WARN`​ 例外メッセージが返されます。

**Select**​ 操作では、この動作は無効な SQL ステートメントが実行された場合に発生します。​**Store procedure**​ 操作では、プロシージャーを崩す可能性があるエラーが一連のステートメント内にある場合に発生します。実際には、JDBC で一連の ​`ResultSets`​、​`UpdateCounts`​、および ​`Exceptions`​ が返されます。

根本原因がドライバーの動作にあるため、Mule ではフローでキャッチされる例外はスローされません。一部のドライバーは JDBC に厳格に準拠して実行時にスローを適切にスローしますが、そうでないドライバーもあります。このため、例外をスローする動作をコネクタのコードに追加すると、例外を想定していない Mule アプリケーションの後方互換性が失われることになります。

**Select**​ 操作の場合、サブクエリで複数の値が返され、その結果が絞り込みや式として使用される場合、Mule で ​`WARN`​ 例外が記録されます。Mule は、操作が実行されたときではなく、操作の結果がページ分割されるとすぐに警告を返します。

たとえば、次の SQL ステートメントがあるとします。

```xml
		<db:select doc:name="Select" config-ref="Database_Config">
			<db:sql ><![CDATA[
						SELECT *
						FROM SomeTable
						WHERE SomeColumn = (SELECT DISTINCT SomeColumn2 from SomeTable2)
					 ]]>
			</db:sql>
		</db:select>
```

Mule で次の ​`WARN`​ 例外が記録されます。

```xml
	WARN  2021-06-01 10:04:33,323 [[MuleRuntime].io.10: [some-mule-app].some-mule-app.BLOCKING @...] [event: ...] org.mule.extension.db.internal.result.resultset.ResultSetIterator: Unable to determine if there are more records
	com.microsoft.sqlserver.jdbc.SQLServerException: Subquery returned more than 1 value. This is not permitted when the subquery follows =, !=, <, <= , >, >= or when the subquery is used as an expression.
```

**Stored procedure**​ 操作の場合、ストアドプロシージャーに複数のステートメントが含まれ、その 1 つ以上が失敗すると、Mule で ​`WARN`​ 例外が記録されます。Mule は、操作が実行されたときではなく、操作の結果がコンシュームされるとすぐに警告を返します。たとえば、次の SQL ストアドプロシージャーがあるとします。

```xml
CREATE PROCEDURE dbo.SomeProcedure
AS
BEGIN
	BEGIN TRY
	select 1/0;
	END TRY
	BEGIN CATCH
	THROW 50000, 'Divide by zero error encountered.', 255;
	END CATCH
END
```

Mule で次の ​`WARN`​ 例外が記録されます。

```xml
	WARN  2021-06-02 09:38:14,624 [[MuleRuntime].io.10: [some-mule-app].some-mule-app.BLOCKING @...] [event: ...] org.mule.extension.db.internal.result.statement.StatementResultIterator: Unable to determine if there are more statement results
	com.microsoft.sqlserver.jdbc.SQLServerException: 'The record does not exist.'
```

## [](#ストアドプロシージャーの例外をスローする-snowflake-jdbc-ドライバーのトラブルシューティング)ストアドプロシージャーの例外をスローする Snowflake JDBC ドライバーのトラブルシューティング

一部のドライバーには、ストアドプロシージャーをコールするときの独自の仕様があります。中括弧 (​`{`​ および ​`}`​) を使用してコール可能なステートメントを設定している場合 (例: `{call doubleMyInt(:myInt)}`​)、アプリケーションを実行すると Snowflake JDBC ドライバーで次の例外がスローされます。

`net.snowflake.client.jdbc.SnowflakeSQLException: Unsupported feature 'call'`

この問題を解決する手順は、次のとおりです。

Snowflake JDBC ドライバーでは、中括弧 ​`{`​ および ​`}`​ を使用せずにコール可能なステートメントを設定します。例:

`call doubleMyInt(:myInt)`

## [](#デプロイ時における静的-ip-を使用する-cloudhub-の失敗のトラブルシューティング)デプロイ時における静的 IP を使用する CloudHub の失敗のトラブルシューティング

静的 IP を使用する CloudHub アプリケーションをデプロイすると、データベーステスト接続エラーがスローされ、プロセスが失敗します。これは、静的 IP が割り当てられる前にテストが実行されているために発生します。

次のスタックトレースにテスト接続エラー ​`Could not obtain connection from data source`​ が示されています。

```xml
[2021-03-05 00:26:11.262] INFO    org.mule.runtime.module.extension.internal.runtime.config.LifecycleAwareConfigurationInstance [[MuleRuntime].uber.02: [iagsatellite-snowflake-sys-api-v1-dev].uber@org.mule.runtime.module.extension.internal.runtime.config.LifecycleAwareConfigurationInstance.testConnectivity:179 @10f9d7dc]: Connectivity test failed for config 'Database_Config'. Application deployment will continue. Error was: Could not obtain connection from data source
org.mule.runtime.api.connection.ConnectionException: Could not obtain connection from data source
```

この問題を解決する手順は、次のとおりです。

次のシステムプロパティをデプロイメントに設定します: `-DdoTestConnectivity=false`

## [](#システムプロパティを使用した-oracle-の-xml-拡張機能のトラブルシューティング)システムプロパティを使用した Oracle の XML 拡張機能のトラブルシューティング

Oracle XML 拡張機能を使用するには、Oracle jar ファイルを連動関係として追加する必要があります。これらの jar ファイルの 1 つに ​`xmlparserv2.jar`​ があります。このファイルは、Java SPI (サービスプロバイダーインターフェース) 経由で XML パーサー機能をエクスポートします。Mule の内部でこのパーサーを使用していると、Mule コンポーネントの想定と一致しなくなるため、次のような XML 解析エラーとなる場合があります。

```xml
	<Line 43, Column 57>: XML-24509: (Error) Duplicated definition for: 'identifiedType' <Line 60, Column 28>: XML-24509: (Error) Duplicated definition for: 'beans' <Line 140, Column 34>: XML-24509: (Error) Duplicated definition for: 'description'
```

この問題には、次のいずれかの方法で対処できます。

- `xmlparserv2.jar`​ ファイルを Database Connector の追加のプラグイン連動関係として追加し、連動関係がコネクタ内でのみ表示されるようにします。  
    ただし、データソースを Spring で設定された Bean として提供するために Oracle 接続をモジュール間で共有する必要がある場合には、この方法は使用できません。
- Mule の内部コンポーネントが常に想定する XML パーサーを取得するように、次のシステムプロパティを設定して XML パーサー SPI ルックアップを無効にします。

システムプロパティ:

```xml
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl
```

これらのプロパティにより、Oracle .jar ファイルを共有ライブラリとしてセットアップする場合などには問題を回避できます。

システムプロパティの設定方法についての詳細は、​[システムプロパティ](https://docs.mulesoft.com/mule-runtime/latest/mule-app-properties-system)​のドキュメントを参照してください。

## [](#一般的なスローの理解)一般的なスローの理解

スローされる一般的なメッセージのリストとその解釈方法を次に示します。

- DB:BAD\_SQL\_SYNTAX
    
    指定された SQL クエリの構文が無効です。
- DB:CANNOT\_LOAD\_DRIVER
    
    Database Connector で JDBC ドライバーを読み込むことができません。
- DB:CANNOT\_REACH
    
    Database Connector で RDBMS との接続を確立できません。
- DB:CONNECTIVITY
    
    いくつかの考えられる接続の問題 (不適切な接続の設定、行のフェッチ結果を待機しているときのデータベース応答の欠落、データベース接続の切断など)。
- DB:INVALID\_DATABASE
    
    RDBMS への接続は確立されましたが、データベースが存在していません。
- DB:INVALID\_CREDENTIALS
    
    データベースで指定されたログイン情報が拒否されました。
- DB:QUERY\_EXECUTION
    
    クエリの実行に失敗しました。
- DB:RETRY\_EXHAUSTED
    
    すべての再接続の試行に失敗しました。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=ef1d3f0ca1019b9ce814344f27ce35156edf23846af99adefd58ea00371106ca url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-troubleshooting.md -->

# Database Connector のトラブルシューティング

データベース用 Anypoint Connector (Database Connector) をトラブルシューティングするために、冗長ログの有効化、プーリングプロファイル接続のトラブルシューティング、Snowflake JDBC ドライバーのトラブルシューティング、スローされる一般的なメッセージの解釈に関する情報について説明します。

Database Connector は、JDBC ライブラリ (Java SE JDK 1.8 を使用) に記載されている標準およびガイドラインに従います。

## [](#冗長ログの有効化)冗長ログの有効化

アプリケーションとデータベースのやりとりが失敗する理由の理解を深めるには、Database Connector の冗長ログを一時的に有効にします。  
手動で ​`log4j2.xml`​ ファイルを変更するか、CloudHub API を使用している場合は Anypoint Runtime Manager を使用して、冗長ログを有効にします。  
Mule アプリケーションのパフォーマンスに影響するため、トラブルシューティングが完了したら、必ず拡張された冗長性を無効にしてください。

設定ファイルで冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。
2. アプリケーションのプロジェクト名を開きます。
3. `src/main/resources`​ パスフォルダーを開きます。
4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。
5. `<Loggers>`​ タグ内に ​`<AsyncLogger>`​ タグを追加します。
    
    ```xml
    			<Loggers>
    				...
    				<AsyncLogger name="org.mule.extension.db" level="DEBUG"/>
    				<AsyncLogger name="org.mule.db.commons" level="DEBUG"/>
    				...
    			</Loggers>
    ```
6. アプリケーションの変更を保存します。
7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。

Anypoint Runtime Manager で冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Runtime Manager にアクセスします。
2. \[API configuration (API 設定)\] に移動します。
3. **\[Logging (ログ)\]**​ サブタブで、DEBUG レベルで ​`org.mule.extension.db`​ および ​`org.mule.db.commons`​ パッケージを追加します。
4. 変更を適用します。

## [](#プーリングプロファイル接続によるフローのハングのトラブルシューティング)プーリングプロファイル接続によるフローのハングのトラブルシューティング

フローで必要とされる接続数よりも少ない接続を提供するプーリングプロファイルを使用すると、フロー全体がハングする可能性があります。

この問題を解決する手順は、次のとおりです。

解決策の 1 つとして、プールのサイズを増やすことが挙げられます。この方法が使用できない場合、仮想マシン用 Anypoint Connector (VM Connector) を使用して、VM メッセージの有効期間に一致するように接続の有効期間を短くします。こうすることで、​**Stored procedure**​ 操作へのすべてのコールが実行されて、その結果がコンシュームされ、操作に関連付けられている接続が終了してプールに戻ります。

次の例は、​**Stored procedure**​ 操作と VM Connector でプーリングプロファイルを使用する方法を示しています。この例では、​`foreach`​ 要素が 11 番目の反復に到達しても、プールで接続を提供できるため、​**Stored procedure**​ 操作はハングしません。

```xml
	<db:config name="Database_Config">
		<db:generic-connection url="someUrl" user="someUser" password="somePassword" driverClassName="someDriver">
			<db:pooling-profile maxPoolSize="10">
			</db:pooling-profile>
		</db:generic-connection>
	</db:config>

	<vm:config name="VM_Config">
		<vm:queues >
			<vm:queue queueName="testQueue" />
		</vm:queues>
	</vm:config>

	<flow name="processingFlow">
		<foreach collection="#[1 to 11]">
			<logger level="INFO" message="#['Starting Iteration ' ++ payload as String]" />
			<vm:publish config-ref="VM_Config" queueName="testQueue"/>
			<logger level="INFO" message="#['Finishing Iteration ' ++ payload as String]"/>
		</foreach>
	</flow>

	<flow name="coolFlow">
		<vm:listener config-ref="VM_Config" queueName="testQueue" numberOfConsumers="1"/>
		<db:stored-procedure config-ref="Database_Config">
				<db:sql><![CDATA[{call testProc2()}]]></db:sql>
			</db:stored-procedure>
		<logger level="INFO" message="#[output application/json --- payload.resultSet1]" />
	</flow>
```

## [](#select-操作と-stored-procedure-操作の警告例外について)Select 操作と Stored Procedure 操作の警告例外について

Database Connector の ​**Select**​ および ​**Stored procedure**​ 操作が適切に実行され、結果が返されない場合、Mule Runtime Engine (Mule) では、例外がスローされるのではなく ​`WARN`​ 例外メッセージが返されます。

**Select**​ 操作では、この動作は無効な SQL ステートメントが実行された場合に発生します。​**Store procedure**​ 操作では、プロシージャーを崩す可能性があるエラーが一連のステートメント内にある場合に発生します。実際には、JDBC で一連の ​`ResultSets`​、​`UpdateCounts`​、および ​`Exceptions`​ が返されます。

根本原因がドライバーの動作にあるため、Mule ではフローでキャッチされる例外はスローされません。一部のドライバーは JDBC に厳格に準拠して実行時にスローを適切にスローしますが、そうでないドライバーもあります。このため、例外をスローする動作をコネクタのコードに追加すると、例外を想定していない Mule アプリケーションの後方互換性が失われることになります。

**Select**​ 操作の場合、サブクエリで複数の値が返され、その結果が絞り込みや式として使用される場合、Mule で ​`WARN`​ 例外が記録されます。Mule は、操作が実行されたときではなく、操作の結果がページ分割されるとすぐに警告を返します。

たとえば、次の SQL ステートメントがあるとします。

```xml
		<db:select doc:name="Select" config-ref="Database_Config">
			<db:sql ><![CDATA[
						SELECT *
						FROM SomeTable
						WHERE SomeColumn = (SELECT DISTINCT SomeColumn2 from SomeTable2)
					 ]]>
			</db:sql>
		</db:select>
```

Mule で次の ​`WARN`​ 例外が記録されます。

```xml
	WARN  2021-06-01 10:04:33,323 [[MuleRuntime].io.10: [some-mule-app].some-mule-app.BLOCKING @...] [event: ...] org.mule.extension.db.internal.result.resultset.ResultSetIterator: Unable to determine if there are more records
	com.microsoft.sqlserver.jdbc.SQLServerException: Subquery returned more than 1 value. This is not permitted when the subquery follows =, !=, <, <= , >, >= or when the subquery is used as an expression.
```

**Stored procedure**​ 操作の場合、ストアドプロシージャーに複数のステートメントが含まれ、その 1 つ以上が失敗すると、Mule で ​`WARN`​ 例外が記録されます。Mule は、操作が実行されたときではなく、操作の結果がコンシュームされるとすぐに警告を返します。たとえば、次の SQL ストアドプロシージャーがあるとします。

```xml
CREATE PROCEDURE dbo.SomeProcedure
AS
BEGIN
	BEGIN TRY
	select 1/0;
	END TRY
	BEGIN CATCH
	THROW 50000, 'Divide by zero error encountered.', 255;
	END CATCH
END
```

Mule で次の ​`WARN`​ 例外が記録されます。

```xml
	WARN  2021-06-02 09:38:14,624 [[MuleRuntime].io.10: [some-mule-app].some-mule-app.BLOCKING @...] [event: ...] org.mule.extension.db.internal.result.statement.StatementResultIterator: Unable to determine if there are more statement results
	com.microsoft.sqlserver.jdbc.SQLServerException: 'The record does not exist.'
```

## [](#ストアドプロシージャーの例外をスローする-snowflake-jdbc-ドライバーのトラブルシューティング)ストアドプロシージャーの例外をスローする Snowflake JDBC ドライバーのトラブルシューティング

一部のドライバーには、ストアドプロシージャーをコールするときの独自の仕様があります。中括弧 (​`{`​ および ​`}`​) を使用してコール可能なステートメントを設定している場合 (例: `{call doubleMyInt(:myInt)}`​)、アプリケーションを実行すると Snowflake JDBC ドライバーで次の例外がスローされます。

`net.snowflake.client.jdbc.SnowflakeSQLException: Unsupported feature 'call'`

この問題を解決する手順は、次のとおりです。

Snowflake JDBC ドライバーでは、中括弧 ​`{`​ および ​`}`​ を使用せずにコール可能なステートメントを設定します。例:

`call doubleMyInt(:myInt)`

## [](#デプロイ時における静的-ip-を使用する-cloudhub-の失敗のトラブルシューティング)デプロイ時における静的 IP を使用する CloudHub の失敗のトラブルシューティング

静的 IP を使用する CloudHub アプリケーションをデプロイすると、データベーステスト接続エラーがスローされ、プロセスが失敗します。これは、静的 IP が割り当てられる前にテストが実行されているために発生します。

次のスタックトレースにテスト接続エラー ​`Could not obtain connection from data source`​ が示されています。

```xml
[2021-03-05 00:26:11.262] INFO    org.mule.runtime.module.extension.internal.runtime.config.LifecycleAwareConfigurationInstance [[MuleRuntime].uber.02: [iagsatellite-snowflake-sys-api-v1-dev].uber@org.mule.runtime.module.extension.internal.runtime.config.LifecycleAwareConfigurationInstance.testConnectivity:179 @10f9d7dc]: Connectivity test failed for config 'Database_Config'. Application deployment will continue. Error was: Could not obtain connection from data source
org.mule.runtime.api.connection.ConnectionException: Could not obtain connection from data source
```

この問題を解決する手順は、次のとおりです。

次のシステムプロパティをデプロイメントに設定します: `-DdoTestConnectivity=false`​。

## [](#システムプロパティを使用した-oracle-の-xml-拡張機能のトラブルシューティング)システムプロパティを使用した Oracle の XML 拡張機能のトラブルシューティング

Oracle XML 拡張機能を使用するには、Oracle jar ファイルを連動関係として追加する必要があります。これらの jar ファイルの 1 つに ​`xmlparserv2.jar`​ があります。このファイルは、Java SPI (サービスプロバイダーインターフェース) 経由で XML パーサー機能をエクスポートします。Mule の内部でこのパーサーを使用していると、Mule コンポーネントの想定と一致しなくなるため、次のような XML 解析エラーとなる場合があります。

```xml
	<Line 43, Column 57>: XML-24509: (Error) Duplicated definition for: 'identifiedType' <Line 60, Column 28>: XML-24509: (Error) Duplicated definition for: 'beans' <Line 140, Column 34>: XML-24509: (Error) Duplicated definition for: 'description'
```

この問題には、次のいずれかの方法で対処できます。

- `xmlparserv2.jar`​ ファイルを Database Connector の追加のプラグイン連動関係として追加し、連動関係がコネクタ内でのみ表示されるようにします。  
    ただし、データソースを Spring で設定された Bean として提供するために Oracle 接続をモジュール間で共有する必要がある場合には、この方法は使用できません。
- Mule の内部コンポーネントが常に想定する XML パーサーを取得するように、次のシステムプロパティを設定して XML パーサー SPI ルックアップを無効にします。

システムプロパティ:

```xml
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl
```

これらのプロパティにより、Oracle .jar ファイルを共有ライブラリとしてセットアップする場合などには問題を回避できます。

システムプロパティの設定方法についての詳細は、​[システムプロパティ](https://docs.mulesoft.com/mule-runtime/latest/mule-app-properties-system)​のドキュメントを参照してください。

## [](#oracle-ドライバーの-tcp-キープアライブのトラブルシューティング)Oracle ドライバーの TCP キープアライブのトラブルシューティング

クエリまたはストアドプロシージャーの実行に 15 ～ 30 分以上かかっている場合、ファイアウォールまたはネットワークデバイスが接続を終了している可能性があります。

これを回避するには、次のフラグを JVM パラメーターとして指定して、Oracle プロバイダーの TCP キープアライブを設定します。

\-Doracle.net.keepAlive=true

このフラグにより、接続が確実にアクティブなままになります。

## [](#一般的なスローの理解)一般的なスローの理解

スローされる一般的なメッセージのリストとその解釈方法を次に示します。

- DB:BAD\_SQL\_SYNTAX
    
    指定された SQL クエリの構文が無効です。
- DB:CANNOT\_LOAD\_DRIVER
    
    Database Connector で JDBC ドライバーを読み込むことができません。
- DB:CANNOT\_REACH
    
    Database Connector で RDBMS との接続を確立できません。
- DB:CONNECTIVITY
    
    いくつかの考えられる接続の問題 (不適切な接続の設定、行のフェッチ結果を待機しているときのデータベース応答の欠落、データベース接続の切断など)。
- DB:INVALID\_DATABASE
    
    RDBMS への接続は確立されましたが、データベースが存在していません。
- DB:INVALID\_CREDENTIALS
    
    データベースで指定されたログイン情報が拒否されました。
- DB:QUERY\_EXECUTION
    
    クエリの実行に失敗しました。
- DB:RETRY\_EXHAUSTED
    
    すべての再接続の試行に失敗しました。

## [](#関連情報)関連情報

- [MuleSoft ヘルプセンター](https://help.mulesoft.com)
- [Known Issues](https://help.salesforce.com/s/issues)

<!-- document id=2babf2e3a1ccbea7421a94575d9c2f14993aafc9440c5311c00c3460ed38ff01 url=/mulesoft/current/ja-jp/db-connector/1.9/database-connector-troubleshooting.md -->

# Database Connector のトラブルシューティング

データベース用 Anypoint Connector (Database Connector) をトラブルシューティングするために、冗長ログの有効化、プーリングプロファイル接続のトラブルシューティング、Snowflake JDBC ドライバーのトラブルシューティング、スローされる一般的なメッセージの解釈に関する情報について説明します。

Database Connector は、JDBC ライブラリ (Java SE JDK 1.8 を使用) に記載されている標準およびガイドラインに従います。

## [](#冗長ログの有効化)冗長ログの有効化

アプリケーションとデータベースのやりとりが失敗する理由の理解を深めるには、Database Connector の冗長ログを一時的に有効にします。  
手動で ​`log4j2.xml`​ ファイルを変更するか、CloudHub API を使用している場合は Anypoint Runtime Manager を使用して、冗長ログを有効にします。  
Mule アプリケーションのパフォーマンスに影響するため、トラブルシューティングが完了したら、必ず拡張された冗長性を無効にしてください。

設定ファイルで冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。
2. アプリケーションのプロジェクト名を開きます。
3. `src/main/resources`​ パスフォルダーを開きます。
4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。
5. `<Loggers>`​ タグ内に ​`<AsyncLogger>`​ タグを追加します。
    
    ```xml
    			<Loggers>
    				...
    				<AsyncLogger name="org.mule.extension.db" level="DEBUG"/>
    				...
    			</Loggers>
    ```
6. アプリケーションの変更を保存します。
7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。

Anypoint Runtime Manager で冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Runtime Manager にアクセスします。
2. \[API configuration (API 設定)\] に移動します。
3. **\[Logging (ログ)\]**​ サブタブで、DEBUG レベルで ​`org.mule.extension.db`​ パッケージを追加します。
4. 変更を適用します。

## [](#プーリングプロファイル接続によるフローのハングのトラブルシューティング)プーリングプロファイル接続によるフローのハングのトラブルシューティング

フローで必要とされる接続数よりも少ない接続を提供するプーリングプロファイルを使用すると、フロー全体がハングする可能性があります。

この問題を解決する手順は、次のとおりです。

解決策の 1 つとして、プールのサイズを増やすことが挙げられます。この方法が使用できない場合、仮想マシン用 Anypoint Connector (VM Connector) を使用して、VM メッセージの有効期間に一致するように接続の有効期間を短くします。こうすることで、​**Stored procedure**​ 操作へのすべてのコールが実行されて、その結果がコンシュームされ、操作に関連付けられている接続が終了してプールに戻ります。

次の例は、​**Stored procedure**​ 操作と VM Connector でプーリングプロファイルを使用する方法を示しています。この例では、​`foreach`​ 要素が 11 番目の反復に到達しても、プールで接続を提供できるため、​**Stored procedure**​ 操作はハングしません。

```xml
	<db:config name="Database_Config">
		<db:generic-connection url="someUrl" user="someUser" password="somePassword" driverClassName="someDriver">
			<db:pooling-profile maxPoolSize="10">
			</db:pooling-profile>
		</db:generic-connection>
	</db:config>

	<vm:config name="VM_Config">
		<vm:queues >
			<vm:queue queueName="testQueue" />
		</vm:queues>
	</vm:config>

	<flow name="processingFlow">
		<foreach collection="#[1 to 11]">
			<logger level="INFO" message="#['Starting Iteration ' ++ payload as String]" />
			<vm:publish config-ref="VM_Config" queueName="testQueue"/>
			<logger level="INFO" message="#['Finishing Iteration ' ++ payload as String]"/>
		</foreach>
	</flow>

	<flow name="coolFlow">
		<vm:listener config-ref="VM_Config" queueName="testQueue" numberOfConsumers="1"/>
		<db:stored-procedure config-ref="Database_Config">
				<db:sql><![CDATA[{call testProc2()}]]></db:sql>
			</db:stored-procedure>
		<logger level="INFO" message="#[output application/json --- payload.resultSet1]" />
	</flow>
```

## [](#ストアドプロシージャーの例外をスローする-snowflake-jdbc-ドライバーのトラブルシューティング)ストアドプロシージャーの例外をスローする Snowflake JDBC ドライバーのトラブルシューティング

一部のドライバーには、ストアドプロシージャーをコールするときの独自の仕様があります。中括弧 (​`{`​ および ​`}`​) を使用してコール可能なステートメントを設定している場合 (例: `{call doubleMyInt(:myInt)}`​)、アプリケーションを実行すると Snowflake JDBC ドライバーで次の例外がスローされます。

`net.snowflake.client.jdbc.SnowflakeSQLException: Unsupported feature 'call'`

この問題を解決する手順は、次のとおりです。

Snowflake JDBC ドライバーでは、中括弧 ​`{`​ および ​`}`​ を使用せずにコール可能なステートメントを設定します。例:

`call doubleMyInt(:myInt)`

## [](#一般的なスローの理解)一般的なスローの理解

スローされる一般的なメッセージのリストとその解釈方法を次に示します。

- DB:BAD\_SQL\_SYNTAX
    
    指定された SQL クエリの構文が無効です。
- DB:CANNOT\_LOAD\_DRIVER
    
    Database Connector で JDBC ドライバーを読み込むことができません。
- DB:CANNOT\_REACH
    
    Database Connector で RDBMS との接続を確立できません。
- DB:CONNECTIVITY
    
    いくつかの考えられる接続の問題 (不適切な接続の設定、行のフェッチ結果を待機しているときのデータベース応答の欠落、データベース接続の切断など)。
- DB:INVALID\_DATABASE
    
    RDBMS への接続は確立されましたが、データベースが存在していません。
- DB:INVALID\_CREDENTIALS
    
    データベースで指定されたログイン情報が拒否されました。
- DB:QUERY\_EXECUTION
    
    クエリの実行に失敗しました。
- DB:RETRY\_EXHAUSTED
    
    すべての再接続の試行に失敗しました。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=8350a93a4811e91361fdc97d12a5bd05f278989eb5d4ce36fb10745415473b80 url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-examples.md -->

# Database Connector の例

データベース用 Anypoint Connector (Database Connector) の例は、データベース接続の設定、データベースの照会、ストアドプロシージャーの実行、DDL ステートメントの実行、スクリプトの実行、データベーストランザクションの実行、一括操作の使用、カスタムデータ型の設定に役立ちます。

- [データベース接続の設定](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-connection)
    
    一般的なデータベースと汎用データベースの両方に接続します。また、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行うようにコネクタを設定します。
- [Mule Maven プラグインを使用したドライバー表示の設定](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-driver-configuration)
    
    Mule Maven プラグインを使用して、ドライバークラスの表示を適切に設定します。
- [データベースのクエリ](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-select)
    
    データベースからデータを照会する ​**Select**​ 操作を設定します。
- [データベースからの単一レコードのクエリ](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-query-single)
    
    MySQL データベースのテーブルから本の情報を取得する ​**Query single**​ 操作を Mule アプリケーション内で設定します。
- [データの挿入、更新、削除](https://docs.mulesoft.com/jp/db-connector/1.10/database-insert-update-delete)
    
    データを管理するように ​**Insert**​、​**Update**​、​**Delete**​ 操作を設定します。
- [ストアドプロシージャーの実行](https://docs.mulesoft.com/jp/db-connector/1.10/database-stored-procedure)
    
    `input`​、​`output`​、および ​`input-output`​ パラメーターを組み合わせる ​**Stored Procedure**​ 操作を設定します。また、ストアドプロシージャーの日付を設定します。
- [UDT を使用する Oracle ストアドプロシージャーのコール](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-udt-stored-procedure)
    
    UDT を入力および出力パラメーターとして使用する Oracle データベースストアドプロシージャーをコールする ​**Stored procedure**​ 操作を設定します。また、​`createStruct`​ および ​`createArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップします。
- [DDL ステートメントの実行](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-execute-ddl)
    
    テーブルや他のデータ構造内のデータを作成または変更する DDL ステートメントを実行する ​**Execute DDL**​ 操作を設定します。
- [一括操作の実行](#execute-bulk-operations)​  
    各入力パラメーターが 1 つの値のみを取る場合に使用する ​**Bulk insert**​、​**Bulk update**​、​**Bulk delete**​ 操作を設定します。
- [スクリプトの実行](https://docs.mulesoft.com/jp/db-connector/1.10/database-execute-script)
    
    スクリプトを 1 つのステートメントとして実行する ​**Execute Script**​ 操作を設定します。
- [データベースのデータ型の設定](https://docs.mulesoft.com/jp/db-connector/1.10/database-configure-data-types)
    
    特定の接続プロバイダーに接続している場合に使用するカスタムデータ型を設定します。
- [データベーストランザクションの設定](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-transactions)
    
    データベース操作をトランザクションのコンテキストで実行します。

## [](#execute-bulk-operations)一括操作の実行

`insert`​、​`update`​、​`delete`​ 操作は、各入力パラメーターが 1 つの値のみを取る場合に使用できます。または、一括操作では、一連のパラメーター値を使用して 1 つのクエリを実行できます。

一括操作を実行すれば、不要なステップを回避して次の利点を得ることができます。

- クエリは 1 回のみ解析される。
- 実行されるステートメントは 1 つのみのため、必要なデータベース接続は 1 つのみである。
- ネットワークオーバーヘッドが最小限に抑えられる。
- RDBMS は一括操作をアトミックに実行できる。

このユースケースでは、コネクタは ​`<db:bulk-insert>`​、​`<db:bulk-update>`​、​`<db:bulk-delete>`​ の 3 つの操作を提供します。

これらの操作は、対応する単一操作と似ていますが、入力パラメーターをキー - 値のペアで受け取るのではなく、キー - 値のペアのリストとして受け取ることを想定しています。

次に例を示します。

```xml
<db:bulk-insert config-ref="dbConfig" >
  <db:bulk-input-parameters>
    #[[{'id': 2, 'name': 'George', 'lastName': 'Costanza'}, {'id': 3, 'name': 'Cosmo', 'lastName': 'Kramer'}]]
  </db:bulk-input-parameters>
  <db:sql>
    insert into customers (id, name, lastName) values (:id, :name, :lastName)
  </db:sql>
</db:bulk-insert>
```

一括操作を使用しない場合、​`delete`​ 操作の実行時に 1 つの条件 ​`(POSITION = X)`​ のみが提供されると、複数の行が条件に一致して削除される可能性があります。 同じ概念が更新にも適用されます。​`UPDATE PRODUCTS set PRICE = PRICE * 0.9 where PRICE > :price`​ を使用するときに、複数の商品に 10% 割引を適用したい場合でも、​`price`​ 入力パラメーターは 1 つの値のみを受け入れます。

価格の異なる商品に異なる割引率を適用するには、多くの操作を実行します。

次の例は、構造 ​`{ price : number, discountRate: number}`​ のオブジェクトのリストであるペイロードです。

```xml
<foreach>
  <db:update config-ref="dbConfig">
    <db:input-parameters>
     #[
      {
        'discountRate' : payload.discountRate,
        'price' : payload.price,
      }
    ]
    </db:input-parameters>
    <db:sql>
      UPDATE PRODUCTS set PRICE = PRICE * :discountRate where PRICE > :price
    </db:sql>
  </db:update>
</foreach>
```

前の操作ではタスクを遂行できますが、非効率的です。リストの要素ごとに、操作の各要素で 1 つのクエリを実行する必要があります。

- クエリが解析される。
- パラメーターが解決される。
- データベースへの接続が取得される (プールから接続を取得するか、新しい接続を確立する)。
- すべてのネットワークオーバーヘッドが支払われる。
- RBMS でクエリを処理し、変更を適用する。
- 接続が解放される。

いずれかの操作の実行中にエラーが発生した場合 (たとえば、100 行の一括挿入のうち 1 行の挿入に失敗した場合)、1 つの例外がスローされます。

一括操作の一部のステートメントは正常に実行できても、他のステートメントはエラーになる可能性があります。この場合、ドライバーが次のいずれかを実行します。

1. 実行をすぐに停止し、残りのすべての操作を無視する
2. 残りのステートメントの実行を続行する。

どちらの場合も、エラーが発生するたびにアプリケーションログを調べて、失敗の原因を確認できます。この場合、問題の原因を説明する 1 つの例外がスローされます。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=63e64bfb776c5a36e65c0992811abcabeaa68fa9ae64e0bf990190673b438b40 url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-examples.md -->

# Database Connector の例

データベース用 Anypoint Connector (Database Connector) の例は、データベース接続の設定、データベースの照会、ストアドプロシージャーの実行、DDL ステートメントの実行、スクリプトの実行、データベーストランザクションの実行、一括操作の使用、カスタムデータ型の設定に役立ちます。

- [データベース接続の設定](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-connection)
    
    一般的なデータベースと汎用データベースの両方に接続します。また、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行うようにコネクタを設定します。
- [Oracle TLS データベース接続の設定](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-connection-secure-oracle)
    
    複数のセキュア Oracle 接続レベルと Mule の TLS 設定を使用して、セキュア TPC (TCPS) トンネル経由で Oracle に接続します。
- [Mule Maven プラグインを使用したドライバー表示の設定](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-driver-configuration)
    
    Mule Maven プラグインを使用して、ドライバークラスの表示を適切に設定します。
- [データベースのクエリ](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-select)
    
    データベースからデータを照会する ​**Select**​ 操作を設定します。
- [データベースからの単一レコードのクエリ](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-query-single)
    
    MySQL データベースのテーブルから本の情報を取得する ​**Query single**​ 操作を Mule アプリケーション内で設定します。
- [データの挿入、更新、削除](https://docs.mulesoft.com/jp/db-connector/1.12/database-insert-update-delete)
    
    データを管理するように ​**Insert**​、​**Update**​、​**Delete**​ 操作を設定します。
- [データベースのデータの一括挿入、一括更新、および一括削除](https://docs.mulesoft.com/jp/db-connector/1.12/database-execute-bulk)
    
    データを一括管理するように ​**Bulk insert**​、​**Bulk update**​、​**Bulk delete**​ 操作を設定します。
- [ストアドプロシージャーの実行](https://docs.mulesoft.com/jp/db-connector/1.12/database-stored-procedure)
    
    `input`​、​`output`​、および ​`input-output`​ パラメーターを組み合わせる ​**Stored Procedure**​ 操作を設定します。また、ストアドプロシージャーの日付を設定します。
- [UDT を使用する Oracle ストアドプロシージャーのコール](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-udt-stored-procedure)
    
    UDT を入力および出力パラメーターとして使用する Oracle データベースストアドプロシージャーをコールする ​**Stored procedure**​ 操作を設定します。また、​`createStruct`​ および ​`createArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップします。
- [DDL ステートメントの実行](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-execute-ddl)
    
    テーブルや他のデータ構造内のデータを作成または変更する DDL ステートメントを実行する ​**Execute DDL**​ 操作を設定します。
- [スクリプトの実行](https://docs.mulesoft.com/jp/db-connector/1.12/database-execute-script)
    
    スクリプトを 1 つのステートメントとして実行する ​**Execute Script**​ 操作を設定します。
- [データベースのデータ型の設定](https://docs.mulesoft.com/jp/db-connector/1.12/database-configure-data-types)
    
    特定の接続プロバイダーに接続している場合に使用するカスタムデータ型を設定します。
- [データベーストランザクションの設定](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-transactions)
    
    データベース操作をトランザクションのコンテキストで実行します。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=c15b596d15c7e7def6763ce3905cf995a47c6c1d4bade7def713f3ba584d7246 url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-examples.md -->

# Database Connector の例

データベース用 Anypoint Connector (Database Connector) の例は、データベース接続の設定、データベースの照会、ストアドプロシージャーの実行、DDL ステートメントの実行、スクリプトの実行、データベーストランザクションの実行、一括操作の使用、カスタムデータ型の設定に役立ちます。

- [データベース接続の設定](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-connection)
    
    一般的なデータベースと汎用データベースの両方に接続します。また、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行うようにコネクタを設定します。
- [Oracle TLS データベース接続の設定](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-connection-secure-oracle)
    
    複数のセキュア Oracle 接続レベルと Mule の TLS 設定を使用して、セキュア TPC (TCPS) トンネル経由で Oracle に接続します。
- [Mule Maven プラグインを使用したドライバー表示の設定](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-driver-configuration)
    
    Mule Maven プラグインを使用して、ドライバークラスの表示を適切に設定します。
- [データベースのクエリ](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-select)
    
    データベースからデータを照会する ​**Select**​ 操作を設定します。
- [データベースからの単一レコードのクエリ](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-query-single)
    
    MySQL データベースのテーブルから本の情報を取得する ​**Query single**​ 操作を Mule アプリケーション内で設定します。
- [データの挿入、更新、削除](https://docs.mulesoft.com/jp/db-connector/1.13/database-insert-update-delete)
    
    データを管理するように ​**Insert**​、​**Update**​、​**Delete**​ 操作を設定します。
- [データベースのデータの一括挿入、一括更新、および一括削除](https://docs.mulesoft.com/jp/db-connector/1.13/database-execute-bulk)
    
    データを一括管理するように ​**Bulk insert**​、​**Bulk update**​、​**Bulk delete**​ 操作を設定します。
- [ストアドプロシージャーの実行](https://docs.mulesoft.com/jp/db-connector/1.13/database-stored-procedure)
    
    `input`​、​`output`​、および ​`input-output`​ パラメーターを組み合わせる ​**Stored Procedure**​ 操作を設定します。また、ストアドプロシージャーの日付を設定します。
- [UDT を使用する Oracle ストアドプロシージャーのコール](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-udt-stored-procedure)
    
    UDT を入力および出力パラメーターとして使用する Oracle データベースストアドプロシージャーをコールする ​**Stored procedure**​ 操作を設定します。また、​`prepareStruct`​ および ​`prepareArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップします。
- [DDL ステートメントの実行](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-execute-ddl)
    
    テーブルや他のデータ構造内のデータを作成または変更する DDL ステートメントを実行する ​**Execute DDL**​ 操作を設定します。
- [スクリプトの実行](https://docs.mulesoft.com/jp/db-connector/1.13/database-execute-script)
    
    スクリプトを 1 つのステートメントとして実行する ​**Execute Script**​ 操作を設定します。
- [データベースのデータ型の設定](https://docs.mulesoft.com/jp/db-connector/1.13/database-configure-data-types)
    
    特定の接続プロバイダーに接続している場合に使用するカスタムデータ型を設定します。
- [データベーストランザクションの設定](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-transactions)
    
    データベース操作をトランザクションのコンテキストで実行します。
- [テーブルへの大きなファイルコンテンツの挿入](https://docs.mulesoft.com/jp/db-connector/1.13/database-insert-large-clob)
    
    大きなファイルを読み取ってテーブルに挿入するように Mule アプリケーションフローを設定します。
- [Database Connector での XA トランザクションの使用](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-xa-transactions)
    
    データソースで拡張アーキテクチャトランザクション (XA トランザクション) がサポートされるように Database Connector のグローバル設定で ​**\[Use XA Transactions (XA トランザクションを使用)\]**​ 項目を設定します。
- [Database Connector SQL サーバー接続での \[Use Bulk Copy (一括コピーを使用)](https://docs.mulesoft.com/jp/db-connector/1.13/database-configure-usebulkcopy) の設定\]
    
    一括挿入操作の実行時に一括コピー操作を行うには、\[Use Bulk Copy (一括コピーを使用)\] を設定します。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=a7d196b294bbef1a37e9915a239663796bdf234a8a94cd786f6bdf6b4c1ad564 url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-examples.md -->

# Database Connector の例

データベース用 Anypoint Connector (Database Connector) の例は、データベース接続の設定、データベースの照会、ストアドプロシージャーの実行、DDL ステートメントの実行、スクリプトの実行、データベーストランザクションの実行、一括操作の使用、カスタムデータ型の設定に役立ちます。

- [データベース接続の設定](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-connection)
    
    一般的なデータベースと汎用データベースの両方に接続します。また、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行うようにコネクタを設定します。
- [Oracle TLS データベース接続の設定](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-connection-secure-oracle)
    
    複数のセキュア Oracle 接続レベルと Mule の TLS 設定を使用して、セキュア TPC (TCPS) トンネル経由で Oracle に接続します。
- [Mule Maven プラグインを使用したドライバー表示の設定](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-driver-configuration)
    
    Mule Maven プラグインを使用して、ドライバークラスの表示を適切に設定します。
- [データベースのクエリ](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-select)
    
    データベースからデータを照会する ​**Select**​ 操作を設定します。
- [データベースからの単一レコードのクエリ](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-query-single)
    
    MySQL データベースのテーブルから本の情報を取得する ​**Query single**​ 操作を Mule アプリケーション内で設定します。
- [データの挿入、更新、削除](https://docs.mulesoft.com/jp/db-connector/1.14/database-insert-update-delete)
    
    データを管理するように ​**Insert**​、​**Update**​、​**Delete**​ 操作を設定します。
- [データベースのデータの一括挿入、一括更新、および一括削除](https://docs.mulesoft.com/jp/db-connector/1.14/database-execute-bulk)
    
    データを一括管理するように ​**Bulk insert**​、​**Bulk update**​、​**Bulk delete**​ 操作を設定します。
- [ストアドプロシージャーの実行](https://docs.mulesoft.com/jp/db-connector/1.14/database-stored-procedure)
    
    `input`​、​`output`​、および ​`input-output`​ パラメーターを組み合わせる ​**Stored Procedure**​ 操作を設定します。また、ストアドプロシージャーの日付を設定します。
- [UDT を使用する Oracle ストアドプロシージャーのコール](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-udt-stored-procedure)
    
    UDT を入力および出力パラメーターとして使用する Oracle データベースストアドプロシージャーをコールする ​**Stored procedure**​ 操作を設定します。また、​`prepareStruct`​ および ​`prepareArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップします。
- [DDL ステートメントの実行](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-execute-ddl)
    
    テーブルや他のデータ構造内のデータを作成または変更する DDL ステートメントを実行する ​**Execute DDL**​ 操作を設定します。
- [スクリプトの実行](https://docs.mulesoft.com/jp/db-connector/1.14/database-execute-script)
    
    スクリプトを 1 つのステートメントとして実行する ​**Execute Script**​ 操作を設定します。
- [データベースのデータ型の設定](https://docs.mulesoft.com/jp/db-connector/1.14/database-configure-data-types)
    
    特定の接続プロバイダーに接続している場合に使用するカスタムデータ型を設定します。
- [データベーストランザクションの設定](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-transactions)
    
    データベース操作をトランザクションのコンテキストで実行します。
- [テーブルへの大きなファイルコンテンツの挿入](https://docs.mulesoft.com/jp/db-connector/1.14/database-insert-large-clob)
    
    大きなファイルを読み取ってテーブルに挿入するように Mule アプリケーションフローを設定します。
- [Database Connector での XA トランザクションの使用](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-xa-transactions)
    
    データソースで拡張アーキテクチャトランザクション (XA トランザクション) がサポートされるように Database Connector のグローバル設定で ​**\[Use XA Transactions (XA トランザクションを使用)\]**​ 項目を設定します。
- [Database Connector SQL サーバー接続での \[Use Bulk Copy (一括コピーを使用)](https://docs.mulesoft.com/jp/db-connector/1.14/database-configure-usebulkcopy) の設定\]
    
    一括挿入操作の実行時に一括コピー操作を行うには、\[Use Bulk Copy (一括コピーを使用)\] を設定します。
- [MS SQL Server の Azure Active Directory 認証の設定](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-integratedsecurity)
    
    Database Connector を使用して ​`IntegratedSecurity`​ パラメーターを介して MS SQL Server の Azure Active Directory 認証を設定します。
- [ストアドプロシージャーの入力および出力パラメーターの設定](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-input-output-parameters)
    
    データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作の入力または出力パラメーターを設定して、ストアドプロシージャーで使用するパラメーターを指定します。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=987e0c3519e1cdacae86570f3218fdf530cbe9372d8402b6411e64fc38f98fe0 url=/mulesoft/current/ja-jp/db-connector/1.8/database-connector-examples.md -->

# Database Connector の例

Database 用 Anypoint Connector (Database Connector) の例は、データベース接続の設定、データベースの照会、ストアドプロシージャーの実行、DDL ステートメントの実行、スクリプトの実行、データベーストランザクションの実行、一括操作の使用、カスタムデータ型の定義に役立ちます。

- [データベース接続の設定](https://docs.mulesoft.com/jp/db-connector/1.8/database-connector-connection)
    
    一般的なデータベースと汎用データベースの両方に接続します。また、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行うようにコネクタを設定します。
- [データベースの照会](#query-database)​  
    データベースからデータを照会する ​**Select**​ 操作を設定します。
- [データの挿入、更新、削除](#insert-update-delete)​  
    データを管理するように ​**Insert**​、​**Update**​、​**Delete**​ 操作を設定します。
- [ストアドプロシージャーの実行](#execute-stored-procedures)​  
    `input`​、​`output`​、および ​`input-output`​ パラメーターを組み合わせる ​**Stored Procedure**​ 操作を設定します。また、ストアドプロシージャーの日付を設定します。
- [UDT を使用する Oracle ストアドプロシージャーのコール](https://docs.mulesoft.com/jp/db-connector/1.8/database-connector-udt-stored-procedure)
    
    UDT を入力および出力パラメーターとして使用する Oracle データベースストアドプロシージャーをコールする ​**Stored procedure**​ 操作を設定します。また、​`createStruct`​ および ​`createArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップします。
- [DDL ステートメントの実行](#execute-ddl-statements)​  
    テーブルや他のデータ構造内のデータを作成または変更する DDL ステートメントを実行する ​**Execute DDL**​ 操作を設定します。
- [一括操作の実行](#execute-bulk-operations)​  
    各入力パラメーターが 1 つの値のみを取る場合に使用する ​**Bulk insert**​、​**Bulk update**​、​**Bulk delete**​ 操作を設定します。
- [Execute Script](#execute-script)​  
    スクリプトを 1 つのステートメントとして実行する ​**Execute script**​ 操作を設定します。
- [カスタムデータ型の定義](#data-types)​  
    特定の接続プロバイダーに接続している場合に使用するカスタムデータ型を定義します。
- [データベーストランザクションの実行](#database-transactions)​  
    データベース操作をトランザクションのコンテキストで実行します。

## [](#query-database)データベースのクエリ

Database Connector を使用してデータベース操作を設定する場合、データベース内で実行する SQL ステートメントに変数値を追加する方法がいくつかあります。

### [](#入力パラメーターを使用したデータベースクエリの保護)入力パラメーターを使用したデータベースクエリの保護

RDBMS から情報を取得するには ​`select`​ 操作を使用します。その操作の主な目標は、SQL クエリを提供し、DataWeave を使用してパラメーターを提供することです。

```xml
<flow name="selectParameterizedQuery">
  <db:select config-ref="dbConfig">
    <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
    <db:input-parameters>
      #[{'name' : payload}]
    </db:input-parameters>
  </db:select>
</flow>
```

この例では、入力パラメーターをキー-値ペアで提供します。このペアは、DataWeave スクリプトを埋め込むことで作成します。このキーをコロン文字 (​`:`​) と組み合わせて、名前によりパラメーター値を参照します。クエリでパラメーターを使用するには、この方法をお勧めします。

入力パラメーターを使用して ​`SELECT`​ ステートメントの ​`WHERE`​ 句を設定する利点は、クエリが SQL インジェクション攻撃の影響を受けなくなり、他の方法では不可能な最適化を実行でき、アプリケーションの全体的なパフォーマンスが向上することです。

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p><strong>バージョン 1.4.0 以降 (コロンのエスケープ):</strong>​ SQL クエリでコロン文字 (​<code>:</code>​) を使用する必要がある場合、コロン文字の前にバックスラッシュを置くことでコロン文字をエスケープできます。これは、PostgreSQL 種別のキャストを使用する場合に役立ちます。この場合、キャスト先の種別の前に 2 つのコロンが必要です。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT price\:\:float8 FROM PRODUCT&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p><strong>バージョン 1.8.0 以降 (PostgreSQL および Snowflake の SQL キャスト)</strong>​:Database Connector は、各コロンをエスケープする必要なく、ダブルコロン (::) 表現を使用して SQL キャスト PostgreSQL および Snowflake 構文を受け入れるようになりました (この機能はコロンのエスケープの動作に影響しません)。次に例を示します。</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT MAX(modified_date)::DATE FROM sales&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

セキュリティ上の理由により、​`<db:sql>SELECT * FROM PLANET WHERE name = #[payload] </db:sql>`​ は直接記述しないでください。

操作の入力と出力には DataSense を使用できます。コネクタはクエリを分析し、SQL ステートメントの射影セクションを分析することで、クエリの出力構造を自動的に計算します。同時に、​`WHERE`​ 句の条件をテーブル構造と比較して、DataSense 入力も生成します。これは、入力パラメーターを生成する DataWeave スクリプトをビルドするのに役立ちます。

### [](#動的クエリ)動的クエリ

場合によっては、​`WHERE`​ 句をパラメーター化するだけでなく、クエリ自体の一部をパラメーター化しなければならないことがあります。次のユースケースの例は、条件に応じてオンラインテーブルか履歴テーブルにアクセスする必要があるクエリ、またはプロジェクトテーブル列を変更する必要がある複雑なクエリです。

次の例では、テーブルが変数に依存することを記述する文字列 ​`$(vars.table)`​ をビルドしてクエリを生成するための完全な式を確認できます。重要なことは、一部のクエリテキストは動的 (​`"SELECT * FROM $(vars.table)`​) ですが、​`WHERE`​ 句では、入力パラメーターを使用して ​`WHERE`​ 条件を定義するベストプラクティスが引き続き使用されていることです (この例では ​`WHERE name = :name`​)。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

上記の例では動的クエリが必要であり、入力パラメーターのようには処理できません。入力パラメーターは、​`WHERE`​ 句のパラメーターにのみ適用できます。クエリの別の部分を変更するには、DataWeave の補間演算子を使用する必要があります。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">Mule 3 では、選択の概念がパラメーター化クエリと動的クエリに分割されており、この両方を同時に使用することができませんでした。動的クエリを使用するか、パラメーターの使用から利点を得るか (SQL インジェクションの保護、PreparedStatement の最適化など) のどちらかを選択する必要がありました。また、それぞれ構文が異なるため、同じことを行うのに 2 つのやり方を学ぶ必要がありました。ただし、Mule 4 の Database Connector があれば、クエリ内で式を使用してこの両方の方法を同時に使用できるようになりました。</td></tr></tbody></table>

### [](#大量の結果のストリーミング)大量の結果のストリーミング

インテグレーションのユースケースなど、多くのレコードを返すクエリでストリーミングを使用します。Mule 4 では、ストリーミングは透過的であり、常に有効になっています。

たとえば、10K 行を返すクエリを送信した場合、それらすべての行を一度にフェッチしようとすると、ネットワークから大量の取り込みを行うため、パフォーマンスが低下し、すべての情報を RAM に読み込む必要があるため、メモリ不足になるリスクがあります。

ストリーミングでは、コネクタは一度にクエリの一部のみをフェッチおよび処理するため、ネットワークとメモリの負荷が軽減されます。 これは、コネクタが 10K 行を一度にフェッチしないことを意味します。代わりに、コネクタは小さなチャンクをフェッチし、そのチャンクがコンシュームされたら残りをフェッチします。

新しい反復可能なストリームメカニズムを使用することもできます。これにより、DataWeave や他のコンポーネントで同じストリームを何度も処理できます。また、並列処理も可能です。反復可能なストリームについての詳細は、Mule 4.0 でのストリーミングを参照してください。

### [](#結果の制限)結果の制限

Mule を使用すると、コネクタでストリーミングを適切に処理できます。ただし、これは、データの大きなチャンクをデータベースから Mule に移動することをお勧めするものではありません。ストリーミングを使用しても、通常の SQL クエリで、各行に大量の情報を含む多くの行が返される可能性はあります。

`select`​ 操作では、これに役立つパラメーター (​`fetchSize`​ および ​`maxRows`​) が提供されます。

```xml
<db:select fetchSize="200" maxRows="1000" config-ref="dbConfig">
  <db:sql>select * from some_table</db:sql>
</db:select>
```

この構文は、フェッチできる合計行数は 1000 (​`maxRows`​ 値) 以下、一度にフェッチできる行数は 200 (​`fetchSize`​ 値) 以下であることをコネクタに指示します。これにより、ネットワークとメモリの負荷が大幅に軽減されます。​`fetchSize`​ 値は JDBC ドライバープロバイダーごとに異なって適用され、多くの場合、デフォルトで ​`10`​ に設定されます。

この組み合わせにより、取得される情報の総量が制限され (​`maxRows`​ 値)、ネットワーク経由でデータベースから小さいチャンクのデータが返されることが保証されます (​`fetchSize`​ 値)。

### [](#query-timeout-クエリタイムアウト)Query Timeout (クエリタイムアウト)

データベースクエリの実行に長い時間がかかる場合があります。多くの場合、次の要因によりクエリの実行が遅延します。

- 非効率なクエリ (多くの行を反復処理する不適切なインデックスを持つクエリなど)
- 混雑している RDBMS またはネットワーク
- ロック競合

一般に、クエリにタイムアウトを設定することをお勧めします。タイムアウトを管理するには、​`queryTimeout`​ と ​`queryTimeoutUnit`​ を設定します。次の例は、Select 操作のタイムアウトの設定方法を示していますが、タイムアウトの設定はすべての操作でサポートされます。

```xml
<db:select queryTimeout="0" queryTimeoutUnit="SECONDS" config-ref="dbConfig">
   <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#insert-update-delete)データの挿入、更新、削除

Database Connector では、​`insert`​、​`update`​、および ​`delete`​ 操作がサポートされています。 select 操作と同様に、これらの操作では、埋め込みの DataWeave 変換を使用して、動的クエリとパラメーター化がサポートされます。また、​`fetchSize`​、​`maxRows`​、​`timeout`​ パラメーターもサポートされます。入力パラメーター化、動的クエリ、およびパラメーターの使用方法の例が提供されますが、詳細は、​`SELECT`​ 操作のドキュメントを参照してください。

### [](#insert)Insert

`electronic`​ という名前のテーブルが含まれている ​`Products`​ という名前のデータベーススキーマがあるとします。​`electronic`​ テーブルには、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という列が含まれます。

次の SQL ステートメントでは、このテーブルを作成します。

```sql
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
)
```

テーブルがすでに作成されていて、​`dbConfig`​ という名前の接続設定がある場合、次の操作で ​`electronic`​ テーブルに新しいレコードが挿入されます。

```xml
<db:insert config-ref="dbConfig">
  <db:sql>
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
  </db:sql>
</db:insert>
```

`id`​ パラメーターは、データベースによって自動的に生成される自動増分キーであるため、クエリに渡されません。

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>入力パラメーターの利点を得るには、次のように同等のクエリを構築します。</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">&lt;db:insert config-ref="dbConfig"&gt;
    &lt;db:sql&gt;
        INSERT INTO electronic(name, description, price, discount)
        VALUES (:name, :description, :price, :discount)
    &lt;/db:sql&gt;
    &lt;db:input-parameters&gt;#[{
        name: 'Coffee Machine',
        description: 'Model:XYZ99. Uses small size capsules.',
        price: 120,
        discount: 5}]
    &lt;/db:input-parameters&gt;
&lt;/db:insert&gt;</code></pre>
</div>
</div>
</td>
</tr>
</tbody></table>

insert 操作は、2 つの項目 (クエリの影響を受けた行数を示す整数 ​`affectedRows`​ と、自動生成されたキーが含まれるマップ ​`generatedKeys`​) が含まれる ​`Statement Result`​ オブジェクトを出力します。この例では、出力は次のようになります。

```json
{
  "affectedRows": 1,
  "generatedKeys": {

  }
}
```

行は正常にテーブルに追加されていますが、マップ ​`generatedKeys`​ は空です。 マップが空になるのは、オーバーヘッドを回避するためにこの情報がデフォルトで無効になっているためです。 情報をアクティブ化してキーを生成するには、​`autoGenerateKeys`​ パラメーターを追加して ​`true`​ に設定します。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true">
   <db:sql>
       INSERT INTO electronic(name, description, price, discount)
       VALUES (:name, :description, :price, :discount)
   </db:sql>
   <db:input-parameters>#[{
       name: 'Coffee Machine',
       description: 'Model:XYZ99. Uses small size capsules.',
       price: 120,
       discount: 5}]
   </db:input-parameters>
</db:insert>
```

ステートメントで影響を受けた行ごとに複数のキーが生成される場合、パラメーター ​`autoGeneratedKeysColumnNames`​ を目的の列名が含まれるリストに設定して、返される列を指定できます。たとえば、​`id`​ 列のみが返されるようにするには、パラメーターを 1 つの文字列要素が含まれる DataWeave リストに設定します。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true" autoGeneratedKeysColumnNames="#[['id']]">
    ...
</db:insert>
```

### [](#update-更新)Update (更新)

「挿入の例」で定義したテーブルの場合、価格値が 100 を越えているすべての項目の割引を 10 % に設定するように ​`electronic`​ を更新する操作は次のようになります。

<db:update config-ref="dbConfig">
    <db:sql><!\[CDATA\[#\["UPDATE electronic SET discount = :discount WHERE price > :price"\]\]\]></db:sql>
	<db:input-parameters>#\[{
        discount: 10,
        price: 100
    }\]</db:input-parameters>
</db:update>

`<![CDATA[…​]]>`​ ラッパーにより、クエリで ​`>`​ や ​`"`​ などの特殊文字を使用できます。 ラッパーがない場合、これらの文字の XML でエスケープされたバージョン (​`&gt;`​ や ​`&quot;`​ など) を使用する必要があります。

XML コードビューの代わりにコネクタの Anypoint Studio ビジュアルユーザーインターフェースを使用する場合、\[​`SQL Query Text`​ (SQL クエリテキスト)\] ボックスに特殊文字を直接入力できます。入力された文字は、Anypoint Studio によって自動的に XML ビューのエスケープされたバージョンに変更されます。

### [](#delete-削除)Delete (削除)

`insert`​ の例で定義されたテーブルの場合、次の演算子は ​`id: 1`​ のレコードをテーブルから削除します。

```xml
<db:delete config-ref="dbConfig">
    <db:sql>DELETE FROM electronic WHERE id = :id</db:sql>
    <db:input-parameters>#[{
        id: 1
    }]</db:input-parameters>
</db:delete>
```

## [](#execute-stored-procedures)ストアドプロシージャーの実行

`input`​、​`output`​、および ​`input-output`​ パラメーターを組み合わせたストアドプロシージャーを呼び出します。

次に例を示します。

```xml
<!-- Invoke a procedure with input parameters -->
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call updatePlanetDescription('Venus', :description) }</db:sql>
    <db:input-parameters>
        #[{'description' : payload}]
    </db:input-parameters>
</db:stored-procedure>

<!-- Invoke a procedure with input-output parameters -->
<db:stored-procedure config-ref="dbConfig">
  <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
  <db:in-out-parameters>
      <db:in-out-parameter key="myInt" value="3"/>
  </db:in-out-parameters>
</db:stored-procedure>

<!-- Invoke a procedure with both input AND output parameters -->
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }</db:sql>
    <db:input-parameters>
        #[{
            'int1' : 3,
            'int2' : 4,
            'int3' : 5
        }]
    </db:input-parameters>
    <db:output-parameters>
        <db:output-parameter key="result1" type="INTEGER"/>
        <db:output-parameter key="result2" type="INTEGER"/>
        <db:output-parameter key="myInt" type="INTEGER"/>
    </db:output-parameters>
</db:stored-procedure>
```

多くの組み合わせが可能です。

実行後、​`output`​ と ​`input-output`​ パラメーターの結果の値は操作の結果内で利用できます。DataSense を活用すると、この値を容易に取得できます。

Database Connector バージョン 1.4.0 以降では、ストアドプロシージャーの名前と最初の括弧の間に空白がないことを確認してください。

Database Connector は、パラメーターが位置的に一致する ​`{ call procedureName(:param1, :param2, …​, :paramN) }`​ 形式である、つまり、​`:paramN`​ がストアドプロシージャー宣言の ​`Nth`​ パラメーターと一致する、コール可能なステートメントの使用をサポートしています。

次のテーブルとストアドプロシージャーを使用して初期化した Oracle データベースを使用しているとします。

```xml
    CREATE TABLE SYSTEM.employees(
        employee_id INTEGER GENERATED BY DEFAULT AS IDENTITY,
        employee_name VARCHAR2(100),
        employee_age INTEGER,
        employee_birthday TIMESTAMP,
        PRIMARY KEY(employee_id)
    );


    CREATE PROCEDURE createEmployee(e_name VARCHAR2, e_age NUMBER, e_birth_date DATE) AS
    BEGIN
        INSERT INTO SYSTEM.employees(employee_name, employee_age, employee_birthday) VALUES(e_name, e_age, e_birth_date);
    END;
```

コネクタはコール可能なステートメントでの名前付きパラメーターをサポートしていないため、名前 (​`{ call createEmployee(employee_age ⇒ :age, e_birth_date ⇒ :date, e_name ⇒ :name) }`​) でパラメーターを一致させようとしても機能しません。パラメーターは適切な順序 (​`{ call createEmployee(e_name ⇒ :name, employee_age ⇒ :age, e_birth_date ⇒ :date) }`​) で指定する必要があります。

## [](#use_dates_stored_procedures)ストアドプロシージャーのデータの使用

Database Connector は、エンジン固有の組み込み関数の使用をサポートしていません。たとえば、Oracle データベースでプロシージャーをコールする前に日付を特定の形式に変更する場合、​`{ call createEmployee(e_name ⇒ :name, employee_age ⇒ :age, e_birth_date ⇒ TO_DATE(:date, 'YYYY-MM-DD HH:mm:ss')) }.`​ のアプローチは機能しません。  
コール可能なステートメントを呼び出す前に、すべてのデータ変換で DataWeave を使用します。たとえば、前の例を使用して、次の変換を実行します。

```xml
<db:stored-procedure doc:name="Create Employee" config-ref="Database_Config">
    <db:sql>{ call createEmployee(:name, :age, :date) }</db:sql>
		<db:input-parameters>
		 	<![CDATA[#[%dw 2.0
				output application/json
				fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
				---
				{ 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }
			]]]>
		</db:input-parameters>
	</db:stored-procedure>
```

## [](#execute-ddl-statements)DDL ステートメントの実行

データ定義言語 (DDL) ステートメントは、データへの直接アクセスやデータの変更を行わない特別な種別の SQL ステートメントです。代わりに、データ構造やストアドプロシージャーなどの作成、変更、破棄を行います。DDL ステートメントを使用して、テーブルや他のデータ構造内のデータを作成または変更することもできます。

### [](#create-table-の例)Create Table の例

`Products`​ という名前のデータベーススキーマがあり、​`Products`​ にアクセスするように設定されている ​`dbConfig`​ という名前の接続もあるとします。​`Execute DDL`​ という名前の次の操作は、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という名前の列がある ​`electronic`​ という名前の新しいテーブルを作成します。

```xml
<db:execute-ddl config-ref="dbConfig">
    <db:sql>
        CREATE TABLE electronic(
            id INT AUTO_INCREMENT PRIMARY KEY,
            name VARCHAR(100),
            description VARCHAR(255),
            price SMALLINT,
            discount TINYINT
        )
    </db:sql>
</db:execute-ddl>
```

`Execute DDL`​ 操作は、テーブルを作成し、エラーがなければ ​`0`​ を返します。

## [](#execute-bulk-operations)一括操作の実行

`insert`​、​`update`​、​`delete`​ 操作は、各入力パラメーターが 1 つの値のみを取る場合に使用できます。または、一括操作では、一連のパラメーター値を使用して 1 つのクエリを実行できます。

一括操作を実行すれば、不要なステップを回避して次の利点を得ることができます。

- クエリは 1 回のみ解析される。
- 実行されるステートメントは 1 つのみのため、必要なデータベース接続は 1 つのみである。
- ネットワークオーバーヘッドが最小限に抑えられる。
- RDBMS は一括操作をアトミックに実行できる。

このユースケースでは、コネクタは ​`<db:bulk-insert>`​、​`<db:bulk-update>`​、​`<db:bulk-delete>`​ の 3 つの操作を提供します。

これらの操作は、対応する単一操作と似ていますが、入力パラメーターをキー - 値のペアで受け取るのではなく、キー - 値のペアのリストとして受け取ることを想定しています。

次に例を示します。

```xml
<db:bulk-insert config-ref="dbConfig" >
  <db:bulk-input-parameters>
    #[[{'id': 2, 'name': 'George', 'lastName': 'Costanza'}, {'id': 3, 'name': 'Cosmo', 'lastName': 'Kramer'}]]
  </db:bulk-input-parameters>
  <db:sql>
    insert into customers (id, name, lastName) values (:id, :name, :lastName)
  </db:sql>
</db:bulk-insert>
```

一括操作を使用しない場合、​`delete`​ 操作の実行時に 1 つの条件 ​`(POSITION = X)`​ のみが提供されると、複数の行が条件に一致して削除される可能性があります。 同じ概念が更新にも適用されます。​`UPDATE PRODUCTS set PRICE = PRICE * 0.9 where PRICE > :price`​ を使用するときに、複数の商品に 10% 割引を適用したい場合でも、​`price`​ 入力パラメーターは 1 つの値のみを受け入れます。

価格の異なる商品に異なる割引率を適用するには、多くの操作を実行します。

次の例は、構造 ​`{ price : number, discountRate: number}`​ のオブジェクトのリストであるペイロードです。

```xml
<foreach>
  <db:update config-ref="dbConfig">
    <db:input-parameters>
     #[
      {
        'discountRate' : payload.discountRate,
        'price' : payload.price,
      }
    ]
    </db:input-parameters>
    <db:sql>
      UPDATE PRODUCTS set PRICE = PRICE * :discountRate where PRICE > :price
    </db:sql>
  </db:update>
</foreach>
```

前の操作ではタスクを遂行できますが、非効率的です。リストの要素ごとに、操作の各要素で 1 つのクエリを実行する必要があります。

- クエリが解析される。
- パラメーターが解決される。
- データベースへの接続が取得される (プールから接続を取得するか、新しい接続を確立する)。
- すべてのネットワークオーバーヘッドが支払われる。
- RBMS でクエリを処理し、変更を適用する。
- 接続が解放される。

いずれかの操作の実行中にエラーが発生した場合 (たとえば、100 行の一括挿入のうち 1 行の挿入に失敗した場合)、1 つの例外がスローされます。

一括操作の一部のステートメントは正常に実行できても、他のステートメントはエラーになる可能性があります。この場合、ドライバーが次のいずれかを実行します。

1. 実行をすぐに停止し、残りのすべての操作を無視する
2. 残りのステートメントの実行を続行する。

どちらの場合も、エラーが発生するたびにアプリケーションログを調べて、失敗の原因を確認できます。この場合、問題の原因を説明する 1 つの例外がスローされます。

## [](#data-types)Database Connector データ型リファレンス

次の例には、データベース入力パラメーターと、特定の接続プロバイダーに接続している場合に使用できるカスタムデータ型の定義方法に関する情報が含まれています。

### [](#パラメーターのデータ型の強制)パラメーターのデータ型の強制

まれに、基礎となる JDBC ドライバーで入力パラメーターを特定のデータ型に強制的に割り当てることが必要になる場合があります。たとえば、JDBC ドライバーで入力のデータ型を特定できない場合や、パラメーターがカスタムデータ型の場合、各入力パラメーターのデータ型を指定して、強制を適用しなければならないことがあります。

```xml
<db:bulk-insert queryTimeout="0" queryTimeoutUnit="SECONDS">
     <db:sql>INSERT INTO PLANET(POSITION, NAME) VALUES (:position, :name)</db:sql>
     <db:parameter-types>
         <db:parameter-type key="name" type="VARCHAR" />
         <db:parameter-type key="position" type="INTEGER" />
     </db:parameter-types>
 </db:bulk-insert>
```

### [](#カスタムデータ型の定義)カスタムデータ型の定義

接続プロバイダー (Derby、Oracle など) ごとに専用パラメーターと共通パラメーターがあります。接続プロバイダー要素の子要素で、特定のプロバイダーに接続している場合に使用できるカスタムデータ型を定義します。次に例を示します。

```xml
<db:config name="dbConfig">
   <db:derby-connection url="jdbc:derby:muleEmbeddedDB;create=true">
       <db:column-types>
           <!-- Derby uses JAVA_OBJECT for UDT-->
           <db:column-type typeName="CONTACT_DETAILS" id="2000"/>
       </db:column-types>
   </db:derby-connection>
</db:config>
```

## [](#database-transactions)データベースのトランザクション

データベース操作をトランザクションのコンテキストで実行できます。各操作に ​`transactionalAction`​ 値があります。これは、アクティブなトランザクションがある場合に、トランザクションに関して、操作で実行できる結合アクションの種別を特定します。たとえば、​`select`​ 操作には次の可能なアクションがあります。

- `ALWAYS_JOIN`  
    メッセージの受信時にトランザクションが進行中であると想定します。トランザクションがない場合、エラーが発生します。
- `JOIN_IF_POSSIBLE`  
    現在のトランザクションが使用可能な場合、そのトランザクションを結合します。それ以外の場合、トランザクションは実行されません。
- `NOT_SUPPORTED`  
    存在するトランザクションの外部で実行します。

### [](#操作のグループ化)操作のグループ化

場合によっては、複数のクエリを同じトランザクションのコンテキストでアトミックに実行する必要があります。たとえば、銀行口座振替中は 1 つの口座から金額を引き、別の口座に加える必要がありますが、この 2 つの操作のいずれかが失敗した場合、両方の操作をロールバックする必要があります。

```xml
<db:update config-ref=”db”>
 <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source</db:sql>
 <db:input-parameters>#[{‘money’ : payload.money, ‘source’: payload.source}]</db:input-parameters>
</db:update>

<db:update config-ref=”db”>
 <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target</db:sql>
 <db:input-parameters>#[{‘money’ : payload.money, ‘target’’: payload.target}]</db:input-parameters>
</db:update>
```

これらのクエリを、すでに存在するトランザクションのコンテキストで実行した場合、クエリは同じトランザクションに属します。アクティブなトランザクションがない場合は、​`<try>`​ スコープを使用してトランザクションを開始できます。

```xml
<try transactionalAction="ALWAYS_BEGIN">
 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'source': payload.source}]</db:input-parameters>
 </db:update>

 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'target'': payload.target}]</db:input-parameters>
 </db:update>
</try>
```

## [](#execute-script)スクリプトの実行リファレンス

この操作ではランダムな長さのスクリプトを 1 つのステートメントとして実行します。スクリプト実行は、次のいくつかの点で他の操作と異なります。

- スクリプトに複数のステートメントを含めることができる。
- さまざまな種別のステートメントを使用できる。
- 入力または出力パラメーターを受け入れることができない。

`execute-script`​ 操作では、SQL 射影を伴わない任意のスクリプトを実行します。次の方法で ​`<db:execute-script>`​ を使用できます。

- 操作に ​`execute-script`​ を埋め込む。
- ファイルから ​`execute-script`​ を参照する。

この両方のスクリプトの実行方法を同時に使用することはできません。

スクリプトを実行すると、整数の配列 (実行したステートメントごとに 1 つの要素) が返されます。各数値は、ステートメントの影響を受けたオブジェクトの数を表します。

### [](#操作への埋め込み)操作への埋め込み

```xml
<db:execute-script config-ref="dbConfig">
   <db:sql>
       update PLANET set NAME='Mercury' where POSITION=0;
       update PLANET set NAME='Mercury' where POSITION=4
   </db:sql>
</db:execute-script>
```

### [](#ファイルからの参照)ファイルからの参照

```xml
<flow name="executeScriptFromFile">
   <db:execute-script config-ref="dbConfig" file="integration/executescript/bulk-script.sql" />
</flow>
```

スクリプト実行操作では、スキーマとテーブルの作成、データの挿入、データの循環が頻繁に実行されます。データの循環は夜間ジョブで実行されます。このジョブでは、データを履歴テーブルに移動およびアーカイブし、オンラインテーブルをパージします。

スクリプト実行操作と一括操作では用途が異なります。 たとえば、データベースに多数の行を挿入するスクリプトをビルドできますが、スクリプトに動的パラメーターを都合よく提供することはできません。また、スクリプトで SQL インジェクション攻撃を防ぐ必要があります。

スクリプトで SELECT ステートメントを実行すると、データは返されず、データ入力の問題が生じます。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=e17e5bada978343c58e607aff21dd58072c32e45f177e6911c9658a06ac8034a url=/mulesoft/current/ja-jp/db-connector/1.9/database-connector-examples.md -->

# Database Connector の例

データベース用 Anypoint Connector (Database Connector) の例は、データベース接続の設定、データベースの照会、ストアドプロシージャーの実行、DDL ステートメントの実行、スクリプトの実行、データベーストランザクションの実行、一括操作の使用、カスタムデータ型の設定に役立ちます。

- [データベース接続の設定](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-connection)
    
    一般的なデータベースと汎用データベースの両方に接続します。また、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行うようにコネクタを設定します。
- [データベースのクエリ](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-select)
    
    データベースからデータを照会する ​**Select**​ 操作を設定します。
- [データベースからの単一レコードのクエリ](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-query-single)
    
    MySQL データベースのテーブルから本の情報を取得する ​**Query single**​ 操作を Mule アプリケーション内で設定します。
- [データの挿入、更新、削除](https://docs.mulesoft.com/jp/db-connector/1.9/database-insert-update-delete)
    
    データを管理するように ​**Insert**​、​**Update**​、​**Delete**​ 操作を設定します。
- [ストアドプロシージャーの実行](https://docs.mulesoft.com/jp/db-connector/1.9/database-stored-procedure)
    
    `input`​、​`output`​、および ​`input-output`​ パラメーターを組み合わせる ​**Stored Procedure**​ 操作を設定します。また、ストアドプロシージャーの日付を設定します。
- [UDT を使用する Oracle ストアドプロシージャーのコール](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-udt-stored-procedure)
    
    UDT を入力および出力パラメーターとして使用する Oracle データベースストアドプロシージャーをコールする ​**Stored procedure**​ 操作を設定します。また、​`createStruct`​ および ​`createArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップします。
- [DDL ステートメントの実行](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-execute-ddl)
    
    テーブルや他のデータ構造内のデータを作成または変更する DDL ステートメントを実行する ​**Execute DDL**​ 操作を設定します。
- [一括操作の実行](#execute-bulk-operations)​  
    各入力パラメーターが 1 つの値のみを取る場合に使用する ​**Bulk insert**​、​**Bulk update**​、​**Bulk delete**​ 操作を設定します。
- [スクリプトの実行](https://docs.mulesoft.com/jp/db-connector/1.9/database-execute-script)
    
    スクリプトを 1 つのステートメントとして実行する ​**Execute Script**​ 操作を設定します。
- [データベースのデータ型の設定](https://docs.mulesoft.com/jp/db-connector/1.9/database-configure-data-types)
    
    特定の接続プロバイダーに接続している場合に使用するカスタムデータ型を設定します。
- [データベーストランザクションの設定](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-transactions)
    
    データベース操作をトランザクションのコンテキストで実行します。

## [](#execute-bulk-operations)一括操作の実行

`insert`​、​`update`​、​`delete`​ 操作は、各入力パラメーターが 1 つの値のみを取る場合に使用できます。または、一括操作では、一連のパラメーター値を使用して 1 つのクエリを実行できます。

一括操作を実行すれば、不要なステップを回避して次の利点を得ることができます。

- クエリは 1 回のみ解析される。
- 実行されるステートメントは 1 つのみのため、必要なデータベース接続は 1 つのみである。
- ネットワークオーバーヘッドが最小限に抑えられる。
- RDBMS は一括操作をアトミックに実行できる。

このユースケースでは、コネクタは ​`<db:bulk-insert>`​、​`<db:bulk-update>`​、​`<db:bulk-delete>`​ の 3 つの操作を提供します。

これらの操作は、対応する単一操作と似ていますが、入力パラメーターをキー - 値のペアで受け取るのではなく、キー - 値のペアのリストとして受け取ることを想定しています。

次に例を示します。

```xml
<db:bulk-insert config-ref="dbConfig" >
  <db:bulk-input-parameters>
    #[[{'id': 2, 'name': 'George', 'lastName': 'Costanza'}, {'id': 3, 'name': 'Cosmo', 'lastName': 'Kramer'}]]
  </db:bulk-input-parameters>
  <db:sql>
    insert into customers (id, name, lastName) values (:id, :name, :lastName)
  </db:sql>
</db:bulk-insert>
```

一括操作を使用しない場合、​`delete`​ 操作の実行時に 1 つの条件 ​`(POSITION = X)`​ のみが提供されると、複数の行が条件に一致して削除される可能性があります。 同じ概念が更新にも適用されます。​`UPDATE PRODUCTS set PRICE = PRICE * 0.9 where PRICE > :price`​ を使用するときに、複数の商品に 10% 割引を適用したい場合でも、​`price`​ 入力パラメーターは 1 つの値のみを受け入れます。

価格の異なる商品に異なる割引率を適用するには、多くの操作を実行します。

次の例は、構造 ​`{ price : number, discountRate: number}`​ のオブジェクトのリストであるペイロードです。

```xml
<foreach>
  <db:update config-ref="dbConfig">
    <db:input-parameters>
     #[
      {
        'discountRate' : payload.discountRate,
        'price' : payload.price,
      }
    ]
    </db:input-parameters>
    <db:sql>
      UPDATE PRODUCTS set PRICE = PRICE * :discountRate where PRICE > :price
    </db:sql>
  </db:update>
</foreach>
```

前の操作ではタスクを遂行できますが、非効率的です。リストの要素ごとに、操作の各要素で 1 つのクエリを実行する必要があります。

- クエリが解析される。
- パラメーターが解決される。
- データベースへの接続が取得される (プールから接続を取得するか、新しい接続を確立する)。
- すべてのネットワークオーバーヘッドが支払われる。
- RBMS でクエリを処理し、変更を適用する。
- 接続が解放される。

いずれかの操作の実行中にエラーが発生した場合 (たとえば、100 行の一括挿入のうち 1 行の挿入に失敗した場合)、1 つの例外がスローされます。

一括操作の一部のステートメントは正常に実行できても、他のステートメントはエラーになる可能性があります。この場合、ドライバーが次のいずれかを実行します。

1. 実行をすぐに停止し、残りのすべての操作を無視する
2. 残りのステートメントの実行を続行する。

どちらの場合も、エラーが発生するたびにアプリケーションログを調べて、失敗の原因を確認できます。この場合、問題の原因を説明する 1 つの例外がスローされます。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=a089dd26e8161fa8141f9e290c76a47b9aff144aaa1496d840969d383d092bde url=/mulesoft/current/ja-jp/db-connector/1.8/database-documentation.md -->

# Database Connector リファレンス

Database Connector v1.8

データベース用 Anypoint Connector (Database Connector) を使用すると、JDBC API を介してリレーショナルデータベースに接続できます。

リリースノート: [Database Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/connector-db)

## [](#設定)設定

* * *

### [](#config)デフォルト設定

次のパラメーターを使用して、デフォルト設定を定義します。

#### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定の名前。コネクタはこの名前の設定を参照します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection (接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#config_data-source">Data Source Reference Connection (データソース参照接続)</a>​</p>
</li>
<li>
<p><a href="#config_derby">Derby Connection (Derby 接続)</a>​</p>
</li>
<li>
<p><a href="#config_generic">Generic Connection (汎用接続)</a>​</p>
</li>
<li>
<p><a href="#config_mssql">Microsoft SQL Server Connection (Microsoft SQL Server 接続)</a>​</p>
</li>
<li>
<p><a href="#config_my-sql">MySQL Connection (MySQL 接続)</a>​</p>
</li>
<li>
<p><a href="#config_oracle">Oracle Connection (Oracle 接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定に指定する接続型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Expiration Policy (有効期限ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ExpirationPolicy">Expiration Policy (有効期限ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#接続種別)接続種別

##### [](#config_data-source)データソース参照接続

参照先のデータソースからデータベース接続を作成する接続プロバイダー実装を設定します。  

データソース参照接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。  
たとえば Oracle DB の場合、\[Constant Field Values (定数項目値)\] ページ (セクション oracle.jdbc.OracleTypes) で正しい ID/型の組み合わせを確認します。

###### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Data Source Ref (データソース参照)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Any (任意)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC DataSource オブジェクトへの参照。通常、このオブジェクトは Spring を使用して作成されます。XA トランザクションを使用する場合は、XADataSource オブジェクトを指定する必要があります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_derby)Derby 接続

次のパラメーターを使用して、Derby データベースへの接続を作成します。

###### [](#パラメーター-3)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Subsub Protocol (Subsub プロトコル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Derby がデータベースを検索する場所を指定します。次の使用可能なオプションがあります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>directory</code>​</p>
</li>
<li>
<p><code>memory</code>​</p>
</li>
<li>
<p><code>classpath</code>​</p>
</li>
<li>
<p><code>jar</code></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>directory</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Create (作成)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースが存在しない場合に作成するかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_generic)汎用接続

JDBC URL と必須の JDBC ドライバークラスを使用して任意の種類のデータベースの接続を作成する接続プロバイダーで、次のパラメーターを設定します。  

汎用接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。  
たとえば Oracle DB の場合、\[Constant Field Values (定数項目値)\] ページ (セクション oracle.jdbc.OracleTypes) で正しい ID/型の組み合わせを確認します。

###### [](#パラメーター-4)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>URL</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続に使用する JDBC URL。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Driver Class Name (ドライバークラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースドライバークラスの完全修飾名。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのユーザー名</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_mssql)Microsoft SQL Server 接続

Microsoft SQL Server データベース用のデータベース接続プロバイダー実装で、次のパラメーターを設定します。

###### [](#パラメーター-5)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance Name (インスタンス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのある SQL Server インスタンスの名前を設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database Name (データベース名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するデフォルトデータベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_my-sql)MySQL 接続

MySQL データベースに接続するには、次のパラメーターを設定します。

###### [](#パラメーター-6)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定のカスタムキー - 値 connectionProperties のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_oracle)Oracle 接続

Oracle データベースへの接続を作成するには、次のパラメーターを設定します。

###### [](#パラメーター-7)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>NOT_CONFIGURED</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1521</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance (インスタンス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースインスタンスの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Service Name (サービス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースサービス名の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

## [](#操作)操作

- [Bulk Delete](#bulkDelete)
- [Bulk Insert](#bulkInsert)
- [Bulk Update](#bulkUpdate)
- [Delete](#delete)
- [Execute DDL](#executeDdl)
- [Execute Script](#executeScript)
- [Insert](#insert)
- [Select](#select)
- [Stored Procedure](#storedProcedure)
- [Update](#update)

## [](#関連付けられたソース)関連付けられたソース

- [On Table Row](#listener)

### [](#bulkDelete)Bulk Delete

`<db:bulk-delete>`

この操作では、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も削除操作を実行できます。これにより、1 つの削除操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-8)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このパラメーターでは、必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkInsert)Bulk Insert

`<db:bulk-insert>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も挿入を実行できます。これにより、1 つの挿入操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-9)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリスト。各リスト項目が、挿入される行を表します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-2)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-2)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-2)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkUpdate)Bulk Update

`<db:bulk-update>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も更新を実行できます。これにより、1 つの更新操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-10)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-3)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-3)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-3)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#delete)Delete

`<db:delete>`

この操作は、データベースのデータを削除します。

#### [](#パラメーター-11)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-4)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-4)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-4)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeDdl)Execute DDL

`<db:execute-ddl>`

この操作は、データベースに対して DDL クエリを実行できます。

#### [](#パラメーター-12)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-5)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-5)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-5)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeScript)Execute Script

`<db:execute-script>`

この操作は、1 つのデータベースステートメントで SQL スクリプトを実行します。スクリプトはユーザーから提供された場合、パラメーターバインドなしで実行されます。

#### [](#パラメーター-13)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Script Path (スクリプトパス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>読み込むファイルの場所を指定します。ファイルはクラスパスまたはディスク上のリソースを参照できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-6)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-6)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-6)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#insert)Insert

`<db:insert>`

この操作は、データベースにデータを挿入します。

#### [](#パラメーター-14)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-7)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-7)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-7)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#select)Select

`<db:select>`

この操作は、データベースからデータを選択します。パフォーマンスやメモリの問題につながる可能性のある結果の先制消費を回避するため、ストリーミングが自動的に割り当てられます。

ただし、一部のドライバーはクエリの実行時に結果全体を読み込むため、ストリーミングは機能しません。たとえば、Postgres ドライバーは結果全体をメモリに読み込む場合があります。

#### [](#パラメーター-15)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-8)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Object (オブジェクトの配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-8)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用)プーリングプロファイルの使用

プーリングプロファイルと ​**Select**​ 操作を使用する場合、フローの実行が終了するか、ストリームのコンテンツが完全にコンシュームされるまで接続は開いたままになります。また、接続がトランザクションキーの場合も同様です。この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

#### [](#スロー-8)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#storedProcedure)Stored Procedure

`<db:stored-procedure>`

データベースでストアドプロシージャーを呼び出します。 ストアドプロシージャーで 1 つまたは複数の ResultSet インスタンスが返される場合、パフォーマンスやメモリの問題につながる可能性のある結果の先制消費を回避するため、ストリーミングが自動的に割り当てられます。

#### [](#パラメーター-16)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input - Output Parameters (入力 - 出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する、入力と出力の両方のパラメーターの名前をキーとするマップ。  SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Output Parameters (出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#OutputParameter">Output Parameter (出力パラメーター)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する出力パラメーターのリスト。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: call multiply(:value, :result))。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-9)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-9)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-2)プーリングプロファイルの使用

プーリングプロファイルと ​**Stored procedure**​ 操作を使用する場合、フローの実行が終了するか、ストリームのコンテンツが完全にコンシュームされるまで接続は開いたままになります。また、接続がトランザクションキーの場合も同様です。この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

Database Connector 1.8.3 以降、​**Stored procedure**​ 操作の接続は、ストリームまたはトランザクションに含まれていない場合に解放されます。

#### [](#スロー-9)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

### [](#update)Update

`<db:update>`

データベースのデータを更新します。

#### [](#パラメーター-17)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-10)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-10)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-10)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

## [](#sources-ソース)Sources (ソース)

### [](#listener)On Table Row

`<db:listener>`

この操作は、一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成します。 必要に応じて、ウォーターマークおよび ID 列を提供できます。ウォーターマーク列を提供した場合、その列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが返されます。ID 列を提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回選択されていないことが自動的に確認されます。

この操作ではストリーミングはサポートされません。つまり、操作結果にアクセスするためにペイロードへの変換をさらに実行する必要はありません。この動作は、バージョン 1.9 でリリースされた ​**Query Single**​ 操作と同じです。

#### [](#パラメーター-18)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Table (テーブル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>選択元のテーブルの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Watermark Column (ウォーターマーク列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ウォーターマークに使用する列の名前。この列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが処理されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Column (ID 列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行 ID とみなす列の名前。提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回処理されていないことが確認されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_BEGIN​</p>
</li>
<li>
<p>None (なし)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ソースがトランザクションに関して実行できる開始アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NONE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Type (トランザクション種別)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>LOCAL</p>
</li>
<li>
<p>XA</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成するトランザクションの種別。使用できるかどうかは、Runtime バージョンによって決まります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>LOCAL</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Primary Node Only (プライマリノードのみ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クラスターでの実行時にこのソースをプライマリノード上でのみ実行する必要があるかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scheduling Strategy (スケジュール戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>scheduling-strategy</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ポーリングをトリガーするスケジューラーを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Redelivery Policy (再配信ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#RedeliveryPolicy">Redelivery Policy (再配信ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>同じメッセージの再配信を処理するためのポリシー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-11)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-11)次の設定の場合

- [デフォルト設定](#config)

## [](#型)型

### [](#pooling-profile)Pooling Profile (プーリングプロファイル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Pool Size (最大プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最大接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Min Pool Size (最小プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最小接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Acquire Increment (取得増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに一度に取得を試みる接続数を決定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Prepared Statement Cache Size (プリペアードステートメントのキャッシュサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールされた接続ごとにキャッシュされるステートメント数を決定します。これを 0 に設定すると、ステートメントのキャッシュが無効になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait (最大待機)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに、接続の取得を試みているクライアントが接続を待機する時間。この値を 0 (デフォルト) に設定すると、無期限に待機します。これは ​<code>checkoutTimeout</code>​ と同じで、追加プロパティで上書きすることはできません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait Unit (最大待機単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>#maxWait。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>SECONDS</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続が破棄される前に、プールされていて未使用のままでいられる秒数を決定します。この値を 0 (デフォルト) に設定すると、アイドル接続が期限切れになることはありません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Additional Properties (追加プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プーリングプロファイル設定プロパティの名前をキーとするマップ。式の使用はサポートされていません。これらのプロパティを使用して、以前に指定したプロパティ ([Max Pool Size (最大プールサイズ)] や [Min Pool Size (最小プールサイズ)] など) を上書きすることはできません。上書きしようとした場合、メインプロパティが優先されます。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ColumnType)Column Type (列の型)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用する型識別子。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Name (型名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用するデータ型の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Class Name (クラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース種別をマップするために使用する必要がある Java クラスを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#Reconnection)Reconnection (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fails Deployment (デプロイメントに失敗)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する再接続戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect)Reconnect (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Count (数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続の試行回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Time Unit (時間単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>maxIdleTime</code>​ 属性の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Redelivery Count (最大再配信数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プロセス失敗メッセージをトリガーするまでに、正常に処理されないメッセージを再配信できる最大回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use Secure Hash (セキュアハッシュを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用するかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Message Digest Algorithm (メッセージダイジェストアルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するセキュアハッシュアルゴリズム。これが設定されていない場合、デフォルトの SHA-256 になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SHA-256</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Expression (ID 式)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メッセージがいつ再配信されたのかを判断するために使用する 1 つ以上の式を定義します。このプロパティは、​<strong>[Use secure hash (セキュアハッシュを使用)]</strong>​ が ​<code>false</code>​ に設定されている場合にのみ設定できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Object Store (オブジェクトストア)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object Store (オブジェクトストア)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>各メッセージの再配信カウンターが保存されるオブジェクトストア。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ParameterType)Parameter Type (パラメーター種別)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#TypeClassifier)Type Classifier (型分類子)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BIT</p>
</li>
<li>
<p>TINYINT</p>
</li>
<li>
<p>SMALLINT</p>
</li>
<li>
<p>INTEGER</p>
</li>
<li>
<p>BIGINT</p>
</li>
<li>
<p>FLOAT</p>
</li>
<li>
<p>REAL</p>
</li>
<li>
<p>DOUBLE</p>
</li>
<li>
<p>NUMERIC</p>
</li>
<li>
<p>DECIMAL</p>
</li>
<li>
<p>CHAR</p>
</li>
<li>
<p>VARCHAR</p>
</li>
<li>
<p>LONGVARCHAR</p>
</li>
<li>
<p>DATE</p>
</li>
<li>
<p>TIME</p>
</li>
<li>
<p>TIMESTAMP</p>
</li>
<li>
<p>BINARY</p>
</li>
<li>
<p>VARBINARY</p>
</li>
<li>
<p>LONGVARBINARY</p>
</li>
<li>
<p>NULL</p>
</li>
<li>
<p>OTHER</p>
</li>
<li>
<p>JAVA_OBJECT​</p>
</li>
<li>
<p>DISTINCT</p>
</li>
<li>
<p>STRUCT</p>
</li>
<li>
<p>ARRAY</p>
</li>
<li>
<p>BLOB</p>
</li>
<li>
<p>CLOB</p>
</li>
<li>
<p>REF</p>
</li>
<li>
<p>DATALINK</p>
</li>
<li>
<p>BOOLEAN</p>
</li>
<li>
<p>ROWID</p>
</li>
<li>
<p>NCHAR</p>
</li>
<li>
<p>NVARCHAR</p>
</li>
<li>
<p>LONGNVARCHAR</p>
</li>
<li>
<p>NCLOB</p>
</li>
<li>
<p>SQLXML</p>
</li>
<li>
<p>UNKNOWN</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Custom Type (カスタム型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#StatementResult)Statement Result (ステートメント結果)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Affected Rows (影響を受けた行)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Generated Keys (生成されたキー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Objects (メモリ内オブジェクト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メモリに保持するインスタンスの最大数。指定された最大数以上が必要な場合、ディスクでのコンテンツのバッファが開始されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-stream)Repeatable In Memory Stream (反復可能なメモリ内ストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。
<strong> BYTE (バイト)
</strong> KB
<strong> MB
</strong> GB</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>これらのすべての属性の単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-stream)Repeatable File Store Stream (反復可能なファイルストアストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Size (メモリ内サイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データをメモリ内に保持するためにストリームで使用する最大メモリを定義します。これを超えると、ディスクのコンテンツがバッファされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BYTE (バイト)</p>
</li>
<li>
<p>KB</p>
</li>
<li>
<p>MB</p>
</li>
<li>
<p>GB</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>[Max in Memory Size (最大メモリ内サイズ)]</strong>​ を表す単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#OutputParameter)Output Parameter (出力パラメーター)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=3d695d696fb9baf3e2698d03b591bd401731688f13ebd34dd715f88ebb8f543c url=/mulesoft/current/ja-jp/db-connector/1.10/database-documentation.md -->

# Database Connector リファレンス 1.10

データベース用 Anypoint Connector (Database Connector) を使用すると、JDBC API を介してリレーショナルデータベースに接続できます。

リリースノート: [Database Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/connector-db)

## [](#設定)設定

* * *

### [](#config)デフォルト設定

次のパラメーターを使用して、デフォルト設定を定義します。

#### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定の名前。コネクタはこの名前の設定を参照します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection (接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#config_data-source">Data Source Reference Connection (データソース参照接続)</a>​</p>
</li>
<li>
<p><a href="#config_derby">Derby Connection (Derby 接続)</a>​</p>
</li>
<li>
<p><a href="#config_generic">Generic Connection (汎用接続)</a>​</p>
</li>
<li>
<p><a href="#config_mssql">Microsoft SQL Server Connection (Microsoft SQL Server 接続)</a>​</p>
</li>
<li>
<p><a href="#config_my-sql">MySQL Connection (MySQL 接続)</a>​</p>
</li>
<li>
<p><a href="#config_oracle">Oracle Connection (Oracle 接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定に指定する接続型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Expiration Policy (有効期限ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ExpirationPolicy">Expiration Policy (有効期限ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#接続種別)接続種別

##### [](#config_data-source)データソース参照接続

参照先のデータソースからデータベース接続を作成する接続プロバイダー実装を設定します。  

データソース参照接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。  
たとえば Oracle DB の場合、\[Constant Field Values (定数項目値)\] ページ (セクション oracle.jdbc.OracleTypes) で正しい ID/型の組み合わせを確認します。

###### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Data Source Ref (データソース参照)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Any (任意)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC DataSource オブジェクトへの参照。通常、このオブジェクトは Spring を使用して作成されます。XA トランザクションを使用する場合は、XADataSource オブジェクトを指定する必要があります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_derby)Derby 接続

次のパラメーターを使用して、Derby データベースへの接続を作成します。

###### [](#パラメーター-3)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Subsub Protocol (Subsub プロトコル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Derby がデータベースを検索する場所を指定します。次の使用可能なオプションがあります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>directory</code>​</p>
</li>
<li>
<p><code>memory</code>​</p>
</li>
<li>
<p><code>classpath</code>​</p>
</li>
<li>
<p><code>jar</code></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>directory</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Create (作成)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースが存在しない場合に作成するかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_generic)汎用接続

JDBC URL と必須の JDBC ドライバークラスを使用して任意の種類のデータベースの接続を作成する接続プロバイダーで、次のパラメーターを設定します。  

汎用接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。  
たとえば Oracle DB の場合、\[Constant Field Values (定数項目値)\] ページ (セクション oracle.jdbc.OracleTypes) で正しい ID/型の組み合わせを確認します。

###### [](#パラメーター-4)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>URL</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続に使用する JDBC URL。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Driver Class Name (ドライバークラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースドライバークラスの完全修飾名。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのユーザー名</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_mssql)Microsoft SQL Server 接続

Microsoft SQL Server データベース用のデータベース接続プロバイダー実装で、次のパラメーターを設定します。

###### [](#パラメーター-5)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance Name (インスタンス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのある SQL Server インスタンスの名前を設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database Name (データベース名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するデフォルトデータベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_my-sql)MySQL 接続

MySQL データベースに接続するには、次のパラメーターを設定します。

###### [](#パラメーター-6)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定のカスタムキー - 値 connectionProperties のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_oracle)Oracle 接続

Oracle データベースへの接続を作成するには、次のパラメーターを設定します。

###### [](#パラメーター-7)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>NOT_CONFIGURED</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1521</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance (インスタンス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースインスタンスの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Service Name (サービス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースサービス名の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

## [](#操作)操作

- [Bulk Delete](#bulkDelete)
- [Bulk Insert](#bulkInsert)
- [Bulk Update](#bulkUpdate)
- [Delete](#delete)
- [Execute DDL](#executeDdl)
- [Execute Script](#executeScript)
- [Insert](#insert)
- [Select](#select)
- [Query Single](#querySingle)
- [Stored Procedure](#storedProcedure)
- [Update](#update)

## [](#関連付けられたソース)関連付けられたソース

- [On Table Row](#listener)

### [](#bulkDelete)Bulk Delete

`<db:bulk-delete>`

この操作では、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も削除操作を実行できます。これにより、1 つの削除操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-8)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このパラメーターでは、必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkInsert)Bulk Insert

`<db:bulk-insert>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も挿入を実行できます。これにより、1 つの挿入操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-9)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリスト。各リスト項目が、挿入される行を表します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の TimeUnit。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-2)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-2)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-2)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkUpdate)Bulk Update

`<db:bulk-update>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も更新を実行できます。これにより、1 つの更新操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-10)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-3)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-3)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-3)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#delete)Delete

`<db:delete>`

この操作は、データベースのデータを削除します。

#### [](#パラメーター-11)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: <code>where id = :myParamName</code>​)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-4)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-4)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-4)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeDdl)Execute DDL

`<db:execute-ddl>`

この操作は、データベースに対して DDL クエリを実行できます。

#### [](#パラメーター-12)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-5)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-5)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-5)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeScript)Execute Script

`<db:execute-script>`

この操作は、1 つのデータベースステートメントで SQL スクリプトを実行します。スクリプトはユーザーから提供された場合、パラメーターバインドなしで実行されます。

#### [](#パラメーター-13)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Script Path (スクリプトパス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>読み込むファイルの場所を指定します。ファイルはクラスパスまたはディスク上のリソースを参照できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-6)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-6)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-6)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#insert)Insert

`<db:insert>`

この操作は、データベースにデータを挿入します。

#### [](#パラメーター-14)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-7)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-7)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-7)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#select)Select

`<db:select>`

この操作は、データベースからデータを照会します。すべての結果が一度に読み込まれることでパフォーマンスとメモリの問題が発生することを防止するため、結果は自動的にストリーミングされます。つまり、必要に応じて ​_fetchSize_​ 行分のページが読み込まれます。この操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

ただし、一部のドライバーはクエリの実行時に結果全体を読み込むため、ストリーミングは機能しません。たとえば、Postgres ドライバーは結果全体をメモリに読み込む場合があります。

#### [](#パラメーター-15)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-8)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Object (オブジェクトの配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-8)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用)プーリングプロファイルの使用

プーリングプロファイルと ​**Select**​ 操作を使用する場合、次のいずれかが発生するまで接続は開いたままです。

- フローの実行が終了する
- ストリームのコンテンツが完全にコンシュームされる
- 接続がトランザクションキーである。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">LOB はストリームとみなされるため、フローの実行が終了するか、フローの完了前にコンテンツがコンシュームされるまで、接続は開いたままになります。この場合、関連する接続を閉じるための最良の方法が実行されます。</td></tr></tbody></table>

この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

#### [](#スロー-8)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#querySingle)Query Single

`<db:query-single>`

この操作は、データベースレコードから 1 つのデータレコードを選択します。複数の行を返す SQL クエリを指定した場合、最初のレコードのみが処理されて返されます。この操作ではストリーミングは使用されません。つまり、Query Single 操作の実行直後に、選択したレコードの完全なコンテンツがメモリに読み込まれます。

#### [](#パラメーター-16)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を評価する式。式の結果は対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-9)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-9)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-2)プーリングプロファイルの使用

プーリングプロファイルと Query Single 操作を使用する場合、接続は操作の実行直後にプールに返されます。

#### [](#スロー-9)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#storedProcedure)Stored Procedure

`<db:stored-procedure>`

データベースでストアドプロシージャーを呼び出します。 ストアドプロシージャーが 1 つ以上の ResultSet インスタンスを返した場合、結果はすべて一度には読み込まれません。パフォーマンスとメモリの問題が発生することを防止するため、結果は自動的にストリーミングされます。この動作は、​`_fetchSize_`​ 行分のページが必要に応じて遅延して読み込まれることを意味します。​**Stored Procedure**​ 操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

#### [](#パラメーター-17)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input - Output Parameters (入力 - 出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する、入力と出力の両方のパラメーターの名前をキーとするマップ。  SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Output Parameters (出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#OutputParameter">Output Parameter (出力パラメーター)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する出力パラメーターのリスト。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: call multiply(:value, :result))。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-10)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-10)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-3)プーリングプロファイルの使用

プーリングプロファイルと ​**Stored procedure**​ 操作を使用する場合、フローの実行が終了するか、ストリームのコンテンツが完全にコンシュームされるまで接続は開いたままになります。また、接続がトランザクションキーの場合も同様です。この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

Database Connector 1.8.3 以降、​**Stored procedure**​ 操作の接続は、ストリームまたはトランザクションに含まれていない場合に解放されます。

#### [](#スロー-10)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

### [](#update)Update

`<db:update>`

データベースのデータを更新します。

#### [](#パラメーター-18)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-11)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-11)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-11)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

## [](#sources-ソース)Sources (ソース)

### [](#listener)On Table Row

`<db:listener>`

この操作は、一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成します。 必要に応じて、ウォーターマークおよび ID 列を提供できます。ウォーターマーク列を提供した場合、その列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが返されます。ID 列を提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回選択されていないことが自動的に確認されます。

この操作ではストリーミングはサポートされません。つまり、操作結果にアクセスするためにペイロードへの変換をさらに実行する必要はありません。この動作は、バージョン 1.9 でリリースされた ​**Query Single**​ 操作と同じです。

#### [](#パラメーター-19)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Table (テーブル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>選択元のテーブルの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Watermark Column (ウォーターマーク列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ウォーターマークに使用する列の名前。この列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが処理されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Column (ID 列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行 ID とみなす列の名前。提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回処理されていないことが確認されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_BEGIN​</p>
</li>
<li>
<p>None (なし)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ソースがトランザクションに関して実行できる開始アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NONE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Type (トランザクション種別)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>LOCAL</p>
</li>
<li>
<p>XA</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成するトランザクションの種別。使用できるかどうかは、Runtime バージョンによって決まります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>LOCAL</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Primary Node Only (プライマリノードのみ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クラスターでの実行時にこのソースをプライマリノード上でのみ実行する必要があるかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scheduling Strategy (スケジュール戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>scheduling-strategy</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ポーリングをトリガーするスケジューラーを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Redelivery Policy (再配信ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#RedeliveryPolicy">Redelivery Policy (再配信ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>同じメッセージの再配信を処理するためのポリシー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-12)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-12)次の設定の場合

- [デフォルト設定](#config)

## [](#型)型

### [](#pooling-profile)Pooling Profile (プーリングプロファイル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Pool Size (最大プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最大接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Min Pool Size (最小プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最小接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Acquire Increment (取得増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに一度に取得を試みる接続数を決定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Prepared Statement Cache Size (プリペアードステートメントのキャッシュサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールされた接続ごとにキャッシュされるステートメント数を決定します。これを 0 に設定すると、ステートメントのキャッシュが無効になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait (最大待機)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに、接続の取得を試みているクライアントが接続を待機する時間。この値を 0 (デフォルト) に設定すると、無期限に待機します。これは ​<code>checkoutTimeout</code>​ と同じで、追加プロパティで上書きすることはできません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait Unit (最大待機単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>#maxWait。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>SECONDS</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続が破棄される前に、プールされていて未使用のままでいられる秒数を決定します。この値を 0 (デフォルト) に設定すると、アイドル接続が期限切れになることはありません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Additional Properties (追加プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プーリングプロファイル設定プロパティの名前をキーとするマップ。式の使用はサポートされていません。これらのプロパティを使用して、以前に指定したプロパティ ([Max Pool Size (最大プールサイズ)] や [Min Pool Size (最小プールサイズ)] など) を上書きすることはできません。上書きしようとした場合、メインプロパティが優先されます。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Statement (最大ステートメント)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>DataSource によりキャッシュされる PreparedStatement の合計数を定義します。プールでは、指定された制限に達すると、使用頻度が最も低い PreparedStatement が破棄されます。​<code>0</code>​ に設定すると、ステートメントのキャッシュが無効になります</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Test connection on checkout (チェックアウト時に接続をテスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>チェックアウト時の接続テストを無効にしてパフォーマンスを向上します。​<code>true</code>​ に設定すると、接続のチェックアウトのたびに操作が実行され、接続が有効であることが確認されます。​<code>c3p0.idleConnectionTestPeriod</code>​ を使用して接続を定期的に確認することをお勧めします。パフォーマンスを向上するには、このプロパティを ​<code>false</code>​ に設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ColumnType)Column Type (列の型)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用する型識別子。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Name (型名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用するデータ型の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Class Name (クラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース種別をマップするために使用する必要がある Java クラスを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#Reconnection)Reconnection (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fails Deployment (デプロイメントに失敗)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する再接続戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect)Reconnect (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Count (数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続の試行回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Time Unit (時間単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>maxIdleTime</code>​ 属性の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Redelivery Count (最大再配信数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プロセス失敗メッセージをトリガーするまでに、正常に処理されないメッセージを再配信できる最大回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use Secure Hash (セキュアハッシュを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用するかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Message Digest Algorithm (メッセージダイジェストアルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するセキュアハッシュアルゴリズム。これが設定されていない場合、デフォルトの SHA-256 になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SHA-256</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Expression (ID 式)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メッセージがいつ再配信されたのかを判断するために使用する 1 つ以上の式を定義します。このプロパティは、​<strong>[Use secure hash (セキュアハッシュを使用)]</strong>​ が ​<code>false</code>​ に設定されている場合にのみ設定できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Object Store (オブジェクトストア)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object Store (オブジェクトストア)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>各メッセージの再配信カウンターが保存されるオブジェクトストア。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ParameterType)Parameter Type (パラメーター種別)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#TypeClassifier)Type Classifier (型分類子)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BIT</p>
</li>
<li>
<p>TINYINT</p>
</li>
<li>
<p>SMALLINT</p>
</li>
<li>
<p>INTEGER</p>
</li>
<li>
<p>BIGINT</p>
</li>
<li>
<p>FLOAT</p>
</li>
<li>
<p>REAL</p>
</li>
<li>
<p>DOUBLE</p>
</li>
<li>
<p>NUMERIC</p>
</li>
<li>
<p>DECIMAL</p>
</li>
<li>
<p>CHAR</p>
</li>
<li>
<p>VARCHAR</p>
</li>
<li>
<p>LONGVARCHAR</p>
</li>
<li>
<p>DATE</p>
</li>
<li>
<p>TIME</p>
</li>
<li>
<p>TIMESTAMP</p>
</li>
<li>
<p>BINARY</p>
</li>
<li>
<p>VARBINARY</p>
</li>
<li>
<p>LONGVARBINARY</p>
</li>
<li>
<p>NULL</p>
</li>
<li>
<p>OTHER</p>
</li>
<li>
<p>JAVA_OBJECT​</p>
</li>
<li>
<p>DISTINCT</p>
</li>
<li>
<p>STRUCT</p>
</li>
<li>
<p>ARRAY</p>
</li>
<li>
<p>BLOB</p>
</li>
<li>
<p>CLOB</p>
</li>
<li>
<p>REF</p>
</li>
<li>
<p>DATALINK</p>
</li>
<li>
<p>BOOLEAN</p>
</li>
<li>
<p>ROWID</p>
</li>
<li>
<p>NCHAR</p>
</li>
<li>
<p>NVARCHAR</p>
</li>
<li>
<p>LONGNVARCHAR</p>
</li>
<li>
<p>NCLOB</p>
</li>
<li>
<p>SQLXML</p>
</li>
<li>
<p>UNKNOWN</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Custom Type (カスタム型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#StatementResult)Statement Result (ステートメント結果)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Affected Rows (影響を受けた行)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Generated Keys (生成されたキー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Objects (メモリ内オブジェクト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メモリに保持するインスタンスの最大数。指定された最大数以上が必要な場合、ディスクでのコンテンツのバッファが開始されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-stream)Repeatable In Memory Stream (反復可能なメモリ内ストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。
<strong> BYTE (バイト)
</strong> KB
<strong> MB
</strong> GB</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>これらのすべての属性の単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-stream)Repeatable File Store Stream (反復可能なファイルストアストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Size (メモリ内サイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データをメモリ内に保持するためにストリームで使用する最大メモリを定義します。これを超えると、ディスクのコンテンツがバッファされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BYTE (バイト)</p>
</li>
<li>
<p>KB</p>
</li>
<li>
<p>MB</p>
</li>
<li>
<p>GB</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>[Max in Memory Size (最大メモリ内サイズ)]</strong>​ を表す単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#OutputParameter)Output Parameter (出力パラメーター)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=9cb44b025caead61314baca840c93d5236f4cec08a37fca26a0fbea7d0cf2832 url=/mulesoft/current/ja-jp/db-connector/1.12/database-documentation.md -->

# Database Connector リファレンス 1.12

データベース用 Anypoint Connector (Database Connector) を使用すると、JDBC API を介してリレーショナルデータベースに接続できます。

リリースノート: [Database Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/connector-db)

## [](#設定)設定

* * *

### [](#config)デフォルト設定

次のパラメーターを使用して、デフォルト設定を定義します。

#### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定の名前。コネクタはこの名前の設定を参照します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection (接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#config_data-source">Data Source Reference Connection (データソース参照接続)</a>​</p>
</li>
<li>
<p><a href="#config_derby">Derby Connection (Derby 接続)</a>​</p>
</li>
<li>
<p><a href="#config_generic">Generic Connection (汎用接続)</a>​</p>
</li>
<li>
<p><a href="#config_mssql">Microsoft SQL Server Connection (Microsoft SQL Server 接続)</a>​</p>
</li>
<li>
<p><a href="#config_my-sql">MySQL Connection (MySQL 接続)</a>​</p>
</li>
<li>
<p><a href="#config_oracle">Oracle Connection (Oracle 接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定に指定する接続型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Expiration Policy (有効期限ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ExpirationPolicy">Expiration Policy (有効期限ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#接続種別)接続種別

##### [](#config_data-source)データソース参照接続

参照先のデータソースからデータベース接続を作成する接続プロバイダー実装を設定します。  

データソース参照接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。  
たとえば Oracle DB の場合、\[Constant Field Values (定数項目値)\] ページ (セクション oracle.jdbc.OracleTypes) で正しい ID/型の組み合わせを確認します。

###### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Data Source Ref (データソース参照)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Any (任意)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC DataSource オブジェクトへの参照。このオブジェクトは通常、Spring を使用して作成されます。XA トランザクションを使用する場合は、XADataSource オブジェクトを指定する必要があります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_derby)Derby 接続

次のパラメーターを使用して、Derby データベースへの接続を作成します。

###### [](#パラメーター-3)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Subsub Protocol (Subsub プロトコル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Derby がデータベースを検索する場所を指定します。次の使用可能なオプションがあります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>directory</code>​</p>
</li>
<li>
<p><code>memory</code>​</p>
</li>
<li>
<p><code>classpath</code>​</p>
</li>
<li>
<p><code>jar</code></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>directory</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Create (作成)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースが存在しない場合に作成するかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_generic)汎用接続

JDBC URL と必須の JDBC ドライバークラスを使用して任意の種類のデータベースの接続を作成する接続プロバイダーで、次のパラメーターを設定します。  

汎用接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。  
たとえば Oracle DB の場合、\[Constant Field Values (定数項目値)\] ページ (セクション oracle.jdbc.OracleTypes) で正しい ID/型の組み合わせを確認します。

###### [](#パラメーター-4)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>URL</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続に使用する JDBC URL。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Driver Class Name (ドライバークラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースドライバークラスの完全修飾名。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのユーザー名</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_mssql)Microsoft SQL Server 接続

Microsoft SQL Server データベース用のデータベース接続プロバイダー実装で、次のパラメーターを設定します。

###### [](#パラメーター-5)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance Name (インスタンス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのある SQL Server インスタンスの名前を設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database Name (データベース名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するデフォルトデータベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_my-sql)MySQL 接続

MySQL データベースに接続するには、次のパラメーターを設定します。

###### [](#パラメーター-6)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定のカスタムキー - 値 connectionProperties のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_oracle)Oracle 接続

Oracle データベースへの接続を作成するには、次のパラメーターを設定します。

###### [](#パラメーター-7)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>NOT_CONFIGURED</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1521</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance (インスタンス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースインスタンスの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Service Name (サービス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースサービス名の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

## [](#操作)操作

- [Bulk Delete](#bulkDelete)
- [Bulk Insert](#bulkInsert)
- [Bulk Update](#bulkUpdate)
- [Delete](#delete)
- [Execute DDL](#executeDdl)
- [Execute Script](#executeScript)
- [Insert](#insert)
- [Select](#select)
- [Query Single](#querySingle)
- [Stored Procedure](#storedProcedure)
- [Update](#update)

## [](#関連付けられたソース)関連付けられたソース

- [On Table Row](#listener)

### [](#bulkDelete)Bulk Delete

`<db:bulk-delete>`

この操作では、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も削除操作を実行できます。これにより、1 つの削除操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-8)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このパラメーターでは、必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkInsert)Bulk Insert

`<db:bulk-insert>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も挿入を実行できます。これにより、1 つの挿入操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-9)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリスト。各リスト項目が、挿入される行を表します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の TimeUnit。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-2)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-2)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-2)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkUpdate)Bulk Update

`<db:bulk-update>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も更新を実行できます。これにより、1 つの更新操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-10)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-3)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-3)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-3)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#delete)Delete

`<db:delete>`

この操作は、データベースのデータを削除します。

#### [](#パラメーター-11)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: <code>where id = :myParamName</code>​)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-4)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-4)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-4)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeDdl)Execute DDL

`<db:execute-ddl>`

この操作は、データベースに対して DDL クエリを実行できます。

#### [](#パラメーター-12)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-5)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-5)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-5)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeScript)Execute Script

`<db:execute-script>`

この操作は、1 つのデータベースステートメントで SQL スクリプトを実行します。スクリプトはユーザーから提供された場合、パラメーターバインドなしで実行されます。

#### [](#パラメーター-13)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Script Path (スクリプトパス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>読み込むファイルの場所を指定します。ファイルはクラスパスまたはディスク上のリソースを参照できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-6)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-6)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-6)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#insert)Insert

`<db:insert>`

この操作は、データベースにデータを挿入します。

#### [](#パラメーター-14)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-7)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-7)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-7)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#select)Select

`<db:select>`

この操作は、データベースからデータを照会します。すべての結果が一度に読み込まれることでパフォーマンスとメモリの問題が発生することを防止するため、結果は自動的にストリーミングされます。つまり、必要に応じて ​_fetchSize_​ 行分のページが読み込まれます。この操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

ただし、一部のドライバーはクエリの実行時に結果全体を読み込むため、ストリーミングは機能しません。たとえば、Postgres ドライバーは結果全体をメモリに読み込む場合があります。

#### [](#パラメーター-15)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-8)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Object (オブジェクトの配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-8)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用)プーリングプロファイルの使用

プーリングプロファイルと ​**Select**​ 操作を使用する場合、次のいずれかが発生するまで接続は開いたままです。

- フローの実行が終了する
- ストリームのコンテンツが完全にコンシュームされる
- 接続がトランザクションキーである。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">LOB はストリームとみなされるため、フローの実行が終了するか、フローの完了前にコンテンツがコンシュームされるまで、接続は開いたままになります。この場合、関連する接続を閉じるための最良の方法が実行されます。</td></tr></tbody></table>

この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

#### [](#スロー-8)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#querySingle)Query Single

`<db:query-single>`

この操作は、データベースレコードから 1 つのデータレコードを選択します。複数の行を返す SQL クエリを指定した場合、最初のレコードのみが処理されて返されます。この操作ではストリーミングは使用されません。つまり、Query Single 操作の実行直後に、選択したレコードの完全なコンテンツがメモリに読み込まれます。

#### [](#パラメーター-16)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を評価する式。式の結果は対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-9)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-9)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-2)プーリングプロファイルの使用

プーリングプロファイルと Query Single 操作を使用する場合、接続は操作の実行直後にプールに返されます。

#### [](#スロー-9)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#storedProcedure)Stored Procedure

`<db:stored-procedure>`

データベースでストアドプロシージャーを呼び出します。 ストアドプロシージャーが 1 つ以上の ResultSet インスタンスを返した場合、結果はすべて一度には読み込まれません。パフォーマンスとメモリの問題が発生することを防止するため、結果は自動的にストリーミングされます。この動作は、​`_fetchSize_`​ 行分のページが必要に応じて遅延して読み込まれることを意味します。​**Stored Procedure**​ 操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

#### [](#パラメーター-17)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input - Output Parameters (入力 - 出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する、入力と出力の両方のパラメーターの名前をキーとするマップ。  SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Output Parameters (出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#OutputParameter">Output Parameter (出力パラメーター)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する出力パラメーターのリスト。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: call multiply(:value, :result))。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-10)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-10)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-3)プーリングプロファイルの使用

プーリングプロファイルと ​**Stored procedure**​ 操作を使用する場合、フローの実行が終了するか、ストリームのコンテンツが完全にコンシュームされるまで接続は開いたままになります。また、接続がトランザクションキーの場合も同様です。この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

Database Connector 1.8.3 以降、​**Stored procedure**​ 操作の接続は、ストリームまたはトランザクションに含まれていない場合に解放されます。

#### [](#スロー-10)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

### [](#update)Update

`<db:update>`

データベースのデータを更新します。

#### [](#パラメーター-18)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-11)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-11)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-11)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

## [](#ソース)ソース

### [](#listener)On Table Row

`<db:listener>`

この操作は、一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成します。 必要に応じて、ウォーターマークおよび ID 列を提供できます。ウォーターマーク列を提供した場合、その列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが返されます。ID 列を提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回選択されていないことが自動的に確認されます。

この操作ではストリーミングはサポートされません。つまり、操作結果にアクセスするためにペイロードへの変換をさらに実行する必要はありません。この動作は、バージョン 1.9 でリリースされた ​**Query Single**​ 操作と同じです。

#### [](#パラメーター-19)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Table (テーブル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>選択元のテーブルの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Watermark Column (ウォーターマーク列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ウォーターマークに使用する列の名前。この列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが処理されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Column (ID 列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行 ID とみなす列の名前。提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回処理されていないことが確認されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_BEGIN​</p>
</li>
<li>
<p>None (なし)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ソースがトランザクションに関して実行できる開始アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NONE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Type (トランザクション種別)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>LOCAL</p>
</li>
<li>
<p>XA</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成するトランザクションの種別。使用できるかどうかは、Runtime バージョンによって決まります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>LOCAL</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Primary Node Only (プライマリノードのみ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クラスターでの実行時にこのソースをプライマリノード上でのみ実行する必要があるかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scheduling Strategy (スケジュール戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>scheduling-strategy</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ポーリングをトリガーするスケジューラーを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Redelivery Policy (再配信ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#RedeliveryPolicy">Redelivery Policy (再配信ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>同じメッセージの再配信を処理するためのポリシー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-12)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-12)次の設定の場合

- [デフォルト設定](#config)

## [](#型)型

### [](#pooling-profile)Pooling Profile (プーリングプロファイル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Pool Size (最大プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最大接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Min Pool Size (最小プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最小接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Acquire Increment (取得増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに一度に取得を試みる接続数を決定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Prepared Statement Cache Size (プリペアードステートメントのキャッシュサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールされた接続ごとにキャッシュされるステートメント数を決定します。これを 0 に設定すると、ステートメントのキャッシュが無効になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait (最大待機)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに、接続の取得を試みているクライアントが接続を待機する時間。この値を 0 (デフォルト) に設定すると、無期限に待機します。これは ​<code>checkoutTimeout</code>​ と同じで、追加プロパティで上書きすることはできません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait Unit (最大待機単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>#maxWait。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>SECONDS</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続が破棄される前に、プールされていて未使用のままでいられる秒数を決定します。この値を 0 (デフォルト) に設定すると、アイドル接続が期限切れになることはありません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Additional Properties (追加プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プーリングプロファイル設定プロパティの名前をキーとするマップ。式の使用はサポートされていません。これらのプロパティを使用して、以前に指定したプロパティ ([Max Pool Size (最大プールサイズ)] や [Min Pool Size (最小プールサイズ)] など) を上書きすることはできません。上書きしようとした場合、メインプロパティが優先されます。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Statement (最大ステートメント)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>DataSource によりキャッシュされる PreparedStatement の合計数を定義します。プールでは、指定された制限に達すると、使用頻度が最も低い PreparedStatement が破棄されます。​<code>0</code>​ に設定すると、ステートメントのキャッシュが無効になります</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Test connection on checkout (チェックアウト時に接続をテスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>チェックアウト時の接続テストを無効にしてパフォーマンスを向上します。​<code>true</code>​ に設定すると、接続のチェックアウトのたびに操作が実行され、接続が有効であることが確認されます。​<code>c3p0.idleConnectionTestPeriod</code>​ を使用して接続を定期的に確認することをお勧めします。パフォーマンスを向上するには、このプロパティを ​<code>false</code>​ に設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ColumnType)Column Type (列の型)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用する型識別子。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Name (型名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用するデータ型の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Class Name (クラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース種別をマップするために使用する必要がある Java クラスを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#Reconnection)Reconnection (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fails Deployment (デプロイメントに失敗)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する再接続戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect)Reconnect (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Count (数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続の試行回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#Tls)TLS

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Enabled Protocols (有効化されたプロトコル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このコンテキストで有効化されたプロトコルのカンマ区切りリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Enabled Cipher Suites (有効化された暗号化スイート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>トラストストア</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TrustStore">トラストストア</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key Store (キーストア)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#KeyStore">Key Store (キーストア)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Revocation Check (取り消し確認)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#standard-revocation-check">Standard Revocation Check (標準の取り消し確認)</a>​</p>
</li>
<li>
<p><a href="#custom-ocsp-responder">Custom Ocsp Responder (カスタム Ocsp レスポンダー)</a>​</p>
</li>
<li>
<p><a href="#crl-file">Crl File (Crl ファイル)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#TrustStore)トラストストア

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Path (パス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トラストストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トラストストアを保護するために使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するストアの型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Algorithm (アルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トラストストアで使用するアルゴリズム。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Insecure (安全ではない)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>true の場合、証明書の検証が実行されず、攻撃に対して接続が脆弱になります。各自の責任で使用してください。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#KeyStore)Key Store (キーストア)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Path (パス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するストアの型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Alias (別名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアに多数の非公開キーがある場合、この属性は、使用する鍵の別名を示します。定義しない場合、デフォルトでファイル内の最初の鍵が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key Password (キーパスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>非公開キーを保護するために使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアを保護するために使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Algorithm (アルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアで使用するアルゴリズム。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#standard-revocation-check)Standard Revocation Check (標準の取り消し確認)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Only End Entities (最後のエンティティのみ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>証明書チェーンの最後の要素のみを確認します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Prefer Crls (CRL を優先)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>最初に OCSP ではなく CRL を試みます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>No Fallback (代替なし)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>第 2 の確認方法 (以前に選択されていない方法) を使用しません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Soft Fail (ソフトフェール)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合に検証エラーを回避します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#custom-ocsp-responder)Custom Ocsp Responder (カスタム Ocsp レスポンダー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Url</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>OCSP レスポンダーの URL。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cert Alias (証明書の別名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>(トラストストアに含まれている) OCSP 応答の署名証明書の別名 (存在する場合)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#crl-file)Crl File (Crl ファイル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Path (パス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>CRL ファイルへのパス。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Time Unit (時間単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>maxIdleTime</code>​ 属性の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Redelivery Count (最大再配信数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プロセス失敗メッセージをトリガーするまでに、正常に処理されないメッセージを再配信できる最大回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use Secure Hash (セキュアハッシュを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用するかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Message Digest Algorithm (メッセージダイジェストアルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するセキュアハッシュアルゴリズム。これが設定されていない場合、デフォルトの SHA-256 になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SHA-256</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Expression (ID 式)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メッセージがいつ再配信されたのかを判断するために使用する 1 つ以上の式を定義します。このプロパティは、​<strong>[Use secure hash (セキュアハッシュを使用)]</strong>​ が ​<code>false</code>​ に設定されている場合にのみ設定できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Object Store (オブジェクトストア)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>オブジェクトストア</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>各メッセージの再配信カウンターが保存されるオブジェクトストア。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ParameterType)Parameter Type (パラメーター種別)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#TypeClassifier)Type Classifier (型分類子)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BIT</p>
</li>
<li>
<p>TINYINT</p>
</li>
<li>
<p>SMALLINT</p>
</li>
<li>
<p>INTEGER</p>
</li>
<li>
<p>BIGINT</p>
</li>
<li>
<p>FLOAT</p>
</li>
<li>
<p>REAL</p>
</li>
<li>
<p>DOUBLE</p>
</li>
<li>
<p>NUMERIC</p>
</li>
<li>
<p>DECIMAL</p>
</li>
<li>
<p>CHAR</p>
</li>
<li>
<p>VARCHAR</p>
</li>
<li>
<p>LONGVARCHAR</p>
</li>
<li>
<p>DATE</p>
</li>
<li>
<p>TIME</p>
</li>
<li>
<p>TIMESTAMP</p>
</li>
<li>
<p>BINARY</p>
</li>
<li>
<p>VARBINARY</p>
</li>
<li>
<p>LONGVARBINARY</p>
</li>
<li>
<p>NULL</p>
</li>
<li>
<p>OTHER</p>
</li>
<li>
<p>JAVA_OBJECT​</p>
</li>
<li>
<p>DISTINCT</p>
</li>
<li>
<p>STRUCT</p>
</li>
<li>
<p>ARRAY</p>
</li>
<li>
<p>BLOB</p>
</li>
<li>
<p>CLOB</p>
</li>
<li>
<p>REF</p>
</li>
<li>
<p>DATALINK</p>
</li>
<li>
<p>BOOLEAN</p>
</li>
<li>
<p>ROWID</p>
</li>
<li>
<p>NCHAR</p>
</li>
<li>
<p>NVARCHAR</p>
</li>
<li>
<p>LONGNVARCHAR</p>
</li>
<li>
<p>NCLOB</p>
</li>
<li>
<p>SQLXML</p>
</li>
<li>
<p>UNKNOWN</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Custom Type (カスタム型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#StatementResult)Statement Result (ステートメント結果)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Affected Rows (影響を受けた行)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Generated Keys (生成されたキー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Objects (メモリ内オブジェクト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メモリに保持するインスタンスの最大数。指定された最大数以上が必要な場合、ディスクでのコンテンツのバッファが開始されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BYTE (バイト)</p>
</li>
<li>
<p>KB</p>
</li>
<li>
<p>MB</p>
</li>
<li>
<p>GB</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>maxInMemorySize で表される単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-stream)Repeatable In Memory Stream (反復可能なメモリ内ストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。
<strong> BYTE (バイト)
</strong> KB
<strong> MB
</strong> GB</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>これらのすべての属性の単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-stream)Repeatable File Store Stream (反復可能なファイルストアストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Size (メモリ内サイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データをメモリ内に保持するためにストリームで使用する最大メモリを定義します。これを超えると、ディスクのコンテンツがバッファされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BYTE (バイト)</p>
</li>
<li>
<p>KB</p>
</li>
<li>
<p>MB</p>
</li>
<li>
<p>GB</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>[Max in Memory Size (最大メモリ内サイズ)]</strong>​ を表す単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#OutputParameter)Output Parameter (出力パラメーター)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=ca46fe5e0b088d3fe22118bcba68f257769f37cac9f071285905df90eac9eab7 url=/mulesoft/current/ja-jp/db-connector/1.13/database-documentation.md -->

# Database Connector リファレンス 1.13

データベース用 Anypoint Connector (Database Connector) を使用すると、JDBC API を介してリレーショナルデータベースに接続できます。

リリースノート: [Database Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/connector-db)

## [](#設定)設定

* * *

### [](#config)デフォルト設定

次のパラメーターを使用して、デフォルト設定を定義します。

#### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定の名前。コネクタはこの名前の設定を参照します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection (接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#config_data-source">Data Source Reference Connection (データソース参照接続)</a>​</p>
</li>
<li>
<p><a href="#config_derby">Derby Connection (Derby 接続)</a>​</p>
</li>
<li>
<p><a href="#config_generic">Generic Connection (汎用接続)</a>​</p>
</li>
<li>
<p><a href="#config_mssql">Microsoft SQL Server Connection (Microsoft SQL Server 接続)</a>​</p>
</li>
<li>
<p><a href="#config_my-sql">MySQL Connection (MySQL 接続)</a>​</p>
</li>
<li>
<p><a href="#config_oracle">Oracle Connection (Oracle 接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定に指定する接続型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Expiration Policy (有効期限ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ExpirationPolicy">Expiration Policy (有効期限ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#接続種別)接続種別

##### [](#config_data-source)データソース参照接続

参照先のデータソースからデータベース接続を作成する接続プロバイダー実装を設定します。  

データソース参照接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。  
たとえば Oracle DB の場合、\[Constant Field Values (定数項目値)\] ページ (セクション oracle.jdbc.OracleTypes) で正しい ID/型の組み合わせを確認します。

###### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Data Source Ref (データソース参照)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Any (任意)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC DataSource オブジェクトへの参照。通常、このオブジェクトは Spring を使用して作成されます。XA トランザクションを使用する場合は、XADataSource オブジェクトを指定する必要があります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_derby)Derby 接続

次のパラメーターを使用して、Derby データベースへの接続を作成します。

###### [](#パラメーター-3)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Subsub Protocol (Subsub プロトコル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Derby がデータベースを検索する場所を指定します。次の使用可能なオプションがあります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>directory</code>​</p>
</li>
<li>
<p><code>memory</code>​</p>
</li>
<li>
<p><code>classpath</code>​</p>
</li>
<li>
<p><code>jar</code></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>directory</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Create (作成)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースが存在しない場合に作成するかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_generic)汎用接続

JDBC URL と必須の JDBC ドライバークラスを使用して任意の種類のデータベースの接続を作成する接続プロバイダーで、次のパラメーターを設定します。  

汎用接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。  
たとえば Oracle DB の場合、\[Constant Field Values (定数項目値)\] ページ (セクション oracle.jdbc.OracleTypes) で正しい ID/型の組み合わせを確認します。

###### [](#パラメーター-4)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>URL</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続に使用する JDBC URL。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Driver Class Name (ドライバークラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースドライバークラスの完全修飾名。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのユーザー名</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_mssql)Microsoft SQL Server 接続

Microsoft SQL Server データベース用のデータベース接続プロバイダー実装で、次のパラメーターを設定します。

###### [](#パラメーター-5)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance Name (インスタンス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのある SQL Server インスタンスの名前を設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database Name (データベース名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するデフォルトデータベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_my-sql)MySQL 接続

MySQL データベースに接続するには、次のパラメーターを設定します。

###### [](#パラメーター-6)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定のカスタムキー - 値 connectionProperties のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_oracle)Oracle 接続

Oracle データベースへの接続を作成するには、次のパラメーターを設定します。

###### [](#パラメーター-7)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>NOT_CONFIGURED</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1521</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance (インスタンス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースインスタンスの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Service Name (サービス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースサービス名の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

## [](#操作)操作

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">操作のクエリ内に SQL 関数を組み込むには、​<code>{fn function()}</code>​ 構文を使用します。これにより、JDBC エスケープコールが構成されます。たとえば、​<code>CURRENT_TIMESTAMP</code>​ を ​<code>{fn CURRENT_TIMESTAMP()}</code>​ として記述する必要があります。</td></tr></tbody></table>

- [Bulk Delete](#bulkDelete)
- [Bulk Insert](#bulkInsert)
- [Bulk Update](#bulkUpdate)
- [Delete](#delete)
- [Execute DDL](#executeDdl)
- [Execute Script](#executeScript)
- [Insert](#insert)
- [Select](#select)
- [Query Single](#querySingle)
- [Stored Procedure](#storedProcedure)
- [Update](#update)

## [](#関連付けられたソース)関連付けられたソース

- [On Table Row](#listener)

### [](#bulkDelete)Bulk Delete

`<db:bulk-delete>`

この操作では、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も削除操作を実行できます。これにより、1 つの削除操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-8)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このパラメーターでは、必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkInsert)Bulk Insert

`<db:bulk-insert>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も挿入を実行できます。これにより、1 つの挿入操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-9)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリスト。各リスト項目が、挿入される行を表します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の TimeUnit。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-2)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-2)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-2)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkUpdate)Bulk Update

`<db:bulk-update>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も更新を実行できます。これにより、1 つの更新操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-10)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-3)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-3)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-3)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#delete)Delete

`<db:delete>`

この操作は、データベースのデータを削除します。

#### [](#パラメーター-11)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: <code>where id = :myParamName</code>​)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-4)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-4)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-4)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeDdl)Execute DDL

`<db:execute-ddl>`

この操作は、データベースに対して DDL クエリを実行できます。

#### [](#パラメーター-12)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-5)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-5)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-5)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeScript)Execute Script

`<db:execute-script>`

この操作は、1 つのデータベースステートメントで SQL スクリプトを実行します。スクリプトはユーザーから提供された場合、パラメーターバインドなしで実行されます。

#### [](#パラメーター-13)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Script Path (スクリプトパス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>読み込むファイルの場所を指定します。ファイルはクラスパスまたはディスク上のリソースを参照できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-6)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-6)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-6)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#insert)Insert

`<db:insert>`

この操作は、データベースにデータを挿入します。

#### [](#パラメーター-14)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-7)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-7)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-7)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#select)Select

`<db:select>`

この操作は、データベースからデータを照会します。すべての結果が一度に読み込まれることでパフォーマンスとメモリの問題が発生することを防止するため、結果は自動的にストリーミングされます。つまり、必要に応じて ​_fetchSize_​ 行分のページが読み込まれます。この操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

ただし、一部のドライバーはクエリの実行時に結果全体を読み込むため、ストリーミングは機能しません。たとえば、Postgres ドライバーは結果全体をメモリに読み込む場合があります。

#### [](#パラメーター-15)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-8)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Object (オブジェクトの配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-8)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用)プーリングプロファイルの使用

プーリングプロファイルと ​**Select**​ 操作を使用する場合、次のいずれかが発生するまで接続は開いたままです。

- フローの実行が終了する
- ストリームのコンテンツが完全にコンシュームされる
- 接続がトランザクションキーである。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">LOB はストリームとみなされるため、フローの実行が終了するか、フローの完了前にコンテンツがコンシュームされるまで、接続は開いたままになります。この場合、関連する接続を閉じるための最良の方法が実行されます。</td></tr></tbody></table>

この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

#### [](#スロー-8)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#querySingle)Query Single

`<db:query-single>`

この操作は、データベースレコードから 1 つのデータレコードを選択します。複数の行を返す SQL クエリを指定した場合、最初のレコードのみが処理されて返されます。この操作ではストリーミングは使用されません。つまり、Query Single 操作の実行直後に、選択したレコードの完全なコンテンツがメモリに読み込まれます。

#### [](#パラメーター-16)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を評価する式。式の結果は対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-9)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-9)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-2)プーリングプロファイルの使用

プーリングプロファイルと Query Single 操作を使用する場合、接続は操作の実行直後にプールに返されます。

#### [](#スロー-9)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#storedProcedure)Stored Procedure

`<db:stored-procedure>`

データベースでストアドプロシージャーを呼び出します。 ストアドプロシージャーが 1 つ以上の ResultSet インスタンスを返した場合、結果はすべて一度には読み込まれません。パフォーマンスとメモリの問題が発生することを防止するため、結果は自動的にストリーミングされます。この動作は、​`_fetchSize_`​ 行分のページが必要に応じて遅延して読み込まれることを意味します。​**Stored Procedure**​ 操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

#### [](#パラメーター-17)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input - Output Parameters (入力 - 出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する、入力と出力の両方のパラメーターの名前をキーとするマップ。  SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Output Parameters (出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#OutputParameter">Output Parameter (出力パラメーター)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する出力パラメーターのリスト。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: call multiply(:value, :result))。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-10)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-10)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-3)プーリングプロファイルの使用

プーリングプロファイルと ​**Stored procedure**​ 操作を使用する場合、フローの実行が終了するか、ストリームのコンテンツが完全にコンシュームされるまで接続は開いたままになります。また、接続がトランザクションキーの場合も同様です。この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

Database Connector 1.8.3 以降、​**Stored procedure**​ 操作の接続は、ストリームまたはトランザクションに含まれていない場合に解放されます。

#### [](#スロー-10)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

### [](#update)Update

`<db:update>`

データベースのデータを更新します。

#### [](#パラメーター-18)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-11)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-11)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-11)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

## [](#sources-ソース)Sources (ソース)

### [](#listener)On Table Row

`<db:listener>`

この操作は、一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成します。 必要に応じて、ウォーターマークおよび ID 列を提供できます。ウォーターマーク列を提供した場合、その列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが返されます。ID 列を提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回選択されていないことが自動的に確認されます。

この操作ではストリーミングはサポートされません。つまり、操作結果にアクセスするためにペイロードへの変換をさらに実行する必要はありません。この動作は、バージョン 1.9 でリリースされた ​**Query Single**​ 操作と同じです。

Database Connector 1.13 では、​**\[Max rows (最大行数)\]**​ 項目の値が無視されるため、​**\[Fetch size (フェッチサイズ)\]**​ 項目がストリーミングに依存していても、このソースで \[Fetch size (フェッチサイズ)\] 項目を使用できます。次の Database Connector バージョンでは、このソースの ​**\[Fetch size (フェッチサイズ)\]**​ 項目が削除され、代わりにソースで正しい ​**\[Max rows (最大行数)\]**​ 項目が使用されます。

#### [](#パラメーター-19)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Table (テーブル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>選択元のテーブルの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Watermark Column (ウォーターマーク列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ウォーターマークに使用する列の名前。この列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが処理されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Column (ID 列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行 ID とみなす列の名前。提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回処理されていないことが確認されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_BEGIN​</p>
</li>
<li>
<p>None (なし)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ソースがトランザクションに関して実行できる開始アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NONE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Type (トランザクション種別)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>LOCAL</p>
</li>
<li>
<p>XA</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成するトランザクションの種別。使用できるかどうかは、Runtime バージョンによって決まります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>LOCAL</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Primary Node Only (プライマリノードのみ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クラスターでの実行時にこのソースをプライマリノード上でのみ実行する必要があるかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scheduling Strategy (スケジュール戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>scheduling-strategy</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ポーリングをトリガーするスケジューラーを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Redelivery Policy (再配信ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#RedeliveryPolicy">Redelivery Policy (再配信ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>同じメッセージの再配信を処理するためのポリシー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-12)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-12)次の設定の場合

- [デフォルト設定](#config)

## [](#型)型

### [](#pooling-profile)Pooling Profile (プーリングプロファイル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Pool Size (最大プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最大接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Min Pool Size (最小プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最小接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Acquire Increment (取得増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに一度に取得を試みる接続数を決定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Prepared Statement Cache Size (プリペアードステートメントのキャッシュサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールされた接続ごとにキャッシュされるステートメント数を決定します。これを 0 に設定すると、ステートメントのキャッシュが無効になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait (最大待機)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに、接続の取得を試みているクライアントが接続を待機する時間。この値を 0 (デフォルト) に設定すると、無期限に待機します。これは ​<code>checkoutTimeout</code>​ と同じで、追加プロパティで上書きすることはできません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait Unit (最大待機単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>#maxWait。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>SECONDS</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続が破棄される前に、プールされていて未使用のままでいられる秒数を決定します。この値を 0 (デフォルト) に設定すると、アイドル接続が期限切れになることはありません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Additional Properties (追加プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プーリングプロファイル設定プロパティの名前をキーとするマップ。式の使用はサポートされていません。これらのプロパティを使用して、以前に指定したプロパティ ([Max Pool Size (最大プールサイズ)] や [Min Pool Size (最小プールサイズ)] など) を上書きすることはできません。上書きしようとした場合、メインプロパティが優先されます。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Statement (最大ステートメント)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>DataSource によりキャッシュされる PreparedStatement の合計数を定義します。プールでは、指定された制限に達すると、使用頻度が最も低い PreparedStatement が破棄されます。​<code>0</code>​ に設定すると、ステートメントのキャッシュが無効になります</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Test connection on checkout (チェックアウト時に接続をテスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>チェックアウト時の接続テストを無効にしてパフォーマンスを向上します。​<code>true</code>​ に設定すると、接続のチェックアウトのたびに操作が実行され、接続が有効であることが確認されます。​<code>c3p0.idleConnectionTestPeriod</code>​ を使用して接続を定期的に確認することをお勧めします。パフォーマンスを向上するには、このプロパティを ​<code>false</code>​ に設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ColumnType)Column Type (列の型)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用する型識別子。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Name (型名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用するデータ型の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Class Name (クラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース種別をマップするために使用する必要がある Java クラスを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#Reconnection)Reconnection (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fails Deployment (デプロイメントに失敗)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する再接続戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect)Reconnect (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Count (数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続の試行回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#Tls)TLS

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Enabled Protocols (有効化されたプロトコル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このコンテキストで有効化されたプロトコルのカンマ区切りリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Enabled Cipher Suites (有効化された暗号化スイート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Trust Store (トラストストア)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TrustStore">トラストストア</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key Store (キーストア)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#KeyStore">Key Store (キーストア)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Revocation Check (取り消し確認)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#standard-revocation-check">Standard Revocation Check (標準の取り消し確認)</a>​</p>
</li>
<li>
<p><a href="#custom-ocsp-responder">Custom Ocsp Responder (カスタム Ocsp レスポンダー)</a>​</p>
</li>
<li>
<p><a href="#crl-file">Crl File (Crl ファイル)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#TrustStore)トラストストア

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Path (パス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トラストストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トラストストアを保護するために使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するストアの型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Algorithm (アルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トラストストアで使用するアルゴリズム。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Insecure (安全ではない)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>true の場合、証明書の検証が実行されず、攻撃に対して接続が脆弱になります。各自の責任で使用してください。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#KeyStore)Key Store (キーストア)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Path (パス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するストアの型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Alias (別名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアに多数の非公開キーがある場合、この属性は、使用する鍵の別名を示します。定義しない場合、デフォルトでファイル内の最初の鍵が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key Password (キーパスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>非公開キーを保護するために使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアを保護するために使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Algorithm (アルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアで使用するアルゴリズム。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#standard-revocation-check)Standard Revocation Check (標準の取り消し確認)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Only End Entities (最後のエンティティのみ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>証明書チェーンの最後の要素のみを確認します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Prefer Crls (CRL を優先)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>最初に OCSP ではなく CRL を試みます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>No Fallback (代替なし)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>第 2 の確認方法 (以前に選択されていない方法) を使用しません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Soft Fail (ソフトフェール)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合に検証エラーを回避します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#custom-ocsp-responder)Custom Ocsp Responder (カスタム Ocsp レスポンダー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Url</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>OCSP レスポンダーの URL。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cert Alias (証明書の別名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>(トラストストアに含まれている) OCSP 応答の署名証明書の別名 (存在する場合)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#crl-file)Crl File (Crl ファイル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Path (パス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>CRL ファイルへのパス。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Time Unit (時間単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS (ナノ秒)</p>
</li>
<li>
<p>MICROSECONDS (マイクロ秒)</p>
</li>
<li>
<p>MILLISECONDS (ミリ秒)</p>
</li>
<li>
<p>SECONDS (秒)</p>
</li>
<li>
<p>MINUTES (分)</p>
</li>
<li>
<p>HOURS (時間)</p>
</li>
<li>
<p>DAYS (日)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>maxIdleTime</code>​ 属性の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Redelivery Count (最大再配信数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プロセス失敗メッセージをトリガーするまでに、正常に処理されないメッセージを再配信できる最大回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use Secure Hash (セキュアハッシュを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用するかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Message Digest Algorithm (メッセージダイジェストアルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するセキュアハッシュアルゴリズム。これが設定されていない場合、デフォルトの SHA-256 になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SHA-256</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Expression (ID 式)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メッセージがいつ再配信されたのかを判断するために使用する 1 つ以上の式を定義します。このプロパティは、​<strong>[Use secure hash (セキュアハッシュを使用)]</strong>​ が ​<code>false</code>​ に設定されている場合にのみ設定できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Object Store (オブジェクトストア)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object Store (オブジェクトストア)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>各メッセージの再配信カウンターが保存されるオブジェクトストア。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ParameterType)Parameter Type (パラメーター種別)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#TypeClassifier)Type Classifier (型分類子)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BIT</p>
</li>
<li>
<p>TINYINT</p>
</li>
<li>
<p>SMALLINT</p>
</li>
<li>
<p>INTEGER</p>
</li>
<li>
<p>BIGINT</p>
</li>
<li>
<p>FLOAT</p>
</li>
<li>
<p>REAL</p>
</li>
<li>
<p>DOUBLE</p>
</li>
<li>
<p>NUMERIC</p>
</li>
<li>
<p>DECIMAL</p>
</li>
<li>
<p>CHAR</p>
</li>
<li>
<p>VARCHAR</p>
</li>
<li>
<p>LONGVARCHAR</p>
</li>
<li>
<p>DATE</p>
</li>
<li>
<p>TIME</p>
</li>
<li>
<p>TIMESTAMP</p>
</li>
<li>
<p>BINARY</p>
</li>
<li>
<p>VARBINARY</p>
</li>
<li>
<p>LONGVARBINARY</p>
</li>
<li>
<p>NULL</p>
</li>
<li>
<p>OTHER</p>
</li>
<li>
<p>JAVA_OBJECT​</p>
</li>
<li>
<p>DISTINCT</p>
</li>
<li>
<p>STRUCT</p>
</li>
<li>
<p>ARRAY</p>
</li>
<li>
<p>BLOB</p>
</li>
<li>
<p>CLOB</p>
</li>
<li>
<p>REF</p>
</li>
<li>
<p>DATALINK</p>
</li>
<li>
<p>BOOLEAN</p>
</li>
<li>
<p>ROWID</p>
</li>
<li>
<p>NCHAR</p>
</li>
<li>
<p>NVARCHAR</p>
</li>
<li>
<p>LONGNVARCHAR</p>
</li>
<li>
<p>NCLOB</p>
</li>
<li>
<p>SQLXML</p>
</li>
<li>
<p>UNKNOWN</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Custom Type (カスタム型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#StatementResult)Statement Result (ステートメント結果)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Affected Rows (影響を受けた行)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Generated Keys (生成されたキー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Objects (メモリ内オブジェクト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メモリに保持するインスタンスの最大数。指定された最大数以上が必要な場合、ディスクでのコンテンツのバッファが開始されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BYTE (バイト)</p>
</li>
<li>
<p>KB</p>
</li>
<li>
<p>MB</p>
</li>
<li>
<p>GB</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>maxInMemorySize で表される単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-stream)Repeatable In Memory Stream (反復可能なメモリ内ストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。
<strong> BYTE (バイト)
</strong> KB
<strong> MB
</strong> GB</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>これらのすべての属性の単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-stream)Repeatable File Store Stream (反復可能なファイルストアストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Size (メモリ内サイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データをメモリ内に保持するためにストリームで使用する最大メモリを定義します。これを超えると、ディスクのコンテンツがバッファされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BYTE (バイト)</p>
</li>
<li>
<p>KB</p>
</li>
<li>
<p>MB</p>
</li>
<li>
<p>GB</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>[Max in Memory Size (最大メモリ内サイズ)]</strong>​ を表す単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#OutputParameter)Output Parameter (出力パラメーター)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=548ef3c5f055e0f463648433d8f3388c1e65668a128af696e903599dae384d6c url=/mulesoft/current/ja-jp/db-connector/1.14/database-documentation.md -->

# Database Connector リファレンス 1.14

データベース用 Anypoint Connector (Database Connector) を使用すると、JDBC API を介してリレーショナルデータベースに接続できます。

リリースノート: [Database Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/connector-db)

## [](#設定)設定

* * *

### [](#config)デフォルト設定

次のパラメーターを使用して、デフォルト設定を定義します。

#### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定の名前。コネクタはこの名前の設定を参照します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection (接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#config_data-source">Data Source Reference Connection (データソース参照接続)</a>​</p>
</li>
<li>
<p><a href="#config_derby">Derby Connection (Derby 接続)</a>​</p>
</li>
<li>
<p><a href="#config_generic">Generic Connection (汎用接続)</a>​</p>
</li>
<li>
<p><a href="#config_mssql">Microsoft SQL Server Connection (Microsoft SQL Server 接続)</a>​</p>
</li>
<li>
<p><a href="#config_my-sql">MySQL Connection (MySQL 接続)</a>​</p>
</li>
<li>
<p><a href="#config_oracle">Oracle Connection (Oracle 接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定に指定する接続型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Expiration Policy (有効期限ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ExpirationPolicy">Expiration Policy (有効期限ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#接続種別)接続種別

##### [](#config_data-source)データソース参照接続

参照先のデータソースからデータベース接続を作成する接続プロバイダー実装を設定します。

データソース参照接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。

###### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Data Source Ref (データソース参照)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Any (任意)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC DataSource オブジェクトへの参照。このオブジェクトは通常、Spring を使用して作成されます。XA トランザクションを使用する場合は、XADataSource オブジェクトを指定する必要があります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_derby)Derby 接続

次のパラメーターを使用して、Derby データベースへの接続を作成します。

###### [](#パラメーター-3)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cache Query Template Size (キャッシュクエリテンプレートサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続のキャッシュクエリテンプレートサイズを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>50</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Subsub Protocol (Subsub プロトコル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Derby がデータベースを検索する場所を指定します。次の使用可能なオプションがあります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>directory</code>​</p>
</li>
<li>
<p><code>memory</code>​</p>
</li>
<li>
<p><code>classpath</code>​</p>
</li>
<li>
<p><code>jar</code></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>directory</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Create (作成)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースが存在しない場合に作成するかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_generic)汎用接続

JDBC URL と必須の JDBC ドライバークラスを使用して任意の種類のデータベースの接続を作成する接続プロバイダーで、次のパラメーターを設定します。

汎用接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。

###### [](#パラメーター-4)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cache Query Template Size (キャッシュクエリテンプレートサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続のキャッシュクエリテンプレートサイズを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>50</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>URL</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続に使用する JDBC URL。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Driver Class Name (ドライバークラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースドライバークラスの完全修飾名。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのユーザー名</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_mssql)Microsoft SQL Server 接続

Microsoft SQL Server データベース用のデータベース接続プロバイダー実装で、次のパラメーターを設定します。

###### [](#パラメーター-5)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cache Query Template Size (キャッシュクエリテンプレートサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続のキャッシュクエリテンプレートサイズを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>50</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance Name (インスタンス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのある SQL Server インスタンスの名前を設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database Name (データベース名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するデフォルトデータベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_my-sql)MySQL 接続

MySQL データベースに接続するには、次のパラメーターを設定します。

###### [](#パラメーター-6)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cache Query Template Size (キャッシュクエリテンプレートサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続のキャッシュクエリテンプレートサイズを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>50</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定のカスタムキー - 値 connectionProperties のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_oracle)Oracle 接続

Oracle データベースへの接続を作成するには、次のパラメーターを設定します。

###### [](#パラメーター-7)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cache Query Template Size (キャッシュクエリテンプレートサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続のキャッシュクエリテンプレートサイズを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>50</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>NOT_CONFIGURED</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1521</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance (インスタンス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースインスタンスの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Service Name (サービス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースサービス名の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

## [](#操作)操作

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">操作のクエリ内に SQL 関数を組み込むには、​<code>{fn function()}</code>​ 構文を使用します。これにより、JDBC エスケープコールが構成されます。たとえば、​<code>CURRENT_TIMESTAMP</code>​ を ​<code>{fn CURRENT_TIMESTAMP()}</code>​ として記述する必要があります。</td></tr></tbody></table>

- [Bulk Delete](#bulkDelete)
- [Bulk Insert](#bulkInsert)
- [Bulk Update](#bulkUpdate)
- [Delete](#delete)
- [Execute DDL](#executeDdl)
- [Execute Script](#executeScript)
- [Insert](#insert)
- [Select](#select)
- [Query Single](#querySingle)
- [Stored Procedure](#storedProcedure)
- [Update](#update)

## [](#関連付けられたソース)関連付けられたソース

- [On Table Row](#listener)

### [](#bulkDelete)Bulk Delete

`<db:bulk-delete>`

この操作では、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も削除操作を実行できます。これにより、1 つの削除操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-8)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong><a id="query-timeout"></a>
Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このパラメーターでは、必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkInsert)Bulk Insert

`<db:bulk-insert>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も挿入を実行できます。これにより、1 つの挿入操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-9)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリスト。各リスト項目が、挿入される行を表します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の TimeUnit。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-2)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-2)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-2)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkUpdate)Bulk Update

`<db:bulk-update>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も更新を実行できます。これにより、1 つの更新操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-10)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-3)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-3)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-3)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#delete)Delete

`<db:delete>`

この操作は、データベースのデータを削除します。

#### [](#パラメーター-11)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: <code>where id = :myParamName</code>​)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-4)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-4)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-4)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeDdl)Execute DDL

`<db:execute-ddl>`

この操作は、データベースに対して DDL クエリを実行できます。

#### [](#パラメーター-12)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-5)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-5)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-5)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeScript)Execute Script

`<db:execute-script>`

この操作は、1 つのデータベースステートメントで SQL スクリプトを実行します。スクリプトはユーザーから提供された場合、パラメーターバインドなしで実行されます。

#### [](#パラメーター-13)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Script Path (スクリプトパス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>読み込むファイルの場所を指定します。ファイルはクラスパスまたはディスク上のリソースを参照できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-6)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-6)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-6)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#insert)Insert

`<db:insert>`

この操作は、データベースにデータを挿入します。

#### [](#パラメーター-14)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-7)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-7)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-7)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#select)Select

`<db:select>`

この操作は、データベースからデータを照会します。すべての結果が一度に読み込まれることでパフォーマンスとメモリの問題が発生することを防止するため、結果は自動的にストリーミングされます。つまり、必要に応じて ​_fetchSize_​ 行分のページが読み込まれます。この操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

ただし、一部のドライバーはクエリの実行時に結果全体を読み込むため、ストリーミングは機能しません。たとえば、Postgres ドライバーは結果全体をメモリに読み込む場合があります。

#### [](#パラメーター-15)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-8)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Object (オブジェクトの配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-8)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用)プーリングプロファイルの使用

プーリングプロファイルと ​**Select**​ 操作を使用する場合、次のいずれかが発生するまで接続は開いたままです。

- フローの実行が終了する
- ストリームのコンテンツが完全にコンシュームされる
- 接続がトランザクションキーである。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">LOB はストリームとみなされるため、フローの実行が終了するか、フローの完了前にコンテンツがコンシュームされるまで、接続は開いたままになります。この場合、関連する接続を閉じるための最良の方法が実行されます。</td></tr></tbody></table>

この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

#### [](#スロー-8)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#querySingle)Query Single

`<db:query-single>`

この操作は、データベースレコードから 1 つのデータレコードを選択します。複数の行を返す SQL クエリを指定した場合、最初のレコードのみが処理されて返されます。この操作ではストリーミングは使用されません。つまり、Query Single 操作の実行直後に、選択したレコードの完全なコンテンツがメモリに読み込まれます。

#### [](#パラメーター-16)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を評価する式。式の結果は対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-9)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-9)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-2)プーリングプロファイルの使用

プーリングプロファイルと Query Single 操作を使用する場合、接続は操作の実行直後にプールに返されます。

#### [](#スロー-9)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#storedProcedure)Stored Procedure

`<db:stored-procedure>`

データベースでストアドプロシージャーを呼び出します。ストアドプロシージャーが 1 つ以上の ResultSet インスタンスを返した場合、結果はすべて一度には読み込まれません。パフォーマンスとメモリの問題が発生することを防止するため、結果は自動的にストリーミングされます。この動作は、​`_fetchSize_`​ 行分のページが必要に応じて遅延して読み込まれることを意味します。​**Stored Procedure**​ 操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

#### [](#パラメーター-17)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input - Output Parameters (入力 - 出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する、入力と出力の両方のパラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Output Parameters (出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#OutputParameter">Output Parameter (出力パラメーター)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する出力パラメーターのリスト。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: call multiply(:value, :result))。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-10)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-10)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-3)プーリングプロファイルの使用

プーリングプロファイルと ​**Stored procedure**​ 操作を使用する場合、フローの実行が終了するか、ストリームのコンテンツが完全にコンシュームされるまで接続は開いたままになります。また、接続がトランザクションキーの場合も同様です。この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

Database Connector 1.8.3 以降、​**Stored procedure**​ 操作の接続は、ストリームまたはトランザクションに含まれていない場合に解放されます。

#### [](#スロー-10)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

### [](#update)Update

`<db:update>`

データベースのデータを更新します。

#### [](#パラメーター-18)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>入力パラメーター</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-11)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-11)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-11)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

## [](#ソース)ソース

### [](#listener)On Table Row

`<db:listener>`

この操作は、一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成します。必要に応じて、ウォーターマークおよび ID 列を提供できます。ウォーターマーク列を提供した場合、その列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが返されます。ID 列を提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回選択されていないことが自動的に確認されます。

この操作ではストリーミングはサポートされません。つまり、操作結果にアクセスするためにペイロードへの変換をさらに実行する必要はありません。この動作は、バージョン 1.9 でリリースされた ​**Query Single**​ 操作と同じです。

#### [](#パラメーター-19)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Table (テーブル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>選択元のテーブルの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Watermark Column (ウォーターマーク列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ウォーターマークに使用する列の名前。この列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが処理されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Column (ID 列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行 ID とみなす列の名前。提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回処理されていないことが確認されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_BEGIN​</p>
</li>
<li>
<p>None (なし)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ソースがトランザクションに関して実行できる開始アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NONE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Type (トランザクション種別)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>LOCAL</p>
</li>
<li>
<p>XA</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成するトランザクションの種別。使用できるかどうかは、Runtime バージョンによって決まります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>LOCAL</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Primary Node Only (プライマリノードのみ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クラスターでの実行時にこのソースをプライマリノード上でのみ実行する必要があるかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scheduling Strategy (スケジュール戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>scheduling-strategy</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ポーリングをトリガーするスケジューラーを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Redelivery Policy (再配信ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#RedeliveryPolicy">Redelivery Policy (再配信ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>同じメッセージの再配信を処理するためのポリシー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。ナノ秒、マイクロ秒、ミリ秒で指定されている値は、秒に丸められます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>10</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-12)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-12)次の設定の場合

- [デフォルト設定](#config)

## [](#型)型

### [](#pooling-profile)Pooling Profile (プーリングプロファイル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Pool Size (最大プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最大接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Min Pool Size (最小プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最小接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Acquire Increment (取得増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに一度に取得を試みる接続数を決定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Prepared Statement Cache Size (プリペアードステートメントのキャッシュサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールされた接続ごとにキャッシュされるステートメント数を決定します。これを 0 に設定すると、ステートメントのキャッシュが無効になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait (最大待機)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに、接続の取得を試みているクライアントが接続を待機する時間。この値を 0 (デフォルト) に設定すると、無期限に待機します。これは ​<code>checkoutTimeout</code>​ と同じで、追加プロパティで上書きすることはできません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait Unit (最大待機単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>#maxWait。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>SECONDS</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続が破棄される前に、プールされていて未使用のままでいられる秒数を決定します。この値を 0 (デフォルト) に設定すると、アイドル接続が期限切れになることはありません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Additional Properties (追加プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プーリングプロファイル設定プロパティの名前をキーとするマップ。式の使用はサポートされていません。これらのプロパティを使用して、以前に指定したプロパティ ([Max Pool Size (最大プールサイズ)] や [Min Pool Size (最小プールサイズ)] など) を上書きすることはできません。上書きしようとした場合、メインプロパティが優先されます。マップの値には、各パラメーターの実際の割り当てが含まれます。この項目を使用して、その他の接続プールプロパティを追加します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Statement (最大ステートメント)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>DataSource によりキャッシュされる PreparedStatement の合計数を定義します。プールでは、指定された制限に達すると、使用頻度が最も低い PreparedStatement が破棄されます。​<code>0</code>​ に設定すると、ステートメントのキャッシュが無効になります</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Test connection on checkout (チェックアウト時に接続をテスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>チェックアウト時の接続テストを無効にしてパフォーマンスを向上します。​<code>true</code>​ に設定すると、接続のチェックアウトのたびに操作が実行され、接続が有効であることが確認されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ColumnType)Column Type (列の型)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用する型識別子。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Name (型名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用するデータ型の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Class Name (クラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース種別をマップするために使用する必要がある Java クラスを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#Reconnection)Reconnection (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fails Deployment (デプロイメントに失敗)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する再接続戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect)Reconnect (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Count (数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続の試行回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#Tls)TLS

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Enabled Protocols (有効化されたプロトコル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このコンテキストで有効化されたプロトコルのカンマ区切りリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Enabled Cipher Suites (有効化された暗号化スイート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>トラストストア</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TrustStore">トラストストア</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key Store (キーストア)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#KeyStore">Key Store (キーストア)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Revocation Check (取り消し確認)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#standard-revocation-check">Standard Revocation Check (標準の取り消し確認)</a>​</p>
</li>
<li>
<p><a href="#custom-ocsp-responder">Custom Ocsp Responder (カスタム Ocsp レスポンダー)</a>​</p>
</li>
<li>
<p><a href="#crl-file">Crl File (Crl ファイル)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#TrustStore)トラストストア

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Path (パス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トラストストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トラストストアを保護するために使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するストアの型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Algorithm (アルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トラストストアで使用するアルゴリズム。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Insecure (安全ではない)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>true の場合、証明書の検証が実行されず、攻撃に対して接続が脆弱になります。各自の責任で使用してください。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#KeyStore)Key Store (キーストア)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Path (パス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するストアの型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Alias (別名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアに多数の非公開キーがある場合、この属性は、使用する鍵の別名を示します。定義しない場合、デフォルトでファイル内の最初の鍵が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key Password (キーパスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>非公開キーを保護するために使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアを保護するために使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Algorithm (アルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>キーストアで使用するアルゴリズム。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#standard-revocation-check)Standard Revocation Check (標準の取り消し確認)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Only End Entities (最後のエンティティのみ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>証明書チェーンの最後の要素のみを確認します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Prefer Crls (CRL を優先)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>最初に OCSP ではなく CRL を試みます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>No Fallback (代替なし)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>第 2 の確認方法 (以前に選択されていない方法) を使用しません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Soft Fail (ソフトフェール)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合に検証エラーを回避します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#custom-ocsp-responder)Custom Ocsp Responder (カスタム Ocsp レスポンダー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Url</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>OCSP レスポンダーの URL。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cert Alias (証明書の別名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>(トラストストアに含まれている) OCSP 応答の署名証明書の別名 (存在する場合)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#crl-file)Crl File (Crl ファイル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Path (パス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>CRL ファイルへのパス。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Time Unit (時間単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>maxIdleTime</code>​ 属性の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Redelivery Count (最大再配信数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プロセス失敗メッセージをトリガーするまでに、正常に処理されないメッセージを再配信できる最大回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use Secure Hash (セキュアハッシュを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用するかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Message Digest Algorithm (メッセージダイジェストアルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するセキュアハッシュアルゴリズム。これが設定されていない場合、デフォルトの SHA-256 になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SHA-256</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Expression (ID 式)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メッセージがいつ再配信されたのかを判断するために使用する 1 つ以上の式を定義します。このプロパティは、​<strong>[Use secure hash (セキュアハッシュを使用)]</strong>​ が ​<code>false</code>​ に設定されている場合にのみ設定できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Object Store (オブジェクトストア)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>オブジェクトストア</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>各メッセージの再配信カウンターが保存されるオブジェクトストア。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ParameterType)Parameter Type (パラメーター種別)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#TypeClassifier)Type Classifier (型分類子)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BIT</p>
</li>
<li>
<p>TINYINT</p>
</li>
<li>
<p>SMALLINT</p>
</li>
<li>
<p>INTEGER</p>
</li>
<li>
<p>BIGINT</p>
</li>
<li>
<p>FLOAT</p>
</li>
<li>
<p>REAL</p>
</li>
<li>
<p>DOUBLE</p>
</li>
<li>
<p>NUMERIC</p>
</li>
<li>
<p>DECIMAL</p>
</li>
<li>
<p>CHAR</p>
</li>
<li>
<p>VARCHAR</p>
</li>
<li>
<p>LONGVARCHAR</p>
</li>
<li>
<p>DATE</p>
</li>
<li>
<p>TIME</p>
</li>
<li>
<p>TIMESTAMP</p>
</li>
<li>
<p>BINARY</p>
</li>
<li>
<p>VARBINARY</p>
</li>
<li>
<p>LONGVARBINARY</p>
</li>
<li>
<p>NULL</p>
</li>
<li>
<p>OTHER</p>
</li>
<li>
<p>JAVA_OBJECT​</p>
</li>
<li>
<p>DISTINCT</p>
</li>
<li>
<p>STRUCT</p>
</li>
<li>
<p>ARRAY</p>
</li>
<li>
<p>BLOB</p>
</li>
<li>
<p>CLOB</p>
</li>
<li>
<p>REF</p>
</li>
<li>
<p>DATALINK</p>
</li>
<li>
<p>BOOLEAN</p>
</li>
<li>
<p>ROWID</p>
</li>
<li>
<p>NCHAR</p>
</li>
<li>
<p>NVARCHAR</p>
</li>
<li>
<p>LONGNVARCHAR</p>
</li>
<li>
<p>NCLOB</p>
</li>
<li>
<p>SQLXML</p>
</li>
<li>
<p>UNKNOWN</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Custom Type (カスタム型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#StatementResult)Statement Result (ステートメント結果)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Affected Rows (影響を受けた行)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Generated Keys (生成されたキー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Objects (メモリ内オブジェクト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メモリに保持するインスタンスの最大数。指定された最大数以上が必要な場合、ディスクでのコンテンツのバッファが開始されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BYTE (バイト)</p>
</li>
<li>
<p>KB</p>
</li>
<li>
<p>MB</p>
</li>
<li>
<p>GB</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>maxInMemorySize で表される単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-stream)Repeatable In Memory Stream (反復可能なメモリ内ストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。
<strong> BYTE (バイト)
</strong> KB
<strong> MB
</strong> GB</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>これらのすべての属性の単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-stream)Repeatable File Store Stream (反復可能なファイルストアストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Size (メモリ内サイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データをメモリ内に保持するためにストリームで使用する最大メモリを定義します。これを超えると、ディスクのコンテンツがバッファされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BYTE (バイト)</p>
</li>
<li>
<p>KB</p>
</li>
<li>
<p>MB</p>
</li>
<li>
<p>GB</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>[Max in Memory Size (最大メモリ内サイズ)]</strong>​ を表す単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#OutputParameter)Output Parameter (出力パラメーター)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#システムプロパティ)システムプロパティ

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">プロパティ</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">例</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mule.db.commons.defaultParamTypeResolver.enable.fallback</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">このシステムプロパティではストアドプロシージャー名内の特殊文字が処理されるため、これらの文字が存在する場合の代替設定方法が提供されます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>-M-Dmule.db.commons.defaultParamTypeResolver.enable.fallback=true</code></p></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=46726e829674fdf11cd419d8783cc3e30673416a0013056811dba6fd10247e81 url=/mulesoft/current/ja-jp/db-connector/1.9/database-documentation.md -->

# Database Connector リファレンス 1.9

データベース用 Anypoint Connector (Database Connector) を使用すると、JDBC API を介してリレーショナルデータベースに接続できます。

リリースノート: [Database Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/connector-db)

## [](#設定)設定

* * *

### [](#config)デフォルト設定

次のパラメーターを使用して、デフォルト設定を定義します。

#### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定の名前。コネクタはこの名前の設定を参照します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection (接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#config_data-source">Data Source Reference Connection (データソース参照接続)</a>​</p>
</li>
<li>
<p><a href="#config_derby">Derby Connection (Derby 接続)</a>​</p>
</li>
<li>
<p><a href="#config_generic">Generic Connection (汎用接続)</a>​</p>
</li>
<li>
<p><a href="#config_mssql">Microsoft SQL Server Connection (Microsoft SQL Server 接続)</a>​</p>
</li>
<li>
<p><a href="#config_my-sql">MySQL Connection (MySQL 接続)</a>​</p>
</li>
<li>
<p><a href="#config_oracle">Oracle Connection (Oracle 接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定に指定する接続型。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Expiration Policy (有効期限ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ExpirationPolicy">Expiration Policy (有効期限ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#接続種別)接続種別

##### [](#config_data-source)データソース参照接続

参照先のデータソースからデータベース接続を作成する接続プロバイダー実装を設定します。  

データソース参照接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。  
たとえば Oracle DB の場合、\[Constant Field Values (定数項目値)\] ページ (セクション oracle.jdbc.OracleTypes) で正しい ID/型の組み合わせを確認します。

###### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Data Source Ref (データソース参照)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Any (任意)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC DataSource オブジェクトへの参照。通常、このオブジェクトは Spring を使用して作成されます。XA トランザクションを使用する場合は、XADataSource オブジェクトを指定する必要があります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_derby)Derby 接続

次のパラメーターを使用して、Derby データベースへの接続を作成します。

###### [](#パラメーター-3)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Subsub Protocol (Subsub プロトコル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Derby がデータベースを検索する場所を指定します。次の使用可能なオプションがあります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>directory</code>​</p>
</li>
<li>
<p><code>memory</code>​</p>
</li>
<li>
<p><code>classpath</code>​</p>
</li>
<li>
<p><code>jar</code></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>directory</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Create (作成)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースが存在しない場合に作成するかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_generic)汎用接続

JDBC URL と必須の JDBC ドライバークラスを使用して任意の種類のデータベースの接続を作成する接続プロバイダーで、次のパラメーターを設定します。  

汎用接続で​_プロバイダーのカスタム型_​を使用する場合は、データベース設定の \[Advanced (詳細)\] セクションの ​**\[Column Types (列の型)\]**​ フォーム内で型を定義します。  
たとえば Oracle DB の場合、\[Constant Field Values (定数項目値)\] ページ (セクション oracle.jdbc.OracleTypes) で正しい ID/型の組み合わせを確認します。

###### [](#パラメーター-4)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>URL</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続に使用する JDBC URL。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Driver Class Name (ドライバークラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースドライバークラスの完全修飾名。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのユーザー名</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_mssql)Microsoft SQL Server 接続

Microsoft SQL Server データベース用のデータベース接続プロバイダー実装で、次のパラメーターを設定します。

###### [](#パラメーター-5)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance Name (インスタンス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのある SQL Server インスタンスの名前を設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database Name (データベース名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するデフォルトデータベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定の接続プロパティのカスタムキー - 値のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_my-sql)MySQL 接続

MySQL データベースに接続するには、次のパラメーターを設定します。

###### [](#パラメーター-6)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NOT_CONFIGURED</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Database (データベース)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connection Properties (接続プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>設定のカスタムキー - 値 connectionProperties のリストを指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

##### [](#config_oracle)Oracle 接続

Oracle データベースへの接続を作成するには、次のパラメーターを設定します。

###### [](#パラメーター-7)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pooling Profile (プーリングプロファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#pooling-profile">Pooling Profile (プーリングプロファイル)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース接続プーリングの設定方法を提供します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Column Types (列の型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ColumnType">Column Type (列の型)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>標準以外の列の型を指定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Isolation (トランザクション分離)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>None (なし)</p>
</li>
<li>
<p>READ_COMMITTED​</p>
</li>
<li>
<p>READ_UNCOMMITTED​</p>
</li>
<li>
<p>REPEATABLE_READ​</p>
</li>
<li>
<p>SERIALIZABLE</p>
</li>
<li>
<p>NOT_CONFIGURED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの接続時にドライバーに対して設定するトランザクション分離レベル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>NOT_CONFIGURED</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use XA Transactions (XA トランザクションを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成したデータソースで XA トランザクションをサポートする必要があるかどうかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Host (ホスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのホストを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port (ポート)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースのポートを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1521</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>ユーザー</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するユーザー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password (パスワード)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースへの認証で使用するパスワード。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instance (インスタンス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースインスタンスの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Service Name (サービス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベースサービス名の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection (再接続)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#Reconnection">Reconnection (再接続)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

## [](#操作)操作

- [Bulk Delete](#bulkDelete)
- [Bulk Insert](#bulkInsert)
- [Bulk Update](#bulkUpdate)
- [Delete](#delete)
- [Execute DDL](#executeDdl)
- [Execute Script](#executeScript)
- [Insert](#insert)
- [Select](#select)
- [Query Single](#querySingle)
- [Stored Procedure](#storedProcedure)
- [Update](#update)

## [](#関連付けられたソース)関連付けられたソース

- [On Table Row](#listener)

### [](#bulkDelete)Bulk Delete

`<db:bulk-delete>`

この操作では、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も削除操作を実行できます。これにより、1 つの削除操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-8)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このパラメーターでは、必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkInsert)Bulk Insert

`<db:bulk-insert>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も挿入を実行できます。これにより、1 つの挿入操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-9)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリスト。各リスト項目が、挿入される行を表します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-2)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-2)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-2)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#bulkUpdate)Bulk Update

`<db:bulk-update>`

この操作は、異なるパラメーターバインドと 1 つのデータベースステートメントを使用して、何度も更新を実行できます。これにより、1 つの更新操作を何度も実行する場合よりもパフォーマンスが向上します。

#### [](#パラメーター-10)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Object (オブジェクトの配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>マップのリストを指定します。マップには、パラメーターのバインド先のキーおよび値としてパラメーター名が含まれ、すべてのリスト項目は挿入する行を表します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-3)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-3)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-3)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#delete)Delete

`<db:delete>`

この操作は、データベースのデータを削除します。

#### [](#パラメーター-11)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。値を指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-4)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-4)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-4)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeDdl)Execute DDL

`<db:execute-ddl>`

この操作は、データベースに対して DDL クエリを実行できます。

#### [](#パラメーター-12)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-5)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number (数値)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-5)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-5)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#executeScript)Execute Script

`<db:execute-script>`

この操作は、1 つのデータベースステートメントで SQL スクリプトを実行します。スクリプトはユーザーから提供された場合、パラメーターバインドなしで実行されます。

#### [](#パラメーター-13)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Script Path (スクリプトパス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>読み込むファイルの場所を指定します。ファイルはクラスパスまたはディスク上のリソースを参照できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-6)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Number (数値の配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-6)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-6)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#insert)Insert

`<db:insert>`

この操作は、データベースにデータを挿入します。

#### [](#パラメーター-14)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-7)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-7)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-7)スロー

- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED
- DB:BAD\_SQL\_SYNTAX

### [](#select)Select

`<db:select>`

この操作は、データベースからデータを選択します。パフォーマンスやメモリの問題につながる可能性のある結果の先制消費を回避するため、ストリーミングが自動的に割り当てられます。

ただし、一部のドライバーはクエリの実行時に結果全体を読み込むため、ストリーミングは機能しません。たとえば、Postgres ドライバーは結果全体をメモリに読み込む場合があります。

#### [](#パラメーター-15)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-8)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Array of Object (オブジェクトの配列)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-8)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用)プーリングプロファイルの使用

プーリングプロファイルと ​**Select**​ 操作を使用する場合、フローの実行が終了するか、ストリームのコンテンツが完全にコンシュームされるまで接続は開いたままになります。また、接続がトランザクションキーの場合も同様です。この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

#### [](#スロー-8)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#querySingle)Query Single

`<db:query-single>`

この操作は、データベースレコードから 1 つのデータレコードを選択します。複数の行を返す SQL クエリを指定した場合、最初のレコードのみが処理されて返されます。この操作ではストリーミングは使用されません。つまり、Query Single 操作の実行直後に、選択したレコードの完全なコンテンツがメモリに読み込まれます。

#### [](#パラメーター-16)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を評価する式。式の結果は対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-9)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-9)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-2)プーリングプロファイルの使用

プーリングプロファイルと Query Single 操作を使用する場合、接続は操作の実行直後にプールに返されます。

#### [](#スロー-9)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION

### [](#storedProcedure)Stored Procedure

`<db:stored-procedure>`

データベースでストアドプロシージャーを呼び出します。 ストアドプロシージャーで 1 つまたは複数の ResultSet インスタンスが返される場合、パフォーマンスやメモリの問題につながる可能性のある結果の先制消費を回避するため、ストリーミングが自動的に割り当てられます。

#### [](#パラメーター-17)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JOIN_IF_POSSIBLE</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Streaming Strategy (ストリーミング戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#repeatable-in-memory-iterable">Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)</a>​</p>
</li>
<li>
<p><a href="#repeatable-file-store-iterable">Repeatable File Store Iterable (反復可能なファイルストアイテラブル)</a>​</p>
</li>
<li>
<p>non-repeatable-iterable</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>反復可能なストリームを使用するように設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトではタイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が resultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが true の場合、このプロパティは必須です。その場合、デフォルト値 (10) が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input - Output Parameters (入力 - 出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する、入力と出力の両方のパラメーターの名前をキーとするマップ。  SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Output Parameters (出力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#OutputParameter">Output Parameter (出力パラメーター)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する出力パラメーターのリスト。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: call multiply(:value, :result))。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-10)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-10)次の設定の場合

- [デフォルト設定](#config)

### [](#プーリングプロファイルの使用-3)プーリングプロファイルの使用

プーリングプロファイルと ​**Stored procedure**​ 操作を使用する場合、フローの実行が終了するか、ストリームのコンテンツが完全にコンシュームされるまで接続は開いたままになります。また、接続がトランザクションキーの場合も同様です。この動作は、操作で生成される結果セットにストリームがあるか、結果セットが実行中のトランザクションに含まれている可能性があるために発生します。

Database Connector 1.8.3 以降、​**Stored procedure**​ 操作の接続は、ストリームまたはトランザクションに含まれていない場合に解放されます。

#### [](#スロー-10)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

### [](#update)Update

`<db:update>`

データベースのデータを更新します。

#### [](#パラメーター-18)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_JOIN​</p>
</li>
<li>
<p>JOIN_IF_POSSIBLE​</p>
</li>
<li>
<p>NOT_SUPPORTED</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションに関する操作で実行できる結合アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>JOIN_IF_POSSIBLE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SQL Query Text (SQL クエリテキスト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行する SQL クエリのテキスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Parameter Types (パラメーターの型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ParameterType">Parameter Type (パラメーター種別)</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必要に応じて、1 つまたは複数のパラメーターの種別をクエリ内で指定できます。指定した場合、すべてのパラメーターを参照しなくてもよくなりますが、入力値に含まれないパラメーターは参照できません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Input parameters (入力パラメーター)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップ。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照する必要があります (例: where id = :myParamName)。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generate Keys (自動生成キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成キーをいつ取得できるようにするかを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Indexes (自動生成キーの列インデックス)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of Number (数値の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにするかを示す列インデックスのリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Generated Keys Column Names (自動生成キーの列名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Array of String (文字列の配列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>どの自動生成キーを取得できるようにする必要があるかを示す列名のリスト。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Variable (対象変数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力を保存する変数の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Target Value (対象値)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>操作の出力に対して評価される式。この式の結果が対象変数に保存されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-11)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#StatementResult">Statement Result (ステートメント結果)</a></p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-11)次の設定の場合

- [デフォルト設定](#config)

#### [](#スロー-11)スロー

- DB:BAD\_SQL\_SYNTAX
- DB:CONNECTIVITY
- DB:QUERY\_EXECUTION
- DB:RETRY\_EXHAUSTED

## [](#sources-ソース)Sources (ソース)

### [](#listener)On Table Row

`<db:listener>`

この操作は、一定間隔でテーブルから選択し、取得した行ごとに 1 つのメッセージを生成します。 必要に応じて、ウォーターマークおよび ID 列を提供できます。ウォーターマーク列を提供した場合、その列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが返されます。ID 列を提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回選択されていないことが自動的に確認されます。

この操作ではストリーミングはサポートされません。つまり、操作結果にアクセスするためにペイロードへの変換をさらに実行する必要はありません。この動作は、バージョン 1.9 でリリースされた ​**Query Single**​ 操作と同じです。

#### [](#パラメーター-19)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Configuration (設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する設定の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Table (テーブル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>選択元のテーブルの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Watermark Column (ウォーターマーク列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ウォーターマークに使用する列の名前。この列から取得された値を使用して次のポーリングのコンテンツが絞り込まれるため、より大きなウォーターマーク値を持つ行のみが処理されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Column (ID 列)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行 ID とみなす列の名前。提供した場合、このコンポーネントでは、同じ行が同時ポーリングによって 2 回処理されていないことが確認されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transactional Action (トランザクションアクション)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ALWAYS_BEGIN​</p>
</li>
<li>
<p>None (なし)</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ソースがトランザクションに関して実行できる開始アクションの種別。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>NONE</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Transaction Type (トランザクション種別)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>LOCAL</p>
</li>
<li>
<p>XA</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成するトランザクションの種別。使用できるかどうかは、Runtime バージョンによって決まります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>LOCAL</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Primary Node Only (プライマリノードのみ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クラスターでの実行時にこのソースをプライマリノード上でのみ実行する必要があるかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scheduling Strategy (スケジュール戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>scheduling-strategy</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ポーリングをトリガーするスケジューラーを設定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Redelivery Policy (再配信ポリシー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#RedeliveryPolicy">Redelivery Policy (再配信ポリシー)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>同じメッセージの再配信を処理するためのポリシー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout (クエリタイムアウト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を指定します。デフォルトでは、タイムアウトは使用されません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query Timeout Unit (クエリタイムアウト単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#queryTimeout</code>​ の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SECONDS</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fetch Size (フェッチサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>行が ResultSet から読み取られるときにデータベースからフェッチする行数を指定します。ストリーミングが ​<code>true</code>​ に設定されている場合、このプロパティは必須です。その場合、デフォルト値の ​<code>10</code>​ が使用されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Rows (最大行数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>このメッセージプロセッサーで生成される ResultSet オブジェクトに含めることができる最大行数の制限を設定します。この制限を超えると、超過行は自動的に削除されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続エラーが発生した場合の再試行戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#出力-12)出力

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">型</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object (オブジェクト)</p></td>
</tr>
</tbody>
</table>

### [](#次の設定の場合-12)次の設定の場合

- [デフォルト設定](#config)

## [](#型)型

### [](#pooling-profile)Pooling Profile (プーリングプロファイル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Pool Size (最大プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最大接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Min Pool Size (最小プールサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>任意の時点にプールで維持される最小接続数</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Acquire Increment (取得増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに一度に取得を試みる接続数を決定します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>1</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Prepared Statement Cache Size (プリペアードステートメントのキャッシュサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールされた接続ごとにキャッシュされるステートメント数を決定します。これを 0 に設定すると、ステートメントのキャッシュが無効になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>5</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait (最大待機)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プールが枯渇したときに、接続の取得を試みているクライアントが接続を待機する時間。この値を 0 (デフォルト) に設定すると、無期限に待機します。これは ​<code>checkoutTimeout</code>​ と同じで、追加プロパティで上書きすることはできません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Wait Unit (最大待機単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>#maxWait。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>SECONDS</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続が破棄される前に、プールされていて未使用のままでいられる秒数を決定します。この値を 0 (デフォルト) に設定すると、アイドル接続が期限切れになることはありません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>0</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Additional Properties (追加プロパティ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プーリングプロファイル設定プロパティの名前をキーとするマップ。式の使用はサポートされていません。これらのプロパティを使用して、以前に指定したプロパティ ([Max Pool Size (最大プールサイズ)] や [Min Pool Size (最小プールサイズ)] など) を上書きすることはできません。上書きしようとした場合、メインプロパティが優先されます。  マップの値には、各パラメーターの実際の割り当てが含まれます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ColumnType)Column Type (列の型)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用する型識別子。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Name (型名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDBC ドライバーで使用するデータ型の名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Class Name (クラス名)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データベース種別をマップするために使用する必要がある Java クラスを示します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#Reconnection)Reconnection (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Fails Deployment (デプロイメントに失敗)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​<code>true</code>​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Reconnection Strategy (再接続戦略)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><a href="#reconnect">Reconnect (再接続)</a>​</p>
</li>
<li>
<p><a href="#reconnect-forever">Reconnect Forever (繰り返し再接続)</a></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する再接続戦略。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect)Reconnect (再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Count (数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続の試行回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Frequency (頻度)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再接続する頻度 (ミリ秒)。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>blocking (ブロック)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>false</code>​ に設定した場合、再接続戦略が個別の非ブロックスレッドで実行されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Idle Time (最大アイドル時間)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Time Unit (時間単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>NANOSECONDS</p>
</li>
<li>
<p>MICROSECONDS</p>
</li>
<li>
<p>MILLISECONDS</p>
</li>
<li>
<p>SECONDS</p>
</li>
<li>
<p>MINUTES</p>
</li>
<li>
<p>HOURS</p>
</li>
<li>
<p>DAYS</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>maxIdleTime</code>​ 属性の時間単位。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Redelivery Count (最大再配信数)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>プロセス失敗メッセージをトリガーするまでに、正常に処理されないメッセージを再配信できる最大回数。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Use Secure Hash (セキュアハッシュを使用)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Boolean (ブール)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用するかどうか。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Message Digest Algorithm (メッセージダイジェストアルゴリズム)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するセキュアハッシュアルゴリズム。これが設定されていない場合、デフォルトの SHA-256 になります。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>SHA-256</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Id Expression (ID 式)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メッセージがいつ再配信されたのかを判断するために使用する 1 つ以上の式を定義します。このプロパティは、​<strong>[Use secure hash (セキュアハッシュを使用)]</strong>​ が ​<code>false</code>​ に設定されている場合にのみ設定できます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Object Store (オブジェクトストア)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object Store (オブジェクトストア)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>各メッセージの再配信カウンターが保存されるオブジェクトストア。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#ParameterType)Parameter Type (パラメーター種別)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#TypeClassifier)Type Classifier (型分類子)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type (型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BIT</p>
</li>
<li>
<p>TINYINT</p>
</li>
<li>
<p>SMALLINT</p>
</li>
<li>
<p>INTEGER</p>
</li>
<li>
<p>BIGINT</p>
</li>
<li>
<p>FLOAT</p>
</li>
<li>
<p>REAL</p>
</li>
<li>
<p>DOUBLE</p>
</li>
<li>
<p>NUMERIC</p>
</li>
<li>
<p>DECIMAL</p>
</li>
<li>
<p>CHAR</p>
</li>
<li>
<p>VARCHAR</p>
</li>
<li>
<p>LONGVARCHAR</p>
</li>
<li>
<p>DATE</p>
</li>
<li>
<p>TIME</p>
</li>
<li>
<p>TIMESTAMP</p>
</li>
<li>
<p>BINARY</p>
</li>
<li>
<p>VARBINARY</p>
</li>
<li>
<p>LONGVARBINARY</p>
</li>
<li>
<p>NULL</p>
</li>
<li>
<p>OTHER</p>
</li>
<li>
<p>JAVA_OBJECT​</p>
</li>
<li>
<p>DISTINCT</p>
</li>
<li>
<p>STRUCT</p>
</li>
<li>
<p>ARRAY</p>
</li>
<li>
<p>BLOB</p>
</li>
<li>
<p>CLOB</p>
</li>
<li>
<p>REF</p>
</li>
<li>
<p>DATALINK</p>
</li>
<li>
<p>BOOLEAN</p>
</li>
<li>
<p>ROWID</p>
</li>
<li>
<p>NCHAR</p>
</li>
<li>
<p>NVARCHAR</p>
</li>
<li>
<p>LONGNVARCHAR</p>
</li>
<li>
<p>NCLOB</p>
</li>
<li>
<p>SQLXML</p>
</li>
<li>
<p>UNKNOWN</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Custom Type (カスタム型)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#StatementResult)Statement Result (ステートメント結果)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Affected Rows (影響を受けた行)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Generated Keys (生成されたキー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Object (オブジェクト)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。デフォルト値は 100 インスタンスです。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>100</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Objects (メモリ内オブジェクト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メモリに保持するインスタンスの最大数。指定された最大数以上が必要な場合、ディスクでのコンテンツのバッファが開始されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-in-memory-stream)Repeatable In Memory Stream (反復可能なメモリ内ストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Initial Buffer Size (初期バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンス数。ストリームのデータ量がこのバッファサイズを超える場合は、​<strong>[Buffer size increment (バッファサイズ増分)]</strong>​ 属性に従って、​<strong>[Max in memory size (最大メモリ内サイズ)]</strong>​ を上限としてバッファが拡張されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Size Increment (バッファサイズ増分)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファサイズが初期サイズを超えた場合に、拡張する量を指定します。値を 0 以下に設定すると、バッファが拡張されません。その場合、バッファがフルになると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Max Buffer Size (最大バッファサイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用するメモリの最大量。指定されたメモリの最大値を超えて使用されると、​<code>STREAM_MAXIMUM_SIZE_EXCEEDED</code>​ エラーが発生します。0 以下の値は無制限を意味します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。
<strong> BYTE (バイト)
</strong> KB
<strong> MB
</strong> GB</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>これらのすべての属性の単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#repeatable-file-store-stream)Repeatable File Store Stream (反復可能なファイルストアストリーム)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>In Memory Size (メモリ内サイズ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Number (数値)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>データをメモリ内に保持するためにストリームで使用する最大メモリを定義します。これを超えると、ディスクのコンテンツがバッファされます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Buffer Unit (バッファ単位)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>BYTE (バイト)</p>
</li>
<li>
<p>KB</p>
</li>
<li>
<p>MB</p>
</li>
<li>
<p>GB</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>[Max in Memory Size (最大メモリ内サイズ)]</strong>​ を表す単位</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

### [](#OutputParameter)Output Parameter (出力パラメーター)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Key (キー)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>入力パラメーターの名前。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Type Classifier (型分類子)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#TypeClassifier">Type Classifier (型分類子)</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=7f63a1a8555d9264f26ac0aa3d341358a95311d21597995be7fb2ed186fd40f5 url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-integratedsecurity.md -->

# Database Connector を使用して MS SQL Server の Azure Active Directory 認証を設定する

Database 用 Anypoint Connector (Database Connector) では、接続設定の ​`IntegratedSecurity`​ 値を使用して MS SQL Server の Azure Active Directory 認証を設定できます。次の例は、Anypoint Studio でこの値を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ タブに移動します。
2. **\[Create (作成)\]**​ をクリックします。
3. 検索条件ボックスで、「​`データベース`​」を検索します。
4. **\[Database Config (データベース設定)\]**​ を選択します。
5. **\[OK\]**​ をクリックします。
6. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ で ​**\[MS SQL Server Connection (MS SQL Server 接続)\]**​ を選択します。
7. **\[Advanced (詳細)\]**​ タブで、​**\[Connection properties (接続プロパティ)\]**​ を ​**\[Edit inline (インライン編集)\]**​ に設定します。
8. 緑のプラス記号をクリックします。
9. **\[Key (キー)\]**​ を ​`Integratedsecurity`​ に設定します。
10. **\[Value (値)\]**​ を ​`true`​ に設定します。
11. **\[Finish (完了)\]**​ をクリックします。
12. データベースへの残り接続文字を完了します。
13. **\[OK\]**​ をクリックします。

![Anypoint Studio の Integratedsecurity キー設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-connector-integrated.png)

**設定 XML**​ エディターでは、​`key="integratedsecurity`​ 設定は次のように記述されます。

```xml
<db:config name="Database_Config1" doc:name="Database Config" >
		<db:my-sql-connection >
			<db:connection-properties >
				<db:connection-property key="integratedsecurity" value="true" />
			</db:connection-properties>
		</db:my-sql-connection>
	</db:config>
```

## [](#関連情報)関連情報

- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=e817905153789066c8cdbc27931b3e2e525b5d6b2d6d86fffc892ceb2bc29bea url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-execute-ddl.md -->

# DDL ステートメントの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Execute DDL**​ 操作では、データベースに対して DDL クエリを実行できます。データ定義言語 (DDL) ステートメントは、データへの直接アクセスやデータの変更を行わない特別な種別の SQL ステートメントです。代わりに、データ構造やストアドプロシージャーなどの作成、変更、破棄を行います。DDL ステートメントを使用して、テーブルや他のデータ構造内のデータを作成または変更することもできます。

## [](#studio-で-execute-ddl-操作を設定する)Studio で Execute DDL 操作を設定する

次の例は、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という名前の列が含まれる ​`electronic`​ という名前の新しいテーブルを作成する ​**Execute DDL**​ 操作の設定方法を示しています。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute DDL\]**​ 操作を選択します。
2. **\[Execute DDL\]**​ 操作を Studio キャンバスにドラッグします。  
    この操作は、テーブルを作成し、エラーがなければ ​`0`​ を返します。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```xml
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
```

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute DDL 操作の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-executeddl.png)

Figure 1. Execute DDL の設定

XML エディターでは、​`<db:execute-ddl>`​ 設定は次のように記述されます。

```xml
<db:execute-ddl config-ref="dbConfig">
    <db:sql>
        CREATE TABLE electronic(
            id INT AUTO_INCREMENT PRIMARY KEY,
            name VARCHAR(100),
            description VARCHAR(255),
            price SMALLINT,
            discount TINYINT
        )
    </db:sql>
</db:execute-ddl>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=7d775df5768c36c304b8dcf74871d201d8950dd693f42d188af6dfc9172a2c17 url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-execute-ddl.md -->

# DDL ステートメントの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Execute DDL**​ 操作では、データベースに対して DDL クエリを実行できます。データ定義言語 (DDL) ステートメントは、データへの直接アクセスやデータの変更を行わない特別な種別の SQL ステートメントです。代わりに、データ構造やストアドプロシージャーなどの作成、変更、破棄を行います。DDL ステートメントを使用して、テーブルや他のデータ構造内のデータを作成または変更することもできます。

## [](#studio-で-execute-ddl-操作を設定する)Studio で Execute DDL 操作を設定する

次の例は、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という名前の列が含まれる ​`electronic`​ という名前の新しいテーブルを作成する ​**Execute DDL**​ 操作の設定方法を示しています。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute DDL\]**​ 操作を選択します。
2. **\[Execute DDL\]**​ 操作を Studio キャンバスにドラッグします。  
    この操作は、テーブルを作成し、エラーがなければ ​`0`​ を返します。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```xml
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
```

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute DDL 操作の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-executeddl.png)

Figure 1. Execute DDL の設定

XML エディターでは、​`<db:execute-ddl>`​ 設定は次のように記述されます。

```xml
<db:execute-ddl config-ref="dbConfig">
    <db:sql>
        CREATE TABLE electronic(
            id INT AUTO_INCREMENT PRIMARY KEY,
            name VARCHAR(100),
            description VARCHAR(255),
            price SMALLINT,
            discount TINYINT
        )
    </db:sql>
</db:execute-ddl>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=4f795e2f439db57f13390049bcac48dc6e2b757118a01f340560292a47efa2d7 url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-execute-ddl.md -->

# DDL ステートメントの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Execute DDL**​ 操作では、データベースに対して DDL クエリを実行できます。データ定義言語 (DDL) ステートメントは、データへの直接アクセスやデータの変更を行わない特別な種別の SQL ステートメントです。代わりに、データ構造やストアドプロシージャーなどの作成、変更、破棄を行います。DDL ステートメントを使用して、テーブルや他のデータ構造内のデータを作成または変更することもできます。

## [](#studio-で-execute-ddl-操作を設定する)Studio で Execute DDL 操作を設定する

次の例は、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という名前の列が含まれる ​`electronic`​ という名前の新しいテーブルを作成する ​**Execute DDL**​ 操作の設定方法を示しています。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute DDL\]**​ 操作を選択します。
2. **\[Execute DDL\]**​ 操作を Studio キャンバスにドラッグします。  
    この操作は、テーブルを作成し、エラーがなければ ​`0`​ を返します。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```xml
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
```

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute DDL 操作の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-executeddl.png)

Figure 1. Execute DDL の設定

XML エディターでは、​`<db:execute-ddl>`​ 設定は次のように記述されます。

```xml
<db:execute-ddl config-ref="dbConfig">
    <db:sql>
        CREATE TABLE electronic(
            id INT AUTO_INCREMENT PRIMARY KEY,
            name VARCHAR(100),
            description VARCHAR(255),
            price SMALLINT,
            discount TINYINT
        )
    </db:sql>
</db:execute-ddl>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=1c2069ec91ef8aec89038d4731150b2fe0ee66fd54683442abeab02c11c73477 url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-execute-ddl.md -->

# DDL ステートメントの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Execute DDL**​ 操作では、データベースに対して DDL クエリを実行できます。データ定義言語 (DDL) ステートメントは、データへの直接アクセスやデータの変更を行わない特別な種別の SQL ステートメントです。代わりに、データ構造やストアドプロシージャーなどの作成、変更、破棄を行います。DDL ステートメントを使用して、テーブルや他のデータ構造内のデータを作成または変更することもできます。

## [](#studio-で-execute-ddl-操作を設定する)Studio で Execute DDL 操作を設定する

次の例は、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という名前の列が含まれる ​`electronic`​ という名前の新しいテーブルを作成する ​**Execute DDL**​ 操作の設定方法を示しています。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute DDL\]**​ 操作を選択します。
2. **\[Execute DDL\]**​ 操作を Studio キャンバスにドラッグします。  
    この操作は、テーブルを作成し、エラーがなければ ​`0`​ を返します。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```xml
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
```

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute DDL 操作の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-executeddl.png)

Figure 1. Execute DDL の設定

XML エディターでは、​`<db:execute-ddl>`​ 設定は次のように記述されます。

```xml
<db:execute-ddl config-ref="dbConfig">
    <db:sql>
        CREATE TABLE electronic(
            id INT AUTO_INCREMENT PRIMARY KEY,
            name VARCHAR(100),
            description VARCHAR(255),
            price SMALLINT,
            discount TINYINT
        )
    </db:sql>
</db:execute-ddl>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=5240ddd9edbe2beced55b19661cf1e8b7fd7da0a30f383f5e308334ab6f45e70 url=/mulesoft/current/ja-jp/db-connector/1.9/database-connector-execute-ddl.md -->

# DDL ステートメントの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Execute DDL**​ 操作では、データベースに対して DDL クエリを実行できます。データ定義言語 (DDL) ステートメントは、データへの直接アクセスやデータの変更を行わない特別な種別の SQL ステートメントです。代わりに、データ構造やストアドプロシージャーなどの作成、変更、破棄を行います。DDL ステートメントを使用して、テーブルや他のデータ構造内のデータを作成または変更することもできます。

## [](#studio-で-execute-ddl-操作を設定する)Studio で Execute DDL 操作を設定する

次の例は、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という名前の列が含まれる ​`electronic`​ という名前の新しいテーブルを作成する ​**Execute DDL**​ 操作の設定方法を示しています。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute DDL\]**​ 操作を選択します。
2. **\[Execute DDL\]**​ 操作を Studio キャンバスにドラッグします。  
    この操作は、テーブルを作成し、エラーがなければ ​`0`​ を返します。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```xml
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
```

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute DDL 操作の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-executeddl.png)

Figure 1. Execute DDL の設定

XML エディターでは、​`<db:execute-ddl>`​ 設定は次のように記述されます。

```xml
<db:execute-ddl config-ref="dbConfig">
    <db:sql>
        CREATE TABLE electronic(
            id INT AUTO_INCREMENT PRIMARY KEY,
            name VARCHAR(100),
            description VARCHAR(255),
            price SMALLINT,
            discount TINYINT
        )
    </db:sql>
</db:execute-ddl>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=4556939d854e3733697178e904cf76616c108f902166050ea596888662a56943 url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-driver-configuration.md -->

# Mule Maven プラグインを使用したドライバー表示の設定

Anypoint Studio では、ほとんどのケースで問題なくデータベースドライバーの連動関係をセットアップできますが、クラスローディング分離メカニズムの関係上、ドライバークラスの表示を適切にセットアップするためには Mule Maven プラグインを使用しなければならないシナリオもあります。

## [](#アプリケーション全体のドライバー表示の設定)アプリケーション全体のドライバー表示の設定

追加のデータベースドライバー連動関係を設定して、ドライバーが Mule アプリケーション内のすべてのコンポーネントで表示されるようにする方法は、『Mule Maven プラグイン』ドキュメントの​[「共有ライブラリの設定」](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept#configure-shared-libraries)​のセクションを参照してください。

## [](#コネクタのみでのドライバー表示の設定)コネクタのみでのドライバー表示の設定

連動関係の競合リスクがあり、Database Connector とドライバーの連動関係を同じクラスローダーに含める必要があるために、ドライバーがコネクタでのみ表示されるようにする方法は、『Mule Maven プラグイン』ドキュメントの​[「追加プラグイン連動関係の設定」](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept#configure-plugin-dependencies)​のセクションを参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">ドライバーは、データベースと接続するコンポーネントのクラスローダーのスコープ内に存在する必要があるため、どのコンポーネントがデータベースと接続する必要があるのかを明確にしてください。たとえば、Mule アプリケーションがデータソース参照接続を使用して Spring Bean データソース定義を対象としている場合は、データベースではなく、Spring のクラスローダーがデータベースライブラリを必要とします。追加のアプリケーション連動関係は、​<em>共有ライブラリ</em>​を使用して設定します。</td></tr></tbody></table>

## [](#関連情報)関連情報

- [Mule Maven プラグイン](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept)
- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.10/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=d445b58bb45a9a2cb7e0248aa5cf407da87e6e65f6eab07c684d2b6ae59c7ae4 url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-driver-configuration.md -->

# Mule Maven プラグインを使用したドライバー表示の設定

Anypoint Studio では、ほとんどのケースで問題なくデータベースドライバーの連動関係をセットアップできますが、クラスローディング分離メカニズムの関係上、ドライバークラスの表示を適切にセットアップするためには Mule Maven プラグインを使用しなければならないシナリオもあります。

## [](#アプリケーション全体のドライバー表示の設定)アプリケーション全体のドライバー表示の設定

追加のデータベースドライバー連動関係を設定して、ドライバーが Mule アプリケーション内のすべてのコンポーネントで表示されるようにする方法は、『Mule Maven プラグイン』ドキュメントの​[「共有ライブラリの設定」](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept#configure-shared-libraries)​のセクションを参照してください。

## [](#コネクタのみでのドライバー表示の設定)コネクタのみでのドライバー表示の設定

連動関係の競合リスクがあり、Database Connector とドライバーの連動関係を同じクラスローダーに含める必要があるために、ドライバーがコネクタでのみ表示されるようにする方法は、『Mule Maven プラグイン』ドキュメントの​[「追加プラグイン連動関係の設定」](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept#configure-plugin-dependencies)​のセクションを参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">ドライバーは、データベースと接続するコンポーネントのクラスローダーのスコープ内に存在する必要があるため、どのコンポーネントがデータベースと接続する必要があるのかを明確にしてください。たとえば、Mule アプリケーションがデータソース参照接続を使用して Spring Bean データソース定義を対象としている場合は、データベースではなく、Spring のクラスローダーがデータベースライブラリを必要とします。追加のアプリケーション連動関係は、​<em>共有ライブラリ</em>​を使用して設定します。</td></tr></tbody></table>

## [](#関連情報)関連情報

- [Mule Maven プラグイン](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept)
- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.12/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=8d1fde6c772d0a6f52376e873558d44a6020e95ceead5cf4882c078bdb9ce148 url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-driver-configuration.md -->

# Mule Maven プラグインを使用したドライバー表示の設定

Anypoint Studio では、ほとんどのケースで問題なくデータベースドライバーの連動関係をセットアップできますが、クラスローディング分離メカニズムの関係上、ドライバークラスの表示を適切にセットアップするためには Mule Maven プラグインを使用しなければならないシナリオもあります。

## [](#アプリケーション全体のドライバー表示の設定)アプリケーション全体のドライバー表示の設定

追加のデータベースドライバー連動関係を設定して、ドライバーが Mule アプリケーション内のすべてのコンポーネントで表示されるようにする方法は、『Mule Maven プラグイン』ドキュメントの​[「共有ライブラリの設定」](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept#configure-shared-libraries)​のセクションを参照してください。

## [](#コネクタのみでのドライバー表示の設定)コネクタのみでのドライバー表示の設定

連動関係の競合リスクがあり、Database Connector とドライバーの連動関係を同じクラスローダーに含める必要があるために、ドライバーがコネクタでのみ表示されるようにする方法は、『Mule Maven プラグイン』ドキュメントの​[「追加プラグイン連動関係の設定」](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept#configure-plugin-dependencies)​のセクションを参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">ドライバーは、データベースと接続するコンポーネントのクラスローダーのスコープ内に存在する必要があるため、どのコンポーネントがデータベースと接続する必要があるのかを明確にしてください。たとえば、Mule アプリケーションがデータソース参照接続を使用して Spring Bean データソース定義を対象としている場合は、データベースではなく、Spring のクラスローダーがデータベースライブラリを必要とします。追加のアプリケーション連動関係は、​<em>共有ライブラリ</em>​を使用して設定します。</td></tr></tbody></table>

## [](#関連情報)関連情報

- [Mule Maven プラグイン](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept)
- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.13/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=5e2410fe9d9b97c461b133bfe36bfb5075959a59dff4563810c4acbf19277698 url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-driver-configuration.md -->

# Mule Maven プラグインを使用したドライバー表示の設定

Anypoint Studio では、ほとんどのケースで問題なくデータベースドライバーの連動関係をセットアップできますが、クラスローディング分離メカニズムの関係上、ドライバークラスの表示を適切にセットアップするためには Mule Maven プラグインを使用しなければならないシナリオもあります。

## [](#アプリケーション全体のドライバー表示の設定)アプリケーション全体のドライバー表示の設定

追加のデータベースドライバー連動関係を設定して、ドライバーが Mule アプリケーション内のすべてのコンポーネントで表示されるようにする方法は、『Mule Maven プラグイン』ドキュメントの​[「共有ライブラリの設定」](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept#configure-shared-libraries)​のセクションを参照してください。

## [](#コネクタのみでのドライバー表示の設定)コネクタのみでのドライバー表示の設定

連動関係の競合リスクがあり、Database Connector とドライバーの連動関係を同じクラスローダーに含める必要があるために、ドライバーがコネクタでのみ表示されるようにする方法は、『Mule Maven プラグイン』ドキュメントの​[「追加プラグイン連動関係の設定」](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept#configure-plugin-dependencies)​のセクションを参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">ドライバーは、データベースと接続するコンポーネントのクラスローダーのスコープ内に存在する必要があるため、どのコンポーネントがデータベースと接続する必要があるのかを明確にしてください。たとえば、Mule アプリケーションがデータソース参照接続を使用して Spring Bean データソース定義を対象としている場合は、データベースではなく、Spring のクラスローダーがデータベースライブラリを必要とします。追加のアプリケーション連動関係は、​<em>共有ライブラリ</em>​を使用して設定します。</td></tr></tbody></table>

## [](#関連情報)関連情報

- [Mule Maven プラグイン](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept)
- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=39ad8c85f4e8e7db54f4b4e12c244d2fb286c805112e5d44620760720d9fff7f url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-connection-secure-oracle.md -->

# Oracle TLS データベース接続の設定

データベース用 Anypoint Connector (Database Connector) を使用すると、専用の Oracle 接続を介して Oracle データベースに安全に接続できます。

Oracle 接続では、次のセキュリティレベルを設定できます。

- TCPS - セキュア TCP トンネル経由での接続 (推奨されません)
- TLS - トラストストア検証のみ
- mTLS - トラストストア検証とキーストア検証
- mTLS - ユーザー名とパスワードなし (ロールは証明書で付与)

## [](#セキュア-oracle-接続を設定する)セキュア Oracle 接続を設定する

次の例は、Anypoint Studio でセキュアな Oracle 接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`localhost`​、​**\[Port (ポート)\]**​ を ​`1522`​、​**\[User (ユーザー)\]**​ を ​`system`​、​**\[Password (パスワード)\]**​ を ​`oracle`​、​**\[Instance (インスタンス)\]**​/​**\[Service Name (サービス名)\]**​ を ​`xe`​ に設定します。
7. **\[TLS\]**​ をクリックします。
8. **\[Trust Store Configuration (トラストストア設定)\]**​ セクションで、次の項目を設定します。
    
    - **Path (パス)**​: `<somePath>/client-truststore.jks`
    - **Password (パスワード)**​: `somepassword`
    - **型**​: `JKS`

1. **\[Key Store Configuration (キーストア設定)\]**​ セクションで、次の項目を設定します。
    
    - **Path (パス)**​: `<somePath>/client-keystore.jks`
    - **Password (パスワード)**​: `somepassword`
    - **Key Password (キーパスワード)**​: `somepassword`
    - **型**​: `JKS`
2. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
3. **\[OK\]**​ をクリックします。

次のスクリーンショットは、セキュア Oracle 接続の全般的な設定と TLS 設定のウィンドウです。

![「Secure Oracle Connection General Configuration (セキュア Oracle 接続の全般的な設定)」 ウィンドウ](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-oracle-connection-secure-general.png)

![「Secure Oracle Connection TLS Configuration (セキュア Oracle 接続の TLS 設定)」 ウィンドウ](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-oracle-connection-secure-tls.png)

**設定 XML**​ エディターでは、​`tls:context`​ 設定は次のように記述されます。

```xml
	<db:config name="oracle-mtls-with-user-pass">
		<db:oracle-connection host="localhost" port="1522" user="system" password="oracle" serviceName="XE">
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
				<tls:key-store path="<somePath>/client-keystore.jks" password="<somePassword>" keyPassword="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

## [](#セキュア-oracle-接続レベルの例)セキュア Oracle 接続レベルの例

次の例は、各セキュア Oracle 接続レベルの XML 設定を示しています。

### [](#セキュア-tcp-トンネル経由での-tcps-接続)セキュア TCP トンネル経由での TCPS 接続

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-tcps">
		<db:oracle-connection host="localhost" port="1522" user="system" password="oracle" serviceName="XE" >
			<tls:context>
				<tls:trust-store insecure="true"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

### [](#トラストストア検証のみの-tls)トラストストア検証のみの TLS

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-tls-with-truststore-only">
		<db:oracle-connection host="localhost" port="1522" user="system" password="oracle" serviceName="XE" >
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

### [](#トラストストア検証とキーストア検証を使用する-mtls)トラストストア検証とキーストア検証を使用する mTLS

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-mtls-with-user-pass">
		<db:oracle-connection host="localhost" user="system" password="oracle" port="1522" serviceName="XE">
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
				<tls:key-store path="<somePath>/client-keystore.jks" password="<somePassword>" keyPassword="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

### [](#ユーザー名とパスワードを使用しない-mtls)ユーザー名とパスワードを使用しない mTLS

この設定では、ロールは証明書によって付与されます。 **設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-mtls-with-user-pass">
		<db:oracle-connection host="localhost" port="1522" serviceName="XE">
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
				<tls:key-store path="<somePath>/client-keystore.jks" password="<somePassword>" keyPassword="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

## [](#関連情報)関連情報

- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.12/database-documentation)
- [キーストアとトラストストアを使用した TLS の設定](https://docs.mulesoft.com/mule-runtime/latest/tls-configuration)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=29cd37f420ec959d3d4110e07721f9bd9a69af69fa9ceecebc741b7692e3f5e1 url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-connection-secure-oracle.md -->

# Oracle TLS データベース接続の設定

データベース用 Anypoint Connector (Database Connector) を使用すると、専用の Oracle 接続を介して Oracle データベースに安全に接続できます。

Oracle 接続では、次のセキュリティレベルを設定できます。

- TCPS - セキュア TCP トンネル経由での接続 (推奨されません)
- TLS - トラストストア検証のみ
- mTLS - トラストストア検証とキーストア検証
- mTLS - ユーザー名とパスワードなし (ロールは証明書で付与)

## [](#セキュア-oracle-接続を設定する)セキュア Oracle 接続を設定する

次の例は、Anypoint Studio でセキュアな Oracle 接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`localhost`​、​**\[Port (ポート)\]**​ を ​`1522`​、​**\[User (ユーザー)\]**​ を ​`system`​、​**\[Password (パスワード)\]**​ を ​`oracle`​、​**\[Instance (インスタンス)\]**​/​**\[Service Name (サービス名)\]**​ を ​`xe`​ に設定します。
7. **\[TLS\]**​ をクリックします。
8. **\[Trust Store Configuration (トラストストア設定)\]**​ セクションで、次の項目を設定します。
    
    - **Path (パス)**​: `<somePath>/client-truststore.jks`
    - **Password (パスワード)**​: `somepassword`
    - **型**​: `JKS`

1. **\[Key Store Configuration (キーストア設定)\]**​ セクションで、次の項目を設定します。
    
    - **Path (パス)**​: `<somePath>/client-keystore.jks`
    - **Password (パスワード)**​: `somepassword`
    - **Key Password (キーパスワード)**​: `somepassword`
    - **型**​: `JKS`
2. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
3. **\[OK\]**​ をクリックします。

次のスクリーンショットは、セキュア Oracle 接続の全般的な設定と TLS 設定のウィンドウです。

![「Secure Oracle Connection General Configuration (セキュア Oracle 接続の全般的な設定)」 ウィンドウ](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-oracle-connection-secure-general.png)

![「Secure Oracle Connection TLS Configuration (セキュア Oracle 接続の TLS 設定)」 ウィンドウ](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-oracle-connection-secure-tls.png)

**設定 XML**​ エディターでは、​`tls:context`​ 設定は次のように記述されます。

```xml
	<db:config name="oracle-mtls-with-user-pass">
		<db:oracle-connection host="localhost" port="1522" user="system" password="oracle" serviceName="XE">
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
				<tls:key-store path="<somePath>/client-keystore.jks" password="<somePassword>" keyPassword="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

## [](#セキュア-oracle-接続レベルの例)セキュア Oracle 接続レベルの例

次の例は、各セキュア Oracle 接続レベルの XML 設定を示しています。

### [](#セキュア-tcp-トンネル経由での-tcps-接続)セキュア TCP トンネル経由での TCPS 接続

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-tcps">
		<db:oracle-connection host="localhost" port="1522" user="system" password="oracle" serviceName="XE" >
			<tls:context>
				<tls:trust-store insecure="true"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

### [](#トラストストア検証のみの-tls)トラストストア検証のみの TLS

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-tls-with-truststore-only">
		<db:oracle-connection host="localhost" port="1522" user="system" password="oracle" serviceName="XE" >
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

### [](#トラストストア検証とキーストア検証を使用する-mtls)トラストストア検証とキーストア検証を使用する mTLS

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-mtls-with-user-pass">
		<db:oracle-connection host="localhost" user="system" password="oracle" port="1522" serviceName="XE">
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
				<tls:key-store path="<somePath>/client-keystore.jks" password="<somePassword>" keyPassword="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

### [](#ユーザー名とパスワードを使用しない-mtls)ユーザー名とパスワードを使用しない mTLS

この設定では、ロールは証明書によって付与されます。 **設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-mtls-with-user-pass">
		<db:oracle-connection host="localhost" port="1522" serviceName="XE">
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
				<tls:key-store path="<somePath>/client-keystore.jks" password="<somePassword>" keyPassword="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

## [](#関連情報)関連情報

- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.13/database-documentation)
- [キーストアとトラストストアを使用した TLS の設定](https://docs.mulesoft.com/mule-runtime/latest/tls-configuration)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=50f420c24fa755e400c705fb96aef19ba5e5b8d8032850995fe59e47ccaf45be url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-connection-secure-oracle.md -->

# Oracle TLS データベース接続の設定

データベース用 Anypoint Connector (Database Connector) を使用すると、専用の Oracle 接続を介して Oracle データベースに安全に接続できます。

Oracle 接続では、次のセキュリティレベルを設定できます。

- TCPS - セキュア TCP トンネル経由での接続 (推奨されません)
- TLS - トラストストア検証のみ
- mTLS - トラストストア検証とキーストア検証
- mTLS - ユーザー名とパスワードなし (ロールは証明書で付与)

## [](#セキュア-oracle-接続を設定する)セキュア Oracle 接続を設定する

次の例は、Anypoint Studio でセキュアな Oracle 接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`localhost`​、​**\[Port (ポート)\]**​ を ​`1522`​、​**\[User (ユーザー)\]**​ を ​`system`​、​**\[Password (パスワード)\]**​ を ​`oracle`​、​**\[Instance (インスタンス)\]**​/​**\[Service Name (サービス名)\]**​ を ​`xe`​ に設定します。
7. **\[TLS\]**​ をクリックします。
8. **\[Trust Store Configuration (トラストストア設定)\]**​ セクションで、次の項目を設定します。
    
    - **Path (パス)**​: `<somePath>/client-truststore.jks`
    - **Password (パスワード)**​: `somepassword`
    - **型**​: `JKS`

1. **\[Key Store Configuration (キーストア設定)\]**​ セクションで、次の項目を設定します。
    
    - **Path (パス)**​: `<somePath>/client-keystore.jks`
    - **Password (パスワード)**​: `somepassword`
    - **Key Password (キーパスワード)**​: `somepassword`
        
        <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">Java Secure Socket Extension (JSSE) のため、[Key Store Configuration (キーストア設定)] の ​<strong>[Password (パスワード)]</strong>​ と ​<strong>[Key Password (キーパスワード)]</strong>​ 項目に同じパスワード値を設定する必要があります。</td></tr></tbody></table>
    - **型**​: `JKS`
2. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
3. **\[OK\]**​ をクリックします。

次のスクリーンショットは、セキュア Oracle 接続の全般的な設定と TLS 設定のウィンドウです。

![「Secure Oracle Connection General Configuration (セキュア Oracle 接続の全般的な設定)」 ウィンドウ](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-oracle-connection-secure-general.png)

**設定 XML**​ エディターでは、​`tls:context`​ 設定は次のように記述されます。

```xml
	<db:config name="oracle-mtls-with-user-pass">
		<db:oracle-connection host="localhost" port="1522" user="system" password="oracle" serviceName="XE">
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
				<tls:key-store path="<somePath>/client-keystore.jks" password="<somePassword>" keyPassword="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

## [](#セキュア-oracle-接続レベルの例)セキュア Oracle 接続レベルの例

次の例は、各セキュア Oracle 接続レベルの XML 設定を示しています。

### [](#セキュア-tcp-トンネル経由での-tcps-接続)セキュア TCP トンネル経由での TCPS 接続

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-tcps">
		<db:oracle-connection host="localhost" port="1522" user="system" password="oracle" serviceName="XE" >
			<tls:context>
				<tls:trust-store insecure="true"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

### [](#トラストストア検証のみの-tls)トラストストア検証のみの TLS

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-tls-with-truststore-only">
		<db:oracle-connection host="localhost" port="1522" user="system" password="oracle" serviceName="XE" >
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

### [](#トラストストア検証とキーストア検証を使用する-mtls)トラストストア検証とキーストア検証を使用する mTLS

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-mtls-with-user-pass">
		<db:oracle-connection host="localhost" user="system" password="oracle" port="1522" serviceName="XE">
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
				<tls:key-store path="<somePath>/client-keystore.jks" password="<somePassword>" keyPassword="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

### [](#ユーザー名とパスワードを使用しない-mtls)ユーザー名とパスワードを使用しない mTLS

この設定では、ロールは証明書によって付与されます。 **設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
	<db:config name="oracle-mtls-with-user-pass">
		<db:oracle-connection host="localhost" port="1522" serviceName="XE">
			<tls:context>
				<tls:trust-store path="<somePath>/client-truststore.jks" password="<somePassword>" type="jks"/>
				<tls:key-store path="<somePath>/client-keystore.jks" password="<somePassword>" keyPassword="<somePassword>" type="jks"/>
			</tls:context>
		</db:oracle-connection>
	</db:config>
```

## [](#関連情報)関連情報

- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation)
- [キーストアとトラストストアを使用した TLS の設定](https://docs.mulesoft.com/mule-runtime/latest/tls-configuration)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=3bf418f92e172390d987cafa5f2d8b2aac8531ae244cf677698730c137cfb283 url=/mulesoft/current/ja-jp/db-connector/1.10/database-execute-script.md -->

# スクリプトの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Execute script**​ 操作ではランダムな長さの SQL スクリプトを 1 つのデータベースステートメントとして実行します。

この操作では、スキーマとテーブルの作成、データの挿入、データの循環が頻繁に実行されます。データの循環は夜間ジョブで実行されます。このジョブでは、データを履歴テーブルに移動およびアーカイブし、オンラインテーブルをパージします。考慮すべき点をいくつか挙げます。

- スクリプトに複数のステートメントを含めることができる。
- さまざまな種別のステートメントを使用できる。
- 入力または出力パラメーターを受け入れることができない。
- この操作では、SQL 射影を伴わない任意のスクリプトを実行します。

**Execute script**​ 操作は、スクリプトを操作に埋め込むか、スクリプトをファイルから参照することで使用できますが、この両方のスクリプトの実行方法を同時に使用することはできません。  

スクリプトを実行すると、整数の配列 (実行したステートメントごとに 1 つの要素) が返されます。各整数は、ステートメントの影響を受けたオブジェクトの数を表します。

**Execute script**​ 操作と ​**Bulk**​ 操作では用途が異なります。たとえば、データベースに多数の行を挿入するスクリプトをビルドできますが、スクリプトに動的パラメーターを都合よく提供することはできません。また、スクリプトで SQL インジェクション攻撃を防ぐようにします。

次の例は、​**Execute script**​ 操作を設定する方法 (操作をスクリプトに埋め込む方法とスクリプトをファイルから参照する方法) を示しています。

## [](#スクリプトを埋め込んで-execute-script-操作を設定する)スクリプトを埋め込んで Execute Script 操作を設定する

Studio でこの操作を設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute script\]**​ 操作を選択します。
2. **\[Execute script\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリスクリプトを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
    
    ```xml
    update PLANET set NAME='Mercury' where POSITION=0;
    update PLANET set NAME='Mercury' where POSITION=4`.
    ```

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute script 操作の設定 (\[SQL Query Text (SQL クエリテキスト)\] 項目で、実行する SQL クエリスクリプトを設定)](_images/database-execute-script-1.png)

Figure 1. Execute script 操作の設定

XML エディターでは、​`<db:execute-script>`​ 設定は次のように記述されます。

```xml
<db:execute-script config-ref="dbConfig">
   <db:sql>
       update PLANET set NAME='Mercury' where POSITION=0;
       update PLANET set NAME='Mercury' where POSITION=4
   </db:sql>
</db:execute-script>
```

## [](#スクリプトを参照して-execute-script-操作を設定する)スクリプトを参照して Execute Script 操作を設定する

Studio でこの操作を設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute script\]**​ 操作を選択します。
2. **\[Execute script\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. **\[Script Path (スクリプトパス)\]**​ 項目を、読み込むスクリプトファイルの場所に設定します (例: `integration/executescript/bulk-script.sql`​)。  
    ファイルはクラスパスまたはディスク上のリソースを参照できます。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute script 操作の設定 (\[Script path (スクリプトパス)\] 項目で、読み込むスクリプトファイルの場所を設定)](_images/database-execute-script-2.png)

Figure 2. Execute Script 操作の設定

XML エディターでは、​`<db:execute-script>`​ および ​`file`​ 設定は次のように記述されます。

```xml
<flow name="executeScriptFromFile">
   <db:execute-script config-ref="dbConfig" file="integration/executescript/bulk-script.sql" />
</flow>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=64d2229492fc360dc1731f0c2e25260fcc03a1bcbbc41d2b54aab1c571104543 url=/mulesoft/current/ja-jp/db-connector/1.12/database-execute-script.md -->

# スクリプトの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Execute script**​ 操作ではランダムな長さの SQL スクリプトを 1 つのデータベースステートメントとして実行します。

この操作では、スキーマとテーブルの作成、データの挿入、データの循環が頻繁に実行されます。データの循環は夜間ジョブで実行されます。このジョブでは、データを履歴テーブルに移動およびアーカイブし、オンラインテーブルをパージします。考慮すべき点をいくつか挙げます。

- スクリプトに複数のステートメントを含めることができる。
- さまざまな種別のステートメントを使用できる。
- 入力または出力パラメーターを受け入れることができない。
- この操作では、SQL 射影を伴わない任意のスクリプトを実行します。

**Execute script**​ 操作は、スクリプトを操作に埋め込むか、スクリプトをファイルから参照することで使用できますが、この両方のスクリプトの実行方法を同時に使用することはできません。  

スクリプトを実行すると、整数の配列 (実行したステートメントごとに 1 つの要素) が返されます。各整数は、ステートメントの影響を受けたオブジェクトの数を表します。

**Execute script**​ 操作と ​**Bulk**​ 操作では用途が異なります。たとえば、データベースに多数の行を挿入するスクリプトをビルドできますが、スクリプトに動的パラメーターを都合よく提供することはできません。また、スクリプトで SQL インジェクション攻撃を防ぐようにします。

次の例は、​**Execute script**​ 操作を設定する方法 (操作をスクリプトに埋め込む方法とスクリプトをファイルから参照する方法) を示しています。

## [](#スクリプトを埋め込んで-execute-script-操作を設定する)スクリプトを埋め込んで Execute Script 操作を設定する

Studio でこの操作を設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute script\]**​ 操作を選択します。
2. **\[Execute script\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリスクリプトを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
    
    ```xml
    update PLANET set NAME='Mercury' where POSITION=0;
    update PLANET set NAME='Mercury' where POSITION=4`.
    ```

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute script 操作の設定 (\[SQL Query Text (SQL クエリテキスト)\] 項目で、実行する SQL クエリスクリプトを設定)](_images/database-execute-script-1.png)

Figure 1. Execute script 操作の設定

XML エディターでは、​`<db:execute-script>`​ 設定は次のように記述されます。

```xml
<db:execute-script config-ref="dbConfig">
   <db:sql>
       update PLANET set NAME='Mercury' where POSITION=0;
       update PLANET set NAME='Mercury' where POSITION=4
   </db:sql>
</db:execute-script>
```

## [](#スクリプトを参照して-execute-script-操作を設定する)スクリプトを参照して Execute Script 操作を設定する

Studio でこの操作を設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute script\]**​ 操作を選択します。
2. **\[Execute script\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. **\[Script Path (スクリプトパス)\]**​ 項目を、読み込むスクリプトファイルの場所に設定します (例: `integration/executescript/bulk-script.sql`​)。  
    ファイルはクラスパスまたはディスク上のリソースを参照できます。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute script 操作の設定 (\[Script path (スクリプトパス)\] 項目で、読み込むスクリプトファイルの場所を設定)](_images/database-execute-script-2.png)

Figure 2. Execute Script 操作の設定

XML エディターでは、​`<db:execute-script>`​ および ​`file`​ 設定は次のように記述されます。

```xml
<flow name="executeScriptFromFile">
   <db:execute-script config-ref="dbConfig" file="integration/executescript/bulk-script.sql" />
</flow>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=27f3f25ae53818baa79666902f6d4116cdb8498033196903f796e092e16d07a7 url=/mulesoft/current/ja-jp/db-connector/1.13/database-execute-script.md -->

# スクリプトの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Execute script**​ 操作ではランダムな長さの SQL スクリプトを 1 つのデータベースステートメントとして実行します。

この操作では、スキーマとテーブルの作成、データの挿入、データの循環が頻繁に実行されます。データの循環は夜間ジョブで実行されます。このジョブでは、データを履歴テーブルに移動およびアーカイブし、オンラインテーブルをパージします。考慮すべき点をいくつか挙げます。

- スクリプトに複数のステートメントを含めることができる。
- さまざまな種別のステートメントを使用できる。
- 入力または出力パラメーターを受け入れることができない。
- この操作では、SQL 射影を伴わない任意のスクリプトを実行します。

**Execute script**​ 操作は、スクリプトを操作に埋め込むか、スクリプトをファイルから参照することで使用できますが、この両方のスクリプトの実行方法を同時に使用することはできません。  

スクリプトを実行すると、整数の配列 (実行したステートメントごとに 1 つの要素) が返されます。各整数は、ステートメントの影響を受けたオブジェクトの数を表します。

**Execute script**​ 操作と ​**Bulk**​ 操作では用途が異なります。たとえば、データベースに多数の行を挿入するスクリプトをビルドできますが、スクリプトに動的パラメーターを都合よく提供することはできません。また、スクリプトで SQL インジェクション攻撃を防ぐようにします。

次の例は、​**Execute script**​ 操作を設定する方法 (操作をスクリプトに埋め込む方法とスクリプトをファイルから参照する方法) を示しています。

## [](#スクリプトを埋め込んで-execute-script-操作を設定する)スクリプトを埋め込んで Execute Script 操作を設定する

Studio でこの操作を設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute script\]**​ 操作を選択します。
2. **\[Execute script\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリスクリプトを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
    
    ```xml
    update PLANET set NAME='Mercury' where POSITION=0;
    update PLANET set NAME='Mercury' where POSITION=4`.
    ```

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute script 操作の設定 (\[SQL Query Text (SQL クエリテキスト)\] 項目で、実行する SQL クエリスクリプトを設定)](_images/database-execute-script-1.png)

Figure 1. Execute script 操作の設定

XML エディターでは、​`<db:execute-script>`​ 設定は次のように記述されます。

```xml
<db:execute-script config-ref="dbConfig">
   <db:sql>
       update PLANET set NAME='Mercury' where POSITION=0;
       update PLANET set NAME='Mercury' where POSITION=4
   </db:sql>
</db:execute-script>
```

## [](#スクリプトを参照して-execute-script-操作を設定する)スクリプトを参照して Execute Script 操作を設定する

Studio でこの操作を設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute script\]**​ 操作を選択します。
2. **\[Execute script\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. **\[Script Path (スクリプトパス)\]**​ 項目を、読み込むスクリプトファイルの場所に設定します (例: `integration/executescript/bulk-script.sql`​)。  
    ファイルはクラスパスまたはディスク上のリソースを参照できます。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute script 操作の設定 (\[Script path (スクリプトパス)\] 項目で、読み込むスクリプトファイルの場所を設定)](_images/database-execute-script-2.png)

Figure 2. Execute Script 操作の設定

XML エディターでは、​`<db:execute-script>`​ および ​`file`​ 設定は次のように記述されます。

```xml
<flow name="executeScriptFromFile">
   <db:execute-script config-ref="dbConfig" file="integration/executescript/bulk-script.sql" />
</flow>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=d574ad6f05b8a06cae6183ff1c06fab919bf04cb5db250d0da49dd9e2a33754a url=/mulesoft/current/ja-jp/db-connector/1.14/database-execute-script.md -->

# スクリプトの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Execute script**​ 操作ではランダムな長さの SQL スクリプトを 1 つのデータベースステートメントとして実行します。

この操作では、スキーマとテーブルの作成、データの挿入、データの循環が頻繁に実行されます。データの循環は夜間ジョブで実行されます。このジョブでは、データを履歴テーブルに移動およびアーカイブし、オンラインテーブルをパージします。考慮すべき点をいくつか挙げます。

- スクリプトに複数のステートメントを含めることができる。
- さまざまな種別のステートメントを使用できる。
- 入力または出力パラメーターを受け入れることができない。
- この操作では、SQL 射影を伴わない任意のスクリプトを実行します。

**Execute script**​ 操作は、スクリプトを操作に埋め込むか、スクリプトをファイルから参照することで使用できますが、この両方のスクリプトの実行方法を同時に使用することはできません。  

スクリプトを実行すると、整数の配列 (実行したステートメントごとに 1 つの要素) が返されます。各整数は、ステートメントの影響を受けたオブジェクトの数を表します。

**Execute script**​ 操作と ​**Bulk**​ 操作では用途が異なります。たとえば、データベースに多数の行を挿入するスクリプトをビルドできますが、スクリプトに動的パラメーターを都合よく提供することはできません。また、スクリプトで SQL インジェクション攻撃を防ぐようにします。

次の例は、​**Execute script**​ 操作を設定する方法 (操作をスクリプトに埋め込む方法とスクリプトをファイルから参照する方法) を示しています。

## [](#スクリプトを埋め込んで-execute-script-操作を設定する)スクリプトを埋め込んで Execute Script 操作を設定する

Studio でこの操作を設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute script\]**​ 操作を選択します。
2. **\[Execute script\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリスクリプトを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
    
    ```xml
    update PLANET set NAME='Mercury' where POSITION=0;
    update PLANET set NAME='Mercury' where POSITION=4`.
    ```

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute script 操作の設定 (\[SQL Query Text (SQL クエリテキスト)\] 項目で、実行する SQL クエリスクリプトを設定)](_images/database-execute-script-1.png)

Figure 1. Execute script 操作の設定

XML エディターでは、​`<db:execute-script>`​ 設定は次のように記述されます。

```xml
<db:execute-script config-ref="dbConfig">
   <db:sql>
       update PLANET set NAME='Mercury' where POSITION=0;
       update PLANET set NAME='Mercury' where POSITION=4
   </db:sql>
</db:execute-script>
```

## [](#スクリプトを参照して-execute-script-操作を設定する)スクリプトを参照して Execute Script 操作を設定する

Studio でこの操作を設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute script\]**​ 操作を選択します。
2. **\[Execute script\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. **\[Script Path (スクリプトパス)\]**​ 項目を、読み込むスクリプトファイルの場所に設定します (例: `integration/executescript/bulk-script.sql`​)。  
    ファイルはクラスパスまたはディスク上のリソースを参照できます。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute script 操作の設定 (\[Script path (スクリプトパス)\] 項目で、読み込むスクリプトファイルの場所を設定)](_images/database-execute-script-2.png)

Figure 2. Execute Script 操作の設定

XML エディターでは、​`<db:execute-script>`​ および ​`file`​ 設定は次のように記述されます。

```xml
<flow name="executeScriptFromFile">
   <db:execute-script config-ref="dbConfig" file="integration/executescript/bulk-script.sql" />
</flow>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=09305ceeafdb22ddac16f53462ebbfd56421843718bd3e4e47064ce08acb2c87 url=/mulesoft/current/ja-jp/db-connector/1.9/database-execute-script.md -->

# スクリプトの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Execute script**​ 操作ではランダムな長さの SQL スクリプトを 1 つのデータベースステートメントとして実行します。

この操作では、スキーマとテーブルの作成、データの挿入、データの循環が頻繁に実行されます。データの循環は夜間ジョブで実行されます。このジョブでは、データを履歴テーブルに移動およびアーカイブし、オンラインテーブルをパージします。考慮すべき点をいくつか挙げます。

- スクリプトに複数のステートメントを含めることができる。
- さまざまな種別のステートメントを使用できる。
- 入力または出力パラメーターを受け入れることができない。
- この操作では、SQL 射影を伴わない任意のスクリプトを実行します。

**Execute script**​ 操作は、スクリプトを操作に埋め込むか、スクリプトをファイルから参照することで使用できますが、この両方のスクリプトの実行方法を同時に使用することはできません。  

スクリプトを実行すると、整数の配列 (実行したステートメントごとに 1 つの要素) が返されます。各整数は、ステートメントの影響を受けたオブジェクトの数を表します。

**Execute script**​ 操作と ​**Bulk**​ 操作では用途が異なります。たとえば、データベースに多数の行を挿入するスクリプトをビルドできますが、スクリプトに動的パラメーターを都合よく提供することはできません。また、スクリプトで SQL インジェクション攻撃を防ぐようにします。

次の例は、​**Execute script**​ 操作を設定する方法 (操作をスクリプトに埋め込む方法とスクリプトをファイルから参照する方法) を示しています。

## [](#スクリプトを埋め込んで-execute-script-操作を設定する)スクリプトを埋め込んで Execute Script 操作を設定する

Studio でこの操作を設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute script\]**​ 操作を選択します。
2. **\[Execute script\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリスクリプトを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
    
    ```xml
    update PLANET set NAME='Mercury' where POSITION=0;
    update PLANET set NAME='Mercury' where POSITION=4`.
    ```

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute script 操作の設定 (\[SQL Query Text (SQL クエリテキスト)\] 項目で、実行する SQL クエリスクリプトを設定)](_images/database-execute-script-1.png)

Figure 1. Execute script 操作の設定

XML エディターでは、​`<db:execute-script>`​ 設定は次のように記述されます。

```xml
<db:execute-script config-ref="dbConfig">
   <db:sql>
       update PLANET set NAME='Mercury' where POSITION=0;
       update PLANET set NAME='Mercury' where POSITION=4
   </db:sql>
</db:execute-script>
```

## [](#スクリプトを参照して-execute-script-操作を設定する)スクリプトを参照して Execute Script 操作を設定する

Studio でこの操作を設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Execute script\]**​ 操作を選択します。
2. **\[Execute script\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. **\[Script Path (スクリプトパス)\]**​ 項目を、読み込むスクリプトファイルの場所に設定します (例: `integration/executescript/bulk-script.sql`​)。  
    ファイルはクラスパスまたはディスク上のリソースを参照できます。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Execute script 操作の設定 (\[Script path (スクリプトパス)\] 項目で、読み込むスクリプトファイルの場所を設定)](_images/database-execute-script-2.png)

Figure 2. Execute Script 操作の設定

XML エディターでは、​`<db:execute-script>`​ および ​`file`​ 設定は次のように記述されます。

```xml
<flow name="executeScriptFromFile">
   <db:execute-script config-ref="dbConfig" file="integration/executescript/bulk-script.sql" />
</flow>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=054f07190667e317bfbaff82cd66df009c84249d63b67c2911770d364a1a3178 url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-input-output-parameters.md -->

# ストアドプロシージャーの入力および出力パラメーターの設定

データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作の入力または出力パラメーターを設定して、ストアドプロシージャーで使用するパラメーターを指定します。入力パラメーター (プロシージャーに渡される値)、出力パラメーター (プロシージャーから返される値)、または入出力パラメーター (両方の組み合わせ) があります。

Anypoint Studio では、次の項目を使用して ​**Stored procedure**​ 操作のパラメーターを設定できます。

- **Input parameters (入力パラメーター)**​
    
    ストアドプロシージャーへの入力として指定される値のパラメーター。
    
    通常、これらのパラメーターを介して Mule アプリケーションからストアドプロシージャーに値を渡します。
- **Output parameters (出力パラメーター)**
    
    ストアドプロシージャーから Mule アプリケーションに値を返すために使用されるパラメーター。
    
    ストアドプロシージャーを実行したら、これらのパラメーターに割り当てられた値を取得できます。
- **In out parameters (入出力パラメーター)**
    
    入力と出力の両方のパラメーターとして機能するパラメーター。
    
    これらのパラメーターを介してストアドプロシージャーに値を渡すことができます。

## [](#入力パラメーターを設定する)入力パラメーターを設定する

顧客の注文を管理するための Mule アプリケーションを開発するシナリオを考えます。このケースでは、顧客 ID や注文状況などのパラメーターを取るストアドプロシージャーを使用してデータベースから注文情報を取得します。

次の例は、​**Stored procedure**​ 操作の ​**\[Input parameters (入力パラメーター)\]**​ 項目を設定して、特定の条件に基づいて注文の詳細を動的に取得する方法を示しています。

1. Studio で、​**\[Database Configuration (データベース設定)\]**​ 要素を Mule アプリケーションプロジェクトに追加し、必要な MySQL データベース接続の詳細を使用して設定します。
2. 注文情報を取得するために、​**Stored procedure**​ 操作をキャンバスにドラッグします。
3. フローから操作を選択します。
4. **\[SQL Query text (SQL クエリテキスト)\]**​ 項目に​`「{call GetOrderDetails(:customerId, :orderStatus)}」`​と入力します。
    
    これにより、名前付きパラメーター ​`customerId`​ および ​`orderStatus`​ を使用してストアドプロシージャー ​`GetOrderDetails`​ をコールするための SQL ステートメントが定義されます。
5. **\[Input parameters (入力パラメーター)\]**​ 項目に、注文の詳細を取得する次の式を入力します。
    
    ```xml
    {
            "name": "customerId",
            "type": "INTEGER",
            "value": #[flowVars.customerId]
        },
        {
            "name": "orderStatus",
            "type": "VARCHAR",
            "value": #[message.inboundProperties['orderStatus']]
        }
    ```
    
    - `name`
        
        入力パラメーターの名前。
    - `type`
        
        入力パラメーターのデータ型。
    - `value`
        
        Mule 式構文を使用して指定される入力パラメーターの値。

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="Database_Config" doc:name="Stored Procedure">
    <db:sql>
        <![CDATA[{call GetOrderDetails(:customerId, :orderStatus)}]]>
    </db:sql>
    <db:input-parameters>
        <![CDATA[#[{
            "name": "customerId",
            "type": "INTEGER",
            "value": #[flowVars.customerId]
        },
        {
            "name": "orderStatus",
            "type": "VARCHAR",
            "value": #[message.inboundProperties['orderStatus']]
        }]]]>
    </db:input-parameters>
</db:stored-procedure>
```

## [](#出力パラメーターを設定する)出力パラメーターを設定する

オンライン販売システムの Mule アプリケーションを開発するシナリオを考えます。Mule アプリケーションで注文処理を管理しますが、ストアドプロシージャーを使用し、MySQL データベースから注文の詳細を取得して注文の総額を計算する機能を実装したいと考えています。このシナリオでは、ストアドプロシージャーは注文品目、数量、総額などの詳細を出力パラメーターとして返します。

次の例は、​**Stored procedure**​ 操作の ​**\[Output parameters (出力パラメーター)\]**​ 項目を設定して、注文の詳細と総額を動的に取得する方法を示しています。

1. Studio で、​**\[Database Configuration (データベース設定)\]**​ 要素を MuleSoft アプリケーションプロジェクトに追加し、必要な MySQL データベース接続の詳細を使用して設定します。
2. 注文情報を取得するために、​**Stored procedure**​ 操作をキャンバスにドラッグします。
3. フローから操作を選択します。
4. **\[SQL Query text (SQL クエリテキスト)\]**​ 項目に​`「{call GetOrderDetails(:orderId, :totalAmount, :orderDetails)}」`​と入力します。
    
    これにより、ストアドプロシージャー ​`GetOrderDetails`​ をコールして、​`orderId`​、​`totalAmount`​、​`orderDetails`​ などの出力パラメーターを取得するための SQL ステートメントが定義されます。
5. **\[Output parameters (出力パラメーター)\]**​ を ​**\[Edit inline (インライン編集)\]**​ に設定します。
6. プラスアイコンをクリックして **\[Output parameter (出力パラメーター)\]** ウィンドウを開きます。
7. **\[Output parameter (出力パラメーター)\]**​ ウィンドウで、次のパラメーターを設定します。
    
    <table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">キー</th>
<th class="tableblock halign-left valign-top">キー値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">orderId</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">INTEGER</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">totalAmount</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Decimal (10 進数)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">orderDetails</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ARRAY</p></td>
</tr>
</tbody>
</table>
8. **\[Finish (完了)\]**​ をクリックします。

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="MySQL_Configuration" doc:name="Stored Procedure">
    <db:sql><![CDATA[{call GetOrderDetails(:orderId, :totalAmount, :orderDetails)}]]></db:sql>
    <db:output-parameters>
        <![CDATA[#[{
            "name": "orderId",
            "type": "INTEGER"
        },
        {
            "name": "totalAmount",
            "type": "DECIMAL"
        },
        {
            "name": "orderDetails",
            "type": "ARRAY"
        }]]]>
    </db:output-parameters>
</db:stored-procedure>
```

## [](#入出力パラメーターを設定する)入出力パラメーターを設定する

特定の商品の在庫レベルの更新プロセスを処理する庫管理システムの Mule アプリケーションを開発するシナリオを考えます。このシナリオでは、Mule アプリケーションは PostgreSQL データベースの ​`UpdateStockLevel`​ という名前のストアドプロシージャーとやりとりします。このやりとりには、入力と出力の両方のパラメーターが必要です。

次の例は、​**Stored procedure**​ 操作の ​**\[In out parameters (入出力パラメーター)\]**​ 項目を設定して、在庫レベルの更新を管理する方法を示しています。これには、入力データ (商品 ID と数量) と出力データ (更新された在庫レベル) の両方が含まれます。

1. Studio で、​**\[Database Configuration (データベース設定)\]**​ 要素を MuleSoft アプリケーションプロジェクトに追加し、必要な PostgreSQL データベース接続の詳細を使用して設定します。
2. 注文情報を取得するために、​**Stored procedure**​ 操作をキャンバスにドラッグします。
3. フローから操作を選択します。
4. **\[SQL Query text (SQL クエリテキスト)\]**​ 項目に​`「{call UpdateStockLevel(:productId, :quantity, :updatedStockLevel)}」`​と入力します。
    
    これにより、​`productId`​ および ​`quantity`​ 入力パラメーターと ​`updatedStockLevel`​ 出力パラメーターを使用して ​`UpdateStockLevel`​ という名前のストアドプロシージャーをコールする SQL ステートメントが作成されます。
5. **\[In out parameters (入出力パラメーター)\]**​ を ​**\[Edit inline (インライン編集)\]**​ に設定します。
6. プラスアイコンをクリックして ​**\[In out parameter (入出力パラメーター)\]**​ ウィンドウを開きます。
7. **\[In out parameter (入出力パラメーター)\]**​ ウィンドウで、次のパラメーターに値を割り当てます。
    
    <table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">キー</th>
<th class="tableblock halign-left valign-top">値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">productId</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">#[payload.productId]</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">quantity</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">#[payload.quantity]</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">updatedStockLevel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">(空)</p></td>
</tr>
</tbody>
</table>
8. **\[Finish (完了)\]**​ をクリックします。

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
<db:stored-procedure doc:name="Stored procedure"
<db:sql ><db:in-out-parameters >
			</db:in-out-parameters><![CDATA[{call UpdateStockLevel(:productId, :quantity, :updatedStockLevel)}]]>
			</db:sql>
			<db:in-out-parameters >
				<db:in-out-parameter key="updatedStockLevel" />
				<db:in-out-parameter key="productId" value="#[payload.productId]" />
				<db:in-out-parameter key="quantity" value="#[payload.quantity]" />
			</db:in-out-parameters>
```

## [](#カスタム型を設定する)カスタム型を設定する

ストアドプロシージャーのパラメーターとしてカスタム型を使用する機能は、使用しているデータベースシステムや、使用している Database Connector またはフレームワークの機能によって異なります。 カスタムデータベース型の ​**Stored procedure**​ 操作を使用して Oracle データベースベンダーと連携するときは注意してください。

\+ パッケージ内でストアドプロシージャーを定義する場合、コネクタ接続設定でカスタム型パラメーターの列の型を設定します。

1. Studio で ​**\[Database Config Global Element Properties (データベース設定グローバル要素プロパティ)\]**​ ウィンドウを開きます。
2. **\[Advanced (詳細)\]**​ タブをクリックします。
3. **\[Column types (列の型)\]**​ を ​**\[Edit inline (インライン編集)\]**​ に設定します。
4. プラス記号をクリックして ​**\[Column types(列の型)\]**​ ウィンドウを開きます。
5. **\[Column types (列の型)\]**​ ウィンドウで、目的の値で ​**\[Id\]**​ および ​**\[Type name (型名)\]**​ 項目を設定します。
6. **\[OK\]**​ をクリックします。

![「Column type (列の型)」 設定ウィンドウ](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-column-type.png)

**設定 XML**​ エディターウィンドウでは、設定は次のように記述されます。

```xml
<db:column-types >
<db:column-type id="2003" typeName="MY_CUSTOM_PKG.MY_CUSTOM_TYPE" />
</db:column-types>
```

ストアドプロシージャーがパッケージに含まれていない場合でも、カスタム型パラメーターの ​**\[Column types (列の型)\]**​ を定義することをお勧めします。

## [](#設定の考慮事項)設定の考慮事項

**入出力パラメーター**​を設定するときは、次の考慮事項を確認してください。

### [](#ストアドプロシージャーの変数値)ストアドプロシージャーの変数値

次の考慮事項は、すべてのデータベースベンダーに適用されます。Mule Runtime Engine (Mule) では、特定の値セットが含まれる変数を​**入出力パラメーター**​としてストアドプロシージャーに渡す場合、操作の完了後に変更された値を変数に含めることはできません。代わりに、変更された値は操作のペイロードに含まれます。

この動作を説明するために、次のシナリオを考えます。  

**入出力パラメーター**​として登録されているパラメーターに、​`foo`​ という名前の変数に保存されている値があります。​`vars.foo`​ がストアドプロシージャー ​`vars.foo`​ に渡されると、操作が呼び出された後にその元の値が返されます。ストアドプロシージャーをチェーニングすると、ストアドプロシージャー ​`A`​ をコールしたときに ​`vars.foo`​ の値が変更され、その後、すでに変更された値を使用してストアドプロシージャー ​`B`​ をコールできると思うかもしれませんが、

変更されたデータは操作の実行後のペイロードのエントリとして返されます。ペイロードには、ストアドプロシージャーで作成できる変更された値が含まれます。そのため、ストアドプロシージャーをチェーニングするには、操作ごとに 1 つのストアドプロシージャーのみを呼び出す必要があります。

**Stored procedure**​ 操作のデータを適切に書式設定するには、​[`prepareArray`​ および ​`prepareStruct`​ 関数](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-udt-stored-procedure#using-preparestruct-and-preparearray-functions)​を使用します。

### [](#返される値のデータ形式)返される値のデータ形式

**Stored procedure**​ 操作では、想定と異なる形式でデータが返されます。この制限は、すべてのデータベースベンダーに適用されます。

この動作を説明するために、次のシナリオを考えます。  

**Stored procedure**​ 操作の入力として SQL 配列または SQL 構造が想定されますが (​`prepareArray`​ および ​`prepareStruct`​ 関数を使用して正しく解決される)、Mule で操作を実行すると、変更された値が含まれる Java オブジェクトが返されます。その結果、操作で想定と異なる形式のデータが返されます。これは、ストアドプロシージャーをチェーニングするときに問題になる可能性があります。

**Stored procedure**​ 操作のデータを適切に書式設定するには、​[`prepareArray`​ および ​`prepareStruct`​ 関数](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-udt-stored-procedure#using-preparestruct-and-preparearray-functions)​を使用します。

<!-- document id=5d0763b594507b9e8208cf3d02c41d577c5117495a0eb899c7f063fd21eeb5f0 url=/mulesoft/current/ja-jp/db-connector/1.10/database-stored-procedure.md -->

# ストアドプロシージャーの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作では、データベースでストアドプロシージャーを呼び出します。ストアドプロシージャーで 1 つまたは複数の ResultSet インスタンスが返される場合、パフォーマンスやメモリの問題につながる可能性のある結果の先制消費を回避するため、ストリーミングが自動的に割り当てられます。

次の例は、ストアドプロシージャーのコール可能なステートメントと日付、および ​**\[Input parameters (入力パラメーター)\]**​、​**\[Output parameters (出力パラメーター)\]**​、​**\[In out parameters (入出力パラメーター)\]**​ 項目を設定してストアドプロシージャーを呼び出す方法を示しています。

## [](#ストアドプロシージャーのコール可能なステートメント)ストアドプロシージャーのコール可能なステートメント

Database Connector は、次の形式のコール可能なステートメントの使用をサポートしています。

`{ call procedureName(:param1, :param2, …​, :paramN) }`

`:paramN`​ は、ストアドプロシージャー宣言の ​`Nth`​ パラメーターと一致します。ストアドプロシージャーの名前と最初の括弧の間に空白がないことを確認してください。 すべての JDBC ドライバーが JDBC 仕様形式に準拠している必要がありますが、一部のドライバーには独自の仕様があります。ストアドプロシージャーをコールする方法についての詳細は、JDBC ドライバーのドキュメントを確認してください。たとえば、Snowflake JDBC ドライバーでは、次のように中括弧 ​`{`​ および ​`}`​ を使用せずにコール可能なステートメントを設定する必要があります。

`call procedureName(:param1, :param2, …​, :paramN)`

### [](#ストアドプロシージャーにパラメーターを渡す)ストアドプロシージャーにパラメーターを渡す

パラメーターをストアドプロシージャーに渡す場合、次のようにします。

- ストアドプロシージャーのすべてのパラメーター (デフォルト値が設定される省略可能なパラメーターも含む) を配置する。
- ストアドプロシージャーで定義した順序でパラメーターを配置する。
- パラメーターをパラメーター化し、文字列や数値などをハードコード化しない。

次の例は、​`SYSTEM.employees`​ という名前のテーブルと ​`createEmployee`​ という名前のストアドプロシージャーを作成するときに初期化された Oracle データベースを示しています。

```xml
    CREATE TABLE SYSTEM.employees(
        employee_id INTEGER GENERATED BY DEFAULT AS IDENTITY,
        employee_name VARCHAR2(100),
        employee_age INTEGER,
        employee_birthday TIMESTAMP,
        PRIMARY KEY(employee_id)
    );


    CREATE PROCEDURE createEmployee(e_name VARCHAR2, e_age NUMBER, e_birth_date DATE) AS
    BEGIN
        INSERT INTO SYSTEM.employees(employee_name, employee_age, employee_birthday) VALUES(e_name, e_age, e_birth_date);
    END;
```

Database Connector はコール可能なステートメントでの名前付きパラメーターをサポートしていないため、名前でパラメーターを一致させようとしても機能しません。例:

`{ call createEmployee(e_age ⇒ :age, e_birth_date ⇒ :date, e_name ⇒ :name) }`

パラメーターは、適切な順序で指定する必要があります。例:

`{ call createEmployee(:name, :age, :date) }`​.

## [](#ストアドプロシージャーのデータの使用)ストアドプロシージャーのデータの使用

Database Connector は、エンジン固有の組み込み関数の使用をサポートしていません。たとえば、Oracle データベースでプロシージャーをコールする前に日付を特定の形式に変更する場合、次のアプローチは機能しません。

`{ call createEmployee(e_name ⇒ :name, employee_age ⇒ :age, e_birth_date ⇒ TO_DATE(:date, 'YYYY-MM-DD HH:mm:ss')) }.`

コール可能なステートメントを呼び出す前に、すべてのデータ変換で DataWeave を使用します。前の例を使用して、次の変換を実行します。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call createEmployee(:name, :age, :date) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次の DataWeave コードに設定します。

```dataweave
%dw 2.0
  output application/json
  fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
  ---
  { 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }

[source,xml,linenums]
```

次のスクリーンショットは、Studio の設定を示しています。

![Stored procedure 操作の日付の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-stored-example-4.png)

Figure 1. ストアドプロシージャーの日付の設定

XML エディターでは、DataWeave 変換を使用した ​`<db:input-parameters>`​ は次のように記述されます。

```xml
<db:stored-procedure doc:name="Create Employee" config-ref="Database_Config">
    <db:sql>{ call createEmployee(:name, :age, :date) }</db:sql>
		<db:input-parameters>
		 	<![CDATA[#[%dw 2.0
				output application/json
				fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
				---
				{ 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }
			]]]>
		</db:input-parameters>
	</db:stored-procedure>
```

## [](#stored-procedure-操作の-input-parameters-入力パラメーター-項目を設定する)Stored Procedure 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

**\[Input parameters (入力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップを作成する値を指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。パラメーターに値を渡す場合、次のようにします。

- 一重引用符を使用して各パラメーターを定義する (例: `'paramName': value`​)。
- デフォルト値には、DataWeave または変数を使用する。これにより、null または空の文字列を渡しても、Mule Runtime Engine によってストアドプロシージャーのデフォルト値が転送されなくなります。

**\[Input parameters (入力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call doubleMyInt(:myInt) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を ​`{'description' : payload}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input parameter (入力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-stored-example-1.png)

Figure 2. \[Input parameter (入力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:stored-procedure>`​ および ​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
    <db:input-parameters>
        #[{'description' : payload}]
    </db:input-parameters>
</db:stored-procedure>
```

## [](#stored-procedure-操作の-in-out-parameters-入出力パラメーター-項目を設定する)Stored Procedure 操作の \[In Out Parameters (入出力パラメーター)\] 項目を設定する

**\[In out parameters (入出力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定するパラメーター (入力と出力の両方) の名前をキーとするマップを作成する値を指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。

**\[In out parameters (入出力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call doubleMyInt(:myInt) }`
3. **\[In out parameters (入出力パラメーター)\]**​ 項目を ​`Edit inline`​ に設定します。
4. プラス記号 (​**+**​) をクリックして、新しい値を追加します。
5. 新しいウィンドウで、​**\[Key (キー)\]**​ 項目を ​`myInt`​、​**\[Value (値)\]**​ 項目を ​`3`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「In out parameters (入出力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-stored-example-2.png)

Figure 3. \[In Out parameters (入出力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:stored-procedure>`​ および ​`<db:in-out-parameter>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
  <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
  <db:in-out-parameters>
      <db:in-out-parameter key="myInt" value="3"/>
  </db:in-out-parameters>
</db:stored-procedure>
```

## [](#stored-procedure-操作の-input-parameters-入力パラメーター-項目と-output-parameters-出力パラメーター-項目を設定する)Stored Procedure 操作の \[Input Parameters (入力パラメーター)\] 項目と \[Output Parameters (出力パラメーター)\] 項目を設定する

**\[Output parameters (出力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定する値のリストを指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `call multiply(:value, :result)`​)。

**\[Input parameters (入力パラメーター)\]**​ 項目と ​**\[Output parameters (出力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次のように設定します。
    
    ```xml
    {
        'int1' : 3,
        'int2' : 4,
        'int3' : 5
    }
    ```
4. **\[Output parameters (出力パラメーター)\]**​ 項目を ​`Edit inline`​ に設定します。
5. プラス記号 (​**+**​) をクリックして、新しい値を追加します。
6. 新しいウィンドウで、​**\[Key (キー)\]**​ 項目を ​`result1`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。
7. ステップ 5 と 6 を繰り返して新しい値を追加し、​**\[Key (キー)\]**​ 項目を ​`result2`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input parameters (入力パラメーター)」 項目と 「Output parameters (出力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-stored-example-3.png)

Figure 4. \[Input parameters (入力パラメーター)\] と \[Output parameters (出力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:input-parameters>`​ および ​`<db:output-parameters>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }</db:sql>
    <db:input-parameters>
        #[{
            'int1' : 3,
            'int2' : 4,
            'int3' : 5
        }]
    </db:input-parameters>
    <db:output-parameters>
        <db:output-parameter key="result1" type="INTEGER"/>
        <db:output-parameter key="result2" type="INTEGER"/>
    </db:output-parameters>
</db:stored-procedure>
```

## [](#結果セットを返す)結果セットを返す

結果セットを返すストアドプロシージャーをコールすると、結果セットはデフォルトでペイロードに割り当てられます。返される結果セットを変更するには、​**Stored procedure**​ 操作設定の ​**\[Advanced (詳細)\]**​ タブで ​**\[Target Variable (対象変数)\]**​ または ​**\[Target Value (対象値)\]**​ を設定します。

次の例は、​`languages`​ という名前のテーブルと、結果セットを返す ​`myProc`​ という名前のストアドプロシージャーを作成するときに初期化される MSSQL データベースを示しています。

```xml
CREATE TABLE LANGUAGES (NAME VARCHAR(128), SAMPLE_TEXT VARCHAR(max));

CREATE PROCEDURE myProc AS
   SELECT * FROM LANGUAGES l;
RETURN;
```

1. **Stored procedure**​ 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`{ call myProc() }`​ に設定します。
2. **\[Advanced (詳細)\]**​ タブで、​**\[Target Variable (対象変数)\]**​ を ​`aResult`​ に設定します。

XML エディターでは、​`<db:stored-procedure>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="MsSQL" target="aResult">
  <db:sql ><![CDATA[{ call myProc() }]]></db:sql>
</db:stored-procedure>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=39bd2f03a637e9b70114832e538511fa050a8351aadba5a3dee2a8d34567ebf7 url=/mulesoft/current/ja-jp/db-connector/1.12/database-stored-procedure.md -->

# ストアドプロシージャーの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作では、データベースでストアドプロシージャーを呼び出します。ストアドプロシージャーで 1 つまたは複数の ResultSet インスタンスが返される場合、パフォーマンスやメモリの問題につながる可能性のある結果の先制消費を回避するため、ストリーミングが自動的に割り当てられます。

次の例は、ストアドプロシージャーのコール可能なステートメントと日付、および ​**\[Input parameters (入力パラメーター)\]**​、​**\[Output parameters (出力パラメーター)\]**​、​**\[In out parameters (入出力パラメーター)\]**​ 項目を設定してストアドプロシージャーを呼び出す方法を示しています。

## [](#ストアドプロシージャーのコール可能なステートメント)ストアドプロシージャーのコール可能なステートメント

Database Connector は、次の形式のコール可能なステートメントの使用をサポートしています。

`{ call procedureName(:param1, :param2, …​, :paramN) }`

`:paramN`​ は、ストアドプロシージャー宣言の ​`Nth`​ パラメーターと一致します。ストアドプロシージャーの名前と最初の括弧の間に空白がないことを確認してください。 すべての JDBC ドライバーが JDBC 仕様形式に準拠している必要がありますが、一部のドライバーには独自の仕様があります。ストアドプロシージャーをコールする方法についての詳細は、JDBC ドライバーのドキュメントを確認してください。たとえば、Snowflake JDBC ドライバーでは、次のように中括弧 ​`{`​ および ​`}`​ を使用せずにコール可能なステートメントを設定する必要があります。

`call procedureName(:param1, :param2, …​, :paramN)`

### [](#ストアドプロシージャーにパラメーターを渡す)ストアドプロシージャーにパラメーターを渡す

パラメーターをストアドプロシージャーに渡す場合、次のようにします。

- ストアドプロシージャーのすべてのパラメーター (デフォルト値が設定される省略可能なパラメーターも含む) を配置する。
- ストアドプロシージャーで定義した順序でパラメーターを配置する。
- パラメーターをパラメーター化し、文字列や数値などをハードコード化しない。

次の例は、​`SYSTEM.employees`​ という名前のテーブルと ​`createEmployee`​ という名前のストアドプロシージャーを作成するときに初期化された Oracle データベースを示しています。

```xml
    CREATE TABLE SYSTEM.employees(
        employee_id INTEGER GENERATED BY DEFAULT AS IDENTITY,
        employee_name VARCHAR2(100),
        employee_age INTEGER,
        employee_birthday TIMESTAMP,
        PRIMARY KEY(employee_id)
    );


    CREATE PROCEDURE createEmployee(e_name VARCHAR2, e_age NUMBER, e_birth_date DATE) AS
    BEGIN
        INSERT INTO SYSTEM.employees(employee_name, employee_age, employee_birthday) VALUES(e_name, e_age, e_birth_date);
    END;
```

Database Connector はコール可能なステートメントでの名前付きパラメーターをサポートしていないため、名前でパラメーターを一致させようとしても機能しません。例:

`{ call createEmployee(e_age ⇒ :age, e_birth_date ⇒ :date, e_name ⇒ :name) }`

パラメーターは、適切な順序で指定する必要があります。例:

`{ call createEmployee(:name, :age, :date) }`​。

## [](#ストアドプロシージャーのデータの使用)ストアドプロシージャーのデータの使用

Database Connector は、エンジン固有の組み込み関数の使用をサポートしていません。たとえば、Oracle データベースでプロシージャーをコールする前に日付を特定の形式に変更する場合、次のアプローチは機能しません。

`{ call createEmployee(e_name ⇒ :name, employee_age ⇒ :age, e_birth_date ⇒ TO_DATE(:date, 'YYYY-MM-DD HH:mm:ss')) }.`

コール可能なステートメントを呼び出す前に、すべてのデータ変換で DataWeave を使用します。前の例を使用して、次の変換を実行します。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call createEmployee(:name, :age, :date) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次の DataWeave コードに設定します。

```dataweave
%dw 2.0
  output application/json
  fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
  ---
  { 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }

[source,xml,linenums]
```

次のスクリーンショットは、Studio の設定を示しています。

![Stored procedure 操作の日付の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-stored-example-4.png)

Figure 1. ストアドプロシージャーの日付の設定

XML エディターでは、DataWeave 変換を使用した ​`<db:input-parameters>`​ は次のように記述されます。

```xml
<db:stored-procedure doc:name="Create Employee" config-ref="Database_Config">
    <db:sql>{ call createEmployee(:name, :age, :date) }</db:sql>
		<db:input-parameters>
		 	<![CDATA[#[%dw 2.0
				output application/json
				fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
				---
				{ 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }
			]]]>
		</db:input-parameters>
	</db:stored-procedure>
```

## [](#stored-procedure-操作の-input-parameters-入力パラメーター-項目を設定する)Stored Procedure 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

**\[Input parameters (入力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップを作成する値を指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。パラメーターに値を渡す場合、次のようにします。

- 一重引用符を使用して各パラメーターを定義する (例: `'paramName': value`​)。
- デフォルト値には、DataWeave または変数を使用する。これにより、null または空の文字列を渡しても、Mule Runtime Engine によってストアドプロシージャーのデフォルト値が転送されなくなります。

**\[Input parameters (入力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call doubleMyInt(:myInt) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を ​`{'description' : payload}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input parameter (入力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-stored-example-1.png)

Figure 2. \[Input parameter (入力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:stored-procedure>`​ および ​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
    <db:input-parameters>
        #[{'description' : payload}]
    </db:input-parameters>
</db:stored-procedure>
```

## [](#stored-procedure-操作の-in-out-parameters-入出力パラメーター-項目を設定する)Stored Procedure 操作の \[In Out Parameters (入出力パラメーター)\] 項目を設定する

**\[In out parameters (入出力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定するパラメーター (入力と出力の両方) の名前をキーとするマップを作成する値を指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。

**\[In out parameters (入出力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call doubleMyInt(:myInt) }`
3. **\[In out parameters (入出力パラメーター)\]**​ 項目を ​`Edit inline`​ に設定します。
4. プラス記号 (​**+**​) をクリックして、新しい値を追加します。
5. 新しいウィンドウで、​**\[Key (キー)\]**​ 項目を ​`myInt`​、​**\[Value (値)\]**​ 項目を ​`3`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「In out parameters (入出力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-stored-example-2.png)

Figure 3. \[In Out parameters (入出力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:stored-procedure>`​ および ​`<db:in-out-parameter>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
  <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
  <db:in-out-parameters>
      <db:in-out-parameter key="myInt" value="3"/>
  </db:in-out-parameters>
</db:stored-procedure>
```

## [](#stored-procedure-操作の-input-parameters-入力パラメーター-項目と-output-parameters-出力パラメーター-項目を設定する)Stored Procedure 操作の \[Input Parameters (入力パラメーター)\] 項目と \[Output Parameters (出力パラメーター)\] 項目を設定する

**\[Output parameters (出力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定する値のリストを指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `call multiply(:value, :result)`​)。

**\[Input parameters (入力パラメーター)\]**​ 項目と ​**\[Output parameters (出力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次のように設定します。
    
    ```xml
    {
        'int1' : 3,
        'int2' : 4,
        'int3' : 5
    }
    ```
4. **\[Output parameters (出力パラメーター)\]**​ 項目を ​`Edit inline`​ に設定します。
5. プラス記号 (​**+**​) をクリックして、新しい値を追加します。
6. 新しいウィンドウで、​**\[Key (キー)\]**​ 項目を ​`result1`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。
7. ステップ 5 と 6 を繰り返して新しい値を追加し、​**\[Key (キー)\]**​ 項目を ​`result2`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input parameters (入力パラメーター)」 項目と 「Output parameters (出力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-stored-example-3.png)

Figure 4. \[Input parameters (入力パラメーター)\] と \[Output parameters (出力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:input-parameters>`​ および ​`<db:output-parameters>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }</db:sql>
    <db:input-parameters>
        #[{
            'int1' : 3,
            'int2' : 4,
            'int3' : 5
        }]
    </db:input-parameters>
    <db:output-parameters>
        <db:output-parameter key="result1" type="INTEGER"/>
        <db:output-parameter key="result2" type="INTEGER"/>
    </db:output-parameters>
</db:stored-procedure>
```

## [](#結果セットを返す)結果セットを返す

結果セットを返すストアドプロシージャーをコールすると、結果セットはデフォルトでペイロードに割り当てられます。返される結果セットを変更するには、​**Stored procedure**​ 操作設定の ​**\[Advanced (詳細)\]**​ タブで ​**\[Target Variable (対象変数)\]**​ または ​**\[Target Value (対象値)\]**​ を設定します。

次の例は、​`languages`​ という名前のテーブルと、結果セットを返す ​`myProc`​ という名前のストアドプロシージャーを作成するときに初期化される MSSQL データベースを示しています。

```xml
CREATE TABLE LANGUAGES (NAME VARCHAR(128), SAMPLE_TEXT VARCHAR(max));

CREATE PROCEDURE myProc AS
   SELECT * FROM LANGUAGES l;
RETURN;
```

1. **Stored procedure**​ 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`{ call myProc() }`​ に設定します。
2. **\[Advanced (詳細)\]**​ タブで、​**\[Target Variable (対象変数)\]**​ を ​`aResult`​ に設定します。

XML エディターでは、​`<db:stored-procedure>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="MsSQL" target="aResult">
  <db:sql ><![CDATA[{ call myProc() }]]></db:sql>
</db:stored-procedure>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=a7d1782cc037ab622cbeaf6d2b84f2e67568062fc1fc72ec67d71e71e44546bf url=/mulesoft/current/ja-jp/db-connector/1.13/database-stored-procedure.md -->

# ストアドプロシージャーの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作では、データベースでストアドプロシージャーを呼び出します。ストアドプロシージャーで 1 つまたは複数の ResultSet インスタンスが返される場合、パフォーマンスやメモリの問題につながる可能性のある結果の先制消費を回避するため、ストリーミングが自動的に割り当てられます。

次の例は、ストアドプロシージャーのコール可能なステートメントと日付、および ​**\[Input parameters (入力パラメーター)\]**​、​**\[Output parameters (出力パラメーター)\]**​、​**\[In out parameters (入出力パラメーター)\]**​ 項目を設定してストアドプロシージャーを呼び出す方法を示しています。

## [](#ストアドプロシージャーのコール可能なステートメント)ストアドプロシージャーのコール可能なステートメント

Database Connector は、次の形式のコール可能なステートメントの使用をサポートしています。

`{ call procedureName(:param1, :param2, …​, :paramN) }`

`:paramN`​ は、ストアドプロシージャー宣言の ​`Nth`​ パラメーターと一致します。ストアドプロシージャーの名前と最初の括弧の間に空白がないことを確認してください。 すべての JDBC ドライバーが JDBC 仕様形式に準拠している必要がありますが、一部のドライバーには独自の仕様があります。ストアドプロシージャーをコールする方法についての詳細は、JDBC ドライバーのドキュメントを確認してください。たとえば、Snowflake JDBC ドライバーでは、次のように中括弧 ​`{`​ および ​`}`​ を使用せずにコール可能なステートメントを設定する必要があります。

`call procedureName(:param1, :param2, …​, :paramN)`

### [](#ストアドプロシージャーにパラメーターを渡す)ストアドプロシージャーにパラメーターを渡す

パラメーターをストアドプロシージャーに渡す場合、次のようにします。

- ストアドプロシージャーのすべてのパラメーター (デフォルト値が設定される省略可能なパラメーターも含む) を配置する。
- ストアドプロシージャーで定義した順序でパラメーターを配置する。
- パラメーターをパラメーター化し、文字列や数値などをハードコード化しない。

次の例は、​`SYSTEM.employees`​ という名前のテーブルと ​`createEmployee`​ という名前のストアドプロシージャーを作成するときに初期化された Oracle データベースを示しています。

```xml
    CREATE TABLE SYSTEM.employees(
        employee_id INTEGER GENERATED BY DEFAULT AS IDENTITY,
        employee_name VARCHAR2(100),
        employee_age INTEGER,
        employee_birthday TIMESTAMP,
        PRIMARY KEY(employee_id)
    );


    CREATE PROCEDURE createEmployee(e_name VARCHAR2, e_age NUMBER, e_birth_date DATE) AS
    BEGIN
        INSERT INTO SYSTEM.employees(employee_name, employee_age, employee_birthday) VALUES(e_name, e_age, e_birth_date);
    END;
```

Database Connector はコール可能なステートメントでの名前付きパラメーターをサポートしていないため、名前でパラメーターを一致させようとしても機能しません。例:

`{ call createEmployee(e_age ⇒ :age, e_birth_date ⇒ :date, e_name ⇒ :name) }`

パラメーターは、適切な順序で指定する必要があります。例:

`{ call createEmployee(:name, :age, :date) }`​.

## [](#ストアドプロシージャーのデータの使用)ストアドプロシージャーのデータの使用

Database Connector は、エンジン固有の組み込み関数の使用をサポートしていません。たとえば、Oracle データベースでプロシージャーをコールする前に日付を特定の形式に変更する場合、次のアプローチは機能しません。

`{ call createEmployee(e_name ⇒ :name, employee_age ⇒ :age, e_birth_date ⇒ TO_DATE(:date, 'YYYY-MM-DD HH:mm:ss')) }.`

コール可能なステートメントを呼び出す前に、すべてのデータ変換で DataWeave を使用します。前の例を使用して、次の変換を実行します。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call createEmployee(:name, :age, :date) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次の DataWeave コードに設定します。

```dataweave
%dw 2.0
  output application/json
  fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
  ---
  { 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }

[source,xml,linenums]
```

次のスクリーンショットは、Studio の設定を示しています。

![Stored procedure 操作の日付の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-stored-example-4.png)

Figure 1. ストアドプロシージャーの日付の設定

XML エディターでは、DataWeave 変換を使用した ​`<db:input-parameters>`​ は次のように記述されます。

```xml
<db:stored-procedure doc:name="Create Employee" config-ref="Database_Config">
    <db:sql>{ call createEmployee(:name, :age, :date) }</db:sql>
		<db:input-parameters>
		 	<![CDATA[#[%dw 2.0
				output application/json
				fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
				---
				{ 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }
			]]]>
		</db:input-parameters>
	</db:stored-procedure>
```

## [](#stored-procedure-操作の-input-parameters-入力パラメーター-項目を設定する)Stored Procedure 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

**\[Input parameters (入力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップを作成する値を指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。パラメーターに値を渡す場合、次のようにします。

- 一重引用符を使用して各パラメーターを定義する (例: `'paramName': value`​)。
- デフォルト値には、DataWeave または変数を使用する。これにより、null または空の文字列を渡しても、Mule Runtime Engine によってストアドプロシージャーのデフォルト値が転送されなくなります。

**\[Input parameters (入力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call doubleMyInt(:myInt) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を ​`{'description' : payload}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input parameter (入力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-stored-example-1.png)

Figure 2. \[Input parameter (入力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:stored-procedure>`​ および ​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
    <db:input-parameters>
        #[{'description' : payload}]
    </db:input-parameters>
</db:stored-procedure>
```

## [](#stored-procedure-操作の-in-out-parameters-入出力パラメーター-項目を設定する)Stored Procedure 操作の \[In Out Parameters (入出力パラメーター)\] 項目を設定する

**\[In out parameters (入出力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定するパラメーター (入力と出力の両方) の名前をキーとするマップを作成する値を指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。

**\[In out parameters (入出力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call doubleMyInt(:myInt) }`
3. **\[In out parameters (入出力パラメーター)\]**​ 項目を ​`Edit inline`​ に設定します。
4. プラス記号 (​**+**​) をクリックして、新しい値を追加します。
5. 新しいウィンドウで、​**\[Key (キー)\]**​ 項目を ​`myInt`​、​**\[Value (値)\]**​ 項目を ​`3`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「In out parameters (入出力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-stored-example-2.png)

Figure 3. \[In Out parameters (入出力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:stored-procedure>`​ および ​`<db:in-out-parameter>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
  <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
  <db:in-out-parameters>
      <db:in-out-parameter key="myInt" value="3"/>
  </db:in-out-parameters>
</db:stored-procedure>
```

## [](#stored-procedure-操作の-input-parameters-入力パラメーター-項目と-output-parameters-出力パラメーター-項目を設定する)Stored Procedure 操作の \[Input Parameters (入力パラメーター)\] 項目と \[Output Parameters (出力パラメーター)\] 項目を設定する

**\[Output parameters (出力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定する値のリストを指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `call multiply(:value, :result)`​)。

**\[Input parameters (入力パラメーター)\]**​ 項目と ​**\[Output parameters (出力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次のように設定します。
    
    ```xml
    {
        'int1' : 3,
        'int2' : 4,
        'int3' : 5
    }
    ```
4. **\[Output parameters (出力パラメーター)\]**​ 項目を ​`Edit inline`​ に設定します。
5. プラス記号 (​**+**​) をクリックして、新しい値を追加します。
6. 新しいウィンドウで、​**\[Key (キー)\]**​ 項目を ​`result1`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。
7. ステップ 5 と 6 を繰り返して新しい値を追加し、​**\[Key (キー)\]**​ 項目を ​`result2`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input parameters (入力パラメーター)」 項目と 「Output parameters (出力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-stored-example-3.png)

Figure 4. \[Input parameters (入力パラメーター)\] と \[Output parameters (出力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:input-parameters>`​ および ​`<db:output-parameters>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }</db:sql>
    <db:input-parameters>
        #[{
            'int1' : 3,
            'int2' : 4,
            'int3' : 5
        }]
    </db:input-parameters>
    <db:output-parameters>
        <db:output-parameter key="result1" type="INTEGER"/>
        <db:output-parameter key="result2" type="INTEGER"/>
    </db:output-parameters>
</db:stored-procedure>
```

## [](#結果セットを返す)結果セットを返す

結果セットを返すストアドプロシージャーをコールすると、結果セットはデフォルトでペイロードに割り当てられます。返される結果セットを変更するには、​**Stored procedure**​ 操作設定の ​**\[Advanced (詳細)\]**​ タブで ​**\[Target Variable (対象変数)\]**​ または ​**\[Target Value (対象値)\]**​ を設定します。

次の例は、​`languages`​ という名前のテーブルと、結果セットを返す ​`myProc`​ という名前のストアドプロシージャーを作成するときに初期化される MSSQL データベースを示しています。

```xml
CREATE TABLE LANGUAGES (NAME VARCHAR(128), SAMPLE_TEXT VARCHAR(max));

CREATE PROCEDURE myProc AS
   SELECT * FROM LANGUAGES l;
RETURN;
```

1. **Stored procedure**​ 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`{ call myProc() }`​ に設定します。
2. **\[Advanced (詳細)\]**​ タブで、​**\[Target Variable (対象変数)\]**​ を ​`aResult`​ に設定します。

![「Target Variable (対象変数)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-stored-example-5.png)

XML エディターでは、​`<db:stored-procedure>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="MsSQL" target="aResult">
  <db:sql ><![CDATA[{ call myProc() }]]></db:sql>
</db:stored-procedure>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=2dca5ed41a1adfdf95ede62efc30f81d7e135a64c8bcc26cb2072ffdfa5e5e7c url=/mulesoft/current/ja-jp/db-connector/1.14/database-stored-procedure.md -->

# ストアドプロシージャーの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作では、データベースでストアドプロシージャーを呼び出します。ストアドプロシージャーで 1 つまたは複数の ResultSet インスタンスが返される場合、パフォーマンスやメモリの問題につながる可能性のある結果の先制消費を回避するため、ストリーミングが自動的に割り当てられます。

次の例は、ストアドプロシージャーのコール可能なステートメントと日付、および ​**\[Input parameters (入力パラメーター)\]**​、​**\[Output parameters (出力パラメーター)\]**​、​**\[In out parameters (入出力パラメーター)\]**​ 項目を設定してストアドプロシージャーを呼び出す方法を示しています。

## [](#ストアドプロシージャーのコール可能なステートメント)ストアドプロシージャーのコール可能なステートメント

Database Connector は、次の形式のコール可能なステートメントの使用をサポートしています。

`{ call procedureName(:param1, :param2, …​, :paramN) }`

`:paramN`​ は、ストアドプロシージャー宣言の ​`Nth`​ パラメーターと一致します。ストアドプロシージャーの名前と最初の括弧の間に空白がないことを確認してください。 すべての JDBC ドライバーが JDBC 仕様形式に準拠している必要がありますが、一部のドライバーには独自の仕様があります。ストアドプロシージャーをコールする方法についての詳細は、JDBC ドライバーのドキュメントを確認してください。たとえば、Snowflake JDBC ドライバーでは、次のように中括弧 ​`{`​ および ​`}`​ を使用せずにコール可能なステートメントを設定する必要があります。

`call procedureName(:param1, :param2, …​, :paramN)`

### [](#ストアドプロシージャーにパラメーターを渡す)ストアドプロシージャーにパラメーターを渡す

パラメーターをストアドプロシージャーに渡す場合、次のようにします。

- ストアドプロシージャーのすべてのパラメーター (デフォルト値が設定される省略可能なパラメーターも含む) を配置する。
- ストアドプロシージャーで定義した順序でパラメーターを配置する。
- パラメーターをパラメーター化し、文字列や数値などをハードコード化しない。

次の例は、​`SYSTEM.employees`​ という名前のテーブルと ​`createEmployee`​ という名前のストアドプロシージャーを作成するときに初期化された Oracle データベースを示しています。

```xml
    CREATE TABLE SYSTEM.employees(
        employee_id INTEGER GENERATED BY DEFAULT AS IDENTITY,
        employee_name VARCHAR2(100),
        employee_age INTEGER,
        employee_birthday TIMESTAMP,
        PRIMARY KEY(employee_id)
    );


    CREATE PROCEDURE createEmployee(e_name VARCHAR2, e_age NUMBER, e_birth_date DATE) AS
    BEGIN
        INSERT INTO SYSTEM.employees(employee_name, employee_age, employee_birthday) VALUES(e_name, e_age, e_birth_date);
    END;
```

Database Connector はコール可能なステートメントでの名前付きパラメーターをサポートしていないため、名前でパラメーターを一致させようとしても機能しません。例:

`{ call createEmployee(e_age ⇒ :age, e_birth_date ⇒ :date, e_name ⇒ :name) }`

パラメーターは、適切な順序で指定する必要があります。例:

`{ call createEmployee(:name, :age, :date) }`​.

## [](#ストアドプロシージャーのデータの使用)ストアドプロシージャーのデータの使用

Database Connector は、エンジン固有の組み込み関数の使用をサポートしていません。たとえば、Oracle データベースでプロシージャーをコールする前に日付を特定の形式に変更する場合、次のアプローチは機能しません。

`{ call createEmployee(e_name ⇒ :name, employee_age ⇒ :age, e_birth_date ⇒ TO_DATE(:date, 'YYYY-MM-DD HH:mm:ss')) }.`

コール可能なステートメントを呼び出す前に、すべてのデータ変換で DataWeave を使用します。前の例を使用して、次の変換を実行します。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call createEmployee(:name, :age, :date) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次の DataWeave コードに設定します。

```dataweave
%dw 2.0
  output application/json
  fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
  ---
  { 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }

[source,xml,linenums]
```

次のスクリーンショットは、Studio の設定を示しています。

![Stored procedure 操作の日付の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-stored-example-4.png)

Figure 1. ストアドプロシージャーの日付の設定

XML エディターでは、DataWeave 変換を使用した ​`<db:input-parameters>`​ は次のように記述されます。

```xml
<db:stored-procedure doc:name="Create Employee" config-ref="Database_Config">
    <db:sql>{ call createEmployee(:name, :age, :date) }</db:sql>
		<db:input-parameters>
		 	<![CDATA[#[%dw 2.0
				output application/json
				fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
				---
				{ 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }
			]]]>
		</db:input-parameters>
	</db:stored-procedure>
```

## [](#stored-procedure-操作の-input-parameters-入力パラメーター-項目を設定する)Stored Procedure 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

**\[Input parameters (入力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップを作成する値を指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。パラメーターに値を渡す場合、次のようにします。

- 一重引用符を使用して各パラメーターを定義する (例: `'paramName': value`​)。
- デフォルト値には、DataWeave または変数を使用する。これにより、null または空の文字列を渡しても、Mule Runtime Engine によってストアドプロシージャーのデフォルト値が転送されなくなります。
- 入力値を入力するときはパラメーターを使用する必要があります。​**Stored Procedure**​ 操作内の値をハードコードしないでください。

**\[Input parameters (入力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call doubleMyInt(:myInt) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を ​`{'myInt' : payload}`​ に設定します。

XML エディターでは、​`<db:stored-procedure>`​ および ​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
    <db:input-parameters>
        #[{'description' : payload}]
    </db:input-parameters>
</db:stored-procedure>
```

## [](#stored-procedure-操作の-in-out-parameters-入出力パラメーター-項目を設定する)Stored Procedure 操作の \[In Out Parameters (入出力パラメーター)\] 項目を設定する

**\[In out parameters (入出力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定するパラメーター (入力と出力の両方) の名前をキーとするマップを作成する値を指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。

**\[In out parameters (入出力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call doubleMyInt(:myInt) }`
3. **\[In out parameters (入出力パラメーター)\]**​ 項目を ​`Edit inline`​ に設定します。
4. プラス記号 (​**+**​) をクリックして、新しい値を追加します。
5. 新しいウィンドウで、​**\[Key (キー)\]**​ 項目を ​`myInt`​、​**\[Value (値)\]**​ 項目を ​`3`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「In out parameters (入出力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-stored-example-2.png)

Figure 2. \[In Out parameters (入出力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:stored-procedure>`​ および ​`<db:in-out-parameter>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
  <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
  <db:in-out-parameters>
      <db:in-out-parameter key="myInt" value="3"/>
  </db:in-out-parameters>
</db:stored-procedure>
```

## [](#stored-procedure-操作の-input-parameters-入力パラメーター-項目と-output-parameters-出力パラメーター-項目を設定する)Stored Procedure 操作の \[Input Parameters (入力パラメーター)\] 項目と \[Output Parameters (出力パラメーター)\] 項目を設定する

**\[Output parameters (出力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定する値のリストを指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `call multiply(:value, :result)`​)。

**\[Input parameters (入力パラメーター)\]**​ 項目と ​**\[Output parameters (出力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次のように設定します。
    
    ```xml
    {
        'int1' : 3,
        'int2' : 4,
        'int3' : 5
    }
    ```
4. **\[Output parameters (出力パラメーター)\]**​ 項目を ​`Edit inline`​ に設定します。
5. プラス記号 (​**+**​) をクリックして、新しい値を追加します。
6. 新しいウィンドウで、​**\[Key (キー)\]**​ 項目を ​`result1`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。
7. ステップ 5 と 6 を繰り返して新しい値を追加し、​**\[Key (キー)\]**​ 項目を ​`result2`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input parameters (入力パラメーター)」 項目と 「Output parameters (出力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-stored-example-3.png)

Figure 3. \[Input parameters (入力パラメーター)\] と \[Output parameters (出力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:input-parameters>`​ および ​`<db:output-parameters>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }</db:sql>
    <db:input-parameters>
        #[{
            'int1' : 3,
            'int2' : 4,
            'int3' : 5
        }]
    </db:input-parameters>
    <db:output-parameters>
        <db:output-parameter key="result1" type="INTEGER"/>
        <db:output-parameter key="result2" type="INTEGER"/>
    </db:output-parameters>
</db:stored-procedure>
```

## [](#結果セットを返す)結果セットを返す

結果セットを返すストアドプロシージャーをコールすると、結果セットはデフォルトでペイロードに割り当てられます。返される結果セットを変更するには、​**Stored procedure**​ 操作設定の ​**\[Advanced (詳細)\]**​ タブで ​**\[Target Variable (対象変数)\]**​ または ​**\[Target Value (対象値)\]**​ を設定します。

次の例は、​`languages`​ という名前のテーブルと、結果セットを返す ​`myProc`​ という名前のストアドプロシージャーを作成するときに初期化される MSSQL データベースを示しています。

```xml
CREATE TABLE LANGUAGES (NAME VARCHAR(128), SAMPLE_TEXT VARCHAR(max));

CREATE PROCEDURE myProc AS
   SELECT * FROM LANGUAGES l;
RETURN;
```

1. **Stored procedure**​ 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`{ call myProc() }`​ に設定します。
2. **\[Advanced (詳細)\]**​ タブで、​**\[Target Variable (対象変数)\]**​ を ​`aResult`​ に設定します。

![「Target Variable (対象変数)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-stored-example-5.png)

XML エディターでは、​`<db:stored-procedure>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="MsSQL" target="aResult">
  <db:sql ><![CDATA[{ call myProc() }]]></db:sql>
</db:stored-procedure>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=4317e460b95e786cdcecd0b0477ae94d53738be4ecc8edf544e315246b3b8030 url=/mulesoft/current/ja-jp/db-connector/1.9/database-stored-procedure.md -->

# ストアドプロシージャーの実行の例

データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作では、データベースでストアドプロシージャーを呼び出します。ストアドプロシージャーで 1 つまたは複数の ResultSet インスタンスが返される場合、パフォーマンスやメモリの問題につながる可能性のある結果の先制消費を回避するため、ストリーミングが自動的に割り当てられます。

次の例は、ストアドプロシージャーのコール可能なステートメントと日付、および ​**\[Input parameters (入力パラメーター)\]**​、​**\[Output parameters (出力パラメーター)\]**​、​**\[In out parameters (入出力パラメーター)\]**​ 項目を設定してストアドプロシージャーを呼び出す方法を示しています。

## [](#ストアドプロシージャーのコール可能なステートメント)ストアドプロシージャーのコール可能なステートメント

Database Connector は、次の形式のコール可能なステートメントの使用をサポートしています。

`{ call procedureName(:param1, :param2, …​, :paramN) }`

`:paramN`​ は、ストアドプロシージャー宣言の ​`Nth`​ パラメーターと一致します。ストアドプロシージャーの名前と最初の括弧の間に空白がないことを確認してください。 すべての JDBC ドライバーが JDBC 仕様形式に準拠している必要がありますが、一部のドライバーには独自の仕様があります。ストアドプロシージャーをコールする方法についての詳細は、JDBC ドライバーのドキュメントを確認してください。たとえば、Snowflake JDBC ドライバーでは、次のように中括弧 ​`{`​ および ​`}`​ を使用せずにコール可能なステートメントを設定する必要があります。

`call procedureName(:param1, :param2, …​, :paramN)`

### [](#ストアドプロシージャーにパラメーターを渡す)ストアドプロシージャーにパラメーターを渡す

パラメーターをストアドプロシージャーに渡す場合、次のようにします。

- ストアドプロシージャーのすべてのパラメーター (デフォルト値が設定される省略可能なパラメーターも含む) を配置する。
- ストアドプロシージャーで定義した順序でパラメーターを配置する。
- パラメーターをパラメーター化し、文字列や数値などをハードコード化しない。

次の例は、​`SYSTEM.employees`​ という名前のテーブルと ​`createEmployee`​ という名前のストアドプロシージャーを作成するときに初期化された Oracle データベースを示しています。

```xml
    CREATE TABLE SYSTEM.employees(
        employee_id INTEGER GENERATED BY DEFAULT AS IDENTITY,
        employee_name VARCHAR2(100),
        employee_age INTEGER,
        employee_birthday TIMESTAMP,
        PRIMARY KEY(employee_id)
    );


    CREATE PROCEDURE createEmployee(e_name VARCHAR2, e_age NUMBER, e_birth_date DATE) AS
    BEGIN
        INSERT INTO SYSTEM.employees(employee_name, employee_age, employee_birthday) VALUES(e_name, e_age, e_birth_date);
    END;
```

Database Connector はコール可能なステートメントでの名前付きパラメーターをサポートしていないため、名前でパラメーターを一致させようとしても機能しません。例:

`{ call createEmployee(e_age ⇒ :age, e_birth_date ⇒ :date, e_name ⇒ :name) }`

パラメーターは、適切な順序で指定する必要があります。例:

`{ call createEmployee(:name, :age, :date) }`​.

## [](#ストアドプロシージャーのデータの使用)ストアドプロシージャーのデータの使用

Database Connector は、エンジン固有の組み込み関数の使用をサポートしていません。たとえば、Oracle データベースでプロシージャーをコールする前に日付を特定の形式に変更する場合、次のアプローチは機能しません。

`{ call createEmployee(e_name ⇒ :name, employee_age ⇒ :age, e_birth_date ⇒ TO_DATE(:date, 'YYYY-MM-DD HH:mm:ss')) }.`

コール可能なステートメントを呼び出す前に、すべてのデータ変換で DataWeave を使用します。前の例を使用して、次の変換を実行します。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call createEmployee(:name, :age, :date) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次の DataWeave コードに設定します。

```dataweave
%dw 2.0
  output application/json
  fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
  ---
  { 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }

[source,xml,linenums]
```

次のスクリーンショットは、Studio の設定を示しています。

![Stored procedure 操作の日付の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-stored-example-4.png)

Figure 1. ストアドプロシージャーの日付の設定

XML エディターでは、DataWeave 変換を使用した ​`<db:input-parameters>`​ は次のように記述されます。

```xml
<db:stored-procedure doc:name="Create Employee" config-ref="Database_Config">
    <db:sql>{ call createEmployee(:name, :age, :date) }</db:sql>
		<db:input-parameters>
		 	<![CDATA[#[%dw 2.0
				output application/json
				fun format(d: DateTime) = d as String { format: "yyyy-MM-dd HH:mm:ss" }
				---
				{ 'date': format(|2019-10-31T13:00:00.000Z|), 'name': 'rick', 'age': 60 }
			]]]>
		</db:input-parameters>
	</db:stored-procedure>
```

## [](#stored-procedure-操作の-input-parameters-入力パラメーター-項目を設定する)Stored Procedure 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

**\[Input parameters (入力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップを作成する値を指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。パラメーターに値を渡す場合、次のようにします。

- 一重引用符を使用して各パラメーターを定義する (例: `'paramName': value`​)。
- デフォルト値には、DataWeave または変数を使用する。これにより、null または空の文字列を渡しても、Mule Runtime Engine によってストアドプロシージャーのデフォルト値が転送されなくなります。

**\[Input parameters (入力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call doubleMyInt(:myInt) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を ​`{'description' : payload}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input parameter (入力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-stored-example-1.png)

Figure 2. \[Input parameter (入力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:stored-procedure>`​ および ​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
    <db:input-parameters>
        #[{'description' : payload}]
    </db:input-parameters>
</db:stored-procedure>
```

## [](#stored-procedure-操作の-in-out-parameters-入出力パラメーター-項目を設定する)Stored Procedure 操作の \[In Out Parameters (入出力パラメーター)\] 項目を設定する

**\[In out parameters (入出力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定するパラメーター (入力と出力の両方) の名前をキーとするマップを作成する値を指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。

**\[In out parameters (入出力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call doubleMyInt(:myInt) }`
3. **\[In out parameters (入出力パラメーター)\]**​ 項目を ​`Edit inline`​ に設定します。
4. プラス記号 (​**+**​) をクリックして、新しい値を追加します。
5. 新しいウィンドウで、​**\[Key (キー)\]**​ 項目を ​`myInt`​、​**\[Value (値)\]**​ 項目を ​`3`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「In out parameters (入出力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-stored-example-2.png)

Figure 3. \[In Out parameters (入出力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:stored-procedure>`​ および ​`<db:in-out-parameter>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
  <db:sql>{ call doubleMyInt(:myInt) }</db:sql>
  <db:in-out-parameters>
      <db:in-out-parameter key="myInt" value="3"/>
  </db:in-out-parameters>
</db:stored-procedure>
```

## [](#stored-procedure-操作の-input-parameters-入力パラメーター-項目と-output-parameters-出力パラメーター-項目を設定する)Stored Procedure 操作の \[Input Parameters (入力パラメーター)\] 項目と \[Output Parameters (出力パラメーター)\] 項目を設定する

**\[Output parameters (出力パラメーター)\]**​ 項目で、JDBC プリペアードステートメントに設定する値のリストを指定します。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `call multiply(:value, :result)`​)。

**\[Input parameters (入力パラメーター)\]**​ 項目と ​**\[Output parameters (出力パラメーター)\]**​ 項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Stored procedure\]**​ 操作を選択します。
2. 操作設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:
    
    `{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }`
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次のように設定します。
    
    ```xml
    {
        'int1' : 3,
        'int2' : 4,
        'int3' : 5
    }
    ```
4. **\[Output parameters (出力パラメーター)\]**​ 項目を ​`Edit inline`​ に設定します。
5. プラス記号 (​**+**​) をクリックして、新しい値を追加します。
6. 新しいウィンドウで、​**\[Key (キー)\]**​ 項目を ​`result1`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。
7. ステップ 5 と 6 を繰り返して新しい値を追加し、​**\[Key (キー)\]**​ 項目を ​`result2`​、​**\[Type (型)\]**​ 項目を ​`INTEGER`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input parameters (入力パラメーター)」 項目と 「Output parameters (出力パラメーター)」 項目を使用した Stored procedure 操作の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-stored-example-3.png)

Figure 4. \[Input parameters (入力パラメーター)\] と \[Output parameters (出力パラメーター)\] を使用したストアドプロシージャーの設定

XML エディターでは、​`<db:input-parameters>`​ および ​`<db:output-parameters>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="dbConfig">
    <db:sql>{ call multiplyInts(:int1, :int2, :result1, :int3, :result2) }</db:sql>
    <db:input-parameters>
        #[{
            'int1' : 3,
            'int2' : 4,
            'int3' : 5
        }]
    </db:input-parameters>
    <db:output-parameters>
        <db:output-parameter key="result1" type="INTEGER"/>
        <db:output-parameter key="result2" type="INTEGER"/>
    </db:output-parameters>
</db:stored-procedure>
```

## [](#結果セットを返す)結果セットを返す

結果セットを返すストアドプロシージャーをコールすると、結果セットはデフォルトでペイロードに割り当てられます。返される結果セットを変更するには、​**Stored procedure**​ 操作設定の ​**\[Advanced (詳細)\]**​ タブで ​**\[Target Variable (対象変数)\]**​ または ​**\[Target Value (対象値)\]**​ を設定します。

次の例は、​`languages`​ という名前のテーブルと、結果セットを返す ​`myProc`​ という名前のストアドプロシージャーを作成するときに初期化される MSSQL データベースを示しています。

```xml
CREATE TABLE LANGUAGES (NAME VARCHAR(128), SAMPLE_TEXT VARCHAR(max));

CREATE PROCEDURE myProc AS
   SELECT * FROM LANGUAGES l;
RETURN;
```

1. **Stored procedure**​ 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`{ call myProc() }`​ に設定します。
2. **\[Advanced (詳細)\]**​ タブで、​**\[Target Variable (対象変数)\]**​ を ​`aResult`​ に設定します。

XML エディターでは、​`<db:stored-procedure>`​ 設定は次のように記述されます。

```xml
<db:stored-procedure config-ref="MsSQL" target="aResult">
  <db:sql ><![CDATA[{ call myProc() }]]></db:sql>
</db:stored-procedure>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=03215d8aa3bed294cfc6a447b43ebfe58988799196ad0efa354dc52f3200539b url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-query-single.md -->

# データベースからの単一レコードの照会の例

データベース用 Anypoint Connector (Database Connector) の ​**Query single**​ 操作では、データベースから単一レコード (行) を返す SQL クエリを実行し、追加の変換なしで結果のペイロードにアクセスできます。この操作では、返された項目はストリーミングされません。クエリを実行すると、返された行のすべての値がメモリに読み込まれ、ペイロードに返されます。

ただし、注意が必要です。行が大きすぎるとメモリ不足になる可能性があります。 また、接続プーリングを使用する場合は、クエリの実行直後に接続がプールに返されるため、アプリケーションで接続が使い果たされることを心配する必要はありません。

**Query single**​ 操作を呼び出す方法は ​**Select**​ 操作と同じですが、​**Query single**​ 操作を使用すると、実際の SQL クエリで返されるレコード数に関係なく、取得する結果は常に 1 つのみになります。

次の例は、MySQL データベースのテーブルから本の情報を取得する操作を Mule アプリケーション内で設定する方法を示しています。この例を実行するには、次の操作が必要です。  

- `BOOK`​ というテーブルを作成する SQL ステートメントを実行し、7 件の本情報 (title、author、bookshopName、isbn、price) のレコードを挿入します。
- SQL データベース接続を設定します。
- Mule アプリケーションを作成します。
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストします。

![データベースからの単一レコードの照会のフロー](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-query-single-flow.png)

Figure 1. データベースからの単一レコードの照会のフロー

## [](#データベースのテーブルの作成)データベースのテーブルの作成

SQL データベース接続を設定して Mule アプリケーションを作成する前に、次の SQL ステートメントを実行して ​`BOOK`​ というテーブルを作成し、7 件の本レコードを挿入します。増分 ​`id`​ は、テーブルに追加される新しい各本に関連付けられます。たとえば、テーブルに最初に追加された本の ​`id`​ は ​`1`​ になり、2 番目の本の ​`id`​ は ​`2`​ になります。

```sql
USE SYS;

CREATE TABLE BOOK(
    id MEDIUMINT NOT NULL AUTO_INCREMENT,
    title VARCHAR(100),
    author VARCHAR(100),
    bookshopName VARCHAR(100),
    isbn VARCHAR(13),
    price SMALLINT,
    PRIMARY KEY (id)
);

INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Good Omens', 'Terry Pratchett and Neil Gaiman', 'A.Z. Fell and Co.', '9780060853983', 50);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('A Wizard of Earthsea', 'Ursula K. Le Guin', 'A.Z. Fell and Co.', '9780547773742', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('IT', 'Stephen King', 'A.Z. Fell and Co.', '9781508297123', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('The Nice and Accurate Prophecies of Agnes Nutter', 'Agnes Nutter', 'A.Z. Fell and Co.', '000000000000', 200);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Cujo', 'Stephen King', 'A.Z. Fell and Co.', '9781501192241', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Nation', 'Terry Pratchett', 'A.Z. Fell and Co.', '9780552557795', 30);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('The Ocean at the End of the Lane', 'Neil Gaiman', 'A.Z. Fell and Co.', '9780062459367', 30);
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

テーブルを作成したら、Anypoint Studio に移動して MySQL データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次の項目に入力します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次の項目に入力します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `3306`
    - **User (ユーザー)**​: `root`
    - **Password (パスワード)**​: `mysql`
    - **Database (データベース)**​: `sys`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. **\[Max pool size (最大プールサイズ)\]**​ 項目を ​`5`​ に設定します。
10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
11. **\[OK\]**​ をクリックします。

次のスクリーンショットは、HTTP ​**リスナー**​のグローバル要素設定を示しています。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-querysingle-example-1.png)

Figure 2. HTTP リスナーの設定

次のスクリーンショットは、データベースのグローバル要素設定を示しています。

![「\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースの一般設定。」](_images/database-querysingle-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

## [](#mule-アプリケーションの作成設定実行テスト)Mule アプリケーションの作成、設定、実行、テスト

MySQL データベース接続を設定したら、Mule アプリケーションの作成、設定、実行、テストを行います。

### [](#http-リスナーと-set-variable-コンポーネントの設定によるフローの作成)HTTP リスナーと Set Variable コンポーネントの設定によるフローの作成

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/select/book/{maxId}`​ に設定します。  
    `maxId`​ 値パラメーターは、データベースから取得する本レコードの数を示します。データベース接続プールに設定された最大接続数に関係なく、この値を増分できます。
4. **\[Mime Type (Mime タイプ)\]**​ タブで ​**\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/json`​ に設定します。
5. **\[Advanced (詳細)\]**​ タブで ​**\[Allowed methods (許可されるメソッド)\]**​ 項目を ​`GET`​ に設定します。
6. **\[Set Variable\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。  
    このコンポーネントでは、​**Query single**​ 操作から取得されるデータベース結果を保存するための新しい変数を作成します。
7. **\[Name (名前)\]**​ 項目を ​`bookCollection`​、​**\[Value (値)\]**​ 項目を ​`#[[]]`​ に設定します。

![Set Variable コンポーネントの設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-querysingle-example-3.png)

Figure 4. Set Variable の設定

### [](#for-each-コンポーネントquery-single-操作set-payload-コンポーネントの設定)For Each コンポーネント、Query Single 操作、Set Payload コンポーネントの設定

**For Each**​ コンポーネントを使用して、​**HTTP リスナー**​で要求された本の数まで反復処理することで、Mule アプリケーションの作成を継続します。次に、​**Query single**​ 操作を使用して本の情報を取得し、結果をペイロード変数に保存します。

1. **\[For Each\]**​ コンポーネントを ​**\[Set Variable\]**​ の右にドラッグします。
2. **\[Collection (コレクション)\]**​ 項目を ​`#[1 to attributes.uriParams.maxId as Number]`​ に設定します。  
    HTTP 要求 ​`/select/book/{maxId}`​ を実行すると、この式により、テーブル内の本のコレクションが最初の本 (​`1`​) から ​`maxId`​ パラメーターに設定された本の数まで反復処理されます。
    
    ![For Each の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-querysingle-example-4.png)
    
    Figure 5. For Each の設定
3. **\[Query single\]**​ 操作を ​**\[For Each\]**​ コンポーネントにドラッグします。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目を ​`Database_Config`​ に設定して、MySQL データベース設定に接続します。
5. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT id, title, author FROM BOOK WHERE id = :id`​ に設定します。  
    このクエリでは、データベースから本の情報を選択します。
6. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`![CDATA[#[{'id': payload }]]]`​ に設定します。  
    この式では、(前述の ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 式で参照されている) キーパラメーター ​`id`​ を、​`SELECT`​ クエリを使用して取得した本情報の結果値である ​`payload`​ にマップします。
    
    ![Query single の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-querysingle-example-5.png)
    
    Figure 6. Query single の設定
7. 別の ​**\[Set Variable\]**​ コンポーネントを ​**\[Query single\]**​ 操作の右にドラッグします。
8. **\[Name (名前)\]**​ 項目を ​`bookCollection`​、​**\[Value (値)\]**​ 項目を ​`#[vars.bookCollection ++ [payload]]`​ に設定します。  
    元の変数 ​`bookCollection`​ に、取得した本情報の ​`payload`​ が保存されるようになります。
9. **\[Set Payload\]**​ コンポーネントを ​**\[For Each\]**​ コンポーネントの右にドラッグします。
10. **\[Value (値)\]**​ 項目を ​`#[vars.bookCollection]`​ に設定して、変数コンテンツを新しい出力ペイロードとして保存します。

![Set Payload の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-querysingle-example-6.png)

Figure 7. Set Payload の設定

### [](#mule-アプリケーションの実行およびテスト)Mule アプリケーションの実行およびテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. コマンドラインで ​`curl localhost:8081/select/book/7`​ を実行して、アプリケーションをテストします。  
    このコマンドでは、プールに設定されている最大接続数 (​`5`​) に関係なく、テーブルの最初の 7 個の本を選択します。

## [](#データベースからの単一レコードを照会するための-xml)データベースからの単一レコードを照会するための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd"></mule>
	<http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" doc:id="9501220e-fba8-440b-afdf-14b4ca010fe8" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="Database_Config" doc:name="Database Config" doc:id="20db2231-3668-48d0-bb60-66f120fc99c8" >
		<db:my-sql-connection host="localhost" port="3306" user="root" password="mysql" database="sys">
			<db:pooling-profile maxPoolSize="5"/>
		</db:my-sql-connection>
	</db:config>

	<flow name="querysingleForeachFlow">
		<http:listener doc:name="Listener" config-ref="HTTP_Listener_config" path="/select/book/{maxId}" outputMimeType="application/json" allowedMethods="GET"/>
		<set-variable variableName="bookCollection" value="#[[]]" />
		<foreach collection="#[1 to attributes.uriParams.maxId as Number]">
			<db:query-single doc:name="Query single" config-ref="Database_Config">
				<db:sql>SELECT id, title, author FROM BOOK WHERE id = :id</db:sql>
				<db:input-parameters><![CDATA[#[{'id': payload }]]]></db:input-parameters>
			</db:query-single>
			<set-variable variableName="bookCollection" value="#[vars.bookCollection ++ [payload]]" />
		</foreach>
		<set-payload value="#[output application/json --- { books : vars.bookCollection }]" />
	</flow>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=872097ad229221584688ed5a55a64723f92351f16cd8881c7de688688c563f48 url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-query-single.md -->

# データベースからの単一レコードの照会の例

データベース用 Anypoint Connector (Database Connector) の ​**Query single**​ 操作では、データベースから単一レコード (行) を返す SQL クエリを実行し、追加の変換なしで結果のペイロードにアクセスできます。この操作では、返された項目はストリーミングされません。クエリを実行すると、返された行のすべての値がメモリに読み込まれ、ペイロードに返されます。

ただし、注意が必要です。行が大きすぎるとメモリ不足になる可能性があります。 また、接続プーリングを使用する場合は、クエリの実行直後に接続がプールに返されるため、アプリケーションで接続が使い果たされることを心配する必要はありません。

**Query single**​ 操作を呼び出す方法は ​**Select**​ 操作と同じですが、​**Query single**​ 操作を使用すると、実際の SQL クエリで返されるレコード数に関係なく、取得する結果は常に 1 つのみになります。

次の例は、MySQL データベースのテーブルから本の情報を取得する操作を Mule アプリケーション内で設定する方法を示しています。この例を実行するには、次の操作が必要です。  

- `BOOK`​ というテーブルを作成する SQL ステートメントを実行し、7 件の本情報 (title、author、bookshopName、isbn、price) のレコードを挿入します。
- SQL データベース接続を設定します。
- Mule アプリケーションを作成します。
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストします。

![データベースからの単一レコードの照会のフロー](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-query-single-flow.png)

Figure 1. データベースからの単一レコードの照会のフロー

## [](#データベースのテーブルの作成)データベースのテーブルの作成

SQL データベース接続を設定して Mule アプリケーションを作成する前に、次の SQL ステートメントを実行して ​`BOOK`​ というテーブルを作成し、7 件の本レコードを挿入します。増分 ​`id`​ は、テーブルに追加される新しい各本に関連付けられます。たとえば、テーブルに最初に追加された本の ​`id`​ は ​`1`​ になり、2 番目の本の ​`id`​ は ​`2`​ になります。

```sql
USE SYS;

CREATE TABLE BOOK(
    id MEDIUMINT NOT NULL AUTO_INCREMENT,
    title VARCHAR(100),
    author VARCHAR(100),
    bookshopName VARCHAR(100),
    isbn VARCHAR(13),
    price SMALLINT,
    PRIMARY KEY (id)
);

INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Good Omens', 'Terry Pratchett and Neil Gaiman', 'A.Z. Fell and Co.', '9780060853983', 50);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('A Wizard of Earthsea', 'Ursula K. Le Guin', 'A.Z. Fell and Co.', '9780547773742', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('IT', 'Stephen King', 'A.Z. Fell and Co.', '9781508297123', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('The Nice and Accurate Prophecies of Agnes Nutter', 'Agnes Nutter', 'A.Z. Fell and Co.', '000000000000', 200);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Cujo', 'Stephen King', 'A.Z. Fell and Co.', '9781501192241', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Nation', 'Terry Pratchett', 'A.Z. Fell and Co.', '9780552557795', 30);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('The Ocean at the End of the Lane', 'Neil Gaiman', 'A.Z. Fell and Co.', '9780062459367', 30);
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

テーブルを作成したら、Anypoint Studio に移動して MySQL データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次の項目に入力します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次の項目に入力します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `3306`
    - **User (ユーザー)**​: `root`
    - **Password (パスワード)**​: `mysql`
    - **Database (データベース)**​: `sys`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. **\[Max pool size (最大プールサイズ)\]**​ 項目を ​`5`​ に設定します。
10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
11. **\[OK\]**​ をクリックします。

次のスクリーンショットは、HTTP ​**リスナー**​のグローバル要素設定を示しています。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-querysingle-example-1.png)

Figure 2. HTTP リスナー設定

次のスクリーンショットは、データベースのグローバル要素設定を示しています。

![「\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースの一般設定。」](_images/database-querysingle-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

## [](#mule-アプリケーションの作成設定実行テスト)Mule アプリケーションの作成、設定、実行、テスト

MySQL データベース接続を設定したら、Mule アプリケーションの作成、設定、実行、テストを行います。

### [](#http-リスナーと-set-variable-コンポーネントの設定によるフローの作成)HTTP リスナーと Set Variable コンポーネントの設定によるフローの作成

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/select/book/{maxId}`​ に設定します。  
    `maxId`​ 値パラメーターは、データベースから取得する本レコードの数を示します。データベース接続プールに設定された最大接続数に関係なく、この値を増分できます。
4. **\[Mime Type (Mime タイプ)\]**​ タブで ​**\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/json`​ に設定します。
5. **\[Advanced (詳細)\]**​ タブで ​**\[Allowed methods (許可されるメソッド)\]**​ 項目を ​`GET`​ に設定します。
6. **\[Set Variable\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。  
    このコンポーネントでは、​**Query single**​ 操作から取得されるデータベース結果を保存するための新しい変数を作成します。
7. **\[Name (名前)\]**​ 項目を ​`bookCollection`​、​**\[Value (値)\]**​ 項目を ​`#[[]]`​ に設定します。

![Set Variable コンポーネントの設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-querysingle-example-3.png)

Figure 4. Set Variable の設定

### [](#for-each-コンポーネントquery-single-操作set-payload-コンポーネントの設定)For Each コンポーネント、Query Single 操作、Set Payload コンポーネントの設定

**For Each**​ コンポーネントを使用して、​**HTTP リスナー**​で要求された本の数まで反復処理することで、Mule アプリケーションの作成を継続します。次に、​**Query single**​ 操作を使用して本の情報を取得し、結果をペイロード変数に保存します。

1. **\[For Each\]**​ コンポーネントを ​**\[Set Variable\]**​ の右にドラッグします。
2. **\[Collection (コレクション)\]**​ 項目を ​`#[1 to attributes.uriParams.maxId as Number]`​ に設定します。  
    HTTP 要求 ​`/select/book/{maxId}`​ を実行すると、この式により、テーブル内の本のコレクションが最初の本 (​`1`​) から ​`maxId`​ パラメーターに設定された本の数まで反復処理されます。
    
    ![For Each の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-querysingle-example-4.png)
    
    Figure 5. For Each の設定
3. **\[Query single\]**​ 操作を ​**\[For Each\]**​ コンポーネントにドラッグします。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目を ​`Database_Config`​ に設定して、MySQL データベース設定に接続します。
5. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT id, title, author FROM BOOK WHERE id = :id`​ に設定します。  
    このクエリでは、データベースから本の情報を選択します。
6. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`![CDATA[#[{'id': payload }]]]`​ に設定します。  
    この式では、(前述の ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 式で参照されている) キーパラメーター ​`id`​ を、​`SELECT`​ クエリを使用して取得した本情報の結果値である ​`payload`​ にマップします。
    
    ![Query single の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-querysingle-example-5.png)
    
    Figure 6. Query single の設定
7. 別の ​**\[Set Variable\]**​ コンポーネントを ​**\[Query single\]**​ 操作の右にドラッグします。
8. **\[Name (名前)\]**​ 項目を ​`bookCollection`​、​**\[Value (値)\]**​ 項目を ​`#[vars.bookCollection ++ [payload]]`​ に設定します。  
    元の変数 ​`bookCollection`​ に、取得した本情報の ​`payload`​ が保存されるようになります。
9. **\[Set Payload\]**​ コンポーネントを ​**\[For Each\]**​ コンポーネントの右にドラッグします。
10. **\[Value (値)\]**​ 項目を ​`#[vars.bookCollection]`​ に設定して、変数のコンテンツを新しい出力ペイロードとして保存します。

![Set Payload の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-querysingle-example-6.png)

Figure 7. Set Payload の設定

### [](#mule-アプリケーションの実行とテスト)Mule アプリケーションの実行とテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. コマンドラインで ​`curl localhost:8081/select/book/7`​ を実行して、アプリケーションをテストします。  
    このコマンドでは、プールに設定されている最大接続数 (​`5`​) に関係なく、テーブルの最初の 7 個の本を選択します。

## [](#データベースからの単一レコードを照会するための-xml)データベースからの単一レコードを照会するための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd"></mule>
	<http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" doc:id="9501220e-fba8-440b-afdf-14b4ca010fe8" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="Database_Config" doc:name="Database Config" doc:id="20db2231-3668-48d0-bb60-66f120fc99c8" >
		<db:my-sql-connection host="localhost" port="3306" user="root" password="mysql" database="sys">
			<db:pooling-profile maxPoolSize="5"/>
		</db:my-sql-connection>
	</db:config>

	<flow name="querysingleForeachFlow">
		<http:listener doc:name="Listener" config-ref="HTTP_Listener_config" path="/select/book/{maxId}" outputMimeType="application/json" allowedMethods="GET"/>
		<set-variable variableName="bookCollection" value="#[[]]" />
		<foreach collection="#[1 to attributes.uriParams.maxId as Number]">
			<db:query-single doc:name="Query single" config-ref="Database_Config">
				<db:sql>SELECT id, title, author FROM BOOK WHERE id = :id</db:sql>
				<db:input-parameters><![CDATA[#[{'id': payload }]]]></db:input-parameters>
			</db:query-single>
			<set-variable variableName="bookCollection" value="#[vars.bookCollection ++ [payload]]" />
		</foreach>
		<set-payload value="#[output application/json --- { books : vars.bookCollection }]" />
	</flow>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=f303badf40cb74495e8bc2dafcc942becee8a366faed42bd809f6f53308b99b5 url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-query-single.md -->

# データベースからの単一レコードの照会の例

データベース用 Anypoint Connector (Database Connector) の ​**Query single**​ 操作では、データベースから単一レコード (行) を返す SQL クエリを実行し、追加の変換なしで結果のペイロードにアクセスできます。この操作では、返された項目はストリーミングされません。クエリを実行すると、返された行のすべての値がメモリに読み込まれ、ペイロードに返されます。

ただし、注意が必要です。行が大きすぎるとメモリ不足になる可能性があります。 また、接続プーリングを使用する場合は、クエリの実行直後に接続がプールに返されるため、アプリケーションで接続が使い果たされることを心配する必要はありません。

**Query single**​ 操作を呼び出す方法は ​**Select**​ 操作と同じですが、​**Query single**​ 操作を使用すると、実際の SQL クエリで返されるレコード数に関係なく、取得する結果は常に 1 つのみになります。

次の例は、MySQL データベースのテーブルから本の情報を取得する操作を Mule アプリケーション内で設定する方法を示しています。この例を実行するには、次の操作が必要です。  

- `BOOK`​ というテーブルを作成する SQL ステートメントを実行し、7 件の本情報 (title、author、bookshopName、isbn、price) のレコードを挿入します。
- SQL データベース接続を設定します。
- Mule アプリケーションを作成します。
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストします。

![データベースからの単一レコードの照会のフロー](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-query-single-flow.png)

Figure 1. データベースからの単一レコードの照会のフロー

## [](#データベースのテーブルの作成)データベースのテーブルの作成

SQL データベース接続を設定して Mule アプリケーションを作成する前に、次の SQL ステートメントを実行して ​`BOOK`​ というテーブルを作成し、7 件の本レコードを挿入します。増分 ​`id`​ は、テーブルに追加される新しい各本に関連付けられます。たとえば、テーブルに最初に追加された本の ​`id`​ は ​`1`​ になり、2 番目の本の ​`id`​ は ​`2`​ になります。

```sql
USE SYS;

CREATE TABLE BOOK(
    id MEDIUMINT NOT NULL AUTO_INCREMENT,
    title VARCHAR(100),
    author VARCHAR(100),
    bookshopName VARCHAR(100),
    isbn VARCHAR(13),
    price SMALLINT,
    PRIMARY KEY (id)
);

INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Good Omens', 'Terry Pratchett and Neil Gaiman', 'A.Z. Fell and Co.', '9780060853983', 50);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('A Wizard of Earthsea', 'Ursula K. Le Guin', 'A.Z. Fell and Co.', '9780547773742', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('IT', 'Stephen King', 'A.Z. Fell and Co.', '9781508297123', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('The Nice and Accurate Prophecies of Agnes Nutter', 'Agnes Nutter', 'A.Z. Fell and Co.', '000000000000', 200);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Cujo', 'Stephen King', 'A.Z. Fell and Co.', '9781501192241', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Nation', 'Terry Pratchett', 'A.Z. Fell and Co.', '9780552557795', 30);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('The Ocean at the End of the Lane', 'Neil Gaiman', 'A.Z. Fell and Co.', '9780062459367', 30);
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

テーブルを作成したら、Anypoint Studio に移動して MySQL データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次の項目に入力します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次の項目に入力します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `3306`
    - **User (ユーザー)**​: `root`
    - **Password (パスワード)**​: `mysql`
    - **Database (データベース)**​: `sys`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. **\[Max pool size (最大プールサイズ)\]**​ 項目を ​`5`​ に設定します。
10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
11. **\[OK\]**​ をクリックします。

次のスクリーンショットは、HTTP ​**リスナー**​のグローバル要素設定を示しています。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-querysingle-example-1.png)

Figure 2. HTTP リスナーの設定

次のスクリーンショットは、データベースのグローバル要素設定を示しています。

![「\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースの一般設定。」](_images/database-querysingle-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

## [](#mule-アプリケーションの作成設定実行テスト)Mule アプリケーションの作成、設定、実行、テスト

MySQL データベース接続を設定したら、Mule アプリケーションの作成、設定、実行、テストを行います。

### [](#http-リスナーと-set-variable-コンポーネントの設定によるフローの作成)HTTP リスナーと Set Variable コンポーネントの設定によるフローの作成

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/select/book/{maxId}`​ に設定します。  
    `maxId`​ 値パラメーターは、データベースから取得する本レコードの数を示します。データベース接続プールに設定された最大接続数に関係なく、この値を増分できます。
4. **\[Mime Type (Mime タイプ)\]**​ タブで ​**\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/json`​ に設定します。
5. **\[Advanced (詳細)\]**​ タブで ​**\[Allowed methods (許可されるメソッド)\]**​ 項目を ​`GET`​ に設定します。
6. **\[Set Variable\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。  
    このコンポーネントでは、​**Query single**​ 操作から取得されるデータベース結果を保存するための新しい変数を作成します。
7. **\[Name (名前)\]**​ 項目を ​`bookCollection`​、​**\[Value (値)\]**​ 項目を ​`#[[]]`​ に設定します。

![Set Variable コンポーネントの設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-querysingle-example-3.png)

Figure 4. Set Variable の設定

### [](#for-each-コンポーネントquery-single-操作set-payload-コンポーネントの設定)For Each コンポーネント、Query Single 操作、Set Payload コンポーネントの設定

**For Each**​ コンポーネントを使用して、​**HTTP リスナー**​で要求された本の数まで反復処理することで、Mule アプリケーションの作成を継続します。次に、​**Query single**​ 操作を使用して本の情報を取得し、結果をペイロード変数に保存します。

1. **\[For Each\]**​ コンポーネントを ​**\[Set Variable\]**​ の右にドラッグします。
2. **\[Collection (コレクション)\]**​ 項目を ​`#[1 to attributes.uriParams.maxId as Number]`​ に設定します。  
    HTTP 要求 ​`/select/book/{maxId}`​ を実行すると、この式により、テーブル内の本のコレクションが最初の本 (​`1`​) から ​`maxId`​ パラメーターに設定された本の数まで反復処理されます。
    
    ![For Each の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-querysingle-example-4.png)
    
    Figure 5. For Each の設定
3. **\[Query single\]**​ 操作を ​**\[For Each\]**​ コンポーネントにドラッグします。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目を ​`Database_Config`​ に設定して、MySQL データベース設定に接続します。
5. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT id, title, author FROM BOOK WHERE id = :id`​ に設定します。  
    このクエリでは、データベースから本の情報を選択します。
6. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`![CDATA[#[{'id': payload }]]]`​ に設定します。  
    この式では、(前述の ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 式で参照されている) キーパラメーター ​`id`​ を、​`SELECT`​ クエリを使用して取得した本情報の結果値である ​`payload`​ にマップします。
    
    ![Query single の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-querysingle-example-5.png)
    
    Figure 6. Query single の設定
7. 別の ​**\[Set Variable\]**​ コンポーネントを ​**\[Query single\]**​ 操作の右にドラッグします。
8. **\[Name (名前)\]**​ 項目を ​`bookCollection`​、​**\[Value (値)\]**​ 項目を ​`#[vars.bookCollection ++ [payload]]`​ に設定します。  
    元の変数 ​`bookCollection`​ に、取得した本情報の ​`payload`​ が保存されるようになります。
9. **\[Set Payload\]**​ コンポーネントを ​**\[For Each\]**​ コンポーネントの右にドラッグします。
10. **\[Value (値)\]**​ 項目を ​`#[vars.bookCollection]`​ に設定して、変数コンテンツを新しい出力ペイロードとして保存します。

![Set Payload の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-querysingle-example-6.png)

Figure 7. Set Payload の設定

### [](#mule-アプリケーションの実行およびテスト)Mule アプリケーションの実行およびテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. コマンドラインで ​`curl localhost:8081/select/book/7`​ を実行して、アプリケーションをテストします。  
    このコマンドでは、プールに設定されている最大接続数 (​`5`​) に関係なく、テーブルの最初の 7 個の本を選択します。

## [](#データベースからの単一レコードを照会するための-xml)データベースからの単一レコードを照会するための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd"></mule>
	<http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" doc:id="9501220e-fba8-440b-afdf-14b4ca010fe8" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="Database_Config" doc:name="Database Config" doc:id="20db2231-3668-48d0-bb60-66f120fc99c8" >
		<db:my-sql-connection host="localhost" port="3306" user="root" password="mysql" database="sys">
			<db:pooling-profile maxPoolSize="5"/>
		</db:my-sql-connection>
	</db:config>

	<flow name="querysingleForeachFlow">
		<http:listener doc:name="Listener" config-ref="HTTP_Listener_config" path="/select/book/{maxId}" outputMimeType="application/json" allowedMethods="GET"/>
		<set-variable variableName="bookCollection" value="#[[]]" />
		<foreach collection="#[1 to attributes.uriParams.maxId as Number]">
			<db:query-single doc:name="Query single" config-ref="Database_Config">
				<db:sql>SELECT id, title, author FROM BOOK WHERE id = :id</db:sql>
				<db:input-parameters><![CDATA[#[{'id': payload }]]]></db:input-parameters>
			</db:query-single>
			<set-variable variableName="bookCollection" value="#[vars.bookCollection ++ [payload]]" />
		</foreach>
		<set-payload value="#[output application/json --- { books : vars.bookCollection }]" />
	</flow>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=8f3174576efb667c37d3dd70c1630975f70f4ce0883b85941d35a9da449056ff url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-query-single.md -->

# データベースからの単一レコードの照会の例

データベース用 Anypoint Connector (Database Connector) の ​**Query single**​ 操作では、データベースから単一レコード (行) を返す SQL クエリを実行し、追加の変換なしで結果のペイロードにアクセスできます。この操作では、返された項目はストリーミングされません。クエリを実行すると、返された行のすべての値がメモリに読み込まれ、ペイロードに返されます。

ただし、注意が必要です。行が大きすぎるとメモリ不足になる可能性があります。 また、接続プーリングを使用する場合は、クエリの実行直後に接続がプールに返されるため、アプリケーションで接続が使い果たされることを心配する必要はありません。

**Query single**​ 操作を呼び出す方法は ​**Select**​ 操作と同じですが、​**Query single**​ 操作を使用すると、実際の SQL クエリで返されるレコード数に関係なく、取得する結果は常に 1 つのみになります。

次の例は、MySQL データベースのテーブルから本の情報を取得する操作を Mule アプリケーション内で設定する方法を示しています。この例を実行するには、次の操作が必要です。  

- `BOOK`​ というテーブルを作成する SQL ステートメントを実行し、7 件の本情報 (title、author、bookshopName、isbn、price) のレコードを挿入します。
- SQL データベース接続を設定します。
- Mule アプリケーションを作成します。
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストします。

![データベースからの単一レコードの照会のフロー](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-query-single-flow.png)

Figure 1. データベースからの単一レコードの照会のフロー

## [](#データベースのテーブルの作成)データベースのテーブルの作成

SQL データベース接続を設定して Mule アプリケーションを作成する前に、次の SQL ステートメントを実行して ​`BOOK`​ というテーブルを作成し、7 件の本レコードを挿入します。増分 ​`id`​ は、テーブルに追加される新しい各本に関連付けられます。たとえば、テーブルに最初に追加された本の ​`id`​ は ​`1`​ になり、2 番目の本の ​`id`​ は ​`2`​ になります。

```sql
USE SYS;

CREATE TABLE BOOK(
    id MEDIUMINT NOT NULL AUTO_INCREMENT,
    title VARCHAR(100),
    author VARCHAR(100),
    bookshopName VARCHAR(100),
    isbn VARCHAR(13),
    price SMALLINT,
    PRIMARY KEY (id)
);

INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Good Omens', 'Terry Pratchett and Neil Gaiman', 'A.Z. Fell and Co.', '9780060853983', 50);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('A Wizard of Earthsea', 'Ursula K. Le Guin', 'A.Z. Fell and Co.', '9780547773742', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('IT', 'Stephen King', 'A.Z. Fell and Co.', '9781508297123', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('The Nice and Accurate Prophecies of Agnes Nutter', 'Agnes Nutter', 'A.Z. Fell and Co.', '000000000000', 200);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Cujo', 'Stephen King', 'A.Z. Fell and Co.', '9781501192241', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Nation', 'Terry Pratchett', 'A.Z. Fell and Co.', '9780552557795', 30);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('The Ocean at the End of the Lane', 'Neil Gaiman', 'A.Z. Fell and Co.', '9780062459367', 30);
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

テーブルを作成したら、Anypoint Studio に移動して MySQL データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次の項目に入力します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次の項目に入力します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `3306`
    - **User (ユーザー)**​: `root`
    - **Password (パスワード)**​: `mysql`
    - **Database (データベース)**​: `sys`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. **\[Max pool size (最大プールサイズ)\]**​ 項目を ​`5`​ に設定します。
10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
11. **\[OK\]**​ をクリックします。

次のスクリーンショットは、HTTP ​**リスナー**​のグローバル要素設定を示しています。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-querysingle-example-1.png)

Figure 2. HTTP リスナーの設定

次のスクリーンショットは、データベースのグローバル要素設定を示しています。

![「\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースの一般設定」](_images/database-querysingle-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

## [](#mule-アプリケーションの作成設定実行テスト)Mule アプリケーションの作成、設定、実行、テスト

MySQL データベース接続を設定したら、Mule アプリケーションの作成、設定、実行、テストを行います。

### [](#http-リスナーと-set-variable-コンポーネントの設定によるフローの作成)HTTP リスナーと Set Variable コンポーネントの設定によるフローの作成

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/select/book/{maxId}`​ に設定します。  
    `maxId`​ 値パラメーターは、データベースから取得する本レコードの数を示します。データベース接続プールに設定された最大接続数に関係なく、この値を増分できます。
4. **\[Mime Type (Mime タイプ)\]**​ タブで ​**\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/json`​ に設定します。
5. **\[Advanced (詳細)\]**​ タブで ​**\[Allowed methods (許可されるメソッド)\]**​ 項目を ​`GET`​ に設定します。
6. **\[Set Variable\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。  
    このコンポーネントでは、​**Query single**​ 操作から取得されるデータベース結果を保存するための新しい変数を作成します。
7. **\[Name (名前)\]**​ 項目を ​`bookCollection`​、​**\[Value (値)\]**​ 項目を ​`#[[]]`​ に設定します。

![Set Variable コンポーネントの設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-querysingle-example-3.png)

Figure 4. Set Variable の設定

### [](#for-each-コンポーネントquery-single-操作set-payload-コンポーネントの設定)For Each コンポーネント、Query Single 操作、Set Payload コンポーネントの設定

**For Each**​ コンポーネントを使用して、​**HTTP リスナー**​で要求された本の数まで反復処理することで、Mule アプリケーションの作成を継続します。次に、​**Query single**​ 操作を使用して本の情報を取得し、結果をペイロード変数に保存します。

1. **\[For Each\]**​ コンポーネントを ​**\[Set Variable\]**​ の右にドラッグします。
2. **\[Collection (コレクション)\]**​ 項目を ​`#[1 to attributes.uriParams.maxId as Number]`​ に設定します。  
    HTTP 要求 ​`/select/book/{maxId}`​ を実行すると、この式により、テーブル内の本のコレクションが最初の本 (​`1`​) から ​`maxId`​ パラメーターに設定された本の数まで反復処理されます。
    
    ![For Each の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-querysingle-example-4.png)
    
    Figure 5. For Each の設定
3. **\[Query single\]**​ 操作を ​**\[For Each\]**​ コンポーネントにドラッグします。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目を ​`Database_Config`​ に設定して、MySQL データベース設定に接続します。
5. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT id, title, author FROM BOOK WHERE id = :id`​ に設定します。  
    このクエリでは、データベースから本の情報を選択します。
6. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`![CDATA[#[{'id': payload }]]]`​ に設定します。  
    この式では、(前述の ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 式で参照されている) キーパラメーター ​`id`​ を、​`SELECT`​ クエリを使用して取得した本情報の結果値である ​`payload`​ にマップします。
    
    ![Query single の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-querysingle-example-5.png)
    
    Figure 6. Query single の設定
7. 別の ​**\[Set Variable\]**​ コンポーネントを ​**\[Query single\]**​ 操作の右にドラッグします。
8. **\[Name (名前)\]**​ 項目を ​`bookCollection`​、​**\[Value (値)\]**​ 項目を ​`#[vars.bookCollection ++ [payload]]`​ に設定します。  
    元の変数 ​`bookCollection`​ に、取得した本情報の ​`payload`​ が保存されるようになります。
9. **\[Set Payload\]**​ コンポーネントを ​**\[For Each\]**​ コンポーネントの右にドラッグします。
10. **\[Value (値)\]**​ 項目を ​`#[vars.bookCollection]`​ に設定して、変数のコンテンツを新しい出力ペイロードとして保存します。

![Set Payload の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-querysingle-example-6.png)

Figure 7. Set Payload の設定

### [](#mule-アプリケーションの実行およびテスト)Mule アプリケーションの実行およびテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. コマンドラインで ​`curl localhost:8081/select/book/7`​ を実行して、アプリケーションをテストします。  
    このコマンドでは、プールに設定されている最大接続数 (​`5`​) に関係なく、テーブルの最初の 7 個の本を選択します。

## [](#データベースからの単一レコードを照会するための-xml)データベースからの単一レコードを照会するための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd"></mule>
	<http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" doc:id="9501220e-fba8-440b-afdf-14b4ca010fe8" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="Database_Config" doc:name="Database Config" doc:id="20db2231-3668-48d0-bb60-66f120fc99c8" >
		<db:my-sql-connection host="localhost" port="3306" user="root" password="mysql" database="sys">
			<db:pooling-profile maxPoolSize="5"/>
		</db:my-sql-connection>
	</db:config>

	<flow name="querysingleForeachFlow">
		<http:listener doc:name="Listener" config-ref="HTTP_Listener_config" path="/select/book/{maxId}" outputMimeType="application/json" allowedMethods="GET"/>
		<set-variable variableName="bookCollection" value="#[[]]" />
		<foreach collection="#[1 to attributes.uriParams.maxId as Number]">
			<db:query-single doc:name="Query single" config-ref="Database_Config">
				<db:sql>SELECT id, title, author FROM BOOK WHERE id = :id</db:sql>
				<db:input-parameters><![CDATA[#[{'id': payload }]]]></db:input-parameters>
			</db:query-single>
			<set-variable variableName="bookCollection" value="#[vars.bookCollection ++ [payload]]" />
		</foreach>
		<set-payload value="#[output application/json --- { books : vars.bookCollection }]" />
	</flow>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=4e2ebee802bf6ea0aa3436533d00f5a0d0c1d07232c6010ec082f18d5deeaee9 url=/mulesoft/current/ja-jp/db-connector/1.9/database-connector-query-single.md -->

# データベースからの単一レコードの照会の例

データベース用 Anypoint Connector (Database Connector) の ​**Query single**​ 操作では、データベースから単一レコード (行) を返す SQL クエリを実行し、追加の変換なしで結果のペイロードにアクセスできます。この操作では、返された項目はストリーミングされません。クエリを実行すると、返された行のすべての値がメモリに読み込まれ、ペイロードに返されます。

ただし、注意が必要です。行が大きすぎるとメモリ不足になる可能性があります。 また、接続プーリングを使用する場合は、クエリの実行直後に接続がプールに返されるため、アプリケーションで接続が使い果たされることを心配する必要はありません。

**Query single**​ 操作を呼び出す方法は ​**Select**​ 操作と同じですが、​**Query single**​ 操作を使用すると、実際の SQL クエリで返されるレコード数に関係なく、取得する結果は常に 1 つのみになります。

次の例は、MySQL データベースのテーブルから本の情報を取得する操作を Mule アプリケーション内で設定する方法を示しています。この例を実行するには、次の操作が必要です。  

- `BOOK`​ というテーブルを作成する SQL ステートメントを実行し、7 件の本情報 (title、author、bookshopName、isbn、price) のレコードを挿入します。
- SQL データベース接続を設定します。
- Mule アプリケーションを作成します。
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストします。

![データベースからの単一レコードの照会のフロー](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-query-single-flow.png)

Figure 1. データベースからの単一レコードの照会のフロー

## [](#データベースのテーブルの作成)データベースのテーブルの作成

SQL データベース接続を設定して Mule アプリケーションを作成する前に、次の SQL ステートメントを実行して ​`BOOK`​ というテーブルを作成し、7 件の本レコードを挿入します。増分 ​`id`​ は、テーブルに追加される新しい各本に関連付けられます。たとえば、テーブルに最初に追加された本の ​`id`​ は ​`1`​ になり、2 番目の本の ​`id`​ は ​`2`​ になります。

```sql
USE SYS;

CREATE TABLE BOOK(
    id MEDIUMINT NOT NULL AUTO_INCREMENT,
    title VARCHAR(100),
    author VARCHAR(100),
    bookshopName VARCHAR(100),
    isbn VARCHAR(13),
    price SMALLINT,
    PRIMARY KEY (id)
);

INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Good Omens', 'Terry Pratchett and Neil Gaiman', 'A.Z. Fell and Co.', '9780060853983', 50);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('A Wizard of Earthsea', 'Ursula K. Le Guin', 'A.Z. Fell and Co.', '9780547773742', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('IT', 'Stephen King', 'A.Z. Fell and Co.', '9781508297123', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('The Nice and Accurate Prophecies of Agnes Nutter', 'Agnes Nutter', 'A.Z. Fell and Co.', '000000000000', 200);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Cujo', 'Stephen King', 'A.Z. Fell and Co.', '9781501192241', 20);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('Nation', 'Terry Pratchett', 'A.Z. Fell and Co.', '9780552557795', 30);
INSERT INTO BOOK(title, author, bookshopName, isbn, price) VALUES('The Ocean at the End of the Lane', 'Neil Gaiman', 'A.Z. Fell and Co.', '9780062459367', 30);
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

テーブルを作成したら、Anypoint Studio に移動して MySQL データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次の項目に入力します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次の項目に入力します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `3306`
    - **User (ユーザー)**​: `root`
    - **Password (パスワード)**​: `mysql`
    - **Database (データベース)**​: `sys`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. **\[Max pool size (最大プールサイズ)\]**​ 項目を ​`5`​ に設定します。
10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
11. **\[OK\]**​ をクリックします。

次のスクリーンショットは、HTTP ​**リスナー**​のグローバル要素設定を示しています。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-querysingle-example-1.png)

Figure 2. HTTP リスナーの設定

次のスクリーンショットは、データベースのグローバル要素設定を示しています。

![「\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースの一般設定。」](_images/database-querysingle-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

## [](#mule-アプリケーションの作成設定実行テスト)Mule アプリケーションの作成、設定、実行、テスト

MySQL データベース接続を設定したら、Mule アプリケーションの作成、設定、実行、テストを行います。

### [](#http-リスナーと-set-variable-コンポーネントの設定によるフローの作成)HTTP リスナーと Set Variable コンポーネントの設定によるフローの作成

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/select/book/{maxId}`​ に設定します。  
    `maxId`​ 値パラメーターは、データベースから取得する本レコードの数を示します。データベース接続プールに設定された最大接続数に関係なく、この値を増分できます。
4. **\[Mime Type (Mime タイプ)\]**​ タブで ​**\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/json`​ に設定します。
5. **\[Advanced (詳細)\]**​ タブで ​**\[Allowed methods (許可されるメソッド)\]**​ 項目を ​`GET`​ に設定します。
6. **\[Set Variable\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。  
    このコンポーネントでは、​**Query single**​ 操作から取得されるデータベース結果を保存するための新しい変数を作成します。
7. **\[Name (名前)\]**​ 項目を ​`bookCollection`​、​**\[Value (値)\]**​ 項目を ​`#[[]]`​ に設定します。

![Set Variable コンポーネントの設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-querysingle-example-3.png)

Figure 4. Set Variable の設定

### [](#for-each-コンポーネントquery-single-操作set-payload-コンポーネントの設定)For Each コンポーネント、Query Single 操作、Set Payload コンポーネントの設定

**For Each**​ コンポーネントを使用して、​**HTTP リスナー**​で要求された本の数まで反復処理することで、Mule アプリケーションの作成を継続します。次に、​**Query single**​ 操作を使用して本の情報を取得し、結果をペイロード変数に保存します。

1. **\[For Each\]**​ コンポーネントを ​**\[Set Variable\]**​ の右にドラッグします。
2. **\[Collection (コレクション)\]**​ 項目を ​`#[1 to attributes.uriParams.maxId as Number]`​ に設定します。  
    HTTP 要求 ​`/select/book/{maxId}`​ を実行すると、この式により、テーブル内の本のコレクションが最初の本 (​`1`​) から ​`maxId`​ パラメーターに設定された本の数まで反復処理されます。
    
    ![For Each の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-querysingle-example-4.png)
    
    Figure 5. For Each の設定
3. **\[Query single\]**​ 操作を ​**\[For Each\]**​ コンポーネントにドラッグします。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目を ​`Database_Config`​ に設定して、MySQL データベース設定に接続します。
5. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT id, title, author FROM BOOK WHERE id = :id`​ に設定します。  
    このクエリでは、データベースから本の情報を選択します。
6. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`![CDATA[#[{'id': payload }]]]`​ に設定します。  
    この式では、(前述の ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 式で参照されている) キーパラメーター ​`id`​ を、​`SELECT`​ クエリを使用して取得した本情報の結果値である ​`payload`​ にマップします。
    
    ![Query single の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-querysingle-example-5.png)
    
    Figure 6. Query single の設定
7. 別の ​**\[Set Variable\]**​ コンポーネントを ​**\[Query single\]**​ 操作の右にドラッグします。
8. **\[Name (名前)\]**​ 項目を ​`bookCollection`​、​**\[Value (値)\]**​ 項目を ​`#[vars.bookCollection ++ [payload]]`​ に設定します。  
    元の変数 ​`bookCollection`​ に、取得した本情報の ​`payload`​ が保存されるようになります。
9. **\[Set Payload\]**​ コンポーネントを ​**\[For Each\]**​ コンポーネントの右にドラッグします。
10. **\[Value (値)\]**​ 項目を ​`#[vars.bookCollection]`​ に設定して、変数コンテンツを新しい出力ペイロードとして保存します。

![Set Payload の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-querysingle-example-6.png)

Figure 7. Set Payload の設定

### [](#mule-アプリケーションの実行およびテスト)Mule アプリケーションの実行およびテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. コマンドラインで ​`curl localhost:8081/select/book/7`​ を実行して、アプリケーションをテストします。  
    このコマンドでは、プールに設定されている最大接続数 (​`5`​) に関係なく、テーブルの最初の 7 個の本を選択します。

## [](#データベースからの単一レコードを照会するための-xml)データベースからの単一レコードを照会するための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd"></mule>
	<http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" doc:id="9501220e-fba8-440b-afdf-14b4ca010fe8" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="Database_Config" doc:name="Database Config" doc:id="20db2231-3668-48d0-bb60-66f120fc99c8" >
		<db:my-sql-connection host="localhost" port="3306" user="root" password="mysql" database="sys">
			<db:pooling-profile maxPoolSize="5"/>
		</db:my-sql-connection>
	</db:config>

	<flow name="querysingleForeachFlow">
		<http:listener doc:name="Listener" config-ref="HTTP_Listener_config" path="/select/book/{maxId}" outputMimeType="application/json" allowedMethods="GET"/>
		<set-variable variableName="bookCollection" value="#[[]]" />
		<foreach collection="#[1 to attributes.uriParams.maxId as Number]">
			<db:query-single doc:name="Query single" config-ref="Database_Config">
				<db:sql>SELECT id, title, author FROM BOOK WHERE id = :id</db:sql>
				<db:input-parameters><![CDATA[#[{'id': payload }]]]></db:input-parameters>
			</db:query-single>
			<set-variable variableName="bookCollection" value="#[vars.bookCollection ++ [payload]]" />
		</foreach>
		<set-payload value="#[output application/json --- { books : vars.bookCollection }]" />
	</flow>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=7314c696d50e9b4b5d59bf671c7911b0daa940bfa6c353e0b8c0e24ab957cf02 url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-transactions.md -->

# データベーストランザクションの設定の例

データベース用 Anypoint Connector (Database Connector) を使用すると、トランザクションのコンテキストでデータベース操作を実行できます。各操作に ​**\[Transactional action (トランザクションアクション)\]**​ 項目があります。この項目を使用して、アクティブなトランザクションに関して、操作で実行できる結合アクションの種別を指定します。

次の例は、Studio で ​**\[Transactional action (トランザクションアクション)\]**​ 項目を設定する方法 (​**Select**​ 操作の場合と、​**Try**​ スコープコンポーネントを使用して操作をグループ化する場合の両方) を示しています。

## [](#studio-で-transactional-action-トランザクションアクション-項目を設定する)Studio で \[Transactional Action (トランザクションアクション)\] 項目を設定する

項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. コネクタ設定画面で、​**\[Advanced (詳細)\]**​ タブをクリックします。
3. **\[Transactional action (トランザクションアクション)\]**​ 項目を次のいずれかのオプションに設定します。
    
    - **ALWAYS\_JOIN**​  
        メッセージの受信時にトランザクションが進行中であると想定します。トランザクションがない場合、エラーが発生します。
    - **JOIN\_IF\_POSSIBLE**​  
        現在のトランザクションが使用可能な場合、そのトランザクションを結合します。それ以外の場合、トランザクションは実行されません。
    - **NOT\_SUPPORTED**​  
        存在するトランザクションの外部で実行します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Transactional action (トランザクションアクション)\] 項目の設定](_images/database-transactions-1.png)

Figure 1. \[Transactional action (トランザクションアクション)\] の設定

XML エディターでは、​`transactionalAction`​ 設定は次のように記述されます。

```xml
<db:select doc:name="Select" transactionalAction="ALWAYS_JOIN">
			<db:sql ><![CDATA[SELECT * FROM PLANET WHERE name = :name]]></db:sql>
</db:select>
```

## [](#try-スコープの-transactional-action-トランザクションアクション-項目を設定して操作をグループ化する)Try スコープの \[Transactional Action (トランザクションアクション)\] 項目を設定して操作をグループ化する

場合によっては、複数のクエリを同じトランザクションのコンテキストでアトミックに実行する必要があります。これらのクエリを、すでに存在するトランザクションのコンテキストで実行した場合、クエリは同じトランザクションに属します。

次の例は、銀行口座振替中に 2 つの Database Connector の ​**Update**​ 操作を使用して、1 つの口座から金額を引き、別の口座に加えるが、この 2 つの操作のいずれかが失敗した場合、両方の操作をロールバックすることを示しています。アクティブなトランザクションがない場合は、​**Try**​ スコープコンポーネントを使用して操作をグループすることでトランザクションを開始できます。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`try`​」を検索し、​**\[Try\]**​ スコープコンポーネントを選択します。
2. **\[Try\]**​ スコープコンポーネントを Studio キャンバスにドラッグします。
3. **\[Update\]**​ 操作を ​**\[Try\]**​ スコープコンポーネントの内部にドラッグします。
4. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
5. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
6. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source`​)。
7. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{‘money’ : payload.money, ‘source’: payload.source}`​ に設定します。
8. 別の ​**\[Update\]**​ 操作を ​**\[Try\]**​ コンポーネント内の最初の ​**\[Update\]**​ 操作の右にドラッグします。
9. **\[Connector configuration (コネクタ設定)\]**​ 項目を、以前に作成したデータベース接続に設定します。
10. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target`​)。
11. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{‘money’ : payload.money, ‘target’’: payload.target}`​ に設定します。
12. フローの ​**\[Try\]**​ スコープコンポーネントを選択します。
13. コンポーネント設定画面で、​**\[Transactional action (トランザクションアクション)\]**​ 項目を ​`ALWAYS_BEGIN`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Try コンポーネントの \[Transactional action (トランザクションアクション)\] 項目の設定](_images/database-transactions-2.png)

Figure 2. \[Transactional action (トランザクションアクション)\] の設定

XML エディターでは、​`transactionalAction`​ 設定は次のように記述されます。

```xml
<try transactionalAction="ALWAYS_BEGIN">
 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'source': payload.source}]</db:input-parameters>
 </db:update>

 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'target'': payload.target}]</db:input-parameters>
 </db:update>
</try>
```

## [](#トランザクションとストリーミング)トランザクションとストリーミング

一部の Database Connector 操作 (​**Select**​ 操作など) の結果は、自動的にストリーミングされ、すべての結果が一度に読み込まれることでパフォーマンスとメモリの問題が発生することを防止します。この動作は、データベース行が必要に応じて遅延して読み込まれることを意味します。 Database Connector 操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=e69ac05bd46e0306a26e8c1f14758a1cbcbddc94e915732bd8335923cbba4553 url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-transactions.md -->

# データベーストランザクションの設定の例

データベース用 Anypoint Connector (Database Connector) を使用すると、トランザクションのコンテキストでデータベース操作を実行できます。各操作に ​**\[Transactional action (トランザクションアクション)\]**​ 項目があります。この項目を使用して、アクティブなトランザクションに関して、操作で実行できる結合アクションの種別を指定します。

次の例は、Studio で ​**\[Transactional action (トランザクションアクション)\]**​ 項目を設定する方法 (​**Select**​ 操作の場合と、​**Try**​ スコープコンポーネントを使用して操作をグループ化する場合の両方) を示しています。

## [](#studio-で-transactional-action-トランザクションアクション-項目を設定する)Studio で \[Transactional Action (トランザクションアクション)\] 項目を設定する

項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. コネクタ設定画面で、​**\[Advanced (詳細)\]**​ タブをクリックします。
3. **\[Transactional action (トランザクションアクション)\]**​ 項目を次のいずれかのオプションに設定します。
    
    - **ALWAYS\_JOIN**​  
        メッセージの受信時にトランザクションが進行中であると想定します。トランザクションがない場合、エラーが発生します。
    - **JOIN\_IF\_POSSIBLE**​  
        現在のトランザクションが使用可能な場合、そのトランザクションを結合します。それ以外の場合、トランザクションは実行されません。
    - **NOT\_SUPPORTED**​  
        存在するトランザクションの外部で実行します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Transactional action (トランザクションアクション)\] 項目の設定](_images/database-transactions-1.png)

Figure 1. \[Transactional action (トランザクションアクション)\] の設定

XML エディターでは、​`transactionalAction`​ 設定は次のように記述されます。

```xml
<db:select doc:name="Select" transactionalAction="ALWAYS_JOIN">
			<db:sql ><![CDATA[SELECT * FROM PLANET WHERE name = :name]]></db:sql>
</db:select>
```

## [](#try-スコープの-transactional-action-トランザクションアクション-項目を設定して操作をグループ化する)Try スコープの \[Transactional Action (トランザクションアクション)\] 項目を設定して操作をグループ化する

場合によっては、複数のクエリを同じトランザクションのコンテキストでアトミックに実行する必要があります。これらのクエリを、すでに存在するトランザクションのコンテキストで実行した場合、クエリは同じトランザクションに属します。

次の例は、銀行口座振替中に 2 つの Database Connector の ​**Update**​ 操作を使用して、1 つの口座から金額を引き、別の口座に加えるが、この 2 つの操作のいずれかが失敗した場合、両方の操作をロールバックすることを示しています。アクティブなトランザクションがない場合は、​**Try**​ スコープコンポーネントを使用して操作をグループすることでトランザクションを開始できます。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`try`​」を検索し、​**\[Try\]**​ スコープコンポーネントを選択します。
2. **\[Try\]**​ スコープコンポーネントを Studio キャンバスにドラッグします。
3. **\[Update\]**​ 操作を ​**\[Try\]**​ スコープコンポーネントの内部にドラッグします。
4. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
5. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
6. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source`​)。
7. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{‘money’ : payload.money, ‘source’: payload.source}`​ に設定します。
8. 別の ​**\[Update\]**​ 操作を ​**\[Try\]**​ コンポーネント内の最初の ​**\[Update\]**​ 操作の右にドラッグします。
9. **\[Connector configuration (コネクタ設定)\]**​ 項目を、以前に作成したデータベース接続に設定します。
10. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target`​)。
11. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{‘money’ : payload.money, ‘target’’: payload.target}`​ に設定します。
12. フローの ​**\[Try\]**​ スコープコンポーネントを選択します。
13. コンポーネント設定画面で、​**\[Transactional action (トランザクションアクション)\]**​ 項目を ​`ALWAYS_BEGIN`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Try コンポーネントの \[Transactional action (トランザクションアクション)\] 項目の設定](_images/database-transactions-2.png)

Figure 2. \[Transactional action (トランザクションアクション)\] の設定

XML エディターでは、​`transactionalAction`​ 設定は次のように記述されます。

```xml
<try transactionalAction="ALWAYS_BEGIN">
 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'source': payload.source}]</db:input-parameters>
 </db:update>

 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'target'': payload.target}]</db:input-parameters>
 </db:update>
</try>
```

## [](#トランザクションとストリーミング)トランザクションとストリーミング

一部の Database Connector 操作 (​**Select**​ 操作など) の結果は、自動的にストリーミングされ、すべての結果が一度に読み込まれることでパフォーマンスとメモリの問題が発生することを防止します。この動作は、データベース行が必要に応じて遅延して読み込まれることを意味します。 Database Connector 操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=905eb9c614582c698769d0fd07d1d047721ef00f637839405a0a9e1b1641c119 url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-transactions.md -->

# データベーストランザクションの設定の例

データベース用 Anypoint Connector (Database Connector) を使用すると、トランザクションのコンテキストでデータベース操作を実行できます。各操作に ​**\[Transactional action (トランザクションアクション)\]**​ 項目があります。この項目を使用して、アクティブなトランザクションに関して、操作で実行できる結合アクションの種別を指定します。

次の例は、Studio で ​**\[Transactional action (トランザクションアクション)\]**​ 項目を設定する方法 (​**Select**​ 操作の場合と、​**Try**​ スコープコンポーネントを使用して操作をグループ化する場合の両方) を示しています。

## [](#studio-で-transactional-action-トランザクションアクション-項目を設定する)Studio で \[Transactional Action (トランザクションアクション)\] 項目を設定する

項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. コネクタ設定画面で、​**\[Advanced (詳細)\]**​ タブをクリックします。
3. **\[Transactional action (トランザクションアクション)\]**​ 項目を次のいずれかのオプションに設定します。
    
    - **ALWAYS\_JOIN**​  
        メッセージの受信時にトランザクションが進行中であると想定します。トランザクションがない場合、エラーが発生します。
    - **JOIN\_IF\_POSSIBLE**​  
        現在のトランザクションが使用可能な場合、そのトランザクションを結合します。それ以外の場合、トランザクションは実行されません。
    - **NOT\_SUPPORTED**​  
        存在するトランザクションの外部で実行します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Transactional action (トランザクションアクション)\] 項目の設定](_images/database-transactions-1.png)

Figure 1. \[Transactional action (トランザクションアクション)\] の設定

XML エディターでは、​`transactionalAction`​ 設定は次のように記述されます。

```xml
<db:select doc:name="Select" transactionalAction="ALWAYS_JOIN">
			<db:sql ><![CDATA[SELECT * FROM PLANET WHERE name = :name]]></db:sql>
</db:select>
```

## [](#try-スコープの-transactional-action-トランザクションアクション-項目を設定して操作をグループ化する)Try スコープの \[Transactional Action (トランザクションアクション)\] 項目を設定して操作をグループ化する

場合によっては、複数のクエリを同じトランザクションのコンテキストでアトミックに実行する必要があります。これらのクエリを、すでに存在するトランザクションのコンテキストで実行した場合、クエリは同じトランザクションに属します。

次の例は、銀行口座振替中に 2 つの Database Connector の ​**Update**​ 操作を使用して、1 つの口座から金額を引き、別の口座に加えるが、この 2 つの操作のいずれかが失敗した場合、両方の操作をロールバックすることを示しています。アクティブなトランザクションがない場合は、​**Try**​ スコープコンポーネントを使用して操作をグループすることでトランザクションを開始できます。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`try`​」を検索し、​**\[Try\]**​ スコープコンポーネントを選択します。
2. **\[Try\]**​ スコープコンポーネントを Studio キャンバスにドラッグします。
3. **\[Update\]**​ 操作を ​**\[Try\]**​ スコープコンポーネントの内部にドラッグします。
4. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
5. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
6. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source`​)。
7. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{‘money’ : payload.money, ‘source’: payload.source}`​ に設定します。
8. 別の ​**\[Update\]**​ 操作を ​**\[Try\]**​ コンポーネント内の最初の ​**\[Update\]**​ 操作の右にドラッグします。
9. **\[Connector configuration (コネクタ設定)\]**​ 項目を、以前に作成したデータベース接続に設定します。
10. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target`​)。
11. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{‘money’ : payload.money, ‘target’’: payload.target}`​ に設定します。
12. フローの ​**\[Try\]**​ スコープコンポーネントを選択します。
13. コンポーネント設定画面で、​**\[Transactional action (トランザクションアクション)\]**​ 項目を ​`ALWAYS_BEGIN`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Try コンポーネントの \[Transactional action (トランザクションアクション)\] 項目の設定](_images/database-transactions-2.png)

Figure 2. \[Transactional action (トランザクションアクション)\] の設定

XML エディターでは、​`transactionalAction`​ 設定は次のように記述されます。

```xml
<try transactionalAction="ALWAYS_BEGIN">
 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'source': payload.source}]</db:input-parameters>
 </db:update>

 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'target'': payload.target}]</db:input-parameters>
 </db:update>
</try>
```

## [](#トランザクションとストリーミング)トランザクションとストリーミング

一部の Database Connector 操作 (​**Select**​ 操作など) の結果は、自動的にストリーミングされ、すべての結果が一度に読み込まれることでパフォーマンスとメモリの問題が発生することを防止します。この動作は、データベース行が必要に応じて遅延して読み込まれることを意味します。 Database Connector 操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=dd4f46b91e6d3df0272613d2dd1abea299d4901a513daab59b1e13fd035a8ac2 url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-transactions.md -->

# データベーストランザクションの設定の例

データベース用 Anypoint Connector (Database Connector) を使用すると、トランザクションのコンテキストでデータベース操作を実行できます。各操作に ​**\[Transactional action (トランザクションアクション)\]**​ 項目があります。この項目を使用して、アクティブなトランザクションに関して、操作で実行できる結合アクションの種別を指定します。

次の例は、Studio で ​**\[Transactional action (トランザクションアクション)\]**​ 項目を設定する方法 (​**Select**​ 操作の場合と、​**Try**​ スコープコンポーネントを使用して操作をグループ化する場合の両方) を示しています。

## [](#studio-で-transactional-action-トランザクションアクション-項目を設定する)Studio で \[Transactional Action (トランザクションアクション)\] 項目を設定する

項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. コネクタ設定画面で、​**\[Advanced (詳細)\]**​ タブをクリックします。
3. **\[Transactional action (トランザクションアクション)\]**​ 項目を次のいずれかのオプションに設定します。
    
    - **ALWAYS\_JOIN**​  
        メッセージの受信時にトランザクションが進行中であると想定します。トランザクションがない場合、エラーが発生します。
    - **JOIN\_IF\_POSSIBLE**​  
        現在のトランザクションが使用可能な場合、そのトランザクションを結合します。それ以外の場合、トランザクションは実行されません。
    - **NOT\_SUPPORTED**​  
        存在するトランザクションの外部で実行します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Transactional action (トランザクションアクション)\] 項目の設定](_images/database-transactions-1.png)

Figure 1. \[Transactional action (トランザクションアクション)\] の設定

XML エディターでは、​`transactionalAction`​ 設定は次のように記述されます。

```xml
<db:select doc:name="Select" transactionalAction="ALWAYS_JOIN">
			<db:sql ><![CDATA[SELECT * FROM PLANET WHERE name = :name]]></db:sql>
</db:select>
```

## [](#try-スコープの-transactional-action-トランザクションアクション-項目を設定して操作をグループ化する)Try スコープの \[Transactional Action (トランザクションアクション)\] 項目を設定して操作をグループ化する

場合によっては、複数のクエリを同じトランザクションのコンテキストでアトミックに実行する必要があります。これらのクエリを、すでに存在するトランザクションのコンテキストで実行した場合、クエリは同じトランザクションに属します。

次の例は、銀行口座振替中に 2 つの Database Connector の ​**Update**​ 操作を使用して、1 つの口座から金額を引き、別の口座に加えるが、この 2 つの操作のいずれかが失敗した場合、両方の操作をロールバックすることを示しています。アクティブなトランザクションがない場合は、​**Try**​ スコープコンポーネントを使用して操作をグループすることでトランザクションを開始できます。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`try`​」を検索し、​**\[Try\]**​ スコープコンポーネントを選択します。
2. **\[Try\]**​ スコープコンポーネントを Studio キャンバスにドラッグします。
3. **\[Update\]**​ 操作を ​**\[Try\]**​ スコープコンポーネントの内部にドラッグします。
4. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
5. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
6. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source`​)。
7. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{‘money’ : payload.money, ‘source’: payload.source}`​ に設定します。
8. 別の ​**\[Update\]**​ 操作を ​**\[Try\]**​ コンポーネント内の最初の ​**\[Update\]**​ 操作の右にドラッグします。
9. **\[Connector configuration (コネクタ設定)\]**​ 項目を、以前に作成したデータベース接続に設定します。
10. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target`​)。
11. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{‘money’ : payload.money, ‘target’’: payload.target}`​ に設定します。
12. フローの ​**\[Try\]**​ スコープコンポーネントを選択します。
13. コンポーネント設定画面で、​**\[Transactional action (トランザクションアクション)\]**​ 項目を ​`ALWAYS_BEGIN`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Try コンポーネントの \[Transactional action (トランザクションアクション)\] 項目の設定](_images/database-transactions-2.png)

Figure 2. \[Transactional action (トランザクションアクション)\] の設定

XML エディターでは、​`transactionalAction`​ 設定は次のように記述されます。

```xml
<try transactionalAction="ALWAYS_BEGIN">
 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'source': payload.source}]</db:input-parameters>
 </db:update>

 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'target'': payload.target}]</db:input-parameters>
 </db:update>
</try>
```

## [](#トランザクションとストリーミング)トランザクションとストリーミング

一部の Database Connector 操作 (​**Select**​ 操作など) の結果は、自動的にストリーミングされ、すべての結果が一度に読み込まれることでパフォーマンスとメモリの問題が発生することを防止します。この動作は、データベース行が必要に応じて遅延して読み込まれることを意味します。 Database Connector 操作がトランザクション (​**Try**​ スコープコンポーネントなど) の内部で実行されて、データがコンシュームされる前にトランザクションが終了した場合、読み込まれていない結果にアクセスしようとするとエラーとなります。

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=3e18ce32615a0fc3d33581937f87fc431b0ac32f93b48531f7ed299658c837ab url=/mulesoft/current/ja-jp/db-connector/1.9/database-connector-transactions.md -->

# データベーストランザクションの設定の例

データベース用 Anypoint Connector (Database Connector) を使用すると、トランザクションのコンテキストでデータベース操作を実行できます。各操作に ​**\[Transactional action (トランザクションアクション)\]**​ 項目があります。この項目を使用して、アクティブなトランザクションに関して、操作で実行できる結合アクションの種別を指定します。

次の例は、Studio で ​**\[Transactional action (トランザクションアクション)\]**​ 項目を設定する方法 (​**Select**​ 操作の場合と、​**Try**​ スコープコンポーネントを使用して操作をグループ化する場合の両方) を示しています。

## [](#studio-で-transactional-action-トランザクションアクション-項目を設定する)Studio で \[Transactional Action (トランザクションアクション)\] 項目を設定する

項目を設定する手順は、次のとおりです。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. コネクタ設定画面で、​**\[Advanced (詳細)\]**​ タブをクリックします。
3. **\[Transactional action (トランザクションアクション)\]**​ 項目を次のいずれかのオプションに設定します。
    
    - **ALWAYS\_JOIN**​  
        メッセージの受信時にトランザクションが進行中であると想定します。トランザクションがない場合、エラーが発生します。
    - **JOIN\_IF\_POSSIBLE**​  
        現在のトランザクションが使用可能な場合、そのトランザクションを結合します。それ以外の場合、トランザクションは実行されません。
    - **NOT\_SUPPORTED**​  
        存在するトランザクションの外部で実行します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Transactional action (トランザクションアクション)\] 項目の設定](_images/database-transactions-1.png)

Figure 1. \[Transactional action (トランザクションアクション)\] の設定

XML エディターでは、​`transactionalAction`​ 設定は次のように記述されます。

```xml
<db:select doc:name="Select" transactionalAction="ALWAYS_JOIN">
			<db:sql ><![CDATA[SELECT * FROM PLANET WHERE name = :name]]></db:sql>
</db:select>
```

## [](#try-スコープの-transactional-action-トランザクションアクション-項目を設定して操作をグループ化する)Try スコープの \[Transactional Action (トランザクションアクション)\] 項目を設定して操作をグループ化する

場合によっては、複数のクエリを同じトランザクションのコンテキストでアトミックに実行する必要があります。これらのクエリを、すでに存在するトランザクションのコンテキストで実行した場合、クエリは同じトランザクションに属します。

次の例は、銀行口座振替中に 2 つの Database Connector の ​**Update**​ 操作を使用して、1 つの口座から金額を引き、別の口座に加えるが、この 2 つの操作のいずれかが失敗した場合、両方の操作をロールバックすることを示しています。アクティブなトランザクションがない場合は、​**Try**​ スコープコンポーネントを使用して操作をグループすることでトランザクションを開始できます。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`try`​」を検索し、​**\[Try\]**​ スコープコンポーネントを選択します。
2. **\[Try\]**​ スコープコンポーネントを Studio キャンバスにドラッグします。
3. **\[Update\]**​ 操作を ​**\[Try\]**​ スコープコンポーネントの内部にドラッグします。
4. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
5. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
6. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source`​)。
7. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{‘money’ : payload.money, ‘source’: payload.source}`​ に設定します。
8. 別の ​**\[Update\]**​ 操作を ​**\[Try\]**​ コンポーネント内の最初の ​**\[Update\]**​ 操作の右にドラッグします。
9. **\[Connector configuration (コネクタ設定)\]**​ 項目を、以前に作成したデータベース接続に設定します。
10. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target`​)。
11. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{‘money’ : payload.money, ‘target’’: payload.target}`​ に設定します。
12. フローの ​**\[Try\]**​ スコープコンポーネントを選択します。
13. コンポーネント設定画面で、​**\[Transactional action (トランザクションアクション)\]**​ 項目を ​`ALWAYS_BEGIN`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Try コンポーネントの \[Transactional action (トランザクションアクション)\] 項目の設定](_images/database-transactions-2.png)

Figure 2. \[Transactional action (トランザクションアクション)\] の設定

XML エディターでは、​`transactionalAction`​ 設定は次のように記述されます。

```xml
<try transactionalAction="ALWAYS_BEGIN">
 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE - :money where ID = :source</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'source': payload.source}]</db:input-parameters>
 </db:update>

 <db:update config-ref="db">
   <db:sql>UPDATE ACCOUNT set BALANCE = BALANCE + :money where ID = :target</db:sql>
   <db:input-parameters>#[{'money' : payload.money, 'target'': payload.target}]</db:input-parameters>
 </db:update>
</try>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=c5acc793c4004527078022f2dd0b40e3c9b62b02e045b3485f2ce309486d5c15 url=/mulesoft/current/ja-jp/db-connector/1.10/database-insert-update-delete.md -->

# データベースのデータの挿入、更新、および削除の例

データベース用 Anypoint Connector (Database Connector) では、データベースのデータを管理できるようにする ​**Insert**​、​**Update**​、​**Delete**​ 操作がサポートされています。

次の例では、​`electronic`​ という名前のテーブルが含まれる ​`Products`​ という名前のデータベーススキーマのデータを挿入、更新、削除します。このテーブルには、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という列が含まれます。

次の SQL ステートメントでは、このテーブルを作成します。

```sql
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
)
```

## [](#studio-で-insert-操作を設定する)Studio で Insert 操作を設定する

テーブル ​`electronic`​ がすでに作成されていて、​`dbConfig`​ という名前の Database Connector 接続設定がある場合、テーブルに新しいレコードを挿入する ​**Insert**​ 操作を設定できます。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. コネクタ設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```XML
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
```

`id`​ パラメーターは、データベースによって自動的に生成される自動増分キーであるため、クエリに渡されません。

次のスクリーンショットは、Studio の設定を示しています。

![Insert 操作の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-insert-example-1.png)

XML エディターでは、​`<db:insert>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig">
  <db:sql>
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
  </db:sql>
</db:insert>
```

### [](#insert-操作の-input-parameters-入力パラメーター-項目を設定する)Insert 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

入力パラメーターの利点を得るには、次のように同等の SQL クエリを構築します。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. コネクタ設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```xml
INSERT INTO electronic(name, description, price, discount)
VALUES (:name, :description, :price, :discount)
```

1. **\[Input Parameters (入力パラメーター)\]**​ 項目で、次のパラメーターを設定します。

```xml
{
    name: 'Coffee Machine',
    description: 'Model:XYZ99. Uses small size capsules.',
    price: 120,
    discount: 5
}
```

次のスクリーンショットは、​**\[Input Parameter (入力パラメーター)\]**​ 項目の設定を示しています。

![「Input Parameter (入力パラメーター)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-insert-example-2.png)

XML エディターでは、​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig">
    <db:sql>
        INSERT INTO electronic(name, description, price, discount)
        VALUES (:name, :description, :price, :discount)
    </db:sql>
    <db:input-parameters>#[{
        name: 'Coffee Machine',
        description: 'Model:XYZ99. Uses small size capsules.',
        price: 120,
        discount: 5}]
    </db:input-parameters>
</db:insert>
```

### [](#insert-操作の-auto-generate-keys-自動生成キー-項目を設定する)Insert 操作の \[Auto Generate Keys (自動生成キー)\] 項目を設定する

**Insert**​ 操作は、2 つの項目 (クエリの影響を受けた行数を示す整数 ​`affectedRows`​ と、自動生成されたキーが含まれるマップ ​`generatedKeys`​) が含まれる ​`Statement Result`​ オブジェクトを出力します。

次の例の出力では、行は正常にテーブルに追加されているが、マップ ​`generatedKeys`​ が空であることが示されています。マップが空になるのは、オーバーヘッドを回避するためにこの情報がデフォルトで無効になっているためです。

```json
{
  "affectedRows": 1,
  "generatedKeys": {

  }
}
```

情報をアクティブ化してキーを生成する手順は、次のとおりです。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. **\[Advanced (詳細)\]**​ タブで ​**\[Auto generate keys (自動生成キー)\]**​ 項目を ​**\[True\]**​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input Parameter (入力パラメーター)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-insert-example-3.png)

XML エディターでは、​`<autoGenerateKeys>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true">
...
</db:insert>
```

ステートメントで影響を受けた行ごとに複数のキーが生成される場合、目的の列名が含まれるリストを設定して、返される列を指定できます。例:

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. **\[Advanced (詳細)\]**​ タブで、​**\[Auto generate column names (列名を自動生成)\]**​ 項目を \[​`Expression or Bean reference`​ (式または bean 参照)\] に設定して、項目を 1 つの文字列要素が含まれる DataWeave リストに設定します。
3. \[expression (式)\] 項目を ​`['id']`​ に設定して、​`id`​ 列のみが返されるようにします。

次のスクリーンショットは、Studio の設定を示しています。

![「Auto generate column names (列名を自動生成)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-insert-example-4.png)

XML エディターでは、​`<autoGeneratedKeysColumnNames>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true" autoGeneratedKeysColumnNames="#[['id']]">
    ...
</db:insert>
```

## [](#studio-で-update-操作を設定する)Studio で Update 操作を設定する

`electronic`​ テーブルが事前に定義されている場合、テーブルのデータを更新する (たとえば、価格値が 100 を越えているすべての項目の割引を 10 % に設定する) には、次のように ​**Update**​ 操作を設定します。

1. Studio のフローで、​**\[Update\]**​ 操作を選択します。
2. コネクタ設定画面で、​`"UPDATE electronic SET discount = :discount WHERE price > :price"`​ のように、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次のパラメーターに設定します。

```xml
{
      discount: 10,
      price: 100
}
```

次のスクリーンショットは、Studio の設定を示しています。

![Update 操作の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-update-example-1.png)

XML エディターでは、​`<db:update>`​ 設定は次のように記述されます。

```xml
<db:update doc:name="Update">
			<db:sql ><![CDATA["UPDATE electronic SET discount = :discount WHERE price > :price"]]></db:sql>
			<db:input-parameters ><![CDATA[#[{
        discount: 10,
        price: 100
    }]]]></db:input-parameters>
		</db:update>
```

`<![CDATA[…​]]>`​ ラッパーにより、クエリで ​`>`​ や ​`"`​ などの特殊文字を使用できます。 ラッパーがない場合、これらの文字の XML でエスケープされたバージョン (​`&gt;`​ や ​`&quot;`​ など) を使用する必要があります。

## [](#studio-で-delete-操作を設定する)Studio で Delete 操作を設定する

`electronic`​ テーブルが事前に定義されている場合、​`id: 1`​ のレコードを削除するには、次のように ​**Delete**​ 操作を設定します。

1. Studio のフローで、​**\[Update\]**​ 操作を選択します。
2. コネクタ設定画面で、​`DELETE FROM electronic WHERE id = :id`​ のように、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
3. **\[Input parameters (入力パラメーター)\]**​ 項目を ​`{id: 1}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Update 操作の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-delete-example-1.png)

XML エディターでは、​`<db:delete>`​ 設定は次のように記述されます。

```xml
<db:delete config-ref="dbConfig">
    <db:sql>DELETE FROM electronic WHERE id = :id</db:sql>
    <db:input-parameters>#[{
        id: 1
    }]</db:input-parameters>
</db:delete>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=9e1cd65f564abe6d97a80fe5ffd077f1e34fdd821d92a53c19966a14d0077d26 url=/mulesoft/current/ja-jp/db-connector/1.12/database-insert-update-delete.md -->

# データベースのデータの挿入、更新、および削除の例

データベース用 Anypoint Connector (Database Connector) では、データベースのデータを管理できるようにする ​**Insert**​、​**Update**​、​**Delete**​ 操作がサポートされています。

次の例では、​`electronic`​ という名前のテーブルが含まれる ​`Products`​ という名前のデータベーススキーマのデータを挿入、更新、削除します。このテーブルには、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という列が含まれます。

次の SQL ステートメントでは、このテーブルを作成します。

```sql
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
)
```

## [](#studio-で-insert-操作を設定する)Studio で Insert 操作を設定する

テーブル ​`electronic`​ がすでに作成されていて、​`dbConfig`​ という名前の Database Connector 接続設定がある場合、テーブルに新しいレコードを挿入する ​**Insert**​ 操作を設定できます。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. コネクタ設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```XML
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
```

`id`​ パラメーターは、データベースによって自動的に生成される自動増分キーであるため、クエリに渡されません。

次のスクリーンショットは、Studio の設定を示しています。

![Insert 操作の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-insert-example-1.png)

XML エディターでは、​`<db:insert>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig">
  <db:sql>
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
  </db:sql>
</db:insert>
```

### [](#insert-操作の-input-parameters-入力パラメーター-項目を設定する)Insert 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

入力パラメーターの利点を得るには、次のように同等の SQL クエリを構築します。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. コネクタ設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```xml
INSERT INTO electronic(name, description, price, discount)
VALUES (:name, :description, :price, :discount)
```

1. **\[Input Parameters (入力パラメーター)\]**​ 項目で、次のパラメーターを設定します。

```xml
{
    name: 'Coffee Machine',
    description: 'Model:XYZ99. Uses small size capsules.',
    price: 120,
    discount: 5
}
```

次のスクリーンショットは、​**\[Input Parameter (入力パラメーター)\]**​ 項目の設定を示しています。

![「Input Parameter (入力パラメーター)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-insert-example-2.png)

XML エディターでは、​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig">
    <db:sql>
        INSERT INTO electronic(name, description, price, discount)
        VALUES (:name, :description, :price, :discount)
    </db:sql>
    <db:input-parameters>#[{
        name: 'Coffee Machine',
        description: 'Model:XYZ99. Uses small size capsules.',
        price: 120,
        discount: 5}]
    </db:input-parameters>
</db:insert>
```

### [](#insert-操作の-auto-generate-keys-自動生成キー-項目を設定する)Insert 操作の \[Auto Generate Keys (自動生成キー)\] 項目を設定する

**Insert**​ 操作は、2 つの項目 (クエリの影響を受けた行数を示す整数 ​`affectedRows`​ と、自動生成されたキーが含まれるマップ ​`generatedKeys`​) が含まれる ​`Statement Result`​ オブジェクトを出力します。

次の例の出力では、行は正常にテーブルに追加されているが、マップ ​`generatedKeys`​ が空であることが示されています。マップが空になるのは、オーバーヘッドを回避するためにこの情報がデフォルトで無効になっているためです。

```json
{
  "affectedRows": 1,
  "generatedKeys": {

  }
}
```

情報をアクティブ化してキーを生成する手順は、次のとおりです。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. **\[Advanced (詳細)\]**​ タブで ​**\[Auto generate keys (自動生成キー)\]**​ 項目を ​**\[True\]**​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input Parameter (入力パラメーター)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-insert-example-3.png)

XML エディターでは、​`<autoGenerateKeys>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true">
...
</db:insert>
```

ステートメントで影響を受けた行ごとに複数のキーが生成される場合、目的の列名が含まれるリストを設定して、返される列を指定できます。例:

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. **\[Advanced (詳細)\]**​ タブで、​**\[Auto generate column names (列名を自動生成)\]**​ 項目を \[​`Expression or Bean reference`​ (式または bean 参照)\] に設定して、項目を 1 つの文字列要素が含まれる DataWeave リストに設定します。
3. \[expression (式)\] 項目を ​`['id']`​ に設定して、​`id`​ 列のみが返されるようにします。

次のスクリーンショットは、Studio の設定を示しています。

![「Auto generate column names (列名を自動生成)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-insert-example-4.png)

XML エディターでは、​`<autoGeneratedKeysColumnNames>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true" autoGeneratedKeysColumnNames="#[['id']]">
    ...
</db:insert>
```

## [](#studio-で-update-操作を設定する)Studio で Update 操作を設定する

`electronic`​ テーブルが事前に定義されている場合、テーブルのデータを更新する (たとえば、価格値が 100 を越えているすべての項目の割引を 10 % に設定する) には、次のように ​**Update**​ 操作を設定します。

1. Studio のフローで、​**\[Update\]**​ 操作を選択します。
2. コネクタ設定画面で、​`"UPDATE electronic SET discount = :discount WHERE price > :price"`​ のように、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次のパラメーターに設定します。

```xml
{
      discount: 10,
      price: 100
}
```

次のスクリーンショットは、Studio の設定を示しています。

![Update 操作の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-update-example-1.png)

XML エディターでは、​`<db:update>`​ 設定は次のように記述されます。

```xml
<db:update doc:name="Update">
			<db:sql ><![CDATA["UPDATE electronic SET discount = :discount WHERE price > :price"]]></db:sql>
			<db:input-parameters ><![CDATA[#[{
        discount: 10,
        price: 100
    }]]]></db:input-parameters>
		</db:update>
```

`<![CDATA[…​]]>`​ ラッパーにより、クエリで ​`>`​ や ​`"`​ などの特殊文字を使用できます。 ラッパーがない場合、これらの文字の XML でエスケープされたバージョン (​`&gt;`​ や ​`&quot;`​ など) を使用する必要があります。

## [](#studio-で-delete-操作を設定する)Studio で Delete 操作を設定する

`electronic`​ テーブルが事前に定義されている場合、​`id: 1`​ のレコードを削除するには、次のように ​**Delete**​ 操作を設定します。

1. Studio のフローで、​**\[Update\]**​ 操作を選択します。
2. コネクタ設定画面で、​`DELETE FROM electronic WHERE id = :id`​ のように、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
3. **\[Input parameters (入力パラメーター)\]**​ 項目を ​`{id: 1}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Update 操作の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-delete-example-1.png)

XML エディターでは、​`<db:delete>`​ 設定は次のように記述されます。

```xml
<db:delete config-ref="dbConfig">
    <db:sql>DELETE FROM electronic WHERE id = :id</db:sql>
    <db:input-parameters>#[{
        id: 1
    }]</db:input-parameters>
</db:delete>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=6f0882a76f7dee3511e43666166ca6a0e41da6fdeb42b743d706e86fad15ab29 url=/mulesoft/current/ja-jp/db-connector/1.13/database-insert-update-delete.md -->

# データベースのデータの挿入、更新、および削除の例

データベース用 Anypoint Connector (Database Connector) では、データベースのデータを管理できるようにする ​**Insert**​、​**Update**​、​**Delete**​ 操作がサポートされています。

次の例では、​`electronic`​ という名前のテーブルが含まれる ​`Products`​ という名前のデータベーススキーマのデータを挿入、更新、削除します。このテーブルには、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という列が含まれます。

次の SQL ステートメントでは、このテーブルを作成します。

```sql
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
)
```

## [](#studio-で-insert-操作を設定する)Studio で Insert 操作を設定する

テーブル ​`electronic`​ がすでに作成されていて、​`dbConfig`​ という名前の Database Connector 接続設定がある場合、テーブルに新しいレコードを挿入する ​**Insert**​ 操作を設定できます。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. コネクタ設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```XML
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
```

`id`​ パラメーターは、データベースによって自動的に生成される自動増分キーであるため、クエリに渡されません。

![Insert 操作の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-insert-example-1.png)

**設定 XML**​ エディターでは、​`<db:insert>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig">
  <db:sql>
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
  </db:sql>
</db:insert>
```

### [](#insert-操作の-input-parameters-入力パラメーター-項目を設定する)Insert 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

入力パラメーターの利点を得るには、次のように同等の SQL クエリを構築します。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. コネクタ設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```xml
INSERT INTO electronic(name, description, price, discount)
VALUES (:name, :description, :price, :discount)
```

1. **\[Input Parameters (入力パラメーター)\]**​ 項目で、次のパラメーターを設定します。

```xml
{
    name: 'Coffee Machine',
    description: 'Model:XYZ99. Uses small size capsules.',
    price: 120,
    discount: 5
}
```

![「Input Parameter (入力パラメーター)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-insert-example-2.png)

**設定 XML**​ エディターでは、​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig">
    <db:sql>
        INSERT INTO electronic(name, description, price, discount)
        VALUES (:name, :description, :price, :discount)
    </db:sql>
    <db:input-parameters>#[{
        name: 'Coffee Machine',
        description: 'Model:XYZ99. Uses small size capsules.',
        price: 120,
        discount: 5}]
    </db:input-parameters>
</db:insert>
```

### [](#insert-操作の-auto-generate-keys-自動生成キー-項目を設定する)Insert 操作の \[Auto Generate Keys (自動生成キー)\] 項目を設定する

**Insert**​ 操作は、2 つの項目 (クエリの影響を受けた行数を示す整数 ​`affectedRows`​ と、自動生成されたキーが含まれるマップ ​`generatedKeys`​) が含まれる ​`Statement Result`​ オブジェクトを出力します。

次の例の出力では、行は正常にテーブルに追加されているが、マップ ​`generatedKeys`​ が空であることが示されています。マップが空になるのは、オーバーヘッドを回避するためにこの情報がデフォルトで無効になっているためです。

```json
{
  "affectedRows": 1,
  "generatedKeys": {

  }
}
```

情報をアクティブ化してキーを生成する手順は、次のとおりです。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. **\[Advanced (詳細)\]**​ タブで ​**\[Auto generate keys (自動生成キー)\]**​ 項目を ​**\[True\]**​ に設定します。

![「Input Parameter (入力パラメーター)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-insert-example-3.png)

**設定 XML**​ エディターでは、​`<autoGenerateKeys>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true">
...
</db:insert>
```

ステートメントで影響を受けた行ごとに複数のキーが生成される場合、目的の列名が含まれるリストを設定して、返される列を指定できます。例:

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. **\[Advanced (詳細)\]**​ タブで、​**\[Auto generate column names (列名を自動生成)\]**​ 項目を \[​`Expression or Bean reference`​ (式または bean 参照)\] に設定して、項目を 1 つの文字列要素が含まれる DataWeave リストに設定します。
3. \[expression (式)\] 項目を ​`['id']`​ に設定して、​`id`​ 列のみが返されるようにします。

![「Auto generate column names (列名を自動生成)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-insert-example-4.png)

**設定 XML**​ エディターでは、​`<autoGeneratedKeysColumnNames>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true" autoGeneratedKeysColumnNames="#[['id']]">
    ...
</db:insert>
```

## [](#studio-で-update-操作を設定する)Studio で Update 操作を設定する

`electronic`​ テーブルが事前に定義されている場合、テーブルのデータを更新する (たとえば、価格値が 100 を越えているすべての項目の割引を 10 % に設定する) には、次のように ​**Update**​ 操作を設定します。

1. Studio のフローで、​**\[Update\]**​ 操作を選択します。
2. コネクタ設定画面で、​`"UPDATE electronic SET discount = :discount WHERE price > :price"`​ のように、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次のパラメーターに設定します。

```xml
{
      discount: 10,
      price: 100
}
```

![Update 操作の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-update-example-1.png)

**設定 XML**​ エディターでは、​`<db:update>`​ 設定は次のように記述されます。

```xml
<db:update doc:name="Update">
			<db:sql ><![CDATA["UPDATE electronic SET discount = :discount WHERE price > :price"]]></db:sql>
			<db:input-parameters ><![CDATA[#[{
        discount: 10,
        price: 100
    }]]]></db:input-parameters>
		</db:update>
```

`<![CDATA[…​]]>`​ ラッパーにより、クエリで ​`>`​ や ​`"`​ などの特殊文字を使用できます。 ラッパーがない場合、これらの文字の XML でエスケープされたバージョン (​`&gt;`​ や ​`&quot;`​ など) を使用する必要があります。

## [](#studio-で-delete-操作を設定する)Studio で Delete 操作を設定する

`electronic`​ テーブルが事前に定義されている場合、​`id: 1`​ のレコードを削除するには、次のように ​**Delete**​ 操作を設定します。

1. Studio のフローで、​**\[Update\]**​ 操作を選択します。
2. コネクタ設定画面で、​`DELETE FROM electronic WHERE id = :id`​ のように、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
3. **\[Input parameters (入力パラメーター)\]**​ 項目を ​`{id: 1}`​ に設定します。

![Studio での Update 操作の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-delete-example-1.png)

**設定 XML**​ エディターでは、​`<db:delete>`​ 設定は次のように記述されます。

```xml
<db:delete config-ref="dbConfig">
    <db:sql>DELETE FROM electronic WHERE id = :id</db:sql>
    <db:input-parameters>#[{
        id: 1
    }]</db:input-parameters>
</db:delete>
```

## [](#レコード挿入-mule-アプリケーションの例)レコード挿入 Mule アプリケーションの例

次の例は、データベースに個人のレコードを作成するように ​**Insert**​ 操作を設定する方法を示しています。

1. Studio で、HTTP ​**Listener**​ ソースを Studio キャンバスにドラッグします。
2. **\[Path (パス)\]**​ を ​`/person`​ に設定します。
3. **\[Insert\]**​ 操作を ​**\[Listener\]**​ ソースの横にドラッグします。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
5. **\[SQL Query Text (SQL クエリテキスト)\]**​ ボックスで、次の SQL テキストを宣言します。
    
    ```xml
    insert into person (id, name, photo, dob)
    values (:ID,:NAME,:PHOTO,:DOB);
    ```

1. **\[Input Parameters (入力パラメーター)\]**​ 項目で、作成する個人レコードのマップのリストを指定します。これには、パラメーター名がキーとして、値がパラメーターとして含まれます。また、すべてのリスト項目は挿入する行を表します。
    
    ```xml
    {'ID' : message.payload.parts['id'].content ,
    'NAME': message.payload.parts['name'].content,
    'PHOTO' : message.payload.parts['photo'].content,
    'DOB' : message.payload.parts['dob'].content}
    ```
2. **\[Set Payload\]**​ コンポーネントを ​**\[Insert\]**​ 操作の横にドラッグ横にます。
3. **\[Value (値)\]**​ を ​`Person Created`​ (個人作成済み) に設定します。
4. Mule アプリケーションを保存して実行します。

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">
	<http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>
	<db:config name="Database_Config" doc:name="Database Config" >
		<db:my-sql-connection host="localhost" port="3306" user="root" password="root" database="dev" />
	</db:config>
	<flow name="db-connector-testFlow">
		<http:listener doc:name="Listener" config-ref="HTTP_Listener_config" path="/person" allowedMethods="POST"/>
		<db:insert doc:name="Insert" config-ref="Database_Config">
			<db:sql ><![CDATA[insert into person (id, name, photo, dob)
values (:ID,:NAME,:PHOTO,:DOB);]]></db:sql>
			<db:input-parameters ><![CDATA[#[{'ID' : message.payload.parts['id'].content ,
'NAME': message.payload.parts['name'].content,
'PHOTO' : message.payload.parts['photo'].content,
'DOB' : message.payload.parts['dob'].content}]]]></db:input-parameters>
		</db:insert>
		<set-payload value="Person Created" doc:name="Set Payload" />
	</flow>
</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=8608056845cf52fd55c264952dd657d547927c4e60db60e64d89056c12ab35d0 url=/mulesoft/current/ja-jp/db-connector/1.14/database-insert-update-delete.md -->

# データベースのデータの挿入、更新、および削除の例

データベース用 Anypoint Connector (Database Connector) では、データベースのデータを管理できるようにする ​**Insert**​、​**Update**​、​**Delete**​ 操作がサポートされています。

次の例では、​`electronic`​ という名前のテーブルが含まれる ​`Products`​ という名前のデータベーススキーマのデータを挿入、更新、削除します。このテーブルには、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という列が含まれます。

次の SQL ステートメントでは、このテーブルを作成します。

```sql
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
)
```

## [](#studio-で-insert-操作を設定する)Studio で Insert 操作を設定する

テーブル ​`electronic`​ がすでに作成されていて、​`dbConfig`​ という名前の Database Connector 接続設定がある場合、テーブルに新しいレコードを挿入する ​**Insert**​ 操作を設定できます。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. コネクタ設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```XML
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
```

`id`​ パラメーターは、データベースによって自動的に生成される自動増分キーであるため、クエリに渡されません。

![Insert 操作の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-insert-example-1.png)

**設定 XML**​ エディターでは、​`<db:insert>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig">
  <db:sql>
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
  </db:sql>
</db:insert>
```

### [](#insert-操作の-input-parameters-入力パラメーター-項目を設定する)Insert 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

入力パラメーターの利点を得るには、次のように同等の SQL クエリを構築します。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. コネクタ設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```xml
INSERT INTO electronic(name, description, price, discount)
VALUES (:name, :description, :price, :discount)
```

1. **\[Input Parameters (入力パラメーター)\]**​ 項目で、次のパラメーターを設定します。

```xml
{
    name: 'Coffee Machine',
    description: 'Model:XYZ99. Uses small size capsules.',
    price: 120,
    discount: 5
}
```

![「Input Parameter (入力パラメーター)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-insert-example-2.png)

**設定 XML**​ エディターでは、​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig">
    <db:sql>
        INSERT INTO electronic(name, description, price, discount)
        VALUES (:name, :description, :price, :discount)
    </db:sql>
    <db:input-parameters>#[{
        name: 'Coffee Machine',
        description: 'Model:XYZ99. Uses small size capsules.',
        price: 120,
        discount: 5}]
    </db:input-parameters>
</db:insert>
```

### [](#insert-操作の-auto-generate-keys-自動生成キー-項目を設定する)Insert 操作の \[Auto Generate Keys (自動生成キー)\] 項目を設定する

**Insert**​ 操作は、2 つの項目 (クエリの影響を受けた行数を示す整数 ​`affectedRows`​ と、自動生成されたキーが含まれるマップ ​`generatedKeys`​) が含まれる ​`Statement Result`​ オブジェクトを出力します。

次の例の出力では、行は正常にテーブルに追加されているが、マップ ​`generatedKeys`​ が空であることが示されています。マップが空になるのは、オーバーヘッドを回避するためにこの情報がデフォルトで無効になっているためです。

```json
{
  "affectedRows": 1,
  "generatedKeys": {

  }
}
```

情報をアクティブ化してキーを生成する手順は、次のとおりです。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. **\[Advanced (詳細)\]**​ タブで ​**\[Auto generate keys (自動生成キー)\]**​ 項目を ​**\[True\]**​ に設定します。

![「Input Parameter (入力パラメーター)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-insert-example-3.png)

**設定 XML**​ エディターでは、​`<autoGenerateKeys>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true">
...
</db:insert>
```

ステートメントで影響を受けた行ごとに複数のキーが生成される場合、目的の列名が含まれるリストを設定して、返される列を指定できます。例:

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. **\[Advanced (詳細)\]**​ タブで、​**\[Auto generate column names (列名を自動生成)\]**​ 項目を \[​`Expression or Bean reference`​ (式または bean 参照)\] に設定して、項目を 1 つの文字列要素が含まれる DataWeave リストに設定します。
3. \[expression (式)\] 項目を ​`['id']`​ に設定して、​`id`​ 列のみが返されるようにします。

![「Auto generate column names (列名を自動生成)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-insert-example-4.png)

**設定 XML**​ エディターでは、​`<autoGeneratedKeysColumnNames>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true" autoGeneratedKeysColumnNames="#[['id']]">
    ...
</db:insert>
```

## [](#studio-で-update-操作を設定する)Studio で Update 操作を設定する

`electronic`​ テーブルが事前に定義されている場合、テーブルのデータを更新する (たとえば、価格値が 100 を越えているすべての項目の割引を 10 % に設定する) には、次のように ​**Update**​ 操作を設定します。

1. Studio のフローで、​**\[Update\]**​ 操作を選択します。
2. コネクタ設定画面で、​`"UPDATE electronic SET discount = :discount WHERE price > :price"`​ のように、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次のパラメーターに設定します。

```xml
{
      discount: 10,
      price: 100
}
```

![Update 操作の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-update-example-1.png)

**設定 XML**​ エディターでは、​`<db:update>`​ 設定は次のように記述されます。

```xml
<db:update doc:name="Update">
			<db:sql ><![CDATA["UPDATE electronic SET discount = :discount WHERE price > :price"]]></db:sql>
			<db:input-parameters ><![CDATA[#[{
        discount: 10,
        price: 100
    }]]]></db:input-parameters>
		</db:update>
```

`<![CDATA[…​]]>`​ ラッパーにより、クエリで ​`>`​ や ​`"`​ などの特殊文字を使用できます。 ラッパーがない場合、これらの文字の XML でエスケープされたバージョン (​`&gt;`​ や ​`&quot;`​ など) を使用する必要があります。

## [](#studio-で-delete-操作を設定する)Studio で Delete 操作を設定する

`electronic`​ テーブルが事前に定義されている場合、​`id: 1`​ のレコードを削除するには、次のように ​**Delete**​ 操作を設定します。

1. Studio のフローで、​**\[Update\]**​ 操作を選択します。
2. コネクタ設定画面で、​`DELETE FROM electronic WHERE id = :id`​ のように、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
3. **\[Input parameters (入力パラメーター)\]**​ 項目を ​`{id: 1}`​ に設定します。

![Studio での Update 操作の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-delete-example-1.png)

**設定 XML**​ エディターでは、​`<db:delete>`​ 設定は次のように記述されます。

```xml
<db:delete config-ref="dbConfig">
    <db:sql>DELETE FROM electronic WHERE id = :id</db:sql>
    <db:input-parameters>#[{
        id: 1
    }]</db:input-parameters>
</db:delete>
```

## [](#レコード挿入-mule-アプリケーションの例)レコード挿入 Mule アプリケーションの例

次の例は、データベースに個人のレコードを作成するように ​**Insert**​ 操作を設定する方法を示しています。

1. Studio で、HTTP ​**Listener**​ ソースを Studio キャンバスにドラッグします。
2. **\[Path (パス)\]**​ を ​`/person`​ に設定します。
3. **\[Insert\]**​ 操作を ​**\[Listener\]**​ ソースの横にドラッグします。
4. **\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
5. **\[SQL Query Text (SQL クエリテキスト)\]**​ ボックスで、次の SQL テキストを宣言します。
    
    ```xml
    insert into person (id, name, photo, dob)
    values (:ID,:NAME,:PHOTO,:DOB);
    ```

1. **\[Input Parameters (入力パラメーター)\]**​ 項目で、作成する個人レコードのマップのリストを指定します。これには、パラメーター名がキーとして、値がパラメーターとして含まれます。また、すべてのリスト項目は挿入する行を表します。
    
    ```xml
    {'ID' : message.payload.parts['id'].content ,
    'NAME': message.payload.parts['name'].content,
    'PHOTO' : message.payload.parts['photo'].content,
    'DOB' : message.payload.parts['dob'].content}
    ```
2. **\[Set Payload\]**​ コンポーネントを ​**\[Insert\]**​ 操作の横にドラッグ横にます。
3. **\[Value (値)\]**​ を ​`Person Created`​ (個人作成済み) に設定します。
4. Mule アプリケーションを保存して実行します。

**設定 XML**​ エディターでは、設定は次のように記述されます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">
	<http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>
	<db:config name="Database_Config" doc:name="Database Config" >
		<db:my-sql-connection host="localhost" port="3306" user="root" password="root" database="dev" />
	</db:config>
	<flow name="db-connector-testFlow">
		<http:listener doc:name="Listener" config-ref="HTTP_Listener_config" path="/person" allowedMethods="POST"/>
		<db:insert doc:name="Insert" config-ref="Database_Config">
			<db:sql ><![CDATA[insert into person (id, name, photo, dob)
values (:ID,:NAME,:PHOTO,:DOB);]]></db:sql>
			<db:input-parameters ><![CDATA[#[{'ID' : message.payload.parts['id'].content ,
'NAME': message.payload.parts['name'].content,
'PHOTO' : message.payload.parts['photo'].content,
'DOB' : message.payload.parts['dob'].content}]]]></db:input-parameters>
		</db:insert>
		<set-payload value="Person Created" doc:name="Set Payload" />
	</flow>
</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=4b0d2acf296a9402d3fdc8cc7c270b5ebee43c82165f17bfdbacdeaf4ea9d9ed url=/mulesoft/current/ja-jp/db-connector/1.9/database-insert-update-delete.md -->

# データベースのデータの挿入、更新、および削除の例

データベース用 Anypoint Connector (Database Connector) では、データベースのデータを管理できるようにする ​**Insert**​、​**Update**​、​**Delete**​ 操作がサポートされています。

次の例では、​`electronic`​ という名前のテーブルが含まれる ​`Products`​ という名前のデータベーススキーマのデータを挿入、更新、削除します。このテーブルには、​`id`​、​`name`​、​`description`​、​`price`​、​`discount`​ という列が含まれます。

次の SQL ステートメントでは、このテーブルを作成します。

```sql
CREATE TABLE electronic(
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100),
    description VARCHAR(255),
    price SMALLINT,
    discount TINYINT
)
```

## [](#studio-で-insert-操作を設定する)Studio で Insert 操作を設定する

テーブル ​`electronic`​ がすでに作成されていて、​`dbConfig`​ という名前の Database Connector 接続設定がある場合、テーブルに新しいレコードを挿入する ​**Insert**​ 操作を設定できます。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. コネクタ設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```XML
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
```

`id`​ パラメーターは、データベースによって自動的に生成される自動増分キーであるため、クエリに渡されません。

次のスクリーンショットは、Studio の設定を示しています。

![Insert 操作の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-insert-example-1.png)

XML エディターでは、​`<db:insert>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig">
  <db:sql>
    INSERT INTO electronic(name, description, price, discount)
    VALUES ('Coffee Machine', 'Model: XYZ99. Uses small size capsules.', 120, 5)
  </db:sql>
</db:insert>
```

### [](#insert-操作の-input-parameters-入力パラメーター-項目を設定する)Insert 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

入力パラメーターの利点を得るには、次のように同等の SQL クエリを構築します。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. コネクタ設定画面で、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。例:

```xml
INSERT INTO electronic(name, description, price, discount)
VALUES (:name, :description, :price, :discount)
```

1. **\[Input Parameters (入力パラメーター)\]**​ 項目で、次のパラメーターを設定します。

```xml
{
    name: 'Coffee Machine',
    description: 'Model:XYZ99. Uses small size capsules.',
    price: 120,
    discount: 5
}
```

次のスクリーンショットは、​**\[Input Parameter (入力パラメーター)\]**​ 項目の設定を示しています。

![「Input Parameter (入力パラメーター)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-insert-example-2.png)

XML エディターでは、​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig">
    <db:sql>
        INSERT INTO electronic(name, description, price, discount)
        VALUES (:name, :description, :price, :discount)
    </db:sql>
    <db:input-parameters>#[{
        name: 'Coffee Machine',
        description: 'Model:XYZ99. Uses small size capsules.',
        price: 120,
        discount: 5}]
    </db:input-parameters>
</db:insert>
```

### [](#insert-操作の-auto-generate-keys-自動生成キー-項目を設定する)Insert 操作の \[Auto Generate Keys (自動生成キー)\] 項目を設定する

**Insert**​ 操作は、2 つの項目 (クエリの影響を受けた行数を示す整数 ​`affectedRows`​ と、自動生成されたキーが含まれるマップ ​`generatedKeys`​) が含まれる ​`Statement Result`​ オブジェクトを出力します。

次の例の出力では、行は正常にテーブルに追加されているが、マップ ​`generatedKeys`​ が空であることが示されています。マップが空になるのは、オーバーヘッドを回避するためにこの情報がデフォルトで無効になっているためです。

```json
{
  "affectedRows": 1,
  "generatedKeys": {

  }
}
```

情報をアクティブ化してキーを生成する手順は、次のとおりです。

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. **\[Advanced (詳細)\]**​ タブで ​**\[Auto generate keys (自動生成キー)\]**​ 項目を ​**\[True\]**​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![「Input Parameter (入力パラメーター)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-insert-example-3.png)

XML エディターでは、​`<autoGenerateKeys>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true">
...
</db:insert>
```

ステートメントで影響を受けた行ごとに複数のキーが生成される場合、目的の列名が含まれるリストを設定して、返される列を指定できます。例:

1. Studio のフローで、​**\[Insert\]**​ 操作を選択します。
2. **\[Advanced (詳細)\]**​ タブで、​**\[Auto generate column names (列名を自動生成)\]**​ 項目を \[​`Expression or Bean reference`​ (式または bean 参照)\] に設定して、項目を 1 つの文字列要素が含まれる DataWeave リストに設定します。
3. \[expression (式)\] 項目を ​`['id']`​ に設定して、​`id`​ 列のみが返されるようにします。

次のスクリーンショットは、Studio の設定を示しています。

![「Auto generate column names (列名を自動生成)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-insert-example-4.png)

XML エディターでは、​`<autoGeneratedKeysColumnNames>`​ 設定は次のように記述されます。

```xml
<db:insert config-ref="dbConfig" autoGenerateKeys="true" autoGeneratedKeysColumnNames="#[['id']]">
    ...
</db:insert>
```

## [](#studio-で-update-操作を設定する)Studio で Update 操作を設定する

`electronic`​ テーブルが事前に定義されている場合、テーブルのデータを更新する (たとえば、価格値が 100 を越えているすべての項目の割引を 10 % に設定する) には、次のように ​**Update**​ 操作を設定します。

1. Studio のフローで、​**\[Update\]**​ 操作を選択します。
2. コネクタ設定画面で、​`"UPDATE electronic SET discount = :discount WHERE price > :price"`​ のように、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
3. **\[Input parameters (入力パラメーター)\]**​ 項目を次のパラメーターに設定します。

```xml
{
      discount: 10,
      price: 100
}
```

次のスクリーンショットは、Studio の設定を示しています。

![Update 操作の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-update-example-1.png)

XML エディターでは、​`<db:update>`​ 設定は次のように記述されます。

```xml
<db:update doc:name="Update">
			<db:sql ><![CDATA["UPDATE electronic SET discount = :discount WHERE price > :price"]]></db:sql>
			<db:input-parameters ><![CDATA[#[{
        discount: 10,
        price: 100
    }]]]></db:input-parameters>
		</db:update>
```

`<![CDATA[…​]]>`​ ラッパーにより、クエリで ​`>`​ や ​`"`​ などの特殊文字を使用できます。 ラッパーがない場合、これらの文字の XML でエスケープされたバージョン (​`&gt;`​ や ​`&quot;`​ など) を使用する必要があります。

## [](#studio-で-delete-操作を設定する)Studio で Delete 操作を設定する

`electronic`​ テーブルが事前に定義されている場合、​`id: 1`​ のレコードを削除するには、次のように ​**Delete**​ 操作を設定します。

1. Studio のフローで、​**\[Update\]**​ 操作を選択します。
2. コネクタ設定画面で、​`DELETE FROM electronic WHERE id = :id`​ のように、実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します。
3. **\[Input parameters (入力パラメーター)\]**​ 項目を ​`{id: 1}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Update 操作の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-delete-example-1.png)

XML エディターでは、​`<db:delete>`​ 設定は次のように記述されます。

```xml
<db:delete config-ref="dbConfig">
    <db:sql>DELETE FROM electronic WHERE id = :id</db:sql>
    <db:input-parameters>#[{
        id: 1
    }]</db:input-parameters>
</db:delete>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=fbabd1f70020c0e369414128279dd7436eb4b4550e16cf3d3105a87347d83427 url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-select.md -->

# データベースの照会の例

データベース用 Anypoint Connector (Database Connector) の ​**Select**​ 操作では、データベースのデータを選択できます。次の例は、Studio で ​**\[Input Parameters (入力パラメーター)\]**​、​**\[Fetch size (フェッチサイズ)\]**​、​**\[Max rows (最大行数)\]**​、​**\[Query timeout (クエリタイムアウト)\]**​ 項目を設定して操作を設定するときに役立ちます。また、動的クエリを設定する方法についても記載されています。

## [](#studio-で-select-操作を設定する)Studio で Select 操作を設定する

Studio で ​**Select**​ 操作を追加および設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Select\]**​ 操作を選択します。
2. **\[Select\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `SELECT * FROM PLANET WHERE name = :name`​)。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Select 操作の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-select-operation-1.png)

Figure 1. Select 操作の設定

XML エディターでは、​`<db:select>`​ 設定は次のように記述されます。

```xml
<db:select config-ref="dbConfig">
  <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
</db:select>
```

## [](#select-操作の-input-parameters-入力パラメーター-項目を設定する)Select 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

データベースクエリを保護するには、データベースで実行する SQL ステートメントに変数値を追加して、​**Select**​ 操作の ​**\[Input parameters (入力パラメーター)\]**​ 項目を設定します。Select 操作の主な目標は、SQL クエリを提供し、パラメーターに DataWeave を使用することです。

指定するパラメーターは、JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップです。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。

入力パラメーターを使用して SQL ​`SELECT`​ ステートメントの ​`WHERE`​ 句を設定すると、クエリが SQL インジェクション攻撃の影響を受けなくなり、他の方法では不可能な最適化を実行でき、アプリケーションのパフォーマンスが向上します。

セキュリティ上の理由により、​`<db:sql>SELECT * FROM PLANET WHERE name = #[payload] </db:sql>`​ は直接記述しないでください。

操作の入力パラメーターと出力パラメーターには DataSense を使用できます。Database Connector はクエリを分析し、SQL ステートメントの射影セクションを分析することで、クエリの出力構造を自動的に計算します。同時に、​`WHERE`​ 句の条件をテーブル構造と比較して、DataSense 入力も生成します。これは、入力パラメーターを生成する DataWeave スクリプトをビルドするのに役立ちます。

次の例では、入力パラメーターをキー-値ペアとして指定します。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT * FROM PLANET WHERE name = :name`​ に設定します。
3. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{'name' : payload}`​ に設定します。  
    このキーでは、コロン文字 (​`:`​) を使用して、名前によりパラメーター値を参照します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Input parameters (入力パラメーター)\] 項目の設定](_images/database-select-operation-2.png)

Figure 2. \[Input Parameters (入力パラメーター)\] の設定

XML エディターでは、​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<flow name="DatabaseFlow">
  <db:select config-ref="dbConfig">
    <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
    <db:input-parameters>
      #[{'name' : payload}]
    </db:input-parameters>
  </db:select>
</flow>
```

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Database Connector 1.4.0 では、SQL クエリでコロンをエスケープできます。SQL クエリでコロン文字 (​<code>:</code>​) を使用する場合、コロン文字の前にバックスラッシュを置くことでコロン文字をエスケープできます。これは、PostgreSQL 種別のキャストを使用する場合に役立ちます。この場合、キャスト先の種別の前に 2 つのコロンが必要です。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT price\:\:float8 FROM PRODUCT&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Database Connector 1.8.0 以降では、ダブルコロン (::) 表現を使用して、各コロンをエスケープせず SQL キャスト PostgreSQL および Snowflake 構文を受け入れることができます。エスケープされたコロンの動作に影響することもありません。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT MAX(modified_date)::DATE FROM sales&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

## [](#select-操作の動的クエリを設定する)Select 操作の動的クエリを設定する

`WHERE`​ 句だけでなくクエリ自体の一部をパラメーター化する必要がある場合 (条件に依存するテーブルを比較するクエリや、プロジェクトテーブル列を変更する必要がある複雑なクエリなど)、動的クエリを設定できます。

次の例では、テーブルが変数に依存することを記述する文字列 ​`$(vars.table)`​ が含まれる完全な式を使用して動的クエリを設定します。一部のクエリテキストは動的 (​`"SELECT * FROM $(vars.table)`​) ですが、​`WHERE`​ 句では、入力パラメーターを使用して引き続き ​`WHERE`​ 条件を定義します (この例では ​`WHERE name = :name`​)。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT * FROM $(vars.table) WHERE name = :name`​ に設定します。
3. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{'name' : payload}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での動的クエリの設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-select-operation-3.png)

Figure 3. 動的クエリの設定

XML エディターでは、​`<db:sql>`​ 設定は次のように記述されます。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

入力パラメーターは ​`WHERE`​ 句のパラメーターにのみ適用できます。クエリの別の部分を変更するには、DataWeave 補間演算子を使用します。

設計時に式の値を使用できない場合があるため、動的クエリを使用すると、DataWeave 評価エラーがスローされたり、​**Select**​ 操作の出力メタデータ (DataSense) に影響したりすることがあります。 値をデフォルトにする (前述の不都合を回避する) には、次のように default 修飾子を使用できます。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table default ASTEROIDS) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

### [](#大量の結果のストリーミング)大量の結果のストリーミング

インテグレーションのユースケースなど、多くのレコードを返すクエリでストリーミングを使用します。Mule 4 では、ストリーミングは透過的であり、常に有効になっています。

たとえば、10,000 行を返すクエリを送信した場合、それらすべての行を一度にフェッチしようとすると、ネットワークから大量の取り込みを行うため、パフォーマンスが低下し、すべての情報を RAM に読み込む必要があるため、メモリ不足になるリスクがあります。

ストリーミングでは、Database Connector は一度にクエリの一部のみをフェッチおよび処理するため、ネットワークとメモリの負荷が軽減されます。 これは、コネクタが 10K 行を一度にフェッチしないことを意味します。代わりに、コネクタは小さなチャンクをフェッチし、そのチャンクがコンシュームされたら残りをフェッチします。

反復可能なストリームメカニズムを使用することもできます。これにより、DataWeave や他のコンポーネントで同じストリームを何度も処理できます。また、並列処理も可能です。

## [](#select-操作の-fetch-size-フェッチサイズ-と-max-rows-最大行数-項目を設定する)Select 操作の \[Fetch Size (フェッチサイズ)\] と \[Max Rows (最大行数)\] 項目を設定する

Mule Runtime Engine (Mule) では、Database Connector でストリーミングを管理できますが、データの大きなチャンクをデータベースから Mule に移動することをお勧めできない場合もあります。ストリーミングを使用しても、単純な SQL クエリで、各行に大量の情報を含む多くの行が返される可能性はあります。結果を制限するには、​**\[Fetch size (フェッチサイズ)\]**​ 項目と ​**\[Max rows (最大行数)\]**​ 項目を設定します。

次の例では、​**Select**​ 操作でこれらの項目を設定します。この構文は、フェッチできる合計行数は 1000 (​**\[Max rows (最大行数)\]**​ 値) 以下、同時にフェッチできる行数は 200 (​**\[Fetch size (フェッチサイズ)\]**​ 値) 以下であることを Database Connector に指示します。これにより、ネットワークとメモリの負荷が大幅に軽減されます。​**\[Fetch size (フェッチサイズ)\]**​ 値は JDBC ドライバープロバイダーごとに異なって適用され、多くの場合、デフォルトで ​`10`​ に設定されます。 この組み合わせにより、取得される情報の総量が制限され (​**\[Max rows (最大行数)\]**​ 値)、ネットワーク経由でデータベースから小さいチャンクのデータが返されることが保証されます (​**\[Fetch size (フェッチサイズ)\]**​ 値)。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`select * from some_table`​ に設定します。
3. **\[Advanced (詳細)\]**​ タブをクリックし、​**\[Fetch size (フェッチサイズ)\]**​ 項目を ​`200`​、​**\[Max rows (最大行数)\]**​ 項目を ​`1000`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Fetch size (フェッチサイズ)\] 項目と \[Max row (最大行数)\] 項目の設定](_images/database-select-operation-4.png)

Figure 4. \[Fetch size (フェッチサイズ)\] 項目と \[Max row (最大行数)\] 項目の設定

XML エディターでは、​`fetchSize`​ および ​`maxRows`​ 設定は次のように記述されます。

```xml
<db:select fetchSize="200" maxRows="1000" config-ref="dbConfig">
  <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#select-操作の-query-timeout-クエリタイムアウト-項目を設定する)Select 操作の \[Query Timeout (クエリタイムアウト)\] 項目を設定する

多くの場合、次の要因によりクエリの実行が遅延します。

- 非効率なクエリ (多くの行を反復処理する不適切なインデックスを持つクエリなど)
- 混雑している RDBMS またはネットワーク
- ロック競合

クエリの実行時にタイムアウトしないようにするには、​**\[Query timeout (クエリタイムアウト)\]**​ 項目と ​**\[Query time unit (クエリ時間単位)\]**​ 項目を設定します。すべての Database Connector 操作でタイムアウトの設定がサポートされています。

次の例は、タイムアウトを設定する方法を示しています。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`select * from some_table`​ に設定します。
3. **\[Advanced (詳細)\]**​ タブで、JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を ​**\[Query timeout (クエリタイムアウト)\]**​ 項目に設定します。例: `0`​。
4. **\[Query timeout (クエリタイムアウト)\]**​ に使用できる時間単位を ​**\[Query timeout unit (クエリタイムアウト単位)\]**​ 項目に設定します。例: `SECONDS`​。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Query timeout (クエリタイムアウト)\] 項目の設定](_images/database-select-operation-5.png)

Figure 5. \[Query timeout (クエリタイムアウト)\] の設定

XML エディターでは、​`queryTimeout`​ および ​`SECONDS`​ 設定は次のように記述されます。

```xml
<db:select queryTimeout="0" queryTimeoutUnit="SECONDS" config-ref="dbConfig">
   <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=e18a67a602f3a8e9c4f23ef0f79332529630df898e1757059948e3c8e7e00390 url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-select.md -->

# データベースの照会の例

データベース用 Anypoint Connector (Database Connector) の ​**Select**​ 操作では、データベースのデータを選択できます。次の例は、Studio で ​**\[Input Parameters (入力パラメーター)\]**​、​**\[Fetch size (フェッチサイズ)\]**​、​**\[Max rows (最大行数)\]**​、​**\[Query timeout (クエリタイムアウト)\]**​ 項目を設定して操作を設定するときに役立ちます。また、動的クエリを設定する方法についても記載されています。

## [](#studio-で-select-操作を設定する)Studio で Select 操作を設定する

Studio で ​**Select**​ 操作を追加および設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Select\]**​ 操作を選択します。
2. **\[Select\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `SELECT * FROM PLANET WHERE name = :name`​)。

![Studio での Select 操作の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-select-operation-1.png)

**設定 XML**​ エディターでは、​`<db:select>`​ 設定は次のように記述されます。

```xml
<db:select config-ref="dbConfig">
  <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
</db:select>
```

## [](#select-操作の-input-parameters-入力パラメーター-項目を設定する)Select 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

データベースクエリを保護するには、データベースで実行する SQL ステートメントに変数値を追加して、​**Select**​ 操作の ​**\[Input parameters (入力パラメーター)\]**​ 項目を設定します。Select 操作の主な目標は、SQL クエリを提供し、パラメーターに DataWeave を使用することです。

指定するパラメーターは、JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップです。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。

入力パラメーターを使用して SQL ​`SELECT`​ ステートメントの ​`WHERE`​ 句を設定すると、クエリが SQL インジェクション攻撃の影響を受けなくなり、他の方法では不可能な最適化を実行でき、アプリケーションのパフォーマンスが向上します。

セキュリティ上の理由により、​`<db:sql>SELECT * FROM PLANET WHERE name = #[payload] </db:sql>`​ は直接記述しないでください。

操作の入力パラメーターと出力パラメーターには DataSense を使用できます。Database Connector はクエリを分析し、SQL ステートメントの射影セクションを分析することで、クエリの出力構造を自動的に計算します。同時に、​`WHERE`​ 句の条件をテーブル構造と比較して、DataSense 入力も生成します。これは、入力パラメーターを生成する DataWeave スクリプトをビルドするのに役立ちます。

次の例では、入力パラメーターをキー-値ペアとして指定します。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`SELECT * FROM PLANET WHERE name = :name`​ に設定します。
3. **\[Input Parameters (入力パラメーター)\]**​ を ​`{'name' : payload}`​ に設定します。  
    このキーでは、コロン文字 (​`:`​) を使用して、名前によりパラメーター値を参照します。

![Studio での \[Input parameters (入力パラメーター)\] 項目の設定](_images/database-select-operation-2.png)

**設定 XML**​ エディターでは、​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<flow name="DatabaseFlow">
  <db:select config-ref="dbConfig">
    <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
    <db:input-parameters>
      #[{'name' : payload}]
    </db:input-parameters>
  </db:select>
</flow>
```

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Database Connector 1.4.0 では、SQL クエリでコロンをエスケープできます。SQL クエリでコロン文字 (​<code>:</code>​) を使用する場合、コロン文字の前にバックスラッシュを置くことでコロン文字をエスケープできます。これは、PostgreSQL 種別のキャストを使用する場合に役立ちます。この場合、キャスト先の種別の前に 2 つのコロンが必要です。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT price\:\:float8 FROM PRODUCT&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Database Connector 1.8.0 以降では、ダブルコロン (::) 表現を使用して、各コロンをエスケープせず SQL キャスト PostgreSQL および Snowflake 構文を受け入れることができます。エスケープされたコロンの動作に影響することもありません。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT MAX(modified_date)::DATE FROM sales&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

## [](#select-操作の動的クエリを設定する)Select 操作の動的クエリを設定する

`WHERE`​ 句だけでなくクエリ自体の一部をパラメーター化する必要がある場合 (条件に依存するテーブルを比較するクエリや、プロジェクトテーブル列を変更する必要がある複雑なクエリなど)、動的クエリを設定できます。

次の例では、テーブルが変数に依存することを記述する文字列 ​`$(vars.table)`​ が含まれる完全な式を使用して動的クエリを設定します。一部のクエリテキストは動的 (​`"SELECT * FROM $(vars.table)`​) ですが、​`WHERE`​ 句では、入力パラメーターを使用して引き続き ​`WHERE`​ 条件を定義します (この例では ​`WHERE name = :name`​)。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT * FROM $(vars.table) WHERE name = :name`​ に設定します。
3. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{'name' : payload}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での動的クエリの設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-select-operation-3.png)

Figure 1. 動的クエリの設定

XML エディターでは、​`<db:sql>`​ 設定は次のように記述されます。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

入力パラメーターは ​`WHERE`​ 句のパラメーターにのみ適用できます。クエリの別の部分を変更するには、DataWeave 補間演算子を使用します。

設計時に式の値を使用できない場合があるため、動的クエリを使用すると、DataWeave 評価エラーがスローされたり、​**Select**​ 操作の出力メタデータ (DataSense) に影響したりすることがあります。 値をデフォルトにして、前述の不都合を回避するには、次のように default 修飾子を使用します。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table default ASTEROIDS) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

### [](#大量の結果のストリーミング)大量の結果のストリーミング

インテグレーションのユースケースなど、多くのレコードを返すクエリでストリーミングを使用します。Mule 4 では、ストリーミングは透過的であり、常に有効になっています。

たとえば、10,000 行を返すクエリを送信した場合、それらすべての行を一度にフェッチしようとすると、ネットワークから大量の取り込みを行うため、パフォーマンスが低下し、すべての情報を RAM に読み込む必要があるため、メモリ不足になるリスクがあります。

ストリーミングでは、Database Connector は一度にクエリの一部のみをフェッチおよび処理するため、ネットワークとメモリの負荷が軽減されます。 これは、コネクタが 10K 行を一度にフェッチしないことを意味します。代わりに、コネクタは小さなチャンクをフェッチし、そのチャンクがコンシュームされたら残りをフェッチします。

反復可能なストリームメカニズムを使用することもできます。これにより、DataWeave や他のコンポーネントで同じストリームを何度も処理できます。また、並列処理も可能です。

## [](#select-操作の-fetch-size-フェッチサイズ-と-max-rows-最大行数-項目を設定する)Select 操作の \[Fetch Size (フェッチサイズ)\] と \[Max Rows (最大行数)\] 項目を設定する

Mule Runtime Engine (Mule) では、Database Connector でストリーミングを管理できますが、データの大きなチャンクをデータベースから Mule に移動することをお勧めできない場合もあります。ストリーミングを使用しても、単純な SQL クエリで、各行に大量の情報を含む多くの行が返される可能性はあります。結果を制限するには、​**\[Fetch size (フェッチサイズ)\]**​ 項目と ​**\[Max rows (最大行数)\]**​ 項目を設定します。

次の例では、​**Select**​ 操作でこれらの項目を設定します。この構文は、フェッチできる合計行数は 1000 (​**\[Max rows (最大行数)\]**​ 値) 以下、同時にフェッチできる行数は 200 (​**\[Fetch size (フェッチサイズ)\]**​ 値) 以下であることを Database Connector に指示します。これにより、ネットワークとメモリの負荷が大幅に軽減されます。​**\[Fetch size (フェッチサイズ)\]**​ 値は JDBC ドライバープロバイダーごとに異なって適用され、多くの場合、デフォルトで ​`10`​ に設定されます。 この組み合わせにより、取得される情報の総量が制限され (​**\[Max rows (最大行数)\]**​ 値)、ネットワーク経由でデータベースから小さいチャンクのデータが返されることが保証されます (​**\[Fetch size (フェッチサイズ)\]**​ 値)。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`select * from some_table`​ に設定します。
3. **\[Advanced (詳細)\]**​ をクリックし、​**\[Fetch size (フェッチサイズ)\]**​ を ​`200`​、​**\[Max rows (最大行数)\]**​ を ​`1000`​ に設定します。

![Studio での \[Fetch size (フェッチサイズ)\] 項目と \[Max row (最大行数)\] 項目の設定](_images/database-select-operation-4.png)

**\[Configuration XML (設定 XML)\]**​ エディターで、​`fetchSize`​ および ​`maxRows`​ の設定は次のように記述されます。

```xml
<db:select fetchSize="200" maxRows="1000" config-ref="dbConfig">
  <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#select-操作の-query-timeout-クエリタイムアウト-項目を設定する)Select 操作の \[Query Timeout (クエリタイムアウト)\] 項目を設定する

多くの場合、次の要因によりクエリの実行が遅延します。

- 非効率なクエリ (多くの行を反復処理する不適切なインデックスを持つクエリなど)
- 混雑している RDBMS またはネットワーク
- ロック競合

クエリの実行時にタイムアウトしないようにするには、​**\[Query timeout (クエリタイムアウト)\]**​ 項目と ​**\[Query time unit (クエリ時間単位)\]**​ 項目を設定します。すべての Database Connector 操作でタイムアウトの設定がサポートされています。

次の例は、タイムアウトを設定する方法を示しています。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`select * from some_table`​ に設定します。
3. **\[Advanced (詳細)\]**​ タブで、JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を ​**\[Query timeout (クエリタイムアウト)\]**​ に設定します。例: `0`​。
4. **\[Query timeout (クエリタイムアウト)\]**​ に使用できる時間単位を ​**\[Query timeout unit (クエリタイムアウト単位)\]**​ に設定します。例: `SECONDS`​。

![Studio での \[Query timeout (クエリタイムアウト)\] 項目の設定](_images/database-select-operation-5.png)

**\[Configuration XML (設定 XML)\]**​ エディターで、​`queryTimeout`​ および ​`SECONDS`​ の設定は次のように記述されます。

```xml
<db:select queryTimeout="0" queryTimeoutUnit="SECONDS" config-ref="dbConfig">
   <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=c57f93fe1ab71759b993cace5abb690f0c038bc1d763df510c1940647a984d20 url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-select.md -->

# データベースの照会の例

データベース用 Anypoint Connector (Database Connector) の ​**Select**​ 操作では、データベースのデータを選択できます。次の例は、Studio で ​**\[Input Parameters (入力パラメーター)\]**​、​**\[Fetch size (フェッチサイズ)\]**​、​**\[Max rows (最大行数)\]**​、​**\[Query timeout (クエリタイムアウト)\]**​ 項目を設定して操作を設定するときに役立ちます。また、動的クエリを設定する方法についても記載されています。

## [](#studio-で-select-操作を設定する)Studio で Select 操作を設定する

Studio で ​**Select**​ 操作を追加および設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Select\]**​ 操作を選択します。
2. **\[Select\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `SELECT * FROM PLANET WHERE name = :name`​)。

![Studio での Select 操作の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-select-operation-1.png)

**設定 XML**​ エディターでは、​`<db:select>`​ 設定は次のように記述されます。

```xml
<db:select config-ref="dbConfig">
  <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
</db:select>
```

## [](#select-操作の-input-parameters-入力パラメーター-項目を設定する)Select 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

データベースクエリを保護するには、データベースで実行する SQL ステートメントに変数値を追加して、​**Select**​ 操作の ​**\[Input parameters (入力パラメーター)\]**​ 項目を設定します。Select 操作の主な目標は、SQL クエリを提供し、パラメーターに DataWeave を使用することです。

指定するパラメーターは、JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップです。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。

入力パラメーターを使用して SQL ​`SELECT`​ ステートメントの ​`WHERE`​ 句を設定すると、クエリが SQL インジェクション攻撃の影響を受けなくなり、他の方法では不可能な最適化を実行でき、アプリケーションのパフォーマンスが向上します。

セキュリティ上の理由により、​`<db:sql>SELECT * FROM PLANET WHERE name = #[payload] </db:sql>`​ は直接記述しないでください。

操作の入力パラメーターと出力パラメーターには DataSense を使用できます。Database Connector はクエリを分析し、SQL ステートメントの射影セクションを分析することで、クエリの出力構造を自動的に計算します。同時に、​`WHERE`​ 句の条件をテーブル構造と比較して、DataSense 入力も生成します。これは、入力パラメーターを生成する DataWeave スクリプトをビルドするのに役立ちます。

次の例では、入力パラメーターをキー-値ペアとして指定します。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`SELECT * FROM PLANET WHERE name = :name`​ に設定します。
3. **\[Input Parameters (入力パラメーター)\]**​ を ​`{'name' : payload}`​ に設定します。  
    このキーでは、コロン文字 (​`:`​) を使用して、名前によりパラメーター値を参照します。

![Studio での \[Input parameters (入力パラメーター)\] 項目の設定](_images/database-select-operation-2.png)

**設定 XML**​ エディターでは、​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<flow name="DatabaseFlow">
  <db:select config-ref="dbConfig">
    <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
    <db:input-parameters>
      #[{'name' : payload}]
    </db:input-parameters>
  </db:select>
</flow>
```

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Database Connector 1.4.0 では、SQL クエリでコロンをエスケープできます。SQL クエリでコロン文字 (​<code>:</code>​) を使用する場合、コロン文字の前にバックスラッシュを置くことでコロン文字をエスケープできます。これは、PostgreSQL 種別のキャストを使用する場合に役立ちます。この場合、キャスト先の種別の前に 2 つのコロンが必要です。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT price\:\:float8 FROM PRODUCT&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Database Connector 1.8.0 以降では、ダブルコロン (::) 表現を使用して、各コロンをエスケープせず SQL キャスト PostgreSQL および Snowflake 構文を受け入れることができます。エスケープされたコロンの動作に影響することもありません。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT MAX(modified_date)::DATE FROM sales&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

## [](#select-操作の動的クエリを設定する)Select 操作の動的クエリを設定する

`WHERE`​ 句だけでなくクエリ自体の一部をパラメーター化する必要がある場合 (条件に依存するテーブルを比較するクエリや、プロジェクトテーブル列を変更する必要がある複雑なクエリなど)、動的クエリを設定できます。

次の例では、テーブルが変数に依存することを記述する文字列 ​`$(vars.table)`​ が含まれる完全な式を使用して動的クエリを設定します。一部のクエリテキストは動的 (​`"SELECT * FROM $(vars.table)`​) ですが、​`WHERE`​ 句では、入力パラメーターを使用して引き続き ​`WHERE`​ 条件を定義します (この例では ​`WHERE name = :name`​)。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT * FROM $(vars.table) WHERE name = :name`​ に設定します。
3. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{'name' : payload}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での動的クエリの設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-select-operation-3.png)

Figure 1. 動的クエリの設定

XML エディターでは、​`<db:sql>`​ 設定は次のように記述されます。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

入力パラメーターは ​`WHERE`​ 句のパラメーターにのみ適用できます。クエリの別の部分を変更するには、DataWeave 補間演算子を使用します。

設計時に式の値を使用できない場合があるため、動的クエリを使用すると、DataWeave 評価エラーがスローされたり、​**Select**​ 操作の出力メタデータ (DataSense) に影響したりすることがあります。 値をデフォルトにして、前述の不都合を回避するには、次のように default 修飾子を使用します。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table default ASTEROIDS) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

### [](#大量の結果のストリーミング)大量の結果のストリーミング

インテグレーションのユースケースなど、多くのレコードを返すクエリでストリーミングを使用します。Mule 4 では、ストリーミングは透過的であり、常に有効になっています。

たとえば、10,000 行を返すクエリを送信した場合、それらすべての行を一度にフェッチしようとすると、ネットワークから大量の取り込みを行うため、パフォーマンスが低下し、すべての情報を RAM に読み込む必要があるため、メモリ不足になるリスクがあります。

ストリーミングでは、Database Connector は一度にクエリの一部のみをフェッチおよび処理するため、ネットワークとメモリの負荷が軽減されます。 これは、コネクタが 10K 行を一度にフェッチしないことを意味します。代わりに、コネクタは小さなチャンクをフェッチし、そのチャンクがコンシュームされたら残りをフェッチします。

反復可能なストリームメカニズムを使用することもできます。これにより、DataWeave や他のコンポーネントで同じストリームを何度も処理できます。また、並列処理も可能です。

## [](#select-操作の-fetch-size-フェッチサイズ-と-max-rows-最大行数-項目を設定する)Select 操作の \[Fetch Size (フェッチサイズ)\] と \[Max Rows (最大行数)\] 項目を設定する

Mule Runtime Engine (Mule) では、Database Connector でストリーミングを管理できますが、データの大きなチャンクをデータベースから Mule に移動することをお勧めできない場合もあります。ストリーミングを使用しても、単純な SQL クエリで、各行に大量の情報を含む多くの行が返される可能性はあります。結果を制限するには、​**\[Fetch size (フェッチサイズ)\]**​ 項目と ​**\[Max rows (最大行数)\]**​ 項目を設定します。

次の例では、​**Select**​ 操作でこれらの項目を設定します。この構文は、フェッチできる合計行数は 1000 (​**\[Max rows (最大行数)\]**​ 値) 以下、同時にフェッチできる行数は 200 (​**\[Fetch size (フェッチサイズ)\]**​ 値) 以下であることを Database Connector に指示します。これにより、ネットワークとメモリの負荷が大幅に軽減されます。​**\[Fetch size (フェッチサイズ)\]**​ 値は JDBC ドライバープロバイダーごとに異なって適用され、多くの場合、デフォルトで ​`10`​ に設定されます。 この組み合わせにより、取得される情報の総量が制限され (​**\[Max rows (最大行数)\]**​ 値)、ネットワーク経由でデータベースから小さいチャンクのデータが返されることが保証されます (​**\[Fetch size (フェッチサイズ)\]**​ 値)。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`select * from some_table`​ に設定します。
3. **\[Advanced (詳細)\]**​ をクリックし、​**\[Fetch size (フェッチサイズ)\]**​ を ​`200`​、​**\[Max rows (最大行数)\]**​ を ​`1000`​ に設定します。

![Studio での \[Fetch size (フェッチサイズ)\] 項目と \[Max row (最大行数)\] 項目の設定](_images/database-select-operation-4.png)

**\[Configuration XML (設定 XML)\]**​ エディターで、​`fetchSize`​ および ​`maxRows`​ の設定は次のように記述されます。

```xml
<db:select fetchSize="200" maxRows="1000" config-ref="dbConfig">
  <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#select-操作の-query-timeout-クエリタイムアウト-項目を設定する)Select 操作の \[Query Timeout (クエリタイムアウト)\] 項目を設定する

多くの場合、次の要因によりクエリの実行が遅延します。

- 非効率なクエリ (多くの行を反復処理する不適切なインデックスを持つクエリなど)
- 混雑している RDBMS またはネットワーク
- ロック競合

クエリの実行時にタイムアウトしないようにするには、​**\[Query timeout (クエリタイムアウト)\]**​ 項目と ​**\[Query time unit (クエリ時間単位)\]**​ 項目を設定します。すべての Database Connector 操作でタイムアウトの設定がサポートされています。

次の例は、タイムアウトを設定する方法を示しています。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`select * from some_table`​ に設定します。
3. **\[Advanced (詳細)\]**​ タブで、JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を ​**\[Query timeout (クエリタイムアウト)\]**​ に設定します。例: `0`​。
4. **\[Query timeout (クエリタイムアウト)\]**​ に使用できる時間単位を ​**\[Query timeout unit (クエリタイムアウト単位)\]**​ に設定します。例: `SECONDS`​。

![Studio での \[Query timeout (クエリタイムアウト)\] 項目の設定](_images/database-select-operation-5.png)

**\[Configuration XML (設定 XML)\]**​ エディターで、​`queryTimeout`​ および ​`SECONDS`​ の設定は次のように記述されます。

```xml
<db:select queryTimeout="0" queryTimeoutUnit="SECONDS" config-ref="dbConfig">
   <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=c007783f5342386a5fb2c27e741af723f8cdb1a424a13628bed8ed745d31bbb1 url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-select.md -->

# データベースの照会の例

データベース用 Anypoint Connector (Database Connector) の ​**Select**​ 操作では、データベースのデータを選択できます。次の例は、Studio で ​**\[Input Parameters (入力パラメーター)\]**​、​**\[Fetch size (フェッチサイズ)\]**​、​**\[Max rows (最大行数)\]**​、​**\[Query timeout (クエリタイムアウト)\]**​ 項目を設定して操作を設定するときに役立ちます。また、動的クエリを設定する方法についても記載されています。

## [](#studio-で-select-操作を設定する)Studio で Select 操作を設定する

Studio で ​**Select**​ 操作を追加および設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Select\]**​ 操作を選択します。
2. **\[Select\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `SELECT * FROM PLANET WHERE name = :name`​)。

![Studio での Select 操作の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-select-operation-1.png)

**設定 XML**​ エディターでは、​`<db:select>`​ 設定は次のように記述されます。

```xml
<db:select config-ref="dbConfig">
  <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
</db:select>
```

## [](#select-操作の-input-parameters-入力パラメーター-項目を設定する)Select 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

データベースクエリを保護するには、データベースで実行する SQL ステートメントに変数値を追加して、​**Select**​ 操作の ​**\[Input parameters (入力パラメーター)\]**​ 項目を設定します。Select 操作の主な目標は、SQL クエリを提供し、パラメーターに DataWeave を使用することです。

指定するパラメーターは、JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップです。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。

入力パラメーターを使用して SQL ​`SELECT`​ ステートメントの ​`WHERE`​ 句を設定すると、クエリが SQL インジェクション攻撃の影響を受けなくなり、他の方法では不可能な最適化を実行でき、アプリケーションのパフォーマンスが向上します。

セキュリティ上の理由により、​`<db:sql>SELECT * FROM PLANET WHERE name = #[payload] </db:sql>`​ は直接記述しないでください。

操作の入力パラメーターと出力パラメーターには DataSense を使用できます。Database Connector はクエリを分析し、SQL ステートメントの射影セクションを分析することで、クエリの出力構造を自動的に計算します。同時に、​`WHERE`​ 句の条件をテーブル構造と比較して、DataSense 入力も生成します。これは、入力パラメーターを生成する DataWeave スクリプトをビルドするのに役立ちます。

次の例では、入力パラメーターをキー-値ペアとして指定します。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`SELECT * FROM PLANET WHERE name = :name`​ に設定します。
3. **\[Input Parameters (入力パラメーター)\]**​ を ​`{'name' : payload}`​ に設定します。  
    このキーでは、コロン文字 (​`:`​) を使用して、名前によりパラメーター値を参照します。

![Studio での \[Input parameters (入力パラメーター)\] 項目の設定](_images/database-select-operation-2.png)

**設定 XML**​ エディターでは、​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<flow name="DatabaseFlow">
  <db:select config-ref="dbConfig">
    <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
    <db:input-parameters>
      #[{'name' : payload}]
    </db:input-parameters>
  </db:select>
</flow>
```

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Database Connector 1.4.0 では、SQL クエリでコロンをエスケープできます。SQL クエリでコロン文字 (​<code>:</code>​) を使用する場合、コロン文字の前にバックスラッシュを置くことでコロン文字をエスケープできます。これは、PostgreSQL 種別のキャストを使用する場合に役立ちます。この場合、キャスト先の種別の前に 2 つのコロンが必要です。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT price\:\:float8 FROM PRODUCT&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Database Connector 1.8.0 以降では、ダブルコロン (::) 表現を使用して、各コロンをエスケープせず SQL キャスト PostgreSQL および Snowflake 構文を受け入れることができます。エスケープされたコロンの動作に影響することもありません。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT MAX(modified_date)::DATE FROM sales&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

## [](#select-操作の動的クエリを設定する)Select 操作の動的クエリを設定する

`WHERE`​ 句だけでなくクエリ自体の一部をパラメーター化する必要がある場合 (条件に依存するテーブルを比較するクエリや、プロジェクトテーブル列を変更する必要がある複雑なクエリなど)、動的クエリを設定できます。

次の例では、テーブルが変数に依存することを記述する文字列 ​`$(vars.table)`​ が含まれる完全な式を使用して動的クエリを設定します。一部のクエリテキストは動的 (​`"SELECT * FROM $(vars.table)`​) ですが、​`WHERE`​ 句では、入力パラメーターを使用して引き続き ​`WHERE`​ 条件を定義します (この例では ​`WHERE name = :name`​)。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT * FROM $(vars.table) WHERE name = :name`​ に設定します。
3. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{'name' : payload}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での動的クエリの設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-select-operation-3.png)

Figure 1. 動的クエリの設定

XML エディターでは、​`<db:sql>`​ 設定は次のように記述されます。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

入力パラメーターは ​`WHERE`​ 句のパラメーターにのみ適用できます。クエリの別の部分を変更するには、DataWeave 補間演算子を使用します。

設計時に式の値を使用できない場合があるため、動的クエリを使用すると、DataWeave 評価エラーがスローされたり、​**Select**​ 操作の出力メタデータ (DataSense) に影響したりすることがあります。 値をデフォルトにして、前述の不都合を回避するには、次のように default 修飾子を使用します。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table default ASTEROIDS) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

### [](#大量の結果のストリーミング)大量の結果のストリーミング

インテグレーションのユースケースなど、多くのレコードを返すクエリでストリーミングを使用します。Mule 4 では、ストリーミングは透過的であり、常に有効になっています。

たとえば、10,000 行を返すクエリを送信した場合、それらすべての行を一度にフェッチしようとすると、ネットワークから大量の取り込みを行うため、パフォーマンスが低下し、すべての情報を RAM に読み込む必要があるため、メモリ不足になるリスクがあります。

ストリーミングでは、Database Connector は一度にクエリの一部のみをフェッチおよび処理するため、ネットワークとメモリの負荷が軽減されます。これは、コネクタが 10K 行を一度にフェッチしないことを意味します。代わりに、コネクタは小さなチャンクをフェッチし、そのチャンクがコンシュームされたら残りをフェッチします。

反復可能なストリームメカニズムを使用することもできます。これにより、DataWeave や他のコンポーネントで同じストリームを何度も処理できます。また、並列処理も可能です。

## [](#select-操作の-fetch-size-フェッチサイズ-と-max-rows-最大行数-項目を設定する)Select 操作の \[Fetch Size (フェッチサイズ)\] と \[Max Rows (最大行数)\] 項目を設定する

Mule Runtime Engine (Mule) では、Database Connector でストリーミングを管理できますが、データの大きなチャンクをデータベースから Mule に移動することをお勧めできない場合もあります。ストリーミングを使用しても、単純な SQL クエリで、各行に大量の情報を含む多くの行が返される可能性はあります。結果を制限するには、​**\[Fetch size (フェッチサイズ)\]**​ 項目と ​**\[Max rows (最大行数)\]**​ 項目を設定します。

次の例では、​**Select**​ 操作でこれらの項目を設定します。この構文は、フェッチできる合計行数は 1000 (​**\[Max rows (最大行数)\]**​ 値) 以下、同時にフェッチできる行数は 200 (​**\[Fetch size (フェッチサイズ)\]**​ 値) 以下であることを Database Connector に指示します。これにより、ネットワークとメモリの負荷が大幅に軽減されます。​**\[Fetch size (フェッチサイズ)\]**​ 値は JDBC ドライバープロバイダーごとに異なって適用され、多くの場合、デフォルトで ​`10`​ に設定されます。この組み合わせにより、取得される情報の総量が制限され (​**\[Max rows (最大行数)\]**​ 値)、ネットワーク経由でデータベースから小さいチャンクのデータが返されることが保証されます (​**\[Fetch size (フェッチサイズ)\]**​ 値)。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`select * from some_table`​ に設定します。
3. **\[Advanced (詳細)\]**​ をクリックし、​**\[Fetch size (フェッチサイズ)\]**​ を ​`200`​、​**\[Max rows (最大行数)\]**​ を ​`1000`​ に設定します。

![Studio での \[Fetch size (フェッチサイズ)\] 項目と \[Max row (最大行数)\] 項目の設定](_images/database-select-operation-4.png)

**\[Configuration XML (設定 XML)\]**​ エディターで、​`fetchSize`​ および ​`maxRows`​ の設定は次のように記述されます。

```xml
<db:select fetchSize="200" maxRows="1000" config-ref="dbConfig">
  <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#select-操作の-query-timeout-クエリタイムアウト-項目を設定する)Select 操作の \[Query Timeout (クエリタイムアウト)\] 項目を設定する

多くの場合、次の要因によりクエリの実行が遅延します。

- 非効率なクエリ (多くの行を反復処理する不適切なインデックスを持つクエリなど)
- 混雑している RDBMS またはネットワーク
- ロック競合

クエリの実行時にタイムアウトしないようにするには、​**\[Query timeout (クエリタイムアウト)\]**​ 項目と ​**\[Query time unit (クエリ時間単位)\]**​ 項目を設定します。すべての Database Connector 操作でタイムアウトの設定がサポートされています。

次の例は、タイムアウトを設定する方法を示しています。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`select * from some_table`​ に設定します。
3. **\[Advanced (詳細)\]**​ タブで、JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を ​**\[Query timeout (クエリタイムアウト)\]**​ に設定します。例: `0`​。
4. **\[Query timeout (クエリタイムアウト)\]**​ に使用できる時間単位を ​**\[Query timeout unit (クエリタイムアウト単位)\]**​ に設定します。例: `SECONDS`​。

![Studio での \[Query timeout (クエリタイムアウト)\] 項目の設定](_images/database-select-operation-5.png)

**\[Configuration XML (設定 XML)\]**​ エディターで、​`queryTimeout`​ および ​`SECONDS`​ の設定は次のように記述されます。

```xml
<db:select queryTimeout="0" queryTimeoutUnit="SECONDS" config-ref="dbConfig">
   <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=5a41f8b94f1a9f99ab20df7cfb7d7bed7faac026eb3e070e89ce271951c25ef9 url=/mulesoft/current/ja-jp/db-connector/1.9/database-connector-select.md -->

# データベースの照会の例

データベース用 Anypoint Connector (Database Connector) の ​**Select**​ 操作では、データベースのデータを選択できます。次の例は、Studio で ​**\[Input Parameters (入力パラメーター)\]**​、​**\[Fetch size (フェッチサイズ)\]**​、​**\[Max rows (最大行数)\]**​、​**\[Query timeout (クエリタイムアウト)\]**​ 項目を設定して操作を設定するときに役立ちます。また、動的クエリを設定する方法についても記載されています。

## [](#studio-で-select-操作を設定する)Studio で Select 操作を設定する

Studio で ​**Select**​ 操作を追加および設定する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`database`​」を検索し、​**\[Select\]**​ 操作を選択します。
2. **\[Select\]**​ 操作を Studio キャンバスにドラッグします。
3. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
4. データベース接続情報を指定し、​**\[OK\]**​ をクリックします。
5. 実行する SQL クエリを ​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に設定します (例: `SELECT * FROM PLANET WHERE name = :name`​)。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での Select 操作の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-select-operation-1.png)

Figure 1. Select 操作の設定

XML エディターでは、​`<db:select>`​ 設定は次のように記述されます。

```xml
<db:select config-ref="dbConfig">
  <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
</db:select>
```

## [](#select-操作の-input-parameters-入力パラメーター-項目を設定する)Select 操作の \[Input Parameters (入力パラメーター)\] 項目を設定する

データベースクエリを保護するには、データベースで実行する SQL ステートメントに変数値を追加して、​**Select**​ 操作の ​**\[Input parameters (入力パラメーター)\]**​ 項目を設定します。Select 操作の主な目標は、SQL クエリを提供し、パラメーターに DataWeave を使用することです。

指定するパラメーターは、JDBC プリペアードステートメントに設定する入力パラメーターの名前をキーとするマップです。SQL テキスト内でコロンプレフィックスを使用して各パラメーターを参照します (例: `where id = :myParamName`​)。マップの値には、各パラメーターの実際の割り当てが含まれます。

入力パラメーターを使用して SQL ​`SELECT`​ ステートメントの ​`WHERE`​ 句を設定すると、クエリが SQL インジェクション攻撃の影響を受けなくなり、他の方法では不可能な最適化を実行でき、アプリケーションのパフォーマンスが向上します。

セキュリティ上の理由により、​`<db:sql>SELECT * FROM PLANET WHERE name = #[payload] </db:sql>`​ は直接記述しないでください。

操作の入力パラメーターと出力パラメーターには DataSense を使用できます。Database Connector はクエリを分析し、SQL ステートメントの射影セクションを分析することで、クエリの出力構造を自動的に計算します。同時に、​`WHERE`​ 句の条件をテーブル構造と比較して、DataSense 入力も生成します。これは、入力パラメーターを生成する DataWeave スクリプトをビルドするのに役立ちます。

次の例では、入力パラメーターをキー-値ペアとして指定します。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT * FROM PLANET WHERE name = :name`​ に設定します。
3. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{'name' : payload}`​ に設定します。  
    このキーでは、コロン文字 (​`:`​) を使用して、名前によりパラメーター値を参照します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Input parameters (入力パラメーター)\] 項目の設定](_images/database-select-operation-2.png)

Figure 2. \[Input Parameters (入力パラメーター)\] の設定

XML エディターでは、​`<db:input-parameters>`​ 設定は次のように記述されます。

```xml
<flow name="DatabaseFlow">
  <db:select config-ref="dbConfig">
    <db:sql>SELECT * FROM PLANET WHERE name = :name</db:sql>
    <db:input-parameters>
      #[{'name' : payload}]
    </db:input-parameters>
  </db:select>
</flow>
```

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Database Connector 1.4.0 では、SQL クエリでコロンをエスケープできます。SQL クエリでコロン文字 (​<code>:</code>​) を使用する場合、コロン文字の前にバックスラッシュを置くことでコロン文字をエスケープできます。これは、PostgreSQL 種別のキャストを使用する場合に役立ちます。この場合、キャスト先の種別の前に 2 つのコロンが必要です。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT price\:\:float8 FROM PRODUCT&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Database Connector 1.8.0 以降では、ダブルコロン (::) 表現を使用して、各コロンをエスケープせず SQL キャスト PostgreSQL および Snowflake 構文を受け入れることができます。エスケープされたコロンの動作に影響することもありません。例:</p>
</div>
<div class="paragraph">
<p><code>&lt;db:sql&gt;SELECT MAX(modified_date)::DATE FROM sales&lt;/db:sql&gt;</code></p>
</div>
</td>
</tr>
</tbody></table>

## [](#select-操作の動的クエリを設定する)Select 操作の動的クエリを設定する

`WHERE`​ 句だけでなくクエリ自体の一部をパラメーター化する必要がある場合 (条件に依存するテーブルを比較するクエリや、プロジェクトテーブル列を変更する必要がある複雑なクエリなど)、動的クエリを設定できます。

次の例では、テーブルが変数に依存することを記述する文字列 ​`$(vars.table)`​ が含まれる完全な式を使用して動的クエリを設定します。一部のクエリテキストは動的 (​`"SELECT * FROM $(vars.table)`​) ですが、​`WHERE`​ 句では、入力パラメーターを使用して引き続き ​`WHERE`​ 条件を定義します (この例では ​`WHERE name = :name`​)。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`SELECT * FROM $(vars.table) WHERE name = :name`​ に設定します。
3. **\[Input Parameters (入力パラメーター)\]**​ 項目を ​`{'name' : payload}`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での動的クエリの設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-select-operation-3.png)

Figure 3. 動的クエリの設定

XML エディターでは、​`<db:sql>`​ 設定は次のように記述されます。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

入力パラメーターは ​`WHERE`​ 句のパラメーターにのみ適用できます。クエリの別の部分を変更するには、DataWeave 補間演算子を使用します。

設計時に式の値を使用できない場合があるため、動的クエリを使用すると、DataWeave 評価エラーがスローされたり、​**Select**​ 操作の出力メタデータ (DataSense) に影響したりすることがあります。 値をデフォルトにして、前述の不都合を回避するには、次のように default 修飾子を使用します。

```xml
<set-variable variableName="table" value="PLANET"/>
<db:select config-ref="dbConfig">
    <db:sql>#["SELECT * FROM $(vars.table default ASTEROIDS) WHERE name = :name"]</db:sql>
    <db:input-parameters>
        #[{'name' : payload}]
    </db:input-parameters>
</db:select>
```

### [](#大量の結果のストリーミング)大量の結果のストリーミング

インテグレーションのユースケースなど、多くのレコードを返すクエリでストリーミングを使用します。Mule 4 では、ストリーミングは透過的であり、常に有効になっています。

たとえば、10,000 行を返すクエリを送信した場合、それらすべての行を一度にフェッチしようとすると、ネットワークから大量の取り込みを行うため、パフォーマンスが低下し、すべての情報を RAM に読み込む必要があるため、メモリ不足になるリスクがあります。

ストリーミングでは、Database Connector は一度にクエリの一部のみをフェッチおよび処理するため、ネットワークとメモリの負荷が軽減されます。 これは、コネクタが 10K 行を一度にフェッチしないことを意味します。代わりに、コネクタは小さなチャンクをフェッチし、そのチャンクがコンシュームされたら残りをフェッチします。

反復可能なストリームメカニズムを使用することもできます。これにより、DataWeave や他のコンポーネントで同じストリームを何度も処理できます。また、並列処理も可能です。

## [](#select-操作の-fetch-size-フェッチサイズ-と-max-rows-最大行数-項目を設定する)Select 操作の \[Fetch Size (フェッチサイズ)\] と \[Max Rows (最大行数)\] 項目を設定する

Mule Runtime Engine (Mule) では、Database Connector でストリーミングを管理できますが、データの大きなチャンクをデータベースから Mule に移動することをお勧めできない場合もあります。ストリーミングを使用しても、単純な SQL クエリで、各行に大量の情報を含む多くの行が返される可能性はあります。結果を制限するには、​**\[Fetch size (フェッチサイズ)\]**​ 項目と ​**\[Max rows (最大行数)\]**​ 項目を設定します。

次の例では、​**Select**​ 操作でこれらの項目を設定します。この構文は、フェッチできる合計行数は 1000 (​**\[Max rows (最大行数)\]**​ 値) 以下、同時にフェッチできる行数は 200 (​**\[Fetch size (フェッチサイズ)\]**​ 値) 以下であることを Database Connector に指示します。これにより、ネットワークとメモリの負荷が大幅に軽減されます。​**\[Fetch size (フェッチサイズ)\]**​ 値は JDBC ドライバープロバイダーごとに異なって適用され、多くの場合、デフォルトで ​`10`​ に設定されます。 この組み合わせにより、取得される情報の総量が制限され (​**\[Max rows (最大行数)\]**​ 値)、ネットワーク経由でデータベースから小さいチャンクのデータが返されることが保証されます (​**\[Fetch size (フェッチサイズ)\]**​ 値)。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`select * from some_table`​ に設定します。
3. **\[Advanced (詳細)\]**​ タブをクリックし、​**\[Fetch size (フェッチサイズ)\]**​ 項目を ​`200`​、​**\[Max rows (最大行数)\]**​ 項目を ​`1000`​ に設定します。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Fetch size (フェッチサイズ)\] 項目と \[Max row (最大行数)\] 項目の設定](_images/database-select-operation-4.png)

Figure 4. \[Fetch size (フェッチサイズ)\] 項目と \[Max row (最大行数)\] 項目の設定

XML エディターでは、​`fetchSize`​ および ​`maxRows`​ 設定は次のように記述されます。

```xml
<db:select fetchSize="200" maxRows="1000" config-ref="dbConfig">
  <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#select-操作の-query-timeout-クエリタイムアウト-項目を設定する)Select 操作の \[Query Timeout (クエリタイムアウト)\] 項目を設定する

多くの場合、次の要因によりクエリの実行が遅延します。

- 非効率なクエリ (多くの行を反復処理する不適切なインデックスを持つクエリなど)
- 混雑している RDBMS またはネットワーク
- ロック競合

クエリの実行時にタイムアウトしないようにするには、​**\[Query timeout (クエリタイムアウト)\]**​ 項目と ​**\[Query time unit (クエリ時間単位)\]**​ 項目を設定します。すべての Database Connector 操作でタイムアウトの設定がサポートされています。

次の例は、タイムアウトを設定する方法を示しています。

1. Studio のフローで、​**\[Select\]**​ 操作を選択します。
2. 操作設定画面で、​**\[SQL Query Text (SQL クエリテキスト)\]**​ 項目を ​`select * from some_table`​ に設定します。
3. **\[Advanced (詳細)\]**​ タブで、JDBC ドライバーが実行中のステートメントをキャンセルしようとするまでの最短時間を ​**\[Query timeout (クエリタイムアウト)\]**​ 項目に設定します。例: `0`​。
4. **\[Query timeout (クエリタイムアウト)\]**​ に使用できる時間単位を ​**\[Query timeout unit (クエリタイムアウト単位)\]**​ 項目に設定します。例: `SECONDS`​。

次のスクリーンショットは、Studio の設定を示しています。

![Studio での \[Query timeout (クエリタイムアウト)\] 項目の設定](_images/database-select-operation-5.png)

Figure 5. \[Query timeout (クエリタイムアウト)\] の設定

XML エディターでは、​`queryTimeout`​ および ​`SECONDS`​ 設定は次のように記述されます。

```xml
<db:select queryTimeout="0" queryTimeoutUnit="SECONDS" config-ref="dbConfig">
   <db:sql>select * from some_table</db:sql>
</db:select>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=38ed2c49d22a70b35d9d75cfd9359bf8b2f044638484a0854edf7d5b11836d2e url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-connection.md -->

# データベース接続の設定

データベース用 Anypoint Connector (Database Connector) は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。次の例は、最も一般的なデータベース (Derby、Microsoft SQL Server、MySQL、Oracle、汎用データベースなど) に接続する方法を示しています。また、高度なユースケースとして、Anypoint Studio と XML エディターの両方で、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行う方法も示しています。

## [](#データソース参照接続の設定)データソース参照接続の設定

Database Connector では、​**\[Generic Connection (汎用接続)\]**​ 項目の設定時に指定したパラメーター値を使用して、JDBC データソースを生成します。独自のデータソースを作成し、そのデータソースを使用してデータベースに接続する場合は、​**\[Data Source Reference Connection (データソース参照接続)\]**​ 項目を設定します。

次の例は、Anypoint Studio を使用して Derby データベースへのデータソース参照接続を設定する方法を示しています。

1. Studio の ​`src/main/resources`​ フォルダーで、Derby データベースに接続するカスタム ​`enhydra`​ データソースを定義する ​`datasource-config.xml`​ bean ファイルを作成します。
    
    datasource-config.xml ファイル
    
    ```xml
    <bean id="jdbcDataSource" class="org.enhydra.jdbc.standard.StandardDataSource"
     destroy-method="shutdown">
       <property name="driverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
       <property name="url" value="jdbc:derby:muleEmbeddedDB;create=true"/>
    </bean>
    ```
2. Mule フローに戻り、​**\[Global Elements (グローバル要素)\]**​ ビューに移動して、​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`spring`​」と入力し、​**\[Spring Config (Spring 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Spring Config (Spring 設定)\]**​ ウィンドウの ​**\[Files (ファイル)\]**​ 項目で、Spring Module を使用して Spring 設定ファイルを参照する ​`datasource-config.xml`​ を追加します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットはこの設定を示しています。

![Spring 設定データソース](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-spring-configuration.png)

Figure 1. Spring 設定データソース

1. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
2. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Data Source Reference Connection (データソース参照接続)\]**​ を選択します。
4. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
5. **\[Data source ref (データソース参照)\]**​ で、​`datasource-config.xml`​ bean ファイルに作成された bean ID ​`jdbcDataSource`​ を追加します。
6. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
7. **\[OK\]**​ をクリックします。

次のスクリーンショットはこの設定を示しています。

![データソース参照接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-datasource-connection.png)

Figure 2. データソース参照接続

XML エディターでは、Spring 設定とデータベース設定は次のように記述されます。

```xml
<spring:config name="datasource" files="datasource-config.xml" />

<db:config name="Database_Config">
   <db:data-source-connection dataSourceRef="jdbcDataSource" />
</db:config>
```

## [](#xa-トランザクションモードでのデータソース参照接続)XA トランザクションモードでのデータソース参照接続

Mule アプリケーションで XA トランザクションにバインドされている操作が必要であり、使用しているデータベース設定で接続プーリングが有効である場合は、データソース参照接続のデフォルト接続プール実装は Enhydra XAPool になります。

Enhydra XAPool は、プリペアードステートメントをサポートしません。これらの操作を実行するには、Bitronix 接続プールを使用してください。詳細は、​[『Bitronix トランザクションマネージャーの設定』](https://docs.mulesoft.com/mule-runtime/latest/using-bitronix-to-manage-transactions#configuring-the-bitronix-transaction-manager)​ドキュメントを参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">XA トランザクションを使用するには、アプリケーションの JDBC データソース Spring Bean 設定ファイルで ​<code>XADataSource</code>​ オブジェクトを指定する必要があります。</td></tr></tbody></table>

XA トランザクションモードで Derby データベースの​**データソース参照接続**​を設定する例を示します。

1. Studio で、​`src/main/resources`​ フォルダーに ​`datasource-config.xml`​ Spring Bean ファイルを作成します。
2. `org.enhydra.jdbc.standard.Standard`​ クラスの最後に ​`XADataSource`​ オブジェクトを追加します (例: `class="org.enhydra.jdbc.standard.StandardXaDataSource`​)。
    
    datasource-config.xml ファイル
    
    ```xml
    <?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="
                   http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd">
    
        <bean id="jdbcDataSource" class="org.enhydra.jdbc.standard.StandardXaDataSource" destroy-method="shutdown">
            <property name="driverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
            <property name="url" value="jdbc:derby:muleEmbeddedDB;create=true"/>
        </bean>
    
    </beans>
    ```
3. Mule フローに戻り、​**\[Global Elements (グローバル要素)\]**​ > ​**\[Create (作成)\]**​ を選択して ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
4. **\[Filter (検索条件)\]**​ に「​`spring`​」と入力し、​**\[Spring Config (Spring 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
5. **\[Spring Config (Spring 設定)\]**​ の ​**\[Files (ファイル)\]**​ で、Spring Module を使用して Spring 設定ファイルを参照する ​`datasource-config.xml`​ を追加します。
6. **\[OK\]**​ をクリックします。

![「Files (ファイル)」 項目で datasource-config.xml が設定された 「Spring Config (Spring 設定)」 ウィンドウ](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-spring-configuration.png)

1. **\[Global Elements (グローバル要素)\]**​ で ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
2. **\[Filter (検索条件)\]**​ に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
3. **\[Database Config (データベース設定)\]**​ > ​**\[Connection (接続)\]**​ で ​**\[Data Source Reference Connection (データソース参照接続)\]**​ を選択します。
4. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
5. **\[Data source ref (データソース参照)\]**​ で、​`datasource-config.xml`​ bean ファイルに作成された bean ID ​`jdbcDataSource`​ を追加します。
6. **\[Advanced (詳細)\]**​ タブで、​**\[Pooling profile (プーリングプロファイル)\]**​、​**\[Column types (列の型)\]**​、​**\[Reconnection (再接続)\]**​ の各項目を設定します。
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
8. **\[OK\]**​ をクリックします。

XML エディターでは、Spring 設定とデータベース設定は次のように記述されます。

```xml
<spring:config name="spring-beans" files="datasource-spring-beans.xml"/>

<db:config name="db-datasource">
    <db:data-source-connection dataSourceRef="jdbcDataSource">
        <reconnection failsDeployment="true">
            <reconnect frequency="4000" count="4"/>
        </reconnection>
        <db:column-types>
            <db:column-type id="124"
                            typeName="column_type"
                            className="class_name"/>
        </db:column-types>
        <db:pooling-profile maxPoolSize="6" minPoolSize="1"
                            acquireIncrement="2"
                            maxWait="1" maxWaitUnit="MINUTES"/>
    </db:data-source-connection>
</db:config>
```

## [](#derby-接続の設定)Derby 接続の設定

Derby データベースに接続する場合は、​**\[Derby Connection (Derby 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Derby Connection (Derby 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Derby JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Database (データベース)\]**​ を ​`derbyDB`​、​**\[Subsub protocol (Subsub プロトコル)\]**​ を ​`directory`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Derby 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-derby-connection.png)

Figure 3. Derby 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config" >
		<db:derby-connection database="derbyDB" />
	</db:config>
```

## [](#汎用接続の設定)汎用接続の設定

次のデータベースに接続する場合は、​**\[Generic Connection (汎用接続)\]**​ 項目種別を使用します。

- MuleSoft で特定の接続種別が提供されていないデータベース
- サポートされるデータベースであるが、使用するカスタムオプションが接続種別に含まれない

次の例は、Anypoint Studio で H2 データベースに接続する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[URL\]**​ を ​`jdbc:h2:file:/tmp/datasenseDBand`​、​**\[Driver class name (ドライバークラス名)\]**​ を ​`org.h2.Driver`​ に設定します。
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
8. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![汎用接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-generic-connection.png)

Figure 4. 汎用接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="org.h2.Driver"
    url="jdbc:h2:file:/tmp/datasenseDB"/>
</db:config>
```

## [](#microsoft-sql-server-接続の設定)Microsoft SQL Server 接続の設定

Microsoft SQL Server データベースに接続する場合は、​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Microsoft SQL Server ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`553`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database name (データベース名)\]**​ を ​`microsoftDB`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Microsoft SQL Server 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-mssql-connection.png)

Figure 5. Microsoft SQL Server 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:mssql-connection
    host="0.0.0.0"
    port="553"
    user="Max"
    password="password"
    databaseName="microsoftDB" />
</db:config>
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

MySQL データベースに接続する場合は、​**\[MySQL Connection (MySQL 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`3306`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database (データベース)\]**​ を ​`someSchema`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![MySQL 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-mysql-connection.png)

Figure 6. MySQL 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:my-sql-connection
  host="0.0.0.0"
  port="3306"
  user="Max"
  password="POWERS"
  database="mysqlDB"/>
</db:config>
```

## [](#oracle-接続の設定)Oracle 接続の設定

Oracle データベースに接続する場合は、​**\[Oracle Connection (Oracle 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`192.168.99.100`​、​**\[Port (ポート)\]**​ を ​`1521`​、​**\[User (ユーザー)\]**​ を ​`system`​、​**\[Password (パスワード)\]**​ を ​`oracle`​、​**\[Instance (インスタンス)\]**​ を ​`xe`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Oracle 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-oracle-connection.png)

Figure 7. Oracle 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:oracle-connection
  host="192.168.99.100"
  port="1521" instance="xe"
  user="system"
  password="oracle" />
</db:config>
```

## [](#jdbc-ドライバーの設定)JDBC ドライバーの設定

接続を設定したら、JDBC ドライバーを追加できます。次の例は、MySQL データベースのドライバーを追加する方法を示しています。

1. Studio で、次のいずれかのオプションを使用してドライバーを追加できます。
    
    - **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Configure (設定)\]**​ をクリックし、​**\[Add Maven dependency (Maven 連動関係を追加)\]**​ を選択して、連動関係を選択します。
        
        ![Maven 連動関係の選択](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-dependency.png)
        
        Figure 8. Maven 連動関係の選択
    - 連動関係をプロジェクトの ​`pom.xml`​ ファイルに直接追加します。
        
        ```xml
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.48</version>
        </dependency>
        ```
2. Mule でドライバーの連動関係を Database Connector に公開するように ​`pom.xml`​ ファイルを設定します。
    
    ```xml
    <build>
        <plugins>
            <!-- Only used to declare the shared libraries-->
            <plugin>
                <groupId>org.mule.tools.maven</groupId>
                <artifactId>mule-maven-plugin</artifactId>
                <version>1.0.0</version>
                <configuration>
                    <sharedLibraries>
                        <sharedLibrary>
                            <groupId>mysql</groupId>
                            <artifactId>mysql-connector-java</artifactId>
                        </sharedLibrary>
                    </sharedLibraries>
                </configuration>
            </plugin>
        </plugins>
    </build>
    ```

## [](#接続プールの設定)接続プールの設定

接続の確立には、コネクタ、リレーショナルデータベース管理システム (RDBMS) ネットワーク、および処理オーバーヘッドの点でコストがかかります。Database Connector ではプーリングプロファイルを使用して接続プールをビルドできます。これは、コネクタで必要な操作を実行するために使用できる確立済みの接続のグループです。これを使用すると、コネクタで新しい接続を毎回確立する必要はありません。

アプリケーションのグローバル要素で ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目を設定する場合は、​**\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ 項目をオフにして接続プーリングでのコネクタのパフォーマンスを向上します。この項目をデフォルト (​`TRUE`​) として選択したままにしていると、接続がプールからチェックアウトされるたびに、接続プールでデータベースに対する接続確認が実行されるため、各操作の完了までにかかる時間が増加します。

**\[Data Source Reference Connection (データソース参照接続)\]**​ 以外のすべての接続種別設定で ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目設定が受け入れられます。JDBC では、プーリングはデータソースレベルで実行されるため、プーリングを有効にするには、グローバルデータソースを設定する必要があります。

次の例は、​**\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ 項目を ​`FALSE`​ に設定して Oracle データベース接続用のプーリングプロファイルを設定する方法を示しています。

1. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Advanced (詳細)\]**​ タブの ​**\[Pooling profile (プーリングプロファイル)\]**​ で ​**\[Edit inline (インライン編集)\]**​ を選択します。
2. 次の項目を設定します。
    
    - **Max pool size (最大プールサイズ)**​: `30`
    - **Min pool size (最小プールサイズ)**​: `4`
    - **Acquire Increment (取得増分)**​: `1`
    - **Prepared statement cache size (プリペアードステートメントのキャッシュサイズ)**​ ​`5`
    - **Max wait (最大待機)**​: `0`
    - **Max wait unit (最大待機単位)**​: `SECONDS (Default)`
    - **Max idle time (最大アイドル時間)**​ ​`0`
    - **Max statements (最大ステートメント)**​ ​`0`

1. **\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ をオフにします。  
    これにより、この項目は ​`FALSE`​ として設定されます。
2. **\[Column types (列の型)\]**​ で、​**\[Edit inline (インライン編集)\]**​ を選択します。
3. (​**+**​) プラス記号をクリックして、列の型を追加します。
4. **\[Column Type (列の型)\]**​ ウィンドウで ​**\[Id\]**​ を ​`2003`​、​**\[Type name (型名)\]**​ を ​`1000`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。
5. ステップ 5 を繰り返します。
6. 新しい列型を追加するには、​**\[Id\]**​ を ​`2002`​、​**\[Type name (型名)\]**​ を ​`PHONE_NUMBER_ARRAY`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Pooling Profile (プーリングプロファイル)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-pooling-configuration.png)

Figure 9. プーリングプロファイルの設定

XML エディターでは、​`<db:pooling-profile>`​ および ​`testConnectionOnCheckout="false`​ の設定は次のように記述されます。

```xml
<db:config name="dbConfig">
		<db:oracle-connection host="localhost" user="myuser" password="mypass" serviceName="orclpdb1">
			<db:pooling-profile minPoolSize="4" maxPoolSize="30" testConnectionOnCheckout="false" acquireIncrement="1" maxWait="0" maxWaitUnit="SECONDS" preparedStatementCacheSize="5"/>
			<db:column-types>
				<db:column-type id="2003" typeName="PHONE_NUMBER" />
				<db:column-type id="2002" typeName="PHONE_NUMBER_ARRAY" />
			</db:column-types>
		</db:oracle-connection>
	</db:config>
```

## [](#tns-名を使用した-oracle-接続の設定)TNS 名を使用した Oracle 接続の設定

次の例は、​`tnsnames.ora`​ ファイルを使用する Oracle データベースに接続する ​**\[Generic Connection (汎用接続)\]**​ 項目を設定する方法を示しています。 ファイアウォールで Mule Runtime Engine をデータベースから分離している場合、TNS 接続で ​`ENABLE=BROKEN`​ パラメーターを使用してキープアライブ接続を有効にします。 キープアライブ接続を設定しない場合、非アクティブタイマーの期限切れにより接続のトラフィックがドロップする可能性があります。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. 接続の ​**\[URL\]**​ を ​`jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port})))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))`​ に設定します。
7. **\[Driver class name (ドライバークラス名)\]**​ を ​`oracle.jdbc.driver.OracleDriver`​ に設定します。
8. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
9. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![TNS 設定を使用した Oracle データベース](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-oracle-tns.png)

Figure 10. TNS 設定を使用した Oracle

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="oracle.jdbc.driver.OracleDriver"
    url="jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port}))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))` and *Driver class name* to `oracle.jdbc.driver.OracleDriver"/>
</db:config>
```

## [](#関連情報)関連情報

- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.10/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=1f895dfdf4a09a3e60cc4fa8daee674229d6c3be54df55df80e35e3e69a4c368 url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-connection.md -->

# データベース接続の設定

データベース用 Anypoint Connector (Database Connector) は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。次の例は、最も一般的なデータベース (Derby、Microsoft SQL Server、MySQL、Oracle、汎用データベースなど) に接続する方法を示しています。また、高度なユースケースとして、Anypoint Studio と XML エディターの両方で、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行う方法も示しています。

## [](#データソース参照接続の設定)データソース参照接続の設定

Database Connector では、​**\[Generic Connection (汎用接続)\]**​ 項目の設定時に指定したパラメーター値を使用して、JDBC データソースを生成します。独自のデータソースを作成し、そのデータソースを使用してデータベースに接続する場合は、​**\[Data Source Reference Connection (データソース参照接続)\]**​ 項目を設定します。

次の例は、Anypoint Studio を使用して Derby データベースへのデータソース参照接続を設定する方法を示しています。

1. Studio の ​`src/main/resources`​ フォルダーで、Derby データベースに接続するカスタム ​`enhydra`​ データソースを定義する ​`datasource-config.xml`​ bean ファイルを作成します。
    
    datasource-config.xml ファイル
    
    ```xml
    <bean id="jdbcDataSource" class="org.enhydra.jdbc.standard.StandardDataSource"
     destroy-method="shutdown">
       <property name="driverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
       <property name="url" value="jdbc:derby:muleEmbeddedDB;create=true"/>
    </bean>
    ```
2. Mule フローに戻り、​**\[Global Elements (グローバル要素)\]**​ ビューに移動して、​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`spring`​」と入力し、​**\[Spring Config (Spring 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Spring Config (Spring 設定)\]**​ ウィンドウの ​**\[Files (ファイル)\]**​ 項目で、Spring Module を使用して Spring 設定ファイルを参照する ​`datasource-config.xml`​ を追加します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットはこの設定を示しています。

![Spring 設定データソース](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-spring-configuration.png)

Figure 1. Spring 設定データソース

1. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
2. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Data Source Reference Connection (データソース参照接続)\]**​ を選択します。
4. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
5. **\[Data source ref (データソース参照)\]**​ で、​`datasource-config.xml`​ bean ファイルに作成された bean ID ​`jdbcDataSource`​ を追加します。
6. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
7. **\[OK\]**​ をクリックします。

次のスクリーンショットはこの設定を示しています。

![データソース参照接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-datasource-connection.png)

Figure 2. データソース参照接続

XML エディターでは、Spring 設定とデータベース設定は次のように記述されます。

```xml
<spring:config name="datasource" files="datasource-config.xml" />

<db:config name="Database_Config">
   <db:data-source-connection dataSourceRef="jdbcDataSource" />
</db:config>
```

## [](#xa-トランザクションモードでのデータソース参照接続)XA トランザクションモードでのデータソース参照接続

Mule アプリケーションで XA トランザクションにバインドされている操作が必要であり、使用しているデータベース設定で接続プーリングが有効である場合は、データソース参照接続のデフォルト接続プール実装は Enhydra XAPool になります。

Enhydra XAPool は、プリペアードステートメントをサポートしません。これらの操作を実行するには、Bitronix 接続プールを使用してください。詳細は、​[『Bitronix トランザクションマネージャーの設定』](https://docs.mulesoft.com/mule-runtime/latest/using-bitronix-to-manage-transactions#configuring-the-bitronix-transaction-manager)​ドキュメントを参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">XA トランザクションを使用するには、アプリケーションの JDBC データソース Spring Bean 設定ファイルで ​<code>XADataSource</code>​ オブジェクトを指定する必要があります。</td></tr></tbody></table>

XA トランザクションモードで Derby データベースの​**データソース参照接続**​を設定する例を示します。

1. Studio で、​`src/main/resources`​ フォルダーに ​`datasource-config.xml`​ Spring Bean ファイルを作成します。
2. `org.enhydra.jdbc.standard.Standard`​ クラスの最後に ​`XADataSource`​ オブジェクトを追加します (例: `class="org.enhydra.jdbc.standard.StandardXaDataSource`​)。
    
    datasource-config.xml ファイル
    
    ```xml
    <?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="
                   http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd">
    
        <bean id="jdbcDataSource" class="org.enhydra.jdbc.standard.StandardXaDataSource" destroy-method="shutdown">
            <property name="driverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
            <property name="url" value="jdbc:derby:muleEmbeddedDB;create=true"/>
        </bean>
    
    </beans>
    ```
3. Mule フローに戻り、​**\[Global Elements (グローバル要素)\]**​ > ​**\[Create (作成)\]**​ を選択して ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
4. **\[Filter (検索条件)\]**​ に「​`spring`​」と入力し、​**\[Spring Config (Spring 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
5. **\[Spring Config (Spring 設定)\]**​ の ​**\[Files (ファイル)\]**​ で、Spring Module を使用して Spring 設定ファイルを参照する ​`datasource-config.xml`​ を追加します。
6. **\[OK\]**​ をクリックします。

![「Files (ファイル)」 項目で datasource-config.xml が設定された 「Spring Config (Spring 設定)」 ウィンドウ](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-spring-configuration.png)

1. **\[Global Elements (グローバル要素)\]**​ で ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
2. **\[Filter (検索条件)\]**​ に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
3. **\[Database Config (データベース設定)\]**​ > ​**\[Connection (接続)\]**​ で ​**\[Data Source Reference Connection (データソース参照接続)\]**​ を選択します。
4. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
5. **\[Data source ref (データソース参照)\]**​ で、​`datasource-config.xml`​ bean ファイルに作成された bean ID ​`jdbcDataSource`​ を追加します。
6. **\[Advanced (詳細)\]**​ タブで、​**\[Pooling profile (プーリングプロファイル)\]**​、​**\[Column types (列の型)\]**​、​**\[Reconnection (再接続)\]**​ の各項目を設定します。
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
8. **\[OK\]**​ をクリックします。

XML エディターでは、Spring 設定とデータベース設定は次のように記述されます。

```xml
<spring:config name="spring-beans" files="datasource-spring-beans.xml"/>

<db:config name="db-datasource">
    <db:data-source-connection dataSourceRef="jdbcDataSource">
        <reconnection failsDeployment="true">
            <reconnect frequency="4000" count="4"/>
        </reconnection>
        <db:column-types>
            <db:column-type id="124"
                            typeName="column_type"
                            className="class_name"/>
        </db:column-types>
        <db:pooling-profile maxPoolSize="6" minPoolSize="1"
                            acquireIncrement="2"
                            maxWait="1" maxWaitUnit="MINUTES"/>
    </db:data-source-connection>
</db:config>
```

## [](#derby-接続の設定)Derby 接続の設定

Derby データベースに接続する場合は、​**\[Derby Connection (Derby 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Derby Connection (Derby 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Derby JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Database (データベース)\]**​ を ​`derbyDB`​、​**\[Subsub protocol (Subsub プロトコル)\]**​ を ​`directory`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Derby 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-derby-connection.png)

Figure 3. Derby 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config" >
		<db:derby-connection database="derbyDB" />
	</db:config>
```

## [](#汎用接続の設定)汎用接続の設定

次のデータベースに接続する場合は、​**\[Generic Connection (汎用接続)\]**​ 項目種別を使用します。

- MuleSoft で特定の接続種別が提供されていないデータベース
- サポートされるデータベースであるが、使用するカスタムオプションが接続種別に含まれない

次の例は、Anypoint Studio で H2 データベースに接続する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[URL\]**​ を ​`jdbc:h2:file:/tmp/datasenseDBand`​、​**\[Driver class name (ドライバークラス名)\]**​ を ​`org.h2.Driver`​ に設定します。
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
8. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![汎用接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-generic-connection.png)

Figure 4. 汎用接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="org.h2.Driver"
    url="jdbc:h2:file:/tmp/datasenseDB"/>
</db:config>
```

## [](#microsoft-sql-server-接続の設定)Microsoft SQL Server 接続の設定

Microsoft SQL Server データベースに接続する場合は、​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Microsoft SQL Server ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`553`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database name (データベース名)\]**​ を ​`microsoftDB`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Microsoft SQL Server 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-mssql-connection.png)

Figure 5. Microsoft SQL Server 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:mssql-connection
    host="0.0.0.0"
    port="553"
    user="Max"
    password="password"
    databaseName="microsoftDB" />
</db:config>
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

MySQL データベースに接続する場合は、​**\[MySQL Connection (MySQL 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`3306`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database (データベース)\]**​ を ​`someSchema`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![MySQL 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-mysql-connection.png)

Figure 6. MySQL 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:my-sql-connection
  host="0.0.0.0"
  port="3306"
  user="Max"
  password="POWERS"
  database="mysqlDB"/>
</db:config>
```

## [](#oracle-接続の設定)Oracle 接続の設定

Oracle データベースに接続する場合は、​**\[Oracle Connection (Oracle 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`192.168.99.100`​、​**\[Port (ポート)\]**​ を ​`1521`​、​**\[User (ユーザー)\]**​ を ​`system`​、​**\[Password (パスワード)\]**​ を ​`oracle`​、​**\[Instance (インスタンス)\]**​ を ​`xe`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Oracle 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-oracle-connection.png)

Figure 7. Oracle 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:oracle-connection
  host="192.168.99.100"
  port="1521" instance="xe"
  user="system"
  password="oracle" />
</db:config>
```

## [](#jdbc-ドライバーの設定)JDBC ドライバーの設定

接続を設定したら、JDBC ドライバーを追加できます。次の例は、MySQL データベースのドライバーを追加する方法を示しています。

1. Studio で、次のいずれかのオプションを使用してドライバーを追加できます。
    
    - **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Configure (設定)\]**​ をクリックし、​**\[Add Maven dependency (Maven 連動関係を追加)\]**​ を選択して、連動関係を選択します。
        
        ![Maven 連動関係の選択](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-dependency.png)
        
        Figure 8. Maven 連動関係の選択
    - 連動関係をプロジェクトの ​`pom.xml`​ ファイルに直接追加します。
        
        ```xml
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.48</version>
        </dependency>
        ```
2. Mule でドライバーの連動関係を Database Connector に公開するように ​`pom.xml`​ ファイルを設定します。
    
    ```xml
    <build>
        <plugins>
            <!-- Only used to declare the shared libraries-->
            <plugin>
                <groupId>org.mule.tools.maven</groupId>
                <artifactId>mule-maven-plugin</artifactId>
                <version>1.0.0</version>
                <configuration>
                    <sharedLibraries>
                        <sharedLibrary>
                            <groupId>mysql</groupId>
                            <artifactId>mysql-connector-java</artifactId>
                        </sharedLibrary>
                    </sharedLibraries>
                </configuration>
            </plugin>
        </plugins>
    </build>
    ```

## [](#接続プールの設定)接続プールの設定

接続の確立には、コネクタ、リレーショナルデータベース管理システム (RDBMS) ネットワーク、および処理オーバーヘッドの点でコストがかかります。Database Connector ではプーリングプロファイルを使用して接続プールをビルドできます。これは、コネクタで必要な操作を実行するために使用できる確立済みの接続のグループです。これを使用すると、コネクタで新しい接続を毎回確立する必要はありません。

アプリケーションのグローバル要素で ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目を設定する場合は、​**\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ 項目をオフにして接続プーリングでのコネクタのパフォーマンスを向上します。この項目をデフォルト (​`TRUE`​) として選択したままにしていると、接続がプールからチェックアウトされるたびに、接続プールでデータベースに対する接続確認が実行されるため、各操作の完了までにかかる時間が増加します。

すべての接続種別で ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目の設定が受け入れられます。JDBC では、プーリングはデータソースレベルで実行されるため、プーリングを有効にするには、グローバルデータソースを設定する必要があります。

次の例は、​**\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ 項目を ​`FALSE`​ に設定して Oracle データベース接続用のプーリングプロファイルを設定する方法を示しています。

1. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Advanced (詳細)\]**​ タブの ​**\[Pooling profile (プーリングプロファイル)\]**​ で ​**\[Edit inline (インライン編集)\]**​ を選択します。
2. 次の項目を設定します。
    
    - **Max pool size (最大プールサイズ)**​: `30`
    - **Min pool size (最小プールサイズ)**​: `4`
    - **Acquire Increment (取得増分)**​: `1`
    - **Prepared statement cache size (プリペアードステートメントのキャッシュサイズ)**​ ​`5`
    - **Max wait (最大待機)**​: `0`
    - **Max wait unit (最大待機単位)**​: `SECONDS (Default)`
    - **Max idle time (最大アイドル時間)**​ ​`0`
    - **Max statements (最大ステートメント)**​ ​`0`

1. **\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ をオフにします。  
    これにより、この項目は ​`FALSE`​ として設定されます。
2. **\[Column types (列の型)\]**​ で、​**\[Edit inline (インライン編集)\]**​ を選択します。
3. (​**+**​) プラス記号をクリックして、列の型を追加します。
4. **\[Column Type (列の型)\]**​ ウィンドウで ​**\[Id\]**​ を ​`2003`​、​**\[Type name (型名)\]**​ を ​`1000`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。
5. ステップ 5 を繰り返します。
6. 新しい列型を追加するには、​**\[Id\]**​ を ​`2002`​、​**\[Type name (型名)\]**​ を ​`PHONE_NUMBER_ARRAY`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Pooling Profile (プーリングプロファイル)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-pooling-configuration.png)

Figure 9. プーリングプロファイルの設定

XML エディターでは、​`<db:pooling-profile>`​ および ​`testConnectionOnCheckout="false`​ の設定は次のように記述されます。

```xml
<db:config name="dbConfig">
		<db:oracle-connection host="localhost" user="myuser" password="mypass" serviceName="orclpdb1">
			<db:pooling-profile minPoolSize="4" maxPoolSize="30" testConnectionOnCheckout="false" acquireIncrement="1" maxWait="0" maxWaitUnit="SECONDS" preparedStatementCacheSize="5"/>
			<db:column-types>
				<db:column-type id="2003" typeName="PHONE_NUMBER" />
				<db:column-type id="2002" typeName="PHONE_NUMBER_ARRAY" />
			</db:column-types>
		</db:oracle-connection>
	</db:config>
```

## [](#tns-名を使用した-oracle-接続の設定)TNS 名を使用した Oracle 接続の設定

次の例は、​`tnsnames.ora`​ ファイルを使用する Oracle データベースに接続する ​**\[Generic Connection (汎用接続)\]**​ 項目を設定する方法を示しています。 ファイアウォールで Mule Runtime Engine をデータベースから分離している場合、TNS 接続で ​`ENABLE=BROKEN`​ パラメーターを使用してキープアライブ接続を有効にします。 キープアライブ接続を設定しない場合、非アクティブタイマーの期限切れにより接続のトラフィックがドロップする可能性があります。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. 接続の ​**\[URL\]**​ を ​`jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port})))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))`​ に設定します。
7. **\[Driver class name (ドライバークラス名)\]**​ を ​`oracle.jdbc.driver.OracleDriver`​ に設定します。
8. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
9. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![TNS 設定を使用した Oracle データベース](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-oracle-tns.png)

Figure 10. TNS 設定を使用した Oracle

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="oracle.jdbc.driver.OracleDriver"
    url="jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port}))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))` and *Driver class name* to `oracle.jdbc.driver.OracleDriver"/>
</db:config>
```

## [](#関連情報)関連情報

- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.12/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=d37b169e1bf0911066eb08b00cb08721c3a985998735b3ec65ba8bd84b2c397f url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-connection.md -->

# データベース接続の設定

データベース用 Anypoint Connector (Database Connector) は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。次の例は、最も一般的なデータベース (Derby、Microsoft SQL Server、MySQL、Oracle、汎用データベースなど) に接続する方法を示しています。また、高度なユースケースとして、Anypoint Studio と XML エディターの両方で、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行う方法も示しています。

## [](#データソース参照接続の設定)データソース参照接続の設定

Database Connector では、​**\[Generic Connection (汎用接続)\]**​ 項目の設定時に指定したパラメーター値を使用して、JDBC データソースを生成します。独自のデータソースを作成し、そのデータソースを使用してデータベースに接続する場合は、​**\[Data Source Reference Connection (データソース参照接続)\]**​ 項目を設定します。

次の例は、Anypoint Studio を使用して Derby データベースへのデータソース参照接続を設定する方法を示しています。

1. Studio の ​`src/main/resources`​ フォルダーで、Derby データベースに接続するカスタム ​`enhydra`​ データソースを定義する ​`datasource-config.xml`​ bean ファイルを作成します。
    
    datasource-config.xml ファイル
    
    ```xml
    <bean id="jdbcDataSource" class="org.enhydra.jdbc.standard.StandardDataSource"
     destroy-method="shutdown">
       <property name="driverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
       <property name="url" value="jdbc:derby:muleEmbeddedDB;create=true"/>
    </bean>
    ```
2. Mule フローに戻り、​**\[Global Elements (グローバル要素)\]**​ ビューに移動して、​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`spring`​」と入力し、​**\[Spring Config (Spring 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Spring Config (Spring 設定)\]**​ ウィンドウの ​**\[Files (ファイル)\]**​ 項目で、Spring Module を使用して Spring 設定ファイルを参照する ​`datasource-config.xml`​ を追加します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットはこの設定を示しています。

![Spring 設定データソース](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-spring-configuration.png)

Figure 1. Spring 設定データソース

1. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
2. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Data Source Reference Connection (データソース参照接続)\]**​ を選択します。
4. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
5. **\[Data source ref (データソース参照)\]**​ で、​`datasource-config.xml`​ bean ファイルに作成された bean ID ​`jdbcDataSource`​ を追加します。
6. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
7. **\[OK\]**​ をクリックします。

次のスクリーンショットはこの設定を示しています。

![データソース参照接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-datasource-connection.png)

Figure 2. データソース参照接続

XML エディターでは、Spring 設定とデータベース設定は次のように記述されます。

```xml
<spring:config name="datasource" files="datasource-config.xml" />

<db:config name="Database_Config">
   <db:data-source-connection dataSourceRef="jdbcDataSource" />
</db:config>
```

## [](#data-source-connection-xa)XA トランザクションモードでのデータソース参照接続

Mule アプリケーションで XA トランザクションにバインドされている操作が必要であり、使用しているデータベース設定で接続プーリングが有効である場合は、データソース参照接続のデフォルト接続プール実装は Enhydra XAPool になります。

Enhydra XAPool は、プリペアードステートメントをサポートしません。これらの操作を実行するには、Bitronix 接続プールを使用してください。詳細は、​[『Bitronix トランザクションマネージャーの設定』](https://docs.mulesoft.com/mule-runtime/latest/using-bitronix-to-manage-transactions#configuring-the-bitronix-transaction-manager)​ドキュメントを参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">XA トランザクションを使用するには、アプリケーションの JDBC データソース Spring Bean 設定ファイルで ​<code>XADataSource</code>​ オブジェクトを指定する必要があります。</td></tr></tbody></table>

XA トランザクションモードで Derby データベースの​**データソース参照接続**​を設定する例を示します。

1. Studio で、​`src/main/resources`​ フォルダーに ​`datasource-config.xml`​ Spring Bean ファイルを作成します。
2. `org.enhydra.jdbc.standard.Standard`​ クラスの最後に ​`XADataSource`​ オブジェクトを追加します (例: `class="org.enhydra.jdbc.standard.StandardXaDataSource`​)。
    
    datasource-config.xml ファイル
    
    ```xml
    <?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="
                   http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd">
    
        <bean id="jdbcDataSource" class="org.enhydra.jdbc.standard.StandardXaDataSource" destroy-method="shutdown">
            <property name="driverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
            <property name="url" value="jdbc:derby:muleEmbeddedDB;create=true"/>
        </bean>
    
    </beans>
    ```
3. Mule フローに戻り、​**\[Global Elements (グローバル要素)\]**​ > ​**\[Create (作成)\]**​ を選択して ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
4. **\[Filter (検索条件)\]**​ に「​`spring`​」と入力し、​**\[Spring Config (Spring 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
5. **\[Spring Config (Spring 設定)\]**​ の ​**\[Files (ファイル)\]**​ で、Spring Module を使用して Spring 設定ファイルを参照する ​`datasource-config.xml`​ を追加します。
6. **\[OK\]**​ をクリックします。

![「Files (ファイル)」 項目で datasource-config.xml が設定された 「Spring Config (Spring 設定)」 ウィンドウ](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-spring-configuration.png)

1. **\[Global Elements (グローバル要素)\]**​ で ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
2. **\[Filter (検索条件)\]**​ に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
3. **\[Database Config (データベース設定)\]**​ > ​**\[Connection (接続)\]**​ で ​**\[Data Source Reference Connection (データソース参照接続)\]**​ を選択します。
4. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
5. **\[Data source ref (データソース参照)\]**​ で、​`datasource-config.xml`​ bean ファイルに作成された bean ID ​`jdbcDataSource`​ を追加します。
6. **\[Advanced (詳細)\]**​ タブで、​**\[Pooling profile (プーリングプロファイル)\]**​、​**\[Column types (列の型)\]**​、​**\[Reconnection (再接続)\]**​ の各項目を設定します。
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
8. **\[OK\]**​ をクリックします。

XML エディターでは、Spring 設定とデータベース設定は次のように記述されます。

```xml
<spring:config name="spring-beans" files="datasource-spring-beans.xml"/>

<db:config name="db-datasource">
    <db:data-source-connection dataSourceRef="jdbcDataSource">
        <reconnection failsDeployment="true">
            <reconnect frequency="4000" count="4"/>
        </reconnection>
        <db:column-types>
            <db:column-type id="124"
                            typeName="column_type"
                            className="class_name"/>
        </db:column-types>
        <db:pooling-profile maxPoolSize="6" minPoolSize="1"
                            acquireIncrement="2"
                            maxWait="1" maxWaitUnit="MINUTES"/>
    </db:data-source-connection>
</db:config>
```

## [](#derby-接続の設定)Derby 接続の設定

Derby データベースに接続する場合は、​**\[Derby Connection (Derby 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Derby Connection (Derby 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Derby JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Database (データベース)\]**​ を ​`derbyDB`​、​**\[Subsub protocol (Subsub プロトコル)\]**​ を ​`directory`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Derby 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-derby-connection.png)

Figure 3. Derby 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config" >
		<db:derby-connection database="derbyDB" />
	</db:config>
```

## [](#汎用接続の設定)汎用接続の設定

次のデータベースに接続する場合は、​**\[Generic Connection (汎用接続)\]**​ 項目種別を使用します。

- MuleSoft で特定の接続種別が提供されていないデータベース
- サポートされるデータベースであるが、使用するカスタムオプションが接続種別に含まれない

次の例は、Anypoint Studio で H2 データベースに接続する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[URL\]**​ を ​`jdbc:h2:file:/tmp/datasenseDBand`​、​**\[Driver class name (ドライバークラス名)\]**​ を ​`org.h2.Driver`​ に設定します。
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
8. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![汎用接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-generic-connection.png)

Figure 4. 汎用接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="org.h2.Driver"
    url="jdbc:h2:file:/tmp/datasenseDB"/>
</db:config>
```

## [](#microsoft-sql-server-接続の設定)Microsoft SQL Server 接続の設定

Microsoft SQL Server データベースに接続する場合は、​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Microsoft SQL Server ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`553`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database name (データベース名)\]**​ を ​`microsoftDB`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Microsoft SQL Server 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-mssql-connection.png)

Figure 5. Microsoft SQL Server 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:mssql-connection
    host="0.0.0.0"
    port="553"
    user="Max"
    password="password"
    databaseName="microsoftDB" />
</db:config>
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

MySQL データベースに接続する場合は、​**\[MySQL Connection (MySQL 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`3306`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database (データベース)\]**​ を ​`someSchema`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![MySQL 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-mysql-connection.png)

Figure 6. MySQL 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:my-sql-connection
  host="0.0.0.0"
  port="3306"
  user="Max"
  password="POWERS"
  database="mysqlDB"/>
</db:config>
```

## [](#oracle-接続の設定)Oracle 接続の設定

Oracle データベースに接続する場合は、​**\[Oracle Connection (Oracle 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`192.168.99.100`​、​**\[Port (ポート)\]**​ を ​`1521`​、​**\[User (ユーザー)\]**​ を ​`system`​、​**\[Password (パスワード)\]**​ を ​`oracle`​、​**\[Instance (インスタンス)\]**​ を ​`xe`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Oracle 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-oracle-connection.png)

Figure 7. Oracle 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:oracle-connection
  host="192.168.99.100"
  port="1521" instance="xe"
  user="system"
  password="oracle" />
</db:config>
```

## [](#jdbc-ドライバーの設定)JDBC ドライバーの設定

接続を設定したら、JDBC ドライバーを追加できます。次の例は、MySQL データベースのドライバーを追加する方法を示しています。

1. Studio で、次のいずれかのオプションを使用してドライバーを追加できます。
    
    - **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Configure (設定)\]**​ をクリックし、​**\[Add Maven dependency (Maven 連動関係を追加)\]**​ を選択して、連動関係を選択します。
        
        ![Maven 連動関係の選択](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-dependency.png)
        
        Figure 8. Maven 連動関係の選択
    - 連動関係をプロジェクトの ​`pom.xml`​ ファイルに直接追加します。
        
        ```xml
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.48</version>
        </dependency>
        ```
2. Mule でドライバーの連動関係を Database Connector に公開するように ​`pom.xml`​ ファイルを設定します。
    
    ```xml
    <build>
        <plugins>
            <!-- Only used to declare the shared libraries-->
            <plugin>
                <groupId>org.mule.tools.maven</groupId>
                <artifactId>mule-maven-plugin</artifactId>
                <version>1.0.0</version>
                <configuration>
                    <sharedLibraries>
                        <sharedLibrary>
                            <groupId>mysql</groupId>
                            <artifactId>mysql-connector-java</artifactId>
                        </sharedLibrary>
                    </sharedLibraries>
                </configuration>
            </plugin>
        </plugins>
    </build>
    ```

## [](#接続プールの設定)接続プールの設定

接続の確立には、コネクタ、リレーショナルデータベース管理システム (RDBMS) ネットワーク、および処理オーバーヘッドの点でコストがかかります。Database Connector ではプーリングプロファイルを使用して接続プールをビルドできます。これは、コネクタで必要な操作を実行するために使用できる確立済みの接続のグループです。これを使用すると、コネクタで新しい接続を毎回確立する必要はありません。

アプリケーションのグローバル要素で ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目を設定する場合は、​**\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ 項目をオフにして接続プーリングでのコネクタのパフォーマンスを向上します。この項目をデフォルト (​`TRUE`​) として選択したままにしていると、接続がプールからチェックアウトされるたびに、接続プールでデータベースに対する接続確認が実行されるため、各操作の完了までにかかる時間が増加します。

すべての接続種別で ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目の設定が受け入れられます。JDBC では、プーリングはデータソースレベルで実行されるため、プーリングを有効にするには、グローバルデータソースを設定する必要があります。

次の例は、​**\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ 項目を ​`FALSE`​ に設定して Oracle データベース接続用のプーリングプロファイルを設定する方法を示しています。

1. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Advanced (詳細)\]**​ タブの ​**\[Pooling profile (プーリングプロファイル)\]**​ で ​**\[Edit inline (インライン編集)\]**​ を選択します。
2. 次の項目を設定します。
    
    - **Max pool size (最大プールサイズ)**​: `30`
    - **Min pool size (最小プールサイズ)**​: `4`
    - **Acquire Increment (取得増分)**​: `1`
    - **Prepared statement cache size (プリペアードステートメントのキャッシュサイズ)**​ ​`5`
    - **Max wait (最大待機)**​: `0`
    - **Max wait unit (最大待機単位)**​: `SECONDS (Default)`
    - **Max idle time (最大アイドル時間)**​ ​`0`
    - **Max statements (最大ステートメント)**​ ​`0`

1. **\[Test connection on checkout (チャックアウト時に接続をテスト)\]**​ をオフにします。  
    これにより、この項目は ​`FALSE`​ として設定されます。
2. **\[Column types (列の型)\]**​ で、​**\[Edit inline (インライン編集)\]**​ を選択します。
3. (​**+**​) プラス記号をクリックして、列の型を追加します。
4. **\[Column Type (列の型)\]**​ ウィンドウで ​**\[Id\]**​ を ​`2003`​、​**\[Type name (型名)\]**​ を ​`1000`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。
5. ステップ 5 を繰り返します。
6. 新しい列型を追加するには、​**\[Id\]**​ を ​`2002`​、​**\[Type name (型名)\]**​ を ​`PHONE_NUMBER_ARRAY`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Pooling Profile (プーリングプロファイル)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-pooling-configuration.png)

Figure 9. プーリングプロファイルの設定

XML エディターでは、​`<db:pooling-profile>`​ および ​`testConnectionOnCheckout="false`​ の設定は次のように記述されます。

```xml
<db:config name="dbConfig">
		<db:oracle-connection host="localhost" user="myuser" password="mypass" serviceName="orclpdb1">
			<db:pooling-profile minPoolSize="4" maxPoolSize="30" testConnectionOnCheckout="false" acquireIncrement="1" maxWait="0" maxWaitUnit="SECONDS" preparedStatementCacheSize="5"/>
			<db:column-types>
				<db:column-type id="2003" typeName="PHONE_NUMBER" />
				<db:column-type id="2002" typeName="PHONE_NUMBER_ARRAY" />
			</db:column-types>
		</db:oracle-connection>
	</db:config>
```

## [](#tns-名を使用した-oracle-接続の設定)TNS 名を使用した Oracle 接続の設定

次の例は、​`tnsnames.ora`​ ファイルを使用する Oracle データベースに接続する ​**\[Generic Connection (汎用接続)\]**​ 項目を設定する方法を示しています。 ファイアウォールで Mule Runtime Engine をデータベースから分離している場合、TNS 接続で ​`ENABLE=BROKEN`​ パラメーターを使用してキープアライブ接続を有効にします。 キープアライブ接続を設定しない場合、非アクティブタイマーの期限切れにより接続のトラフィックがドロップする可能性があります。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. 接続の ​**\[URL\]**​ を ​`jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port})))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))`​ に設定します。
7. **\[Driver class name (ドライバークラス名)\]**​ を ​`oracle.jdbc.driver.OracleDriver`​ に設定します。
8. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
9. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![TNS 設定を使用した Oracle データベース](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-oracle-tns.png)

Figure 10. TNS 設定を使用した Oracle

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="oracle.jdbc.driver.OracleDriver"
    url="jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port}))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))` and *Driver class name* to `oracle.jdbc.driver.OracleDriver"/>
</db:config>
```

## [](#関連情報)関連情報

- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.13/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=6eabb3b671f599edc17eae25ec6cb56a9010414b0865603f6446eb741adc3a4e url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-connection.md -->

# データベース接続の設定

データベース用 Anypoint Connector (Database Connector) は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。次の例は、最も一般的なデータベース (Derby、Microsoft SQL Server、MySQL、Oracle、汎用データベースなど) に接続する方法を示しています。また、高度なユースケースとして、Anypoint Studio と XML エディターの両方で、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行う方法も示しています。

## [](#データソース参照接続の設定)データソース参照接続の設定

Database Connector では、​**\[Generic Connection (汎用接続)\]**​ 項目の設定時に指定したパラメーター値を使用して、JDBC データソースを生成します。独自のデータソースを作成し、そのデータソースを使用してデータベースに接続する場合は、​**\[Data Source Reference Connection (データソース参照接続)\]**​ 項目を設定します。

次の例は、Anypoint Studio を使用して Derby データベースへのデータソース参照接続を設定する方法を示しています。

1. Studio の ​`src/main/resources`​ フォルダーで、Derby データベースに接続するカスタム ​`enhydra`​ データソースを定義する ​`datasource-config.xml`​ bean ファイルを作成します。
    
    datasource-config.xml ファイル
    
    ```xml
    <?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="
                   http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd">
    <bean id="jdbcDataSource" class="org.enhydra.jdbc.standard.StandardDataSource"
     destroy-method="shutdown">
       <property name="driverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
       <property name="url" value="jdbc:derby:muleEmbeddedDB;create=true"/>
    </bean>
    </beans>
    ```
2. Mule フローに戻り、​**\[Global Elements (グローバル要素)\]**​ ビューに移動して、​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`spring`​」と入力し、​**\[Spring Config (Spring 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Spring Config (Spring 設定)\]**​ ウィンドウの ​**\[Files (ファイル)\]**​ 項目で、Spring Module を使用して Spring 設定ファイルを参照する ​`datasource-config.xml`​ を追加します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットは設定を示しています。

![Spring 設定データソース](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-spring-configuration.png)

Figure 1. Spring 設定データソース

1. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
2. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Data Source Reference Connection (データソース参照接続)\]**​ を選択します。
4. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
5. **\[Data source ref (データソース参照)\]**​ で、​`datasource-config.xml`​ bean ファイルに作成された bean ID ​`jdbcDataSource`​ を追加します。
6. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
7. **\[OK\]**​ をクリックします。

次のスクリーンショットは設定を示しています。

![データソース参照接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-datasource-connection.png)

Figure 2. データソース参照接続

XML エディターでは、Spring 設定とデータベース設定は次のように記述されます。

```xml
<spring:config name="datasource" files="datasource-config.xml" />

<db:config name="Database_Config">
   <db:data-source-connection dataSourceRef="jdbcDataSource" />
</db:config>
```

## [](#data-source-connection-xa)XA トランザクションモードでのデータソース参照接続

Mule アプリケーションで XA トランザクションにバインドされている操作が必要であり、使用しているデータベース設定で接続プーリングが有効である場合は、データソース参照接続のデフォルト接続プール実装は Enhydra XAPool になります。

Enhydra XAPool は、プリペアードステートメントをサポートしません。これらの操作を実行するには、Bitronix 接続プールを使用してください。詳細は、​[『Bitronix トランザクションマネージャーの設定』](https://docs.mulesoft.com/mule-runtime/latest/using-bitronix-to-manage-transactions#configuring-the-bitronix-transaction-manager)​ドキュメントを参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">XA トランザクションを使用するには、アプリケーションの JDBC データソース Spring Bean 設定ファイルで ​<code>XADataSource</code>​ オブジェクトを指定する必要があります。</td></tr></tbody></table>

XA トランザクションモードで Derby データベースの​**データソース参照接続**​を設定する例を示します。

1. Studio で、​`src/main/resources`​ フォルダーに ​`datasource-config.xml`​ Spring Bean ファイルを作成します。
2. `org.enhydra.jdbc.standard.Standard`​ クラスの最後に ​`XADataSource`​ オブジェクトを追加します (例: `class="org.enhydra.jdbc.standard.StandardXaDataSource`​)。
    
    datasource-config.xml ファイル
    
    ```xml
    <?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="
                   http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd">
    
        <bean id="jdbcDataSource" class="org.enhydra.jdbc.standard.StandardXaDataSource" destroy-method="shutdown">
            <property name="driverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
            <property name="url" value="jdbc:derby:muleEmbeddedDB;create=true"/>
        </bean>
    
    </beans>
    ```
3. Mule フローに戻り、​**\[Global Elements (グローバル要素)\]**​ > ​**\[Create (作成)\]**​ を選択して ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
4. **\[Filter (検索条件)\]**​ に「​`spring`​」と入力し、​**\[Spring Config (Spring 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
5. **\[Spring Config (Spring 設定)\]**​ の ​**\[Files (ファイル)\]**​ で、Spring Module を使用して Spring 設定ファイルを参照する ​`datasource-config.xml`​ を追加します。
6. **\[OK\]**​ をクリックします。

![「Files (ファイル)」 項目で datasource-config.xml が設定された 「Spring Config (Spring 設定)」 ウィンドウ](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-spring-configuration.png)

1. **\[Global Elements (グローバル要素)\]**​ で ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
2. **\[Filter (検索条件)\]**​ に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
3. **\[Database Config (データベース設定)\]**​ > ​**\[Connection (接続)\]**​ で ​**\[Data Source Reference Connection (データソース参照接続)\]**​ を選択します。
4. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
5. **\[Data source ref (データソース参照)\]**​ で、​`datasource-config.xml`​ bean ファイルに作成された bean ID ​`jdbcDataSource`​ を追加します。
6. **\[Advanced (詳細)\]**​ タブで、​**\[Pooling profile (プーリングプロファイル)\]**​、​**\[Column types (列の型)\]**​、​**\[Reconnection (再接続)\]**​ の各項目を設定します。
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
8. **\[OK\]**​ をクリックします。

XML エディターでは、Spring 設定とデータベース設定は次のように記述されます。

```xml
<spring:config name="spring-beans" files="datasource-spring-beans.xml"/>

<db:config name="db-datasource">
    <db:data-source-connection dataSourceRef="jdbcDataSource">
        <reconnection failsDeployment="true">
            <reconnect frequency="4000" count="4"/>
        </reconnection>
        <db:column-types>
            <db:column-type id="124"
                            typeName="column_type"
                            className="class_name"/>
        </db:column-types>
        <db:pooling-profile maxPoolSize="6" minPoolSize="1"
                            acquireIncrement="2"
                            maxWait="1" maxWaitUnit="MINUTES"/>
    </db:data-source-connection>
</db:config>
```

## [](#derby-接続の設定)Derby 接続の設定

Derby データベースに接続するには、​**\[Derby Connection (Derby 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Derby Connection (Derby 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Derby JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Database (データベース)\]**​ を ​`derbyDB`​、​**\[Subsub protocol (Subsub プロトコル)\]**​ を ​`directory`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Derby 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-derby-connection.png)

Figure 3. Derby 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config" >
		<db:derby-connection database="derbyDB" />
	</db:config>
```

## [](#汎用接続の設定)汎用接続の設定

次のデータベースに接続するには、​**\[Generic Connection (汎用接続)\]**​ 項目種別を使用します。

- MuleSoft で特定の接続種別が提供されていないデータベース
- 接続種別に含まれないカスタムオプションを使用するサポート対象データベース

次の例は、Anypoint Studio で H2 データベースに接続する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[URL\]**​ を ​`jdbc:h2:file:/tmp/datasenseDBand`​、​**\[Driver class name (ドライバークラス名)\]**​ を ​`org.h2.Driver`​ に設定します。
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
8. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![汎用接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-generic-connection.png)

Figure 4. 汎用接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="org.h2.Driver"
    url="jdbc:h2:file:/tmp/datasenseDB"/>
</db:config>
```

## [](#microsoft-sql-server-接続の設定)Microsoft SQL Server 接続の設定

Microsoft SQL Server データベースに接続するには、​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Microsoft SQL Server ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`553`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database name (データベース名)\]**​ を ​`microsoftDB`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Microsoft SQL Server 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-mssql-connection.png)

Figure 5. Microsoft SQL Server 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:mssql-connection
    host="0.0.0.0"
    port="553"
    user="Max"
    password="password"
    databaseName="microsoftDB" />
</db:config>
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

MySQL データベースに接続するには、​**\[MySQL Connection (MySQL 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`3306`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database (データベース)\]**​ を ​`someSchema`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![MySQL 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-mysql-connection.png)

Figure 6. MySQL 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:my-sql-connection
  host="0.0.0.0"
  port="3306"
  user="Max"
  password="POWERS"
  database="mysqlDB"/>
</db:config>
```

## [](#oracle-接続の設定)Oracle 接続の設定

Oracle データベースに接続するには、​**\[Oracle Connection (Oracle 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`192.168.99.100`​、​**\[Port (ポート)\]**​ を ​`1521`​、​**\[User (ユーザー)\]**​ を ​`system`​、​**\[Password (パスワード)\]**​ を ​`oracle`​、​**\[Instance (インスタンス)\]**​ を ​`xe`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Oracle 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-oracle-connection.png)

Figure 7. Oracle 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:oracle-connection
  host="192.168.99.100"
  port="1521" instance="xe"
  user="system"
  password="oracle" />
</db:config>
```

## [](#jdbc-ドライバーの設定)JDBC ドライバーの設定

接続を設定したら、JDBC ドライバーを追加します。次の例は、MySQL データベースのドライバーを追加する方法を示しています。

1. Studio で、次のいずれかのオプションを使用してドライバーを追加します。
    
    - **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Configure (設定)\]**​ をクリックし、​**\[Add Maven dependency (Maven 連動関係を追加)\]**​ を選択して、連動関係を選択します。
        
        ![Maven 連動関係の選択](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-dependency.png)
        
        Figure 8. Maven 連動関係の選択
    - 連動関係をプロジェクトの ​`pom.xml`​ ファイルに直接追加します。
        
        ```xml
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.48</version>
        </dependency>
        ```
2. Mule でドライバーの連動関係を Database Connector に公開するように ​`pom.xml`​ ファイルを設定します。
    
    ```xml
    <build>
        <plugins>
            <!-- Only used to declare the shared libraries-->
            <plugin>
                <groupId>org.mule.tools.maven</groupId>
                <artifactId>mule-maven-plugin</artifactId>
                <version>1.0.0</version>
                <configuration>
                    <sharedLibraries>
                        <sharedLibrary>
                            <groupId>mysql</groupId>
                            <artifactId>mysql-connector-java</artifactId>
                        </sharedLibrary>
                    </sharedLibraries>
                </configuration>
            </plugin>
        </plugins>
    </build>
    ```

## [](#接続プールの設定)接続プールの設定

接続の確立には、コネクタ、リレーショナルデータベース管理システム (RDBMS) ネットワーク、および処理オーバーヘッドの点でコストがかかります。Database Connector ではプーリングプロファイルを使用して接続プールをビルドできます。これは、コネクタで必要な操作を実行するために使用できる確立済みの接続のグループです。これを使用すると、コネクタで新しい接続を毎回確立する必要はありません。

アプリケーションのグローバル要素で ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目を設定する場合は、​**\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ 項目をオフにして接続プーリングでのコネクタのパフォーマンスを向上します。この項目をデフォルト (​`TRUE`​) として選択したままにしていると、接続がプールからチェックアウトされるたびに、接続プールでデータベースに対する接続確認が実行されるため、各操作の完了までにかかる時間が増加します。

すべての接続種別で ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目の設定が受け入れられます。JDBC では、プーリングはデータソースレベルで実行されるため、プーリングを有効にするには、グローバルデータソースを設定する必要があります。

次の例は、​**\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ 項目を ​`FALSE`​ に設定して Oracle データベース接続用のプーリングプロファイルを設定する方法を示しています。

1. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Advanced (詳細)\]**​ タブの ​**\[Pooling profile (プーリングプロファイル)\]**​ で ​**\[Edit inline (インライン編集)\]**​ を選択します。
2. 次の項目を設定します。
    
    - **Max pool size (最大プールサイズ)**​: `30`
    - **Min pool size (最小プールサイズ)**​: `4`
    - **Acquire Increment (取得増分)**​: `1`
    - **Prepared statement cache size (プリペアードステートメントのキャッシュサイズ)**​ ​`5`
    - **Max wait (最大待機)**​: `0`
    - **Max wait unit (最大待機単位)**​: `SECONDS (Default)`
    - **Max idle time (最大アイドル時間)**​ ​`60`
    - **Max statements (最大ステートメント)**​ ​`0`

1. **\[Test connection on checkout (チェックアウト時に接続をテスト)\]**​ をオフにします。  
    これにより、この項目は ​`FALSE`​ として設定されます。
2. **\[Column types (列の型)\]**​ で、​**\[Edit inline (インライン編集)\]**​ を選択します。
3. (​**+**​) プラス記号をクリックして、列の型を追加します。
4. **\[Column Type (列の型)\]**​ ウィンドウで ​**\[Id\]**​ を ​`2003`​、​**\[Type name (型名)\]**​ を ​`1000`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。
5. ステップ 5 を繰り返します。
6. 新しい列型を追加するには、​**\[Id\]**​ を ​`2002`​、​**\[Type name (型名)\]**​ を ​`PHONE_NUMBER_ARRAY`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Pooling Profile (プーリングプロファイル)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-pooling-configuration.png)

Figure 9. プーリングプロファイルの設定

XML エディターでは、​`<db:pooling-profile>`​ および ​`testConnectionOnCheckout="false`​ の設定は次のように記述されます。

```xml
<db:config name="dbConfig">
		<db:oracle-connection host="localhost" user="myuser" password="mypass" serviceName="orclpdb1">
			<db:pooling-profile minPoolSize="4" maxPoolSize="30" testConnectionOnCheckout="false" acquireIncrement="1" maxWait="0" maxWaitUnit="SECONDS" preparedStatementCacheSize="5"/>
			<db:column-types>
				<db:column-type id="2003" typeName="PHONE_NUMBER" />
				<db:column-type id="2002" typeName="PHONE_NUMBER_ARRAY" />
			</db:column-types>
		</db:oracle-connection>
	</db:config>
```

## [](#tns-名を使用した-oracle-接続の設定)TNS 名を使用した Oracle 接続の設定

次の例は、​`tnsnames.ora`​ ファイルを使用する Oracle データベースに接続する ​**\[Generic Connection (汎用接続)\]**​ 項目を設定する方法を示しています。 ファイアウォールで Mule Runtime Engine をデータベースから分離している場合、TNS 接続で ​`ENABLE=BROKEN`​ パラメーターを使用してキープアライブ接続を有効にします。 キープアライブ接続を設定しない場合、非アクティブタイマーの期限切れにより接続のトラフィックがドロップする可能性があります。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. 接続の ​**\[URL\]**​ を ​`jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port})))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))`​ に設定します。
7. **\[Driver class name (ドライバークラス名)\]**​ を ​`oracle.jdbc.driver.OracleDriver`​ に設定します。
8. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
9. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![TNS 設定を使用した Oracle データベース](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-oracle-tns.png)

Figure 10. TNS 設定を使用した Oracle

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="oracle.jdbc.driver.OracleDriver"
    url="jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port}))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))` and *Driver class name* to `oracle.jdbc.driver.OracleDriver"/>
</db:config>
```

## [](#キャッシュクエリテンプレートサイズを設定する)キャッシュクエリテンプレートサイズを設定する

次の例は、接続の ​**\[Cache Query Template Size (キャッシュクエリテンプレートサイズ)\]**​ 項目を設定する方法を示しています。

1. Studio で \[Database Global Configuration (データベースグローバル設定)\] ウィンドウを開きます。
2. **\[Advanced (詳細)\]**​ タブを選択します。
3. **\[Cache Query Template Size (キャッシュクエリテンプレートサイズ)\]**​ 項目を目的の値に設定します。

![50 に設定された \[Cache Query Template Size (キャッシュクエリテンプレートサイズ)\] 項目](_images/database-cachequery.png)

## [](#関連情報)関連情報

- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.14/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=88d85d94c25ce2cbce397dbdd65da9dbcb2b6eba3c187f7abf81afd41f6fea89 url=/mulesoft/current/ja-jp/db-connector/1.8/database-connector-connection.md -->

# データベース接続の設定

データベース用 Anypoint Connector (Database Connector) は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。次の例は、最も一般的なデータベース (Derby、Microsoft SQL Server、MySQL、Oracle、汎用データベースなど) に接続する方法を示しています。また、高度なユースケースとして、Anypoint Studio と XML エディターの両方で、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行う方法も示しています。

## [](#データソース参照接続の設定)データソース参照接続の設定

Database Connector では、​**\[Generic Connection (汎用接続)\]**​ の設定時に指定したパラメーター値を使用して、JDBC データソースを生成します。独自のデータソースを作成し、そのデータソースを使用してデータベースに接続する場合は、​**\[Data Source Reference Connection (データソース参照接続)\]**​ を設定します。

次の例は、Anypoint Studio を使用して Derby データベースへのデータソース参照接続を設定する方法を示しています。

1. Studio の ​`src/main/resources`​ フォルダーで、Derby データベースに接続するカスタム ​`enhydra`​ データソースを定義する ​`datasource-config.xml`​ bean ファイルを作成します。
    
    datasource-config.xml ファイル
    
    ```xml
    <bean id="jdbcDataSource" class="org.enhydra.jdbc.standard.StandardDataSource"
     destroy-method="shutdown">
       <property name="driverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
       <property name="url" value="jdbc:derby:muleEmbeddedDB;create=true"/>
    </bean>
    ```
2. Mule フローに戻り、​**\[Global Elements (グローバル要素)\]**​ ビューに移動して、​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`spring`​」と入力し、​**\[Spring Config (Spring 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Spring Config (Spring 設定)\]**​ ウィンドウの ​**\[Files (ファイル)\]**​ 項目で、Spring Module を使用して Spring 設定ファイルを参照する ​`datasource-config.xml`​ を追加します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットはこの設定を示しています。

![Spring 設定データソース](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-spring-configuration.png)

Figure 1. Spring 設定データソース

1. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
2. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Data Source Reference Connection (データソース参照接続)\]**​ を選択します。
4. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
5. **\[Data source ref (データソース参照)\]**​ で、​`datasource-config.xml`​ bean ファイルに作成された bean ID ​`jdbcDataSource`​ を追加します。
6. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
7. **\[OK\]**​ をクリックします。

次のスクリーンショットはこの設定を示しています。

![データソース参照接続](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-datasource-connection.png)

Figure 2. データソース参照接続

XML エディターでは、Spring 設定とデータベース設定は次のように記述されます。

```xml
<spring:config name="datasource" files="datasource-config.xml" />

<db:config name="Database_Config">
   <db:data-source-connection dataSourceRef="jdbcDataSource" />
</db:config>
```

## [](#derby-接続の設定)Derby 接続の設定

Derby データベースに接続する場合は、​**\[Derby Connection (Derby 接続)\]**​ 種別を使用します。

次の例は、Anypoint Studio で ​**\[Derby Connection (Derby 接続)\]**​ を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Derby Connection (Derby 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Derby JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Database (データベース)\]**​ を ​`derbyDB`​、​**\[Subsub protocol (Subsub プロトコル)\]**​ を ​`directory`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Derby 接続の設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-derby-connection.png)

Figure 3. Derby 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config" >
		<db:derby-connection database="derbyDB" />
	</db:config>
```

## [](#汎用接続の設定)汎用接続の設定

次のデータベースに接続する場合は、​**\[Generic Connection (汎用接続)\]**​ 種別を使用します。

- MuleSoft で特定の接続種別が提供されていないデータベース
- サポートされるデータベースであるが、使用するカスタムオプションが接続種別に含まれない

次の例は、Anypoint Studio で H2 データベースに接続する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[URL\]**​ を ​`jdbc:h2:file:/tmp/datasenseDBand`​、​**\[Driver class name (ドライバークラス名)\]**​ を ​`org.h2.Driver`​ に設定します。
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
8. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![汎用接続の設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-generic-connection.png)

Figure 4. 汎用接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="org.h2.Driver"
    url="jdbc:h2:file:/tmp/datasenseDB"/>
</db:config>
```

## [](#microsoft-sql-server-接続の設定)Microsoft SQL Server 接続の設定

Microsoft SQL Server データベースに接続する場合は、​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ 種別を使用します。

次の例は、Anypoint Studio で ​**\[Microsoft SQL Server (Microsoft SQL Server 接続)\]**​ を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Microsoft SQL Server ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`553`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database name (データベース名)\]**​ を ​`microsoftDB`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Microsoft SQL Server 接続の設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-mssql-connection.png)

Figure 5. Microsoft SQL Server 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:mssql-connection
    host="0.0.0.0"
    port="553"
    user="Max"
    password="password"
    databaseName="microsoftDB" />
</db:config>
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

MySQL データベースに接続する場合は、​**\[MySQL Connection (MySQL 接続)\]**​ 種別を使用します。

次の例は、Anypoint Studio で ​**\[MySQL Connection (MySQL 接続)\]**​ を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`3306`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database (データベース)\]**​ を ​`someSchema`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![MySQL 接続の設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-mysql-connection.png)

Figure 6. MySQL 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:my-sql-connection
  host="0.0.0.0"
  port="3306"
  user="Max"
  password="POWERS"
  database="mysqlDB"/>
</db:config>
```

## [](#oracle-接続の設定)Oracle 接続の設定

Oracle データベースに接続する場合は、​**\[Oracle Connection (Oracle 接続)\]**​ 種別を使用します。

次の例は、Anypoint Studio で ​**\[Oracle Connection (Oracle 接続)\]**​ を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`192.168.99.100`​、​**\[Port (ポート)\]**​ を ​`1521`​、​**\[User (ユーザー)\]**​ を ​`system`​、​**\[Password (パスワード)\]**​ を ​`oracle`​、​**\[Instance (インスタンス)\]**​ を ​`xe`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Oracle 接続の設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-oracle-connection.png)

Figure 7. Oracle 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:oracle-connection
  host="192.168.99.100"
  port="1521" instance="xe"
  user="system"
  password="oracle" />
</db:config>
```

## [](#jdbc-ドライバーの設定)JDBC ドライバーの設定

接続を設定したら、JDBC ドライバーを追加できます。次の例は、MySQL データベースのドライバーを追加する方法を示しています。

1. Studio で、次のいずれかのオプションを使用してドライバーを追加できます。
    
    - **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Configure (設定)\]**​ をクリックし、​**\[Add Maven dependency (Maven 連動関係を追加)\]**​ を選択して、連動関係を選択します。
        
        ![Maven 連動関係の選択](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-dependency.png)
        
        Figure 8. Maven 連動関係の選択
    - 連動関係をプロジェクトの ​`pom.xml`​ ファイルに直接追加します。
        
        ```xml
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.48</version>
        </dependency>
        ```
2. Mule でドライバーの連動関係を Database Connector に公開するように ​`pom.xml`​ ファイルを設定します。
    
    ```xml
    <build>
        <plugins>
            <!-- Only used to declare the shared libraries-->
            <plugin>
                <groupId>org.mule.tools.maven</groupId>
                <artifactId>mule-maven-plugin</artifactId>
                <version>1.0.0</version>
                <configuration>
                    <sharedLibraries>
                        <sharedLibrary>
                            <groupId>mysql</groupId>
                            <artifactId>mysql-connector-java</artifactId>
                        </sharedLibrary>
                    </sharedLibraries>
                </configuration>
            </plugin>
        </plugins>
    </build>
    ```

## [](#接続プールの設定)接続プールの設定

接続の確立には、コネクタ、リレーショナルデータベース管理システム (RDBMS) ネットワーク、および処理オーバーヘッドの点でコストがかかります。Database Connector では ​**\[Pooling profile (プーリングプロファイル)\]**​ パラメーターがサポートされており、このパラメーターを使用して、いくつかの接続を提供する接続プールをビルドできます。

**\[Data Source Reference Connection (データソース参照接続)\]**​ 以外のすべての接続種別設定で ​**\[Pooling profile (プーリングプロファイル)\]**​ 設定が受け入れられます。JDBC では、プーリングはデータソースレベルで実行されるため、プーリングを有効にするには、グローバルデータソースを設定する必要があります。

次の例は、MySQL データベース接続の ​**\[Pooling profile (プーリングプロファイル)\]**​ パラメーターを設定する方法を示しています。

1. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Advanced (詳細)\]**​ タブの ​**\[Pooling profile (プーリングプロファイル)\]**​ で ​**\[Edit inline (インライン編集)\]**​ を選択します。
2. **\[Max pool size (最大プールサイズ)\]**​ を ​`5`​、​**\[Min pool size (最小プールサイズ)\]**​ を ​`0`​、​**\[Acquire increment (取得増分)\]**​ を ​`1`​、​**\[Prepared statement cache size (プリペアードステートメントのキャッシュサイズ)\]**​ を ​`5`​、​**\[Max wait (最大待機)\]**​ を ​`0`​、​**\[Max wait unit (最大待機単位)\]**​ を ​`SECONDS (Default)`​、​**\[Max idle time (最大アイドル時間)\]**​ を ​`0`​ に設定します。
3. **\[Additional properties (追加プロパティ)\]**​ パラメーターを有効にします。  
    以前に設定されたメインプロパティはこの追加プロパティによって上書きされません。
4. (​**+**​) プラス記号をクリックして、新規プロパティを追加します。
5. **\[Additional property (追加プロパティ)\]**​ ウィンドウで ​**\[Key (キー)\]**​ を ​`checkoutTimeout`​、​**\[Value (値)\]**​ を ​`1000`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。
6. 新規プロパティを追加するには、​**\[Key (キー)\]**​ を ​`idleConnectionTestPeriod`​、​**\[Value (値)\]**​ を ​`2`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![プーリングプロファイルの設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-pooling-configuration.png)

Figure 9. プーリングプロファイルの設定

データベースには ​`<db:pooling-profile>`​ 要素などの特別なプーリング属性があるため、XML エディターでは、設定で標準の Mule ​`<pooling-profile>`​ 要素ではなく ​`preparedStatementCacheSize`​ 要素を使用します。

```xml
<db:config name="Database_Config">
    <db:my-sql-connection database="mozart_test" host="${host}" password="${password}" port="${port}" user="${user}">
        <db:pooling-profile acquireIncrement="1" maxPoolSize="5" maxWait="0" maxWaitUnit="SECONDS" minPoolSize="0" preparedStatementCacheSize="5"/>
        <db:additional-properties>
            <db:additional-property key="checkoutTimeout" value="1000"/>
            <db:additional-property key="idleConnectionTestPeriod" value="2" />
        </db:additional-properties>
    </db:my-sql-connection>
</db:config>
```

## [](#tns-名を使用した-oracle-接続の設定)TNS 名を使用した Oracle 接続の設定

次の例は、​`tnsnames.ora`​ ファイルを使用する Oracle データベースに接続する ​**\[Generic Connection (汎用接続)\]**​ を設定する方法を示しています。 ファイアウォールで Mule Runtime Engine をデータベースから分離している場合、TNS 接続で ​`ENABLE=BROKEN`​ パラメーターを使用してキープアライブ接続を有効にします。 キープアライブ接続を設定しない場合、非アクティブタイマーの期限切れにより接続のトラフィックがドロップする可能性があります。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. 接続の ​**\[URL\]**​ を ​`jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port}))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))`​ に設定します。
7. **\[Driver class name (ドライバークラス名)\]**​ を ​`oracle.jdbc.driver.OracleDriver`​ に設定します。
8. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
9. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![TNS 設定を使用した Oracle](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-oracle-tns.png)

Figure 10. TNS 設定を使用した Oracle

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="oracle.jdbc.driver.OracleDriver"
    url="jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port}))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))` and *Driver class name* to `oracle.jdbc.driver.OracleDriver"/>
</db:config>
```

## [](#関連情報)関連情報

- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.8/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=3e5c4e72f79e9f47e0b4335eeb8d64a020431f823cf7599b51d0e3ee45d2fe29 url=/mulesoft/current/ja-jp/db-connector/1.9/database-connector-connection.md -->

# データベース接続の設定

データベース用 Anypoint Connector (Database Connector) は、JDBC ドライバーを使用できるあらゆるデータベースに接続できます。次の例は、最も一般的なデータベース (Derby、Microsoft SQL Server、MySQL、Oracle、汎用データベースなど) に接続する方法を示しています。また、高度なユースケースとして、Anypoint Studio と XML エディターの両方で、グローバルデータソースへの接続、JDBC ドライバーの設定、接続プーリングの設定、TNS を使用した Oracle データベースへの接続を行う方法も示しています。

## [](#データソース参照接続の設定)データソース参照接続の設定

Database Connector では、​**\[Generic Connection (汎用接続)\]**​ 項目の設定時に指定したパラメーター値を使用して、JDBC データソースを生成します。独自のデータソースを作成し、そのデータソースを使用してデータベースに接続する場合は、​**\[Data Source Reference Connection (データソース参照接続)\]**​ 項目を設定します。

次の例は、Anypoint Studio を使用して Derby データベースへのデータソース参照接続を設定する方法を示しています。

1. Studio の ​`src/main/resources`​ フォルダーで、Derby データベースに接続するカスタム ​`enhydra`​ データソースを定義する ​`datasource-config.xml`​ bean ファイルを作成します。
    
    datasource-config.xml ファイル
    
    ```xml
    <bean id="jdbcDataSource" class="org.enhydra.jdbc.standard.StandardDataSource"
     destroy-method="shutdown">
       <property name="driverName" value="org.apache.derby.jdbc.EmbeddedDriver"/>
       <property name="url" value="jdbc:derby:muleEmbeddedDB;create=true"/>
    </bean>
    ```
2. Mule フローに戻り、​**\[Global Elements (グローバル要素)\]**​ ビューに移動して、​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`spring`​」と入力し、​**\[Spring Config (Spring 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Spring Config (Spring 設定)\]**​ ウィンドウの ​**\[Files (ファイル)\]**​ 項目で、Spring Module を使用して Spring 設定ファイルを参照する ​`datasource-config.xml`​ を追加します。
5. **\[OK\]**​ をクリックします。

次のスクリーンショットはこの設定を示しています。

![Spring 設定データソース](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-spring-configuration.png)

Figure 1. Spring 設定データソース

1. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ウィンドウを開きます。
2. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
3. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Data Source Reference Connection (データソース参照接続)\]**​ を選択します。
4. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
5. **\[Data source ref (データソース参照)\]**​ で、​`datasource-config.xml`​ bean ファイルに作成された bean ID ​`jdbcDataSource`​ を追加します。
6. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
7. **\[OK\]**​ をクリックします。

次のスクリーンショットはこの設定を示しています。

![データソース参照接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-datasource-connection.png)

Figure 2. データソース参照接続

XML エディターでは、Spring 設定とデータベース設定は次のように記述されます。

```xml
<spring:config name="datasource" files="datasource-config.xml" />

<db:config name="Database_Config">
   <db:data-source-connection dataSourceRef="jdbcDataSource" />
</db:config>
```

## [](#derby-接続の設定)Derby 接続の設定

Derby データベースに接続する場合は、​**\[Derby Connection (Derby 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Derby Connection (Derby 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Derby JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Database (データベース)\]**​ を ​`derbyDB`​、​**\[Subsub protocol (Subsub プロトコル)\]**​ を ​`directory`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Derby 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-derby-connection.png)

Figure 3. Derby 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config" >
		<db:derby-connection database="derbyDB" />
	</db:config>
```

## [](#汎用接続の設定)汎用接続の設定

次のデータベースに接続する場合は、​**\[Generic Connection (汎用接続)\]**​ 項目種別を使用します。

- MuleSoft で特定の接続種別が提供されていないデータベース
- サポートされるデータベースであるが、使用するカスタムオプションが接続種別に含まれない

次の例は、Anypoint Studio で H2 データベースに接続する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[URL\]**​ を ​`jdbc:h2:file:/tmp/datasenseDBand`​、​**\[Driver class name (ドライバークラス名)\]**​ を ​`org.h2.Driver`​ に設定します。
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
8. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![汎用接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-generic-connection.png)

Figure 4. 汎用接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="org.h2.Driver"
    url="jdbc:h2:file:/tmp/datasenseDB"/>
</db:config>
```

## [](#microsoft-sql-server-接続の設定)Microsoft SQL Server 接続の設定

Microsoft SQL Server データベースに接続する場合は、​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Microsoft SQL Server Connection (Microsoft SQL Server 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Microsoft SQL Server ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`553`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database name (データベース名)\]**​ を ​`microsoftDB`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Microsoft SQL Server 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-mssql-connection.png)

Figure 5. Microsoft SQL Server 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:mssql-connection
    host="0.0.0.0"
    port="553"
    user="Max"
    password="password"
    databaseName="microsoftDB" />
</db:config>
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

MySQL データベースに接続する場合は、​**\[MySQL Connection (MySQL 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`0.0.0.0`​、​**\[Port (ポート)\]**​ を ​`3306`​、​**\[User (ユーザー)\]**​ を ​`Max`​、​**\[Password (パスワード)\]**​ を ​`password`​、​**\[Database (データベース)\]**​ を ​`someSchema`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![MySQL 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-mysql-connection.png)

Figure 6. MySQL 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:my-sql-connection
  host="0.0.0.0"
  port="3306"
  user="Max"
  password="POWERS"
  database="mysqlDB"/>
</db:config>
```

## [](#oracle-接続の設定)Oracle 接続の設定

Oracle データベースに接続する場合は、​**\[Oracle Connection (Oracle 接続)\]**​ 項目種別を使用します。

次の例は、Anypoint Studio で接続を設定する方法を示しています。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. **\[Host (ホスト)\]**​ を ​`192.168.99.100`​、​**\[Port (ポート)\]**​ を ​`1521`​、​**\[User (ユーザー)\]**​ を ​`system`​、​**\[Password (パスワード)\]**​ を ​`oracle`​、​**\[Instance (インスタンス)\]**​ を ​`xe`​ に設定します。
7. **\[Transactions (トランザクション)\]**​ タブで、必要に応じて、データベースに接続するときのトランザクション分離 (XA トランザクション) を指定します。
8. **\[Advanced (詳細)\]**​ タブで、必要に応じて接続プーリングおよび再接続情報 (再接続戦略を含む) を指定します。
9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
10. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![Oracle 接続のグローバル設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-oracle-connection.png)

Figure 7. Oracle 接続の設定

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
  <db:oracle-connection
  host="192.168.99.100"
  port="1521" instance="xe"
  user="system"
  password="oracle" />
</db:config>
```

## [](#jdbc-ドライバーの設定)JDBC ドライバーの設定

接続を設定したら、JDBC ドライバーを追加できます。次の例は、MySQL データベースのドライバーを追加する方法を示しています。

1. Studio で、次のいずれかのオプションを使用してドライバーを追加できます。
    
    - **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Configure (設定)\]**​ をクリックし、​**\[Add Maven dependency (Maven 連動関係を追加)\]**​ を選択して、連動関係を選択します。
        
        ![Maven 連動関係の選択](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-dependency.png)
        
        Figure 8. Maven 連動関係の選択
    - 連動関係をプロジェクトの ​`pom.xml`​ ファイルに直接追加します。
        
        ```xml
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.48</version>
        </dependency>
        ```
2. Mule でドライバーの連動関係を Database Connector に公開するように ​`pom.xml`​ ファイルを設定します。
    
    ```xml
    <build>
        <plugins>
            <!-- Only used to declare the shared libraries-->
            <plugin>
                <groupId>org.mule.tools.maven</groupId>
                <artifactId>mule-maven-plugin</artifactId>
                <version>1.0.0</version>
                <configuration>
                    <sharedLibraries>
                        <sharedLibrary>
                            <groupId>mysql</groupId>
                            <artifactId>mysql-connector-java</artifactId>
                        </sharedLibrary>
                    </sharedLibraries>
                </configuration>
            </plugin>
        </plugins>
    </build>
    ```

## [](#接続プールの設定)接続プールの設定

接続の確立には、コネクタ、リレーショナルデータベース管理システム (RDBMS) ネットワーク、および処理オーバーヘッドの点でコストがかかります。Database Connector では ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目がサポートされており、この項目を使用して、いくつかの接続を提供する接続プールをビルドできます。

**\[Data Source Reference Connection (データソース参照接続)\]**​ 以外のすべての接続種別設定で ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目設定が受け入れられます。JDBC では、プーリングはデータソースレベルで実行されるため、プーリングを有効にするには、グローバルデータソースを設定する必要があります。

次の例は、MySQL データベース接続の ​**\[Pooling profile (プーリングプロファイル)\]**​ 項目を設定する方法を示しています。

1. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Advanced (詳細)\]**​ タブの ​**\[Pooling profile (プーリングプロファイル)\]**​ で ​**\[Edit inline (インライン編集)\]**​ を選択します。
2. **\[Max pool size (最大プールサイズ)\]**​ を ​`5`​、​**\[Min pool size (最小プールサイズ)\]**​ を ​`0`​、​**\[Acquire increment (取得増分)\]**​ を ​`1`​、​**\[Prepared statement cache size (プリペアードステートメントのキャッシュサイズ)\]**​ を ​`5`​、​**\[Max wait (最大待機)\]**​ を ​`0`​、​**\[Max wait unit (最大待機単位)\]**​ を ​`SECONDS (Default)`​、​**\[Max idle time (最大アイドル時間)\]**​ を ​`0`​ に設定します。
3. **\[Additional properties (追加プロパティ)\]**​ パラメーターを有効にします。  
    以前に設定されたメインプロパティはこの追加プロパティによって上書きされません。
4. (​**+**​) プラス記号をクリックして、新規プロパティを追加します。
5. **\[Additional property (追加プロパティ)\]**​ ウィンドウで ​**\[Key (キー)\]**​ を ​`checkoutTimeout`​、​**\[Value (値)\]**​ を ​`1000`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。
6. 新規プロパティを追加するには、​**\[Key (キー)\]**​ を ​`idleConnectionTestPeriod`​、​**\[Value (値)\]**​ を ​`2`​ に設定し、​**\[Finish (完了)\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![「Pooling Profile (プーリングプロファイル)」 項目の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-pooling-configuration.png)

Figure 9. プーリングプロファイルの設定

データベースには ​`<db:pooling-profile>`​ 要素などの特別なプーリング属性があるため、XML エディターでは、設定で標準の Mule ​`<pooling-profile>`​ 要素ではなく ​`preparedStatementCacheSize`​ 要素を使用します。

```xml
<db:config name="Database_Config">
    <db:my-sql-connection database="mozart_test" host="${host}" password="${password}" port="${port}" user="${user}">
        <db:pooling-profile acquireIncrement="1" maxPoolSize="5" maxWait="0" maxWaitUnit="SECONDS" minPoolSize="0" preparedStatementCacheSize="5"/>
        <db:additional-properties>
            <db:additional-property key="checkoutTimeout" value="1000"/>
            <db:additional-property key="idleConnectionTestPeriod" value="2" />
        </db:additional-properties>
    </db:my-sql-connection>
</db:config>
```

## [](#tns-名を使用した-oracle-接続の設定)TNS 名を使用した Oracle 接続の設定

次の例は、​`tnsnames.ora`​ ファイルを使用する Oracle データベースに接続する ​**\[Generic Connection (汎用接続)\]**​ 項目を設定する方法を示しています。 ファイアウォールで Mule Runtime Engine をデータベースから分離している場合、TNS 接続で ​`ENABLE=BROKEN`​ パラメーターを使用してキープアライブ接続を有効にします。 キープアライブ接続を設定しない場合、非アクティブタイマーの期限切れにより接続のトラフィックがドロップする可能性があります。

1. Studio で、​**\[Global Elements (グローバル要素)\]**​ ビューに移動します。
2. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウの ​**\[Connection (接続)\]**​ 項目で ​**\[Generic Connection (汎用接続)\]**​ を選択します。
5. **\[Configure (設定)\]**​ をクリックし、必要な JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
6. 接続の ​**\[URL\]**​ を ​`jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port}))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))`​ に設定します。
7. **\[Driver class name (ドライバークラス名)\]**​ を ​`oracle.jdbc.driver.OracleDriver`​ に設定します。
8. **\[Test Connection (接続をテスト)\]**​ をクリックして、データベースとの接続を検証します。
9. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio の設定を示しています。

![TNS 設定を使用した Oracle データベース](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-oracle-tns.png)

Figure 10. TNS 設定を使用した Oracle

XML エディターでは、この設定は次のように記述されます。

```xml
<db:config name="Database_Config">
    <db:generic-connection driverClassName="oracle.jdbc.driver.OracleDriver"
    url="jdbc:oracle:thin:${oracle.user}/${oracle.password}@(DESCRIPTION=(ENABLE=BROKEN)(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host1})(PORT=${oracle.port}))(ADDRESS=(PROTOCOL=TCP)(HOST=${oracle.host2})(PORT=${oracle.port}))(CONNECT_DATA=(SERVICE_NAME=${oracle.service})))` and *Driver class name* to `oracle.jdbc.driver.OracleDriver"/>
</db:config>
```

## [](#関連情報)関連情報

- [Database Connector リファレンス](https://docs.mulesoft.com/jp/db-connector/1.9/database-documentation)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=e24494d28713c8307129a8a3e53e901d82c8c751c3ac6032e93960861cb392b8 url=/mulesoft/current/ja-jp/db-connector/1.13/database-insert-large-clob.md -->

# テーブルへの大きなファイルコンテンツの挿入の例

データベース用 Anypoint Connector (Database Connector) の ​**Insert**​ 操作では、テーブルへのキャラクターラージオブジェクト (CLOB) の挿入がサポートされます。次の例は、大きなファイルのコンテンツを読み取って、そのコンテンツの型をサポートするテーブルにコンテンツを挿入する方法を示しています。

この例を実行するには、次の操作が必要です。  

- テーブルを作成する
- Mule アプリケーションを作成する
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストする

![Studio キャンバスでの Mule アプリケーションフローの例](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-insert-large-clobs.png)

## [](#テーブルの作成)テーブルの作成

任意の SQL クライアントツールを使用して、次の SQL ステートメントを含む ​`.sql`​ スクリプトを実行してテーブルを作成します。

```sql
CREATE TABLE AWESOMECLOBDATA(
    id INT AUTO_INCREMENT PRIMARY KEY,
    clob_data CLOB
);
```

## [](#mule-アプリケーションの作成)Mule アプリケーションの作成

次の手順に従って Mule アプリケーションを作成します。

1. Studio で HTTP の ​**\[Listener\]**​ ソースをキャンバスにドラッグします。
2. HTTP グローバル接続を設定するために、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックします。
3. HTTP グローバル接続を設定して、​**\[OK\]**​ をクリックします。
4. **\[Path (パス)\]**​ を ​`/read-insert`​ に設定します。
5. **\[Logger\]**​ コンポーネントを \[HTTP\] の ​**\[Listener\]**​ ソースの右にドラッグします。
6. **\[Message (メッセージ)\]**​ を ​`Starting LARGE CLOB reading`​ に設定します。
7. File Connector の ​**\[Read\]**​ 操作を ​**\[Logger\]**​ コンポーネントの右にドラッグします。
8. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
9. ファイルを適切に読み取るために ​**\[Working Directory (作業ディレクトリ)\]**​ を ​`/dir/containing/file/`​ に設定します。
10. **\[OK\]**​ をクリックします。
11. **\[File Path (ファイルパス)\]**​ を ​`awesomeFile.json`​ に設定します。
12. **\[MIME Type (MIME タイプ)\]**​ タブで ​**\[MIME Type (MIME タイプ)\]**​ を ​`application/octet-stream`​ に設定します。
13. 別の ​**\[Logger\]**​ コンポーネントを ​**\[Read\]**​ 操作の右にドラッグします。
14. **\[Display Name (表示名)\]**​ を ​`LARGE CLOB’s content on flow`​ と設定します。
15. Database Connector の ​**\[Insert\]**​ 操作を 2 番目の ​**\[Logger\]**​ コンポーネントの右にドラッグします。
16. データベースグローバル接続を設定するために、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックします。
17. データベース接続を設定して、​**\[OK\]**​ をクリックします。
18. **\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`INSERT INTO AWESOMECLOBDATA (clob_data) VALUES (:payload)`​ に設定します。  
    SQL テキストでは、ファイルのコンテンツを含む新しいレコードをテーブルに挿入します。
19. **\[Input Parameters (入力パラメーター)\]**​ を式に設定します。

```none
{
	payload: payload
}
```

1. 別の ​**\[Logger\]**​ コンポーネントを ​**\[Insert\]**​ 操作の右にドラッグします。
2. **\[Display Name (表示名)\]**​ を ​`LARGE CLOB’s content inserted`​ と設定します。
3. **\[Message (メッセージ)\]**​ を式 ​`payload`​ に設定します。
4. Mule アプリケーションを保存して実行します。
5. ターミナルで curl コマンド「​`curl localhost:8081/read-insert`​」を使用して、アプリケーションをテストします。

### [](#アプリケーションの-mime-タイプ)アプリケーションの MIME タイプ

`application/octet-stream`​ MIME タイプでは、ファイルのコンテンツがバイナリ形式に変換されるため、​**Read**​ 操作から ​**Insert**​ 操作にデータを適切に流すことができます。

たとえば、​`text/plain`​ MIME タイプを使用した場合、メモリ不足 (OOM) エラーが発生する可能性があります。これは、​**Insert**​ 操作の ​**\[Input Parameters (入力パラメーター)\]**​ 項目で定義された DataWeave ブロックで、データを操作自体に配布する前に、ファイルからのデータストリーム全体をテキストに変換する操作が試行されるために発生する可能性があります。

`application/json`​ MIME タイプを使用することもできます。ただし、ペイロードを参照するには、​**Insert**​ 操作で ​`payload.^raw`​ を使用します。

## [](#mule-アプリケーションの-xml)Mule アプリケーションの XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/file http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">
	<http:listener-config name="HTTP_Listener_config"  >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<file:config name="File_Config" >
		<file:connection workingDir="/dir/containing/file/" />
	</file:config>

	<db:config name="dbConfig"  >
		<db:oracle-connection host="127.0.0.1" user="sys as sysdba" password="password" serviceName="orcl"/>
	</db:config>

	<flow name="read-insert-large-clob-file"  >
		<http:listener doc:name="/read-insert"  config-ref="HTTP_Listener_config" path="/read-insert" />

		<logger level="INFO" message="Starting LARGE CLOB reading" />

		<file:read config-ref="File_Config" path='awesomeFile.json' outputMimeType="application/octet-stream" />

		<logger level="INFO" doc:name="LARGE CLOB's content on flow" />

		<db:insert doc:name="Insert LARGE CLOB" config-ref="dbConfig">
			      <db:sql><![CDATA[INSERT INTO AWESOMECLOBDATA (clob_data) VALUES (:payload)]]></db:sql>
					<db:input-parameters><![CDATA[#[{
	payload: payload
}]]]></db:input-parameters>
		        </db:insert>

		<logger level="INFO" message="#[payload]" />
	</flow>
</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [File Connector](https://docs.mulesoft.com/file-connector/1.3/)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=fb658fbe2ad5b78ca61003be55d37efaabe6122c877f0e1ba55280c99f4a6142 url=/mulesoft/current/ja-jp/db-connector/1.14/database-insert-large-clob.md -->

# テーブルへの大きなファイルコンテンツの挿入の例

データベース用 Anypoint Connector (Database Connector) の ​**Insert**​ 操作では、テーブルへのキャラクターラージオブジェクト (CLOB) の挿入がサポートされます。次の例は、大きなファイルのコンテンツを読み取って、そのコンテンツの型をサポートするテーブルにコンテンツを挿入する方法を示しています。

この例を実行するには、次の操作が必要です。  

- テーブルを作成する
- Mule アプリケーションを作成する
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストする

![Studio キャンバスでの Mule アプリケーションフローの例](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-insert-large-clobs.png)

## [](#テーブルの作成)テーブルの作成

任意の SQL クライアントツールを使用して、次の SQL ステートメントを含む ​`.sql`​ スクリプトを実行してテーブルを作成します。

```sql
CREATE TABLE AWESOMECLOBDATA(
    id INT AUTO_INCREMENT PRIMARY KEY,
    clob_data CLOB
);
```

## [](#mule-アプリケーションの作成)Mule アプリケーションの作成

次の手順に従って Mule アプリケーションを作成します。

1. Studio で HTTP の ​**\[Listener\]**​ ソースをキャンバスにドラッグします。
2. HTTP グローバル接続を設定するために、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックします。
3. HTTP グローバル接続を設定して、​**\[OK\]**​ をクリックします。
4. **\[Path (パス)\]**​ を ​`/read-insert`​ に設定します。
5. **\[Logger\]**​ コンポーネントを \[HTTP\] の ​**\[Listener\]**​ ソースの右にドラッグします。
6. **\[Message (メッセージ)\]**​ を ​`Starting LARGE CLOB reading`​ に設定します。
7. File Connector の ​**\[Read\]**​ 操作を ​**\[Logger\]**​ コンポーネントの右にドラッグします。
8. 操作の設定画面の ​**\[General (一般)\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックし、グローバル要素設定項目にアクセスします。
9. ファイルを適切に読み取るために ​**\[Working Directory (作業ディレクトリ)\]**​ を ​`/dir/containing/file/`​ に設定します。
10. **\[OK\]**​ をクリックします。
11. **\[File Path (ファイルパス)\]**​ を ​`awesomeFile.json`​ に設定します。
12. **\[MIME Type (MIME タイプ)\]**​ タブで ​**\[MIME Type (MIME タイプ)\]**​ を ​`application/octet-stream`​ に設定します。
13. 別の ​**\[Logger\]**​ コンポーネントを ​**\[Read\]**​ 操作の右にドラッグします。
14. **\[Display Name (表示名)\]**​ を ​`LARGE CLOB’s content on flow`​ と設定します。
15. Database Connector の ​**\[Insert\]**​ 操作を 2 番目の ​**\[Logger\]**​ コンポーネントの右にドラッグします。
16. データベースグローバル接続を設定するために、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (​**+**​) をクリックします。
17. データベース接続を設定して、​**\[OK\]**​ をクリックします。
18. **\[SQL Query Text (SQL クエリテキスト)\]**​ を ​`INSERT INTO AWESOMECLOBDATA (clob_data) VALUES (:payload)`​ に設定します。  
    SQL テキストでは、ファイルのコンテンツを含む新しいレコードをテーブルに挿入します。
19. **\[Input Parameters (入力パラメーター)\]**​ を式に設定します。

```none
{
	payload: payload
}
```

1. 別の ​**\[Logger\]**​ コンポーネントを ​**\[Insert\]**​ 操作の右にドラッグします。
2. **\[Display Name (表示名)\]**​ を ​`LARGE CLOB’s content inserted`​ と設定します。
3. **\[Message (メッセージ)\]**​ を式 ​`payload`​ に設定します。
4. Mule アプリケーションを保存して実行します。
5. ターミナルで curl コマンド「​`curl localhost:8081/read-insert`​」を使用して、アプリケーションをテストします。

### [](#アプリケーションの-mime-タイプ)アプリケーションの MIME タイプ

`application/octet-stream`​ MIME タイプでは、ファイルのコンテンツがバイナリ形式に変換されるため、​**Read**​ 操作から ​**Insert**​ 操作にデータを適切に流すことができます。

たとえば、​`text/plain`​ MIME タイプを使用した場合、メモリ不足 (OOM) エラーが発生する可能性があります。これは、​**Insert**​ 操作の ​**\[Input Parameters (入力パラメーター)\]**​ 項目で定義された DataWeave ブロックで、データを操作自体に配布する前に、ファイルからのデータストリーム全体をテキストに変換する操作が試行されるために発生する可能性があります。

`application/json`​ MIME タイプを使用することもできます。ただし、ペイロードを参照するには、​**Insert**​ 操作で ​`payload.^raw`​ を使用します。

## [](#mule-アプリケーションの-xml)Mule アプリケーションの XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/file http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">
	<http:listener-config name="HTTP_Listener_config"  >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<file:config name="File_Config" >
		<file:connection workingDir="/dir/containing/file/" />
	</file:config>

	<db:config name="dbConfig"  >
		<db:oracle-connection host="127.0.0.1" user="sys as sysdba" password="password" serviceName="orcl"/>
	</db:config>

	<flow name="read-insert-large-clob-file"  >
		<http:listener doc:name="/read-insert"  config-ref="HTTP_Listener_config" path="/read-insert" />

		<logger level="INFO" message="Starting LARGE CLOB reading" />

		<file:read config-ref="File_Config" path='awesomeFile.json' outputMimeType="application/octet-stream" />

		<logger level="INFO" doc:name="LARGE CLOB's content on flow" />

		<db:insert doc:name="Insert LARGE CLOB" config-ref="dbConfig">
			      <db:sql><![CDATA[INSERT INTO AWESOMECLOBDATA (clob_data) VALUES (:payload)]]></db:sql>
					<db:input-parameters><![CDATA[#[{
	payload: payload
}]]]></db:input-parameters>
		        </db:insert>

		<logger level="INFO" message="#[payload]" />
	</flow>
</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [File Connector](https://docs.mulesoft.com/file-connector/1.3/)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=d93e12d551e87a3de31f13abc51901c350471a9046824d376197a677ebf16db4 url=/mulesoft/current/ja-jp/db-connector/1.10/database-connector-udt-stored-procedure.md -->

# ユーザー定義型 (UDT) を使用する Oracle ストアドプロシージャーのコールの例

Oracle では、​_ユーザー定義型 (UDT)_​ と呼ばれるカスタムデータ型を作成できます。次の例は、Oracle データベースの UDT を使用するストアドプロシージャーをコールする、データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作を Mule アプリケーション内で設定する方法を示しています。  
このストアドプロシージャーでは次の 2 つのアクションを実行します。  

- 100 歳未満の個人の名、姓、年齢、電話番号をテーブルに挿入する
- テーブルに追加されているすべての個人の電話番号のリストを返す

この例を実行するには、次の操作が必要です。  

- UDT、テーブル、およびストアドプロシージャーを作成するスクリプトを実行する
- Oracle データベース接続を設定する
- Mule アプリケーションを作成する
- `createStruct`​ および ​`createArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップする
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストする

![Studio での Oracle UDT のフロー](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-oracle-udt-flow.png)

Figure 1. UDT を使用する Oracle ストアドプロシージャーのフロー

## [](#udtテーブルおよびストアドプロシージャーの作成)UDT、テーブル、およびストアドプロシージャーの作成

Oracle データベース接続を設定して Mule アプリケーションを作成する前に、任意の SQL クライアントツールを使用して、データベースに次の UDT を作成する ​`.sql`​ スクリプトを実行します。

1. `PEOPLE`
2. `PERSON`
3. `PHONE_NUMBER`
4. `PHONE_NUMBER_ARRAY`
5. `PHONE_BOOK`

一部の UDT には別の UDT が含まれるため、UDT を定義する順序が重要になります。たとえば、オブジェクト型 ​`PERSON`​ は、そのメンバーの ​`PHONE_NUMBER_ARRAY`​ を定義する前に定義する必要があります。

このスクリプトでは、​`HUMANS`​ というテーブルと、​`PROC_INSERT_HUMANS`​ というストアドプロシージャーも作成されます。このストアドプロシージャーの目的は、入力パラメーターとして型 ​`PEOPLE`​ のオブジェクトを受け取って、そのオブジェクトから 100 歳未満の個人を取得してテーブル ​`HUMANS`​ に挿入することです。また、このストアドプロシージャーでは、​`HUMANS`​ テーブルにすでに挿入されているすべての個人の電話番号のリストで構成される型 ​`PHONE_BOOK`​ の出力パラメーターも定義されています。

この UDT、テーブル、およびストアドプロシージャーを作成するために実行するスクリプトは次のとおりです。

```xml
--CREATE CUSTOM DATA TYPES (UDTs)
CREATE OR REPLACE TYPE PHONE_NUMBER AS object(areaCode VARCHAR2(10), phoneNumber VARCHAR2(20));
CREATE OR REPLACE TYPE PHONE_NUMBER_ARRAY AS VARRAY(10) OF PHONE_NUMBER;
CREATE OR REPLACE TYPE PERSON IS OBJECT(firstName VARCHAR(50), surname VARCHAR(50), age NUMBER, phoneNumbers PHONE_NUMBER_ARRAY);
CREATE OR REPLACE TYPE PEOPLE IS TABLE OF PERSON;

CREATE OR REPLACE TYPE PHONE_BOOK AS VARRAY(10) OF VARCHAR2(200);


--CREATE TABLE HUMANS;
CREATE TABLE HUMANS(
  firstName VARCHAR(50),
  surname VARCHAR(50),
  age NUMBER,
  phoneNumbers PHONE_NUMBER_ARRAY
);

--CREATE STORED PROCEDURE
create or replace procedure PROC_INSERT_HUMANS(people IN PEOPLE, contactList OUT PHONE_BOOK) IS
    phoneBook PHONE_BOOK := PHONE_BOOK();
    BEGIN
        FOR idx IN people.first .. people.last LOOP
            IF people(idx).age < 100 THEN
                INSERT INTO HUMANS(firstName, surname, age, phoneNumbers)
                VALUES(people(idx).firstName, people(idx).surname, people(idx).age, people(idx).phoneNumbers);
            END IF;
        END LOOP;

        FOR humanContact IN (SELECT * FROM  HUMANS h, TABLE(h.phoneNumbers) n) LOOP
            phoneBook.EXTEND(1);
            phoneBook(phoneBook.COUNT) := humanContact.surname || ',' || humanContact.firstname || ':' || humanContact.areaCode ||'-'|| humanContact.phoneNumber;
        END LOOP;

        contactList := phonebook;

        COMMIT;
END PROC_INSERT_HUMANS;
```

## [](#oracle-データベース接続の設定)Oracle データベース接続の設定

Oracle データベース内で UDT、テーブル、ストアドプロシージャーを作成したら、Anypoint Studio に移動して Oracle データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次のパラメーターを設定します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次のパラメーターを設定します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `1521`
    - **User (ユーザー)**​: `SYS as SYSDBA`
    - **Password (パスワード)**​: `Oradoc_db1`
    - **Instance (インスタンス)**​: `ORCLCDB`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Column types (列の型)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. プラス記号 ​**(+)**​ をクリックして、新しい列の型を追加し、すでに作成されているすべての UDT をリストします。
10. 次の値を ​**\[Id\]**​ および ​**\[Type name (型名)\]**​ 項目に指定します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Id</th>
<th class="tableblock halign-left valign-top">型名</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PEOPLE</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_NUMBER</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2008</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PERSON</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_ARRAY</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_BOOK</code></p>
</div></div></td>
</tr>
</tbody>
</table>
11. **\[Finish (完了)\]**​ をクリックして、​**\[Column Type (列の型)\]**​ ウィンドウを閉じます。
12. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
13. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio での HTTP リスナーのグローバル要素設定を示しています。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-oracleudt-example-1.png)

Figure 2. HTTP リスナーの設定

次のスクリーンショットは、Studio でのデータベースのグローバル要素設定を示しています。

![\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースのグローバル要素設定。](_images/database-oracleudt-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

![「Column types (列の型)」 項目を設定するデータベースのグローバル要素詳細設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-oracleudt-example-3.png)

Figure 4. \[Database Config (データベース設定)\] の \[Advanced (詳細)\] 設定

## [](#mule-アプリケーションの作成実行テスト)Mule アプリケーションの作成、実行、テスト

Oracle データベース接続を設定したら、Mule アプリケーションを作成、実行、およびテストして、ストアドプロシージャーをコールします。

### [](#http-リスナーと-set-payload-コンポーネントの設定)HTTP リスナーと Set Payload コンポーネントの設定

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/oracle`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ の右にドラッグします。  
    このコンポーネントでは、処理のためにストアドプロシージャーに送信する項目のリストを作成します。
5. **\[Value (値)\]**​ 項目で、リストする項目を指定します。  
    
    ```xml
    [{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
    	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
    	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
    	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
    	]
    ```
6. **\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/java`​ に設定します。

![Set payload コンポーネントの設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-oracleudt-example-4.png)

Figure 5. Set Payload の設定

### [](#dataweave-関数を使用した-transform-message-コンポーネントの設定)DataWeave 関数を使用した Transform Message コンポーネントの設定

**Transform Message**​ コンポーネントと、アプリケーションデータをカスタムユーザーデータ型の例にマップする ​`createStruct`​ および ​`createArray`​ DataWeave 関数を使用して、Mule アプリケーションの作成を継続します。

1. **\[Transform Message\]**​ コンポーネントを ​**\[Set Payload\]**​ の右にドラッグします。  
    このコンポーネントでは、ストアドプロシージャーで入力パラメーターとして想定されているデータ型 ​`PEOPLE`​ にマップできるオブジェクトに JSON オブジェクトが変換されます。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - Prepare UDT`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで ​**\[Edit Current Target (現在の対象を編集)\]**​ ボタンをクリックします。
4. **\[Selection dialog (選択ダイアログ)\]**​ ボックスで ​**\[Output (出力)\]**​ 項目を ​`Variable`​、​**\[Variable name (変数名)\]**​ を ​`in_people_tab`​ に設定し、​**\[OK\]**​ をクリックします。
5. **\[Output (出力)\]**​ 項目で、​`createStruct`​ および ​`createArray`​ 関数が含まれる次の DataWeave 式を指定します。
    
    ```DataWeave
    %dw 2.0
    output application/java
    
    fun toPhoneNumberArray(phoneNumber) = Db::createArray("dbConfig", "PHONE_NUMBER_ARRAY",[Db::createStruct("dbConfig", "PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
    fun toPerson(person) = Db::createStruct("dbConfig", "PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
    ---
    Db::createArray("dbConfig", "PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
    ```
    
    ![Transform Message の設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-oracleudt-example-6.png)
    
    Figure 6. Transform Message の設定

`createStruct`​ 関数では、​`Name`​ 型および対応するプロパティに基づいて JDBC 構造オブジェクトが作成されます。この例では、型 ​`PERSON`​ と ​`PHONE_NUMBER`​ が構造オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `configName`  
    `Struct`​ 型を作成する設定の名前を含む文字列 (この例では ​`dbConfig`​)
- `typeName`  
    作成する ​`Struct`​ 型の名前を含む文字列 (この例では ​`PERSON`​ または ​`PHONE_NUMBER`​)
- `values`  
    `Struct`​ プロパティに準拠する値の配列 (この例では ​`PHONE_NUMBER`​、​`['046', '666']`​)

`createArray`​ 関数では、​`Array`​ 型に基づいて JDBC 配列オブジェクトが作成されます。この例では、型 ​`PHONE_NUMBER_ARRAY`​、​`PEOPLE`​、および ​`PHONE_BOOK`​ が配列オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `configName`  
    `Array`​ 型を作成する設定の名前を含む文字列 (この例では ​`dbConfig`​)
- `typeName`  
    作成する ​`Array`​ 型の名前を含む文字列 (この例では ​`PEOPLE`​ または ​`PHONE_NUMBER_ARRAY`​)
- `values`  
    `Array`​ 型に準拠する値の配列 (この例では ​`createStruct`​ 関数を使用して作成された ​`PERSON`​ オブジェクトの配列)

これらの関数を組み合わせて使用して、サブタイプまたはネストされた型を作成できます。この例では、型 ​`PERSON`​ に ​`PHONE_NUMBER_ARRAY`​ オブジェクトが含まれます。同時に型 ​`PHONE_NUMBER_ARRAY`​ が ​`PHONE_NUMBER`​ の配列として定義されます。

また、​`Array`​ 型に基づいて UDT に一致させるときに ​`createArray`​ 関数を使用する場合、複合型に合わせてこれらの関数を組み合わせることができます。

### [](#stored-procedure-操作の設定)Stored Procedure 操作の設定

Database Connector の ​**Stored Procedure**​ 操作を使用して、UDT を使用する Oracle ストアドプロシージャーをコールします。

1. **\[Stored procedure\]**​ 操作を ​**\[Transform Message\]**​ の右にドラッグします。  
    この操作では、Database Connector を使用してストアドプロシージャーがコールされます。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`dbConfig`​ グローバル設定を選択します。
3. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に「​`{ call proc_insert_humans(:people, :phoneBook) }`​」と入力します。
4. **\[Input Parameters (入力パラメーター)\]**​ 項目に「​`{ people: vars.in_people_tab}`​」と入力します  
    このステップでは、​`in_people_tab`​ という変数に保存された変換の出力が入力パラメーターにマップされます。
5. **\[Output Parameters (出力パラメーター)\]**​ 項目で ​`Edit inline`​ を選択し、プラス記号 (​**+**​) をクリックしてカスタムパラメーターを設定します。
    
    - **Key (キー)**​: `phoneBook`
    - **Custom type (カスタム型)**​: `PHONE_BOOK`

![ストアドプロシージャーの設定](/mulesoft/current/ja-jp/db-connector/1.10/_images/database-oracleudt-example-5.png)

Figure 7. ストアドプロシージャーの設定

1. 2 つ目の ​**\[Transform Message\]**​ コンポーネントを ​**\[Stored Procedure\]**​ の右にドラッグします。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - response to JSON`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで、次の DataWeave 式を設定します。

```DataWeave
%dw 2.0
output application/json
---
payload
```

### [](#mule-アプリケーションの実行およびテスト)Mule アプリケーションの実行およびテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. ターミナルで curl コマンド「​`curl localhost:8081/oracle`​」を使用して、アプリケーションをテストします。  
    このストアドプロシージャーでは、テーブル ​`HUMANS`​ に追加されているすべての個人の電話番号のリストが返されます。

## [](#udt-を使用する-oracle-ストアドプロシージャーをコールするための-xml)UDT を使用する Oracle ストアドプロシージャーをコールするための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">

	<http:listener-config name="HTTP_Listener_config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="dbConfig" >
		<db:oracle-connection host="localhost" user="SYS as SYSDBA" password="Oradoc_db1" instance="ORCLCDB">
			<db:column-types>
				<db:column-type id="2003" typeName="PEOPLE"/>
				<db:column-type id="2003" typeName="PHONE_NUMBER"/>
				<db:column-type id="2008" typeName="PERSON" />
				<db:column-type id="2003" typeName="PHONE_NUMBER_ARRAY"/>
				<db:column-type id="2003" typeName="PHONE_BOOK"/>
			</db:column-types>
		</db:oracle-connection>
	</db:config>

	<flow name="oracle-udtsFlow" >
		<http:listener config-ref="HTTP_Listener_config" path="/oracle"/>

		<set-payload value="#[[{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
	]]" mimeType="application/java"/>


	<ee:transform doc:name="Transform Message - Prepare UDT">
			<ee:variables>
				<ee:set-variable variableName="in_people_tab"><![CDATA[%dw 2.0
				output application/java
				fun toPhoneNumberArray(phoneNumber) = Db::createArray("dbConfig", "PHONE_NUMBER_ARRAY",[Db::createStruct("dbConfig", "PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
				fun toPerson(person) = Db::createStruct("dbConfig", "PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
				---
				Db::createArray("dbConfig", "PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
				]]></ee:set-variable>
			</ee:variables>
		</ee:transform>
		<db:stored-procedure config-ref="dbConfig">
			<db:sql><![CDATA[{ call proc_insert_humans(:people, :phoneBook) }]]></db:sql>
			<db:input-parameters><![CDATA[{
				people: vars.in_people_tab
			}]]></db:input-parameters>
			<db:output-parameters >
				<db:output-parameter key="phoneBook" customType="PHONE_BOOK" />
			</db:output-parameters>
		</db:stored-procedure>
		<ee:transform doc:name="Transform Message - response to JSON" >
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
					output application/json
					---
					payload]]></ee:set-payload>
			</ee:message>
		</ee:transform>
	</flow>

</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.10/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=1324698375157da241afeb3815a8541645af0f12da01c6fe5fc4d59569d9bd7a url=/mulesoft/current/ja-jp/db-connector/1.12/database-connector-udt-stored-procedure.md -->

# ユーザー定義型 (UDT) を使用する Oracle ストアドプロシージャーのコールの例

Oracle では、​_ユーザー定義型 (UDT)_​ と呼ばれるカスタムデータ型を作成できます。次の例は、Oracle データベースの UDT を使用するストアドプロシージャーをコールする、データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作を Mule アプリケーション内で設定する方法を示しています。  
このストアドプロシージャーでは次の 2 つのアクションを実行します。  

- 100 歳未満の個人の名、姓、年齢、電話番号をテーブルに挿入する
- テーブルに追加されているすべての個人の電話番号のリストを返す

この例を実行するには、次の操作が必要です。  

- UDT、テーブル、およびストアドプロシージャーを作成するスクリプトを実行する
- Oracle データベース接続を設定する
- Mule アプリケーションを作成する
- `createStruct`​ および ​`createArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップする
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストする

![Studio での Oracle UDT のフロー](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-oracle-udt-flow.png)

Figure 1. UDT を使用する Oracle ストアドプロシージャーのフロー

## [](#udtテーブルおよびストアドプロシージャーの作成)UDT、テーブル、およびストアドプロシージャーの作成

Oracle データベース接続を設定して Mule アプリケーションを作成する前に、任意の SQL クライアントツールを使用して、データベースに次の UDT を作成する ​`.sql`​ スクリプトを実行します。

1. `PEOPLE`
2. `PERSON`
3. `PHONE_NUMBER`
4. `PHONE_NUMBER_ARRAY`
5. `PHONE_BOOK`

一部の UDT には別の UDT が含まれるため、UDT を定義する順序が重要になります。たとえば、オブジェクト型 ​`PERSON`​ は、そのメンバーの ​`PHONE_NUMBER_ARRAY`​ を定義する前に定義する必要があります。

このスクリプトでは、​`HUMANS`​ というテーブルと、​`PROC_INSERT_HUMANS`​ というストアドプロシージャーも作成されます。このストアドプロシージャーの目的は、入力パラメーターとして型 ​`PEOPLE`​ のオブジェクトを受け取って、そのオブジェクトから 100 歳未満の個人を取得してテーブル ​`HUMANS`​ に挿入することです。また、このストアドプロシージャーでは、​`HUMANS`​ テーブルにすでに挿入されているすべての個人の電話番号のリストで構成される型 ​`PHONE_BOOK`​ の出力パラメーターも定義されています。

この UDT、テーブル、およびストアドプロシージャーを作成するために実行するスクリプトは次のとおりです。

```xml
--CREATE CUSTOM DATA TYPES (UDTs)
CREATE OR REPLACE TYPE PHONE_NUMBER AS object(areaCode VARCHAR2(10), phoneNumber VARCHAR2(20));
CREATE OR REPLACE TYPE PHONE_NUMBER_ARRAY AS VARRAY(10) OF PHONE_NUMBER;
CREATE OR REPLACE TYPE PERSON IS OBJECT(firstName VARCHAR(50), surname VARCHAR(50), age NUMBER, phoneNumbers PHONE_NUMBER_ARRAY);
CREATE OR REPLACE TYPE PEOPLE IS TABLE OF PERSON;

CREATE OR REPLACE TYPE PHONE_BOOK AS VARRAY(10) OF VARCHAR2(200);


--CREATE TABLE HUMANS;
CREATE TABLE HUMANS(
  firstName VARCHAR(50),
  surname VARCHAR(50),
  age NUMBER,
  phoneNumbers PHONE_NUMBER_ARRAY
);

--CREATE STORED PROCEDURE
create or replace procedure PROC_INSERT_HUMANS(people IN PEOPLE, contactList OUT PHONE_BOOK) IS
    phoneBook PHONE_BOOK := PHONE_BOOK();
    BEGIN
        FOR idx IN people.first .. people.last LOOP
            IF people(idx).age < 100 THEN
                INSERT INTO HUMANS(firstName, surname, age, phoneNumbers)
                VALUES(people(idx).firstName, people(idx).surname, people(idx).age, people(idx).phoneNumbers);
            END IF;
        END LOOP;

        FOR humanContact IN (SELECT * FROM  HUMANS h, TABLE(h.phoneNumbers) n) LOOP
            phoneBook.EXTEND(1);
            phoneBook(phoneBook.COUNT) := humanContact.surname || ',' || humanContact.firstname || ':' || humanContact.areaCode ||'-'|| humanContact.phoneNumber;
        END LOOP;

        contactList := phonebook;

        COMMIT;
END PROC_INSERT_HUMANS;
```

## [](#oracle-データベース接続の設定)Oracle データベース接続の設定

Oracle データベース内で UDT、テーブル、ストアドプロシージャーを作成したら、Anypoint Studio に移動して Oracle データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次のパラメーターを設定します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次のパラメーターを設定します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `1521`
    - **User (ユーザー)**​: `SYS as SYSDBA`
    - **Password (パスワード)**​: `Oradoc_db1`
    - **Instance (インスタンス)**​: `ORCLCDB`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Column types (列の型)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. プラス記号 ​**(+)**​ をクリックして、新しい列の型を追加し、すでに作成されているすべての UDT をリストします。
10. 次の値を ​**\[Id\]**​ および ​**\[Type name (型名)\]**​ 項目に指定します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Id</th>
<th class="tableblock halign-left valign-top">型名</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PEOPLE</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_NUMBER</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2008</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PERSON</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_ARRAY</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_BOOK</code></p>
</div></div></td>
</tr>
</tbody>
</table>
11. **\[Finish (完了)\]**​ をクリックして、​**\[Column Type (列の型)\]**​ ウィンドウを閉じます。
12. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
13. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio での HTTP リスナーのグローバル要素設定を示しています。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-oracleudt-example-1.png)

Figure 2. HTTP リスナー設定

次のスクリーンショットは、Studio でのデータベースのグローバル要素設定を示しています。

![\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースのグローバル要素設定。](_images/database-oracleudt-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

![「Column types (列の型)」 項目を設定するデータベースのグローバル要素詳細設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-oracleudt-example-3.png)

Figure 4. \[Database Config (データベース設定)\] の \[Advanced (詳細)\] 設定

## [](#mule-アプリケーションの作成実行テスト)Mule アプリケーションの作成、実行、テスト

Oracle データベース接続を設定したら、Mule アプリケーションを作成、実行、およびテストして、ストアドプロシージャーをコールします。

### [](#http-リスナーと-set-payload-コンポーネントの設定)HTTP リスナーと Set Payload コンポーネントの設定

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/oracle`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ の右にドラッグします。  
    このコンポーネントでは、処理のためにストアドプロシージャーに送信する項目のリストを作成します。
5. **\[Value (値)\]**​ 項目で、リストする項目を指定します。  
    
    ```xml
    [{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
    	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
    	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
    	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
    	]
    ```
6. **\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/java`​ に設定します。

![Set payload コンポーネントの設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-oracleudt-example-4.png)

Figure 5. Set Payload の設定

### [](#dataweave-関数を使用した-transform-message-コンポーネントの設定)DataWeave 関数を使用した Transform Message コンポーネントの設定

**Transform Message**​ コンポーネントと、アプリケーションデータをカスタムユーザーデータ型の例にマップする ​`createStruct`​ および ​`createArray`​ DataWeave 関数を使用して、Mule アプリケーションの作成を継続します。

1. **\[Transform Message\]**​ コンポーネントを ​**\[Set Payload\]**​ の右にドラッグします。  
    このコンポーネントでは、ストアドプロシージャーで入力パラメーターとして想定されているデータ型 ​`PEOPLE`​ にマップできるオブジェクトに JSON オブジェクトが変換されます。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - Prepare UDT`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで ​**\[Edit Current Target (現在の対象を編集)\]**​ ボタンをクリックします。
4. **\[Selection dialog (選択ダイアログ)\]**​ ボックスで ​**\[Output (出力)\]**​ 項目を ​`Variable`​、​**\[Variable name (変数名)\]**​ を ​`in_people_tab`​ に設定し、​**\[OK\]**​ をクリックします。
5. **\[Output (出力)\]**​ 項目で、​`createStruct`​ および ​`createArray`​ 関数が含まれる次の DataWeave 式を指定します。
    
    ```DataWeave
    %dw 2.0
    output application/java
    
    fun toPhoneNumberArray(phoneNumber) = Db::createArray("dbConfig", "PHONE_NUMBER_ARRAY",[Db::createStruct("dbConfig", "PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
    fun toPerson(person) = Db::createStruct("dbConfig", "PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
    ---
    Db::createArray("dbConfig", "PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
    ```
    
    ![Transform Message の設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-oracleudt-example-6.png)
    
    Figure 6. Transform Message の設定

`createStruct`​ 関数では、​`Name`​ 型および対応するプロパティに基づいて JDBC 構造オブジェクトが作成されます。この例では、型 ​`PERSON`​ と ​`PHONE_NUMBER`​ が構造オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `configName`  
    `Struct`​ 型を作成する設定の名前を含む文字列 (この例では ​`dbConfig`​)
- `typeName`  
    作成する ​`Struct`​ 型の名前を含む文字列 (この例では ​`PERSON`​ または ​`PHONE_NUMBER`​)
- `values`  
    `Struct`​ プロパティに準拠する値の配列 (この例では ​`PHONE_NUMBER`​、​`['046', '666']`​)

`createArray`​ 関数では、​`Array`​ 型に基づいて JDBC 配列オブジェクトが作成されます。この例では、型 ​`PHONE_NUMBER_ARRAY`​、​`PEOPLE`​、および ​`PHONE_BOOK`​ が配列オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `configName`  
    `Array`​ 型を作成する設定の名前を含む文字列 (この例では ​`dbConfig`​)
- `typeName`  
    作成する ​`Array`​ 型の名前を含む文字列 (この例では ​`PEOPLE`​ または ​`PHONE_NUMBER_ARRAY`​)
- `values`  
    `Array`​ 型に準拠する値の配列 (この例では ​`createStruct`​ 関数を使用して作成された ​`PERSON`​ オブジェクトの配列)

これらの関数を組み合わせて使用して、サブタイプまたはネストされた型を作成できます。この例では、型 ​`PERSON`​ に ​`PHONE_NUMBER_ARRAY`​ オブジェクトが含まれます。同時に型 ​`PHONE_NUMBER_ARRAY`​ が ​`PHONE_NUMBER`​ の配列として定義されます。

また、​`Array`​ 型に基づいて UDT に一致させるときに ​`createArray`​ 関数を使用する場合、複合型に合わせてこれらの関数を組み合わせることができます。

### [](#stored-procedure-操作の設定)Stored Procedure 操作の設定

Database Connector の ​**Stored Procedure**​ 操作を使用して、UDT を使用する Oracle ストアドプロシージャーをコールします。

1. **\[Stored procedure\]**​ 操作を ​**\[Transform Message\]**​ の右にドラッグします。  
    この操作では、Database Connector を使用してストアドプロシージャーがコールされます。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`dbConfig`​ グローバル設定を選択します。
3. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に「​`{ call proc_insert_humans(:people, :phoneBook) }`​」と入力します。
4. **\[Input Parameters (入力パラメーター)\]**​ 項目に「​`{ people: vars.in_people_tab}`​」と入力します  
    このステップでは、​`in_people_tab`​ という変数に保存された変換の出力が入力パラメーターにマップされます。
5. **\[Output Parameters (出力パラメーター)\]**​ 項目で ​`Edit inline`​ を選択し、プラス記号 (​**+**​) をクリックしてカスタムパラメーターを設定します。
    
    - **Key (キー)**​: `phoneBook`
    - **Custom type (カスタム型)**​: `PHONE_BOOK`

![ストアドプロシージャーの設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-oracleudt-example-5.png)

Figure 7. ストアドプロシージャーの設定

1. 2 つ目の ​**\[Transform Message\]**​ コンポーネントを ​**\[Stored Procedure\]**​ の右にドラッグします。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - response to JSON`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで、次の DataWeave 式を設定します。

```DataWeave
%dw 2.0
output application/json
---
payload
```

### [](#mule-アプリケーションの実行とテスト)Mule アプリケーションの実行とテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. ターミナルで curl コマンド「​`curl localhost:8081/oracle`​」を使用して、アプリケーションをテストします。  
    このストアドプロシージャーでは、テーブル ​`HUMANS`​ に追加されているすべての個人の電話番号のリストが返されます。

## [](#udt-を使用する-oracle-ストアドプロシージャーをコールするための-xml)UDT を使用する Oracle ストアドプロシージャーをコールするための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">

	<http:listener-config name="HTTP_Listener_config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="dbConfig" >
		<db:oracle-connection host="localhost" user="SYS as SYSDBA" password="Oradoc_db1" instance="ORCLCDB">
			<db:column-types>
				<db:column-type id="2003" typeName="PEOPLE"/>
				<db:column-type id="2003" typeName="PHONE_NUMBER"/>
				<db:column-type id="2008" typeName="PERSON" />
				<db:column-type id="2003" typeName="PHONE_NUMBER_ARRAY"/>
				<db:column-type id="2003" typeName="PHONE_BOOK"/>
			</db:column-types>
		</db:oracle-connection>
	</db:config>

	<flow name="oracle-udtsFlow" >
		<http:listener config-ref="HTTP_Listener_config" path="/oracle"/>

		<set-payload value="#[[{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
	]]" mimeType="application/java"/>


	<ee:transform doc:name="Transform Message - Prepare UDT">
			<ee:variables>
				<ee:set-variable variableName="in_people_tab"><![CDATA[%dw 2.0
				output application/java
				fun toPhoneNumberArray(phoneNumber) = Db::createArray("dbConfig", "PHONE_NUMBER_ARRAY",[Db::createStruct("dbConfig", "PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
				fun toPerson(person) = Db::createStruct("dbConfig", "PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
				---
				Db::createArray("dbConfig", "PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
				]]></ee:set-variable>
			</ee:variables>
		</ee:transform>
		<db:stored-procedure config-ref="dbConfig">
			<db:sql><![CDATA[{ call proc_insert_humans(:people, :phoneBook) }]]></db:sql>
			<db:input-parameters><![CDATA[{
				people: vars.in_people_tab
			}]]></db:input-parameters>
			<db:output-parameters >
				<db:output-parameter key="phoneBook" customType="PHONE_BOOK" />
			</db:output-parameters>
		</db:stored-procedure>
		<ee:transform doc:name="Transform Message - response to JSON" >
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
					output application/json
					---
					payload]]></ee:set-payload>
			</ee:message>
		</ee:transform>
	</flow>

</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=68a7fccf84795846a4b5851e8a42e6e90213dff4c14b0233b9d3e41a92fe1e8d url=/mulesoft/current/ja-jp/db-connector/1.13/database-connector-udt-stored-procedure.md -->

# ユーザー定義型 (UDT) を使用する Oracle ストアドプロシージャーのコールの例

Oracle では、​_ユーザー定義型 (UDT)_​ と呼ばれるカスタムデータ型を作成できます。次の例は、Oracle データベースの UDT を使用するストアドプロシージャーをコールする、データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作を Mule アプリケーション内で設定する方法を示しています。  
このストアドプロシージャーでは次の 2 つのアクションを実行します。  

- 100 歳未満の個人の名、姓、年齢、電話番号をテーブルに挿入する
- テーブルに追加されているすべての個人の電話番号のリストを返す

この例を実行するには、次の操作が必要です。  

- UDT、テーブル、およびストアドプロシージャーを作成するスクリプトを実行する
- Oracle データベース接続を設定する
- Mule アプリケーションを作成する
- `prepareStruct`​ および ​`prepareArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップする
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストする

![Studio での Oracle UDT のフロー](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-oracle-udt-flow.png)

Figure 1. UDT を使用する Oracle ストアドプロシージャーのフロー

## [](#preparestruct-および-preparearray-関数の使用)prepareStruct および prepareArray 関数の使用

以前の Mule バージョンでは ​`createStruct`​ および ​`createArray`​ 関数が提供されましたが、これらは非推奨になりました。これらの関数では JDBC 値がすぐに作成されましたが、その値は、Database Connector 操作で使用された接続と同じ接続を使用して作成されている必要があります。新しい ​`prepareStruct`​ および ​`prepareArray`​ 関数を使用すると、Database Connector ではこれらの JDBC 値の作成を、適切な SQL 接続が使用可能になるまで遅延することができます。​`createArray`​ および ​`createStruct`​ 関数は、以前は Oracle 接続プロバイダーでのみ動作していました。​`preprareStruct`​ および ​`prepareArray`​ 関数は、汎用接続プロバイダーやデータソース参照接続プロバイダーなどのすべての接続プロバイダーと互換性が確保されるようになり、接続の負荷分散とフォールトトレランス URI を正常に設定できます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">非推奨関数</th>
<th class="tableblock halign-left valign-top">アクティブな関数</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Db::createArray(configName, typeName, values): java.sql.Array</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Db::prepareArray(typeName, values): java.util.List</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Db::createStruct(configName, typeName, properties): java.sql.Struct</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Db::prepareStruct(typeName, properties): java.util.List</code></p></td>
</tr>
</tbody>
</table>

### [](#パラメーター)パラメーター

`Db::prepareArray(typeName, values): java.util.List`​ 関数では、データベースに送信する配列を java.sql.Array として準備します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>typeName</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">作成する Array (配列) 型の名前。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>values</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">List&lt;Object&gt;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースに渡す値。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>java.util.List</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">List&lt;Object&gt;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">戻り値は、後で配列を作成するためのすべての情報を保持する不変リストです。</p></td>
</tr>
</tbody>
</table>

`Db::prepareStruct(typeName, properties): java.util.List`​ 関数では、データベースに送信する構造を java.sql.Struct として準備します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>typeName</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">作成する Struct (構造) 型の名前。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>properties</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">List&lt;Object&gt;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースに渡すプロパティ。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>java.util.List</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">List&lt;Object&gt;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">戻り値は、後で構造を作成するためのすべての情報を保持する不変リストです。</p></td>
</tr>
</tbody>
</table>

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">非推奨関数を使用する既存の Mule アプリケーションがある場合、​<code>createStruct</code>​ を ​<code>prepareStruct</code>​ に置き換えて、​<code>createArray</code>​ を ​<code>prepareArray</code>​ に置き換えます。また、最初のパラメーター ​<code>configName</code>​ を関数構造から削除します。</td></tr></tbody></table>

## [](#udtテーブルおよびストアドプロシージャーの作成)UDT、テーブル、およびストアドプロシージャーの作成

Oracle データベース接続を設定して Mule アプリケーションを作成する前に、任意の SQL クライアントツールを使用して、データベースに次の UDT を作成する ​`.sql`​ スクリプトを実行します。

1. `PEOPLE`
2. `PERSON`
3. `PHONE_NUMBER`
4. `PHONE_NUMBER_ARRAY`
5. `PHONE_BOOK`

一部の UDT には別の UDT が含まれるため、UDT を定義する順序が重要になります。たとえば、オブジェクト型 ​`PERSON`​ は、そのメンバーの ​`PHONE_NUMBER_ARRAY`​ を定義する前に定義する必要があります。

このスクリプトでは、​`HUMANS`​ というテーブルと、​`PROC_INSERT_HUMANS`​ というストアドプロシージャーも作成されます。このストアドプロシージャーの目的は、入力パラメーターとして型 ​`PEOPLE`​ のオブジェクトを受け取って、そのオブジェクトから 100 歳未満の個人を取得してテーブル ​`HUMANS`​ に挿入することです。また、このストアドプロシージャーでは、​`HUMANS`​ テーブルにすでに挿入されているすべての個人の電話番号のリストで構成される型 ​`PHONE_BOOK`​ の出力パラメーターも定義されています。

この UDT、テーブル、およびストアドプロシージャーを作成するために実行するスクリプトは次のとおりです。

```xml
--CREATE CUSTOM DATA TYPES (UDTs)
CREATE OR REPLACE TYPE PHONE_NUMBER AS object(areaCode VARCHAR2(10), phoneNumber VARCHAR2(20));
CREATE OR REPLACE TYPE PHONE_NUMBER_ARRAY AS VARRAY(10) OF PHONE_NUMBER;
CREATE OR REPLACE TYPE PERSON IS OBJECT(firstName VARCHAR(50), surname VARCHAR(50), age NUMBER, phoneNumbers PHONE_NUMBER_ARRAY);
CREATE OR REPLACE TYPE PEOPLE IS TABLE OF PERSON;

CREATE OR REPLACE TYPE PHONE_BOOK AS VARRAY(10) OF VARCHAR2(200);


--CREATE TABLE HUMANS;
CREATE TABLE HUMANS(
  firstName VARCHAR(50),
  surname VARCHAR(50),
  age NUMBER,
  phoneNumbers PHONE_NUMBER_ARRAY
);

--CREATE STORED PROCEDURE
create or replace procedure PROC_INSERT_HUMANS(people IN PEOPLE, contactList OUT PHONE_BOOK) IS
    phoneBook PHONE_BOOK := PHONE_BOOK();
    BEGIN
        FOR idx IN people.first .. people.last LOOP
            IF people(idx).age < 100 THEN
                INSERT INTO HUMANS(firstName, surname, age, phoneNumbers)
                VALUES(people(idx).firstName, people(idx).surname, people(idx).age, people(idx).phoneNumbers);
            END IF;
        END LOOP;

        FOR humanContact IN (SELECT * FROM  HUMANS h, TABLE(h.phoneNumbers) n) LOOP
            phoneBook.EXTEND(1);
            phoneBook(phoneBook.COUNT) := humanContact.surname || ',' || humanContact.firstname || ':' || humanContact.areaCode ||'-'|| humanContact.phoneNumber;
        END LOOP;

        contactList := phonebook;

        COMMIT;
END PROC_INSERT_HUMANS;
```

## [](#oracle-データベース接続の設定)Oracle データベース接続の設定

Oracle データベース内で UDT、テーブル、ストアドプロシージャーを作成したら、Anypoint Studio に移動して Oracle データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次のパラメーターを設定します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次のパラメーターを設定します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `1521`
    - **User (ユーザー)**​: `SYS as SYSDBA`
    - **Password (パスワード)**​: `Oradoc_db1`
    - **Instance (インスタンス)**​: `ORCLCDB`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Column types (列の型)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. プラス記号 ​**(+)**​ をクリックして、新しい列の型を追加し、すでに作成されているすべての UDT をリストします。
10. 次の値を ​**\[Id\]**​ および ​**\[Type name (型名)\]**​ 項目に指定します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Id</th>
<th class="tableblock halign-left valign-top">型名</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PEOPLE</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_NUMBER</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2008</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PERSON</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_ARRAY</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_BOOK</code></p>
</div></div></td>
</tr>
</tbody>
</table>
11. **\[Finish (完了)\]**​ をクリックして、​**\[Column Type (列の型)\]**​ ウィンドウを閉じます。
12. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
13. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio での HTTP リスナーのグローバル要素設定を示しています。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-oracleudt-example-1.png)

Figure 2. HTTP リスナー設定

次のスクリーンショットは、Studio でのデータベースのグローバル要素設定を示しています。

![\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースのグローバル要素設定。](_images/database-oracleudt-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

![「Column types (列の型)」 項目を設定するデータベースのグローバル要素詳細設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-oracleudt-example-3.png)

Figure 4. \[Database Config (データベース設定)\] の \[Advanced (詳細)\] 設定

## [](#mule-アプリケーションの作成実行テスト)Mule アプリケーションの作成、実行、テスト

Oracle データベース接続を設定したら、Mule アプリケーションを作成、実行、およびテストして、ストアドプロシージャーをコールします。

### [](#http-リスナーと-set-payload-コンポーネントの設定)HTTP リスナーと Set Payload コンポーネントの設定

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/oracle`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ の右にドラッグします。  
    このコンポーネントでは、処理のためにストアドプロシージャーに送信する項目のリストを作成します。
5. **\[Value (値)\]**​ 項目で、リストする項目を指定します。  
    
    ```xml
    [{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
    	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
    	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
    	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
    	]
    ```
6. **\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/java`​ に設定します。

![Set payload コンポーネントの設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-oracleudt-example-4.png)

Figure 5. Set Payload の設定

### [](#dataweave-関数を使用した-transform-message-コンポーネントの設定)DataWeave 関数を使用した Transform Message コンポーネントの設定

**Transform Message**​ コンポーネントと、アプリケーションデータをカスタムユーザーデータ型の例にマップする ​`prepareStruct`​ および ​`prepareArray`​ DataWeave 関数を使用して、Mule アプリケーションの作成を継続します。

1. **\[Transform Message\]**​ コンポーネントを ​**\[Set Payload\]**​ の右にドラッグします。  
    このコンポーネントでは、ストアドプロシージャーで入力パラメーターとして想定されているデータ型 ​`PEOPLE`​ にマップできるオブジェクトに JSON オブジェクトが変換されます。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - Prepare UDT`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで ​**\[Edit Current Target (現在の対象を編集)\]**​ ボタンをクリックします。
4. **\[Selection dialog (選択ダイアログ)\]**​ ボックスで ​**\[Output (出力)\]**​ 項目を ​`Variable`​、​**\[Variable name (変数名)\]**​ を ​`in_people_tab`​ に設定し、​**\[OK\]**​ をクリックします。
5. **\[Output (出力)\]**​ 項目で、​`prepareStruct`​ および ​`prepareArray`​ 関数が含まれる次の DataWeave 式を指定します。
    
    ```DataWeave
    %dw 2.0
    output application/java
    
    fun toPhoneNumberArray(phoneNumber) = Db::prepareArray("PHONE_NUMBER_ARRAY",[Db::prepareStruct("PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
    fun toPerson(person) = Db::prepareStruct("PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
    ---
    Db::prepareArray("PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
    ```
    
    ![Transform Message の設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-oracleudt-example-6.png)
    
    Figure 6. Transform Message の設定

`prepareStruct`​ では、データベース操作の実行時に ​`Name`​ 型および対応するプロパティに基づいて JDBC 構造オブジェクトを作成するように Mule に指示します。この例では、型 ​`PERSON`​ と ​`PHONE_NUMBER`​ が構造オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `typeName`  
    作成する ​`Struct`​ 型の名前を含む文字列 (この例では ​`PERSON`​ または ​`PHONE_NUMBER`​)
- `values`  
    `Struct`​ プロパティに準拠する値の配列 (この例では ​`PHONE_NUMBER`​、​`['046', '666']`​)

Mule アプリケーションで Database Connector 操作を実行するときに、​`prepareArray`​ 関数では、​`Array`​ 型に基づいて JDBC 配列オブジェクトを作成するように Mule に指示します。この例では、型 ​`PHONE_NUMBER_ARRAY`​、​`PEOPLE`​、および ​`PHONE_BOOK`​ が配列オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `typeName`  
    作成する ​`Array`​ 型の名前を含む文字列 (この例では ​`PEOPLE`​ または ​`PHONE_NUMBER_ARRAY`​)
- `values`  
    `Array`​ 型に準拠する値の配列 (この例では ​`prepareStruct`​ 関数を使用して作成された、各配列が ​`PERSON`​ オブジェクトを表す配列)

`prepareStruct`​ および ​`prepareArray`​ 関数では、要求された SQL 値を作成するためのすべての情報を保持する特別な配列が返されます。操作時にパラメーターデータが再帰的に分析され、これらの配列が適切な SQL オブジェクトに置き換えられます。

これらの関数を組み合わせて使用して、サブタイプまたはネストされた型を作成できます。この例では、型 ​`PERSON`​ に ​`PHONE_NUMBER_ARRAY`​ オブジェクトが含まれます。同時に型 ​`PHONE_NUMBER_ARRAY`​ が ​`PHONE_NUMBER`​ の配列として定義されます。

また、​`Array`​ 型に基づいて UDT に一致させるときに ​`prepareArray`​ 関数を使用する場合、複合型に合わせてこれらの関数を組み合わせることができます。

### [](#stored-procedure-操作の設定)Stored Procedure 操作の設定

Database Connector の ​**Stored Procedure**​ 操作を使用して、UDT を使用する Oracle ストアドプロシージャーをコールします。

1. **\[Stored procedure\]**​ 操作を ​**\[Transform Message\]**​ の右にドラッグします。  
    この操作では、Database Connector を使用してストアドプロシージャーがコールされます。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`dbConfig`​ グローバル設定を選択します。
3. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に「​`{ call proc_insert_humans(:people, :phoneBook) }`​」と入力します。
4. **\[Input Parameters (入力パラメーター)\]**​ 項目に「​`{ people: vars.in_people_tab}`​」と入力します  
    このステップでは、​`in_people_tab`​ という変数に保存された変換の出力が入力パラメーターにマップされます。
5. **\[Output Parameters (出力パラメーター)\]**​ 項目で ​`Edit inline`​ を選択し、プラス記号 (​**+**​) をクリックしてカスタムパラメーターを設定します。
    
    - **Key (キー)**​: `phoneBook`
    - **Custom type (カスタム型)**​: `PHONE_BOOK`

![ストアドプロシージャーの設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-oracleudt-example-5.png)

Figure 7. ストアドプロシージャーの設定

1. 2 つ目の ​**\[Transform Message\]**​ コンポーネントを ​**\[Stored Procedure\]**​ の右にドラッグします。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - response to JSON`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで、次の DataWeave 式を設定します。

```DataWeave
%dw 2.0
output application/json
---
payload
```

### [](#mule-アプリケーションの実行およびテスト)Mule アプリケーションの実行およびテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. ターミナルで curl コマンド「​`curl localhost:8081/oracle`​」を使用して、アプリケーションをテストします。  
    このストアドプロシージャーでは、テーブル ​`HUMANS`​ に追加されているすべての個人の電話番号のリストが返されます。

## [](#udt-を使用する-oracle-ストアドプロシージャーをコールするための-xml)UDT を使用する Oracle ストアドプロシージャーをコールするための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">

	<http:listener-config name="HTTP_Listener_config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="dbConfig" >
		<db:oracle-connection host="localhost" user="SYS as SYSDBA" password="Oradoc_db1" instance="ORCLCDB">
			<db:column-types>
				<db:column-type id="2003" typeName="PEOPLE"/>
				<db:column-type id="2003" typeName="PHONE_NUMBER"/>
				<db:column-type id="2008" typeName="PERSON" />
				<db:column-type id="2003" typeName="PHONE_NUMBER_ARRAY"/>
				<db:column-type id="2003" typeName="PHONE_BOOK"/>
			</db:column-types>
		</db:oracle-connection>
	</db:config>

	<flow name="oracle-udtsFlow" >
		<http:listener config-ref="HTTP_Listener_config" path="/oracle"/>

		<set-payload value="#[[{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
	]]" mimeType="application/java"/>


	<ee:transform doc:name="Transform Message - Prepare UDT">
			<ee:variables>
				<ee:set-variable variableName="in_people_tab"><![CDATA[%dw 2.0
				output application/java
				fun toPhoneNumberArray(phoneNumber) = Db::prepareArray("PHONE_NUMBER_ARRAY",[Db::prepareStruct("PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
				fun toPerson(person) = Db::prepareStruct("PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
				---
				Db::prepareArray("PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
				]]></ee:set-variable>
			</ee:variables>
		</ee:transform>
		<db:stored-procedure config-ref="dbConfig">
			<db:sql><![CDATA[{ call proc_insert_humans(:people, :phoneBook) }]]></db:sql>
			<db:input-parameters><![CDATA[{
				people: vars.in_people_tab
			}]]></db:input-parameters>
			<db:output-parameters >
				<db:output-parameter key="phoneBook" customType="PHONE_BOOK" />
			</db:output-parameters>
		</db:stored-procedure>
		<ee:transform doc:name="Transform Message - response to JSON" >
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
					output application/json
					---
					payload]]></ee:set-payload>
			</ee:message>
		</ee:transform>
	</flow>

</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=a61687cb012ccb745dd76580fff774b41736d7344d70b0f1d62df4b547244628 url=/mulesoft/current/ja-jp/db-connector/1.14/database-connector-udt-stored-procedure.md -->

# ユーザー定義型 (UDT) を使用する Oracle ストアドプロシージャーのコールの例

Oracle では、​_ユーザー定義型 (UDT)_​ と呼ばれるカスタムデータ型を作成できます。次の例は、Oracle データベースの UDT を使用するストアドプロシージャーをコールする、データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作を Mule アプリケーション内で設定する方法を示しています。  
このストアドプロシージャーでは次の 2 つのアクションを実行します。  

- 100 歳未満の個人の名、姓、年齢、電話番号をテーブルに挿入する
- テーブルに追加されているすべての個人の電話番号のリストを返す

この例を実行するには、次の操作が必要です。  

- UDT、テーブル、およびストアドプロシージャーを作成するスクリプトを実行する
- Oracle データベース接続を設定する
- Mule アプリケーションを作成する
- `prepareStruct`​ および ​`prepareArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップする
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストする

![Studio での Oracle UDT のフロー](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-oracle-udt-flow.png)

Figure 1. UDT を使用する Oracle ストアドプロシージャーのフロー

## [](#using-preparestruct-and-preparearray-functions)prepareStruct および prepareArray 関数の使用

以前の Mule バージョンでは ​`createStruct`​ および ​`createArray`​ 関数が提供されましたが、これらは非推奨になりました。これらの関数では JDBC 値がすぐに作成されましたが、その値は、Database Connector 操作で使用された接続と同じ接続を使用して作成されている必要があります。新しい ​`prepareStruct`​ および ​`prepareArray`​ 関数を使用すると、Database Connector ではこれらの JDBC 値の作成を、適切な SQL 接続が使用可能になるまで遅延することができます。​`createArray`​ および ​`createStruct`​ 関数は、以前は Oracle 接続プロバイダーでのみ動作していました。​`preprareStruct`​ および ​`prepareArray`​ 関数は、汎用接続プロバイダーやデータソース参照接続プロバイダーなどのすべての接続プロバイダーと互換性が確保されるようになり、接続の負荷分散とフォールトトレランス URI を正常に設定できます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">非推奨関数</th>
<th class="tableblock halign-left valign-top">アクティブな関数</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Db::createArray(configName, typeName, values): java.sql.Array</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Db::prepareArray(typeName, values): java.util.List</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Db::createStruct(configName, typeName, properties): java.sql.Struct</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Db::prepareStruct(typeName, properties): java.util.List</code></p></td>
</tr>
</tbody>
</table>

### [](#パラメーター)パラメーター

`Db::prepareArray(typeName, values): java.util.List`​ 関数では、データベースに送信する配列を ​`java.sql.Array`​ として準備します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>typeName</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">作成する Array (配列) 型の名前。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>values</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">List&lt;Object&gt;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースに渡す値。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>java.util.List</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">List&lt;Object&gt;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">戻り値は、後で配列を作成するためのすべての情報を保持する不変リストです。</p></td>
</tr>
</tbody>
</table>

`Db::prepareStruct(typeName, properties): java.util.List`​ 関数では、データベースに送信する​`構造`​を ​`java.sql.Struct`​ として準備します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>typeName</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">作成する Struct (構造) 型の名前。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>properties</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">List&lt;Object&gt;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースに渡すプロパティ。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>java.util.List</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">List&lt;Object&gt;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">戻り値は、後で構造を作成するためのすべての情報を保持する不変リストです。</p></td>
</tr>
</tbody>
</table>

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">非推奨関数を使用する既存の Mule アプリケーションがある場合、​<code>createStruct</code>​ を ​<code>prepareStruct</code>​ に置き換えて、​<code>createArray</code>​ を ​<code>prepareArray</code>​ に置き換えます。また、最初のパラメーター ​<code>configName</code>​ を関数構造から削除します。</td></tr></tbody></table>

## [](#udtテーブルおよびストアドプロシージャーの作成)UDT、テーブル、およびストアドプロシージャーの作成

Oracle データベース接続を設定して Mule アプリケーションを作成する前に、任意の SQL クライアントツールを使用して、データベースに次の UDT を作成する ​`.sql`​ スクリプトを実行します。

1. `PEOPLE`
2. `PERSON`
3. `PHONE_NUMBER`
4. `PHONE_NUMBER_ARRAY`
5. `PHONE_BOOK`

一部の UDT には別の UDT が含まれるため、UDT を定義する順序が重要になります。たとえば、オブジェクト型 ​`PERSON`​ は、そのメンバーの ​`PHONE_NUMBER_ARRAY`​ を定義する前に定義する必要があります。

このスクリプトでは、​`HUMANS`​ というテーブルと、​`PROC_INSERT_HUMANS`​ というストアドプロシージャーも作成されます。このストアドプロシージャーの目的は、入力パラメーターとして型 ​`PEOPLE`​ のオブジェクトを受け取って、そのオブジェクトから 100 歳未満の個人を取得してテーブル ​`HUMANS`​ に挿入することです。また、このストアドプロシージャーでは、​`HUMANS`​ テーブルにすでに挿入されているすべての個人の電話番号のリストで構成される型 ​`PHONE_BOOK`​ の出力パラメーターも定義されています。

この UDT、テーブル、およびストアドプロシージャーを作成するために実行するスクリプトは次のとおりです。

```xml
--CREATE CUSTOM DATA TYPES (UDTs)
CREATE OR REPLACE TYPE PHONE_NUMBER AS object(areaCode VARCHAR2(10), phoneNumber VARCHAR2(20));
CREATE OR REPLACE TYPE PHONE_NUMBER_ARRAY AS VARRAY(10) OF PHONE_NUMBER;
CREATE OR REPLACE TYPE PERSON IS OBJECT(firstName VARCHAR(50), surname VARCHAR(50), age NUMBER, phoneNumbers PHONE_NUMBER_ARRAY);
CREATE OR REPLACE TYPE PEOPLE IS TABLE OF PERSON;

CREATE OR REPLACE TYPE PHONE_BOOK AS VARRAY(10) OF VARCHAR2(200);


--CREATE TABLE HUMANS;
CREATE TABLE HUMANS(
  firstName VARCHAR(50),
  surname VARCHAR(50),
  age NUMBER,
  phoneNumbers PHONE_NUMBER_ARRAY
);

--CREATE STORED PROCEDURE
create or replace procedure PROC_INSERT_HUMANS(people IN PEOPLE, contactList OUT PHONE_BOOK) IS
    phoneBook PHONE_BOOK := PHONE_BOOK();
    BEGIN
        FOR idx IN people.first .. people.last LOOP
            IF people(idx).age < 100 THEN
                INSERT INTO HUMANS(firstName, surname, age, phoneNumbers)
                VALUES(people(idx).firstName, people(idx).surname, people(idx).age, people(idx).phoneNumbers);
            END IF;
        END LOOP;

        FOR humanContact IN (SELECT * FROM  HUMANS h, TABLE(h.phoneNumbers) n) LOOP
            phoneBook.EXTEND(1);
            phoneBook(phoneBook.COUNT) := humanContact.surname || ',' || humanContact.firstname || ':' || humanContact.areaCode ||'-'|| humanContact.phoneNumber;
        END LOOP;

        contactList := phonebook;

        COMMIT;
END PROC_INSERT_HUMANS;
```

## [](#oracle-データベース接続の設定)Oracle データベース接続の設定

Oracle データベース内で UDT、テーブル、ストアドプロシージャーを作成したら、Anypoint Studio に移動して Oracle データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次のパラメーターを設定します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次のパラメーターを設定します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `1521`
    - **User (ユーザー)**​: `SYS as SYSDBA`
    - **Password (パスワード)**​: `Oradoc_db1`
    - **Instance (インスタンス)**​: `ORCLCDB`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Column types (列の型)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. プラス記号 ​**(+)**​ をクリックして、新しい列の型を追加し、すでに作成されているすべての UDT をリストします。
10. 次の値を ​**\[Id\]**​ および ​**\[Type name (型名)\]**​ 項目に指定します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Id</th>
<th class="tableblock halign-left valign-top">型名</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PEOPLE</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_NUMBER</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2008</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PERSON</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_ARRAY</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_BOOK</code></p>
</div></div></td>
</tr>
</tbody>
</table>
11. **\[Finish (完了)\]**​ をクリックして、​**\[Column Type (列の型)\]**​ ウィンドウを閉じます。
12. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
13. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio での HTTP リスナーのグローバル要素設定を示しています。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-oracleudt-example-1.png)

Figure 2. HTTP リスナー設定

次のスクリーンショットは、Studio でのデータベースのグローバル要素設定を示しています。

![「Host (ホスト)」、「Port (ポート)」、「User (ユーザー)」、「Password (パスワード)」項目を設定するデータベースのグローバル要素設定。](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-oracleudt-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

![「Column types (列の型)」 項目を設定するデータベースのグローバル要素詳細設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-oracleudt-example-3.png)

Figure 4. \[Database Config (データベース設定)\] の \[Advanced (詳細)\] 設定

## [](#mule-アプリケーションの作成実行テスト)Mule アプリケーションの作成、実行、テスト

Oracle データベース接続を設定したら、Mule アプリケーションを作成、実行、およびテストして、ストアドプロシージャーをコールします。

### [](#http-リスナーと-set-payload-コンポーネントの設定)HTTP リスナーと Set Payload コンポーネントの設定

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/oracle`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ の右にドラッグします。  
    このコンポーネントでは、処理のためにストアドプロシージャーに送信する項目のリストを作成します。
5. **\[Value (値)\]**​ 項目で、リストする項目を指定します。  
    
    ```xml
    [{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
    	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
    	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
    	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
    	]
    ```
6. **\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/java`​ に設定します。

![Set payload コンポーネントの設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-oracleudt-example-4.png)

Figure 5. Set Payload の設定

### [](#dataweave-関数を使用した-transform-message-コンポーネントの設定)DataWeave 関数を使用した Transform Message コンポーネントの設定

**Transform Message**​ コンポーネントと、アプリケーションデータをカスタムユーザーデータ型の例にマップする ​`prepareStruct`​ および ​`prepareArray`​ DataWeave 関数を使用して、Mule アプリケーションの作成を継続します。

1. **\[Transform Message\]**​ コンポーネントを ​**\[Set Payload\]**​ の右にドラッグします。  
    このコンポーネントでは、ストアドプロシージャーで入力パラメーターとして想定されているデータ型 ​`PEOPLE`​ にマップできるオブジェクトに JSON オブジェクトが変換されます。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - Prepare UDT`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで ​**\[Edit Current Target (現在の対象を編集)\]**​ ボタンをクリックします。
4. **\[Selection dialog (選択ダイアログ)\]**​ ボックスで ​**\[Output (出力)\]**​ 項目を ​`Variable`​、​**\[Variable name (変数名)\]**​ を ​`in_people_tab`​ に設定し、​**\[OK\]**​ をクリックします。
5. **\[Output (出力)\]**​ 項目で、​`prepareStruct`​ および ​`prepareArray`​ 関数が含まれる次の DataWeave 式を指定します。
    
    ```DataWeave
    %dw 2.0
    output application/java
    
    fun toPhoneNumberArray(phoneNumber) = Db::prepareArray("PHONE_NUMBER_ARRAY",[Db::prepareStruct("PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
    fun toPerson(person) = Db::prepareStruct("PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
    ---
    Db::prepareArray("PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
    ```
    
    ![Transform Message の設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-oracleudt-example-6.png)
    
    Figure 6. Transform Message の設定

`prepareStruct`​ では、データベース操作の実行時に ​`Name`​ 型および対応するプロパティに基づいて JDBC 構造オブジェクトを作成するように Mule に指示します。この例では、型 ​`PERSON`​ と ​`PHONE_NUMBER`​ が構造オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `typeName`  
    作成する ​`Struct`​ 型の名前を含む文字列 (この例では ​`PERSON`​ または ​`PHONE_NUMBER`​)
- `values`  
    `Struct`​ プロパティに準拠する値の配列 (この例では ​`PHONE_NUMBER`​、​`['046', '666']`​)

Mule アプリケーションで Database Connector 操作を実行するときに、​`prepareArray`​ 関数では、​`Array`​ 型に基づいて JDBC 配列オブジェクトを作成するように Mule に指示します。この例では、型 ​`PHONE_NUMBER_ARRAY`​、​`PEOPLE`​、および ​`PHONE_BOOK`​ が配列オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `typeName`  
    作成する ​`Array`​ 型の名前を含む文字列 (この例では ​`PEOPLE`​ または ​`PHONE_NUMBER_ARRAY`​)
- `values`  
    `Array`​ 型に準拠する値の配列 (この例では ​`prepareStruct`​ 関数を使用して作成された、各配列が ​`PERSON`​ オブジェクトを表す配列)

`prepareStruct`​ および ​`prepareArray`​ 関数では、要求された SQL 値を作成するためのすべての情報を保持する特別な配列が返されます。操作時にパラメーターデータが再帰的に分析され、これらの配列が適切な SQL オブジェクトに置き換えられます。

これらの関数を組み合わせて使用して、サブタイプまたはネストされた型を作成できます。この例では、型 ​`PERSON`​ に ​`PHONE_NUMBER_ARRAY`​ オブジェクトが含まれます。同時に型 ​`PHONE_NUMBER_ARRAY`​ が ​`PHONE_NUMBER`​ の配列として定義されます。

また、​`Array`​ 型に基づいて UDT に一致させるときに ​`prepareArray`​ 関数を使用する場合、複合型に合わせてこれらの関数を組み合わせることができます。

### [](#stored-procedure-操作の設定)Stored Procedure 操作の設定

Database Connector の ​**Stored Procedure**​ 操作を使用して、UDT を使用する Oracle ストアドプロシージャーをコールします。

1. **\[Stored procedure\]**​ 操作を ​**\[Transform Message\]**​ の右にドラッグします。  
    この操作では、Database Connector を使用してストアドプロシージャーがコールされます。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`dbConfig`​ グローバル設定を選択します。
3. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に「​`{ call proc_insert_humans(:people, :phoneBook) }`​」と入力します。
4. **\[Input Parameters (入力パラメーター)\]**​ 項目に「​`{ people: vars.in_people_tab}`​」と入力します  
    このステップでは、​`in_people_tab`​ という変数に保存された変換の出力が入力パラメーターにマップされます。
5. **\[Output Parameters (出力パラメーター)\]**​ 項目で ​`Edit inline`​ を選択し、プラス記号 (​**+**​) をクリックしてカスタムパラメーターを設定します。
    
    - **Key (キー)**​: `phoneBook`
    - **Custom type (カスタム型)**​: `PHONE_BOOK`

![ストアドプロシージャーの設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-oracleudt-example-5.png)

Figure 7. ストアドプロシージャーの設定

1. 2 つ目の ​**\[Transform Message\]**​ コンポーネントを ​**\[Stored Procedure\]**​ の右にドラッグします。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - response to JSON`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで、次の DataWeave 式を設定します。

```DataWeave
%dw 2.0
output application/json
---
payload
```

### [](#mule-アプリケーションの実行とテスト)Mule アプリケーションの実行とテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. ターミナルで curl コマンド「​`curl localhost:8081/oracle`​」を使用して、アプリケーションをテストします。  
    このストアドプロシージャーでは、テーブル ​`HUMANS`​ に追加されているすべての個人の電話番号のリストが返されます。

## [](#udt-を使用する-oracle-ストアドプロシージャーをコールするための-xml)UDT を使用する Oracle ストアドプロシージャーをコールするための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">

	<http:listener-config name="HTTP_Listener_config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="dbConfig" >
		<db:oracle-connection host="localhost" user="SYS as SYSDBA" password="Oradoc_db1" instance="ORCLCDB">
			<db:column-types>
				<db:column-type id="2003" typeName="PEOPLE"/>
				<db:column-type id="2003" typeName="PHONE_NUMBER"/>
				<db:column-type id="2008" typeName="PERSON" />
				<db:column-type id="2003" typeName="PHONE_NUMBER_ARRAY"/>
				<db:column-type id="2003" typeName="PHONE_BOOK"/>
			</db:column-types>
		</db:oracle-connection>
	</db:config>

	<flow name="oracle-udtsFlow" >
		<http:listener config-ref="HTTP_Listener_config" path="/oracle"/>

		<set-payload value="#[[{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
	]]" mimeType="application/java"/>


	<ee:transform doc:name="Transform Message - Prepare UDT">
			<ee:variables>
				<ee:set-variable variableName="in_people_tab"><![CDATA[%dw 2.0
				output application/java
				fun toPhoneNumberArray(phoneNumber) = Db::prepareArray("PHONE_NUMBER_ARRAY",[Db::prepareStruct("PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
				fun toPerson(person) = Db::prepareStruct("PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
				---
				Db::prepareArray("PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
				]]></ee:set-variable>
			</ee:variables>
		</ee:transform>
		<db:stored-procedure config-ref="dbConfig">
			<db:sql><![CDATA[{ call proc_insert_humans(:people, :phoneBook) }]]></db:sql>
			<db:input-parameters><![CDATA[{
				people: vars.in_people_tab
			}]]></db:input-parameters>
			<db:output-parameters >
				<db:output-parameter key="phoneBook" customType="PHONE_BOOK" />
			</db:output-parameters>
		</db:stored-procedure>
		<ee:transform doc:name="Transform Message - response to JSON" >
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
					output application/json
					---
					payload]]></ee:set-payload>
			</ee:message>
		</ee:transform>
	</flow>

</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=e106bb803a2c83ef6c3ed91382edd2590f57313c85305bfb092d68671413be46 url=/mulesoft/current/ja-jp/db-connector/1.8/database-connector-udt-stored-procedure.md -->

# ユーザー定義型 (UDT) を使用する Oracle ストアドプロシージャーのコールの例

Oracle では、​_ユーザー定義型 (UDT)_​ と呼ばれるカスタムデータ型を作成できます。次の例は、Oracle データベースの UDT を使用するストアドプロシージャーをコールする、データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作を Mule アプリケーション内で設定する方法を示しています。  
このストアドプロシージャーでは次の 2 つのアクションを実行します。  

- 100 歳未満の個人の名、姓、年齢、電話番号をテーブルに挿入する
- テーブルに追加されているすべての個人の電話番号のリストを返す

この例を実行するには、次の操作が必要です。  

- UDT、テーブル、およびストアドプロシージャーを作成するスクリプトを実行する
- Oracle データベース接続を設定する
- Mule アプリケーションを作成する
- `createStruct`​ および ​`createArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップする
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストする

次のスクリーンショットは、この例の Anypoint Studio アプリケーションフローを示しています。

![Anypoint Studio での Oracle UDT のフロー](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-oracle-udt-flow.png)

Figure 1. UDT を使用する Oracle ストアドプロシージャーのフロー

## [](#udtテーブルおよびストアドプロシージャーの作成)UDT、テーブル、およびストアドプロシージャーの作成

Oracle データベース接続を設定して Mule アプリケーションを作成する前に、任意の SQL クライアントツールを使用して、データベースに次の UDT を作成する ​`.sql`​ スクリプトを実行します。

1. `PEOPLE`
2. `PERSON`
3. `PHONE_NUMBER`
4. `PHONE_NUMBER_ARRAY`
5. `PHONE_BOOK`

一部の UDT には別の UDT が含まれるため、UDT を定義する順序が重要になります。たとえば、オブジェクト型 ​`PERSON`​ は、そのメンバーの ​`PHONE_NUMBER_ARRAY`​ を定義する前に定義する必要があります。

このスクリプトでは、​`HUMANS`​ というテーブルと、​`PROC_INSERT_HUMANS`​ というストアドプロシージャーも作成されます。このストアドプロシージャーの目的は、入力パラメーターとして型 ​`PEOPLE`​ のオブジェクトを受け取って、そのオブジェクトから 100 歳未満の個人を取得してテーブル ​`HUMANS`​ に挿入することです。また、このストアドプロシージャーでは、​`HUMANS`​ テーブルにすでに挿入されているすべての個人の電話番号のリストで構成される型 ​`PHONE_BOOK`​ の出力パラメーターも定義されています。

この UDT、テーブル、およびストアドプロシージャーを作成するために実行するスクリプトは次のとおりです。

```xml
--CREATE CUSTOM DATA TYPES (UDTs)
CREATE OR REPLACE TYPE PHONE_NUMBER AS object(areaCode VARCHAR2(10), phoneNumber VARCHAR2(20));
CREATE OR REPLACE TYPE PHONE_NUMBER_ARRAY AS VARRAY(10) OF PHONE_NUMBER;
CREATE OR REPLACE TYPE PERSON IS OBJECT(firstName VARCHAR(50), surname VARCHAR(50), age NUMBER, phoneNumbers PHONE_NUMBER_ARRAY);
CREATE OR REPLACE TYPE PEOPLE IS TABLE OF PERSON;

CREATE OR REPLACE TYPE PHONE_BOOK AS VARRAY(10) OF VARCHAR2(200);


--CREATE TABLE HUMANS;
CREATE TABLE HUMANS(
  firstName VARCHAR(50),
  surname VARCHAR(50),
  age NUMBER,
  phoneNumbers PHONE_NUMBER_ARRAY
);

--CREATE STORED PROCEDURE
create or replace procedure PROC_INSERT_HUMANS(people IN PEOPLE, contactList OUT PHONE_BOOK) IS
    phoneBook PHONE_BOOK := PHONE_BOOK();
    BEGIN
        FOR idx IN people.first .. people.last LOOP
            IF people(idx).age < 100 THEN
                INSERT INTO HUMANS(firstName, surname, age, phoneNumbers)
                VALUES(people(idx).firstName, people(idx).surname, people(idx).age, people(idx).phoneNumbers);
            END IF;
        END LOOP;

        FOR humanContact IN (SELECT * FROM  HUMANS h, TABLE(h.phoneNumbers) n) LOOP
            phoneBook.EXTEND(1);
            phoneBook(phoneBook.COUNT) := humanContact.surname || ',' || humanContact.firstname || ':' || humanContact.areaCode ||'-'|| humanContact.phoneNumber;
        END LOOP;

        contactList := phonebook;

        COMMIT;
END PROC_INSERT_HUMANS;
```

## [](#oracle-データベース接続の設定)Oracle データベース接続の設定

Oracle データベース内で UDT、テーブル、ストアドプロシージャーを作成したら、Anypoint Studio に移動して Oracle データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次のパラメーターを設定します。
    
    - **Protocol (プロトコル)**​  
        `HTTP (デフォルト)`
    - **Host (ホスト)**​  
        `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​  
        `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次のパラメーターを設定します。  
    
    - **Host (ホスト)**​  
        `localhost`
    - **Port (ポート)**​  
        `1521`
    - **User (ユーザー)**​  
        `SYS as SYSDBA`
    - **Password (パスワード)**​  
        `Oradoc_db1`
    - **Instance (インスタンス)**​  
        `ORCLCDB`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Column types (列の型)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. プラス記号 ​**(+)**​ をクリックして、新しい列の型を追加し、すでに作成されているすべての UDT をリストします。
10. 次の値を ​**\[Id\]**​ および ​**\[Type name (型名)\]**​ 項目に指定します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Id</th>
<th class="tableblock halign-left valign-top">型名</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PEOPLE</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_NUMBER</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2008</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PERSON</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_ARRAY</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_BOOK</code></p>
</div></div></td>
</tr>
</tbody>
</table>
11. **\[Finish (完了)\]**​ をクリックして、​**\[Column Type (列の型)\]**​ ウィンドウを閉じます。
12. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
13. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio での HTTP リスナーのグローバル要素設定を示しています。

![HTTP リスナーの設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-oracleudt-example-1.png)

Figure 2. HTTP リスナーの設定

次のスクリーンショットは、Studio でのデータベースのグローバル要素設定を示しています。

![\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\]、\[Instance values (インスタンス値)\] パラメーターを設定する \[Database Config (データベース設定)\] の \[General (一般)\] 設定。](_images/database-oracleudt-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

![「Column types (列の型)」 値を設定する 「Database Config (データベース設定)」 の 「advanced (詳細)」 設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-oracleudt-example-3.png)

Figure 4. \[Database Config (データベース設定)\] の \[Advanced (詳細)\] 設定

## [](#mule-アプリケーションの作成実行テスト)Mule アプリケーションの作成、実行、テスト

Oracle データベース接続を設定したら、Mule アプリケーションを作成、実行、およびテストして、ストアドプロシージャーをコールします。

### [](#http-リスナーと-set-payload-コンポーネントの設定)HTTP リスナーと Set Payload コンポーネントの設定

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/oracle`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ の右にドラッグします。  
    このコンポーネントでは、処理のためにストアドプロシージャーに送信する項目のリストを作成します。
5. **\[Value (値)\]**​ 項目で、リストする項目を指定します。  
    
    ```xml
    [{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
    	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
    	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
    	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
    	]
    ```
6. **\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/java`​ に設定します。

![Set Payload の設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-oracleudt-example-4.png)

Figure 5. Set Payload の設定

### [](#dataweave-関数を使用した-transform-message-コンポーネントの設定)DataWeave 関数を使用した Transform Message コンポーネントの設定

**Transform Message**​ コンポーネントと、アプリケーションデータをカスタムユーザーデータ型の例にマップする ​`createStruct`​ および ​`createArray`​ DataWeave 関数を使用して、Mule アプリケーションの作成を継続します。

1. **\[Transform Message\]**​ コンポーネントを ​**\[Set Payload\]**​ の右にドラッグします。  
    このコンポーネントでは、ストアドプロシージャーで入力パラメーターとして想定されているデータ型 ​`PEOPLE`​ にマップできるオブジェクトに JSON オブジェクトが変換されます。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - Prepare UDT`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで ​**\[Edit Current Target (現在の対象を編集)\]**​ ボタンをクリックします。
4. **\[Selection dialog (選択ダイアログ)\]**​ ボックスで ​**\[Output (出力)\]**​ 項目を ​`Variable`​、​**\[Variable name (変数名)\]**​ を ​`in_people_tab`​ に設定し、​**\[OK\]**​ をクリックします。
5. **\[Output (出力)\]**​ 項目で、​`createStruct`​ および ​`createArray`​ 関数が含まれる次の DataWeave 式を指定します。
    
    ```DataWeave
    %dw 2.0
    output application/java
    
    fun toPhoneNumberArray(phoneNumber) = Db::createArray("dbConfig", "PHONE_NUMBER_ARRAY",[Db::createStruct("dbConfig", "PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
    fun toPerson(person) = Db::createStruct("dbConfig", "PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
    ---
    Db::createArray("dbConfig", "PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
    ```
    
    ![Transform Message の設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-oracleudt-example-6.png)
    
    Figure 6. Transform Message の設定

`createStruct`​ 関数では、​`Name`​ 型および対応するプロパティに基づいて JDBC 構造オブジェクトが作成されます。この例では、型 ​`PERSON`​ と ​`PHONE_NUMBER`​ が構造オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `configName`  
    `Struct`​ 型を作成する設定の名前を含む文字列 (この例では ​`dbConfig`​)
- `typeName`  
    作成する ​`Struct`​ 型の名前を含む文字列 (この例では ​`PERSON`​ または ​`PHONE_NUMBER`​)
- `values`  
    `Struct`​ プロパティに準拠する値の配列 (この例では ​`PHONE_NUMBER`​、​`['046', '666']`​)

`createArray`​ 関数では、​`Array`​ 型に基づいて JDBC 配列オブジェクトが作成されます。この例では、型 ​`PHONE_NUMBER_ARRAY`​、​`PEOPLE`​、および ​`PHONE_BOOK`​ が配列オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `configName`  
    `Array`​ 型を作成する設定の名前を含む文字列 (この例では ​`dbConfig`​)
- `typeName`  
    作成する ​`Array`​ 型の名前を含む文字列 (この例では ​`PEOPLE`​ または ​`PHONE_NUMBER_ARRAY`​)
- `values`  
    `Array`​ 型に準拠する値の配列 (この例では ​`createStruct`​ 関数を使用して作成された ​`PERSON`​ オブジェクトの配列)

これらの関数を組み合わせて使用して、サブタイプまたはネストされた型を作成できます。この例では、型 ​`PERSON`​ に ​`PHONE_NUMBER_ARRAY`​ オブジェクトが含まれます。同時に型 ​`PHONE_NUMBER_ARRAY`​ が ​`PHONE_NUMBER`​ の配列として定義されます。

また、​`Array`​ 型に基づいて UDT に一致させるときに ​`createArray`​ 関数を使用する場合、複合型に合わせてこれらの関数を組み合わせることができます。

### [](#stored-procedure-操作の設定)Stored Procedure 操作の設定

Database Connector の ​**Stored Procedure**​ 操作を使用して、UDT を使用する Oracle ストアドプロシージャーをコールします。

1. **\[Stored procedure\]**​ 操作を ​**\[Transform Message\]**​ の右にドラッグします。  
    この操作では、Database Connector を使用してストアドプロシージャーがコールされます。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`dbConfig`​ グローバル設定を選択します。
3. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に「​`{ call proc_insert_humans(:people, :phoneBook) }`​」と入力します。
4. **\[Input Parameters (入力パラメーター)\]**​ 項目に「​`{ people: vars.in_people_tab}`​」と入力します  
    このステップでは、​`in_people_tab`​ という変数に保存された変換の出力が入力パラメーターにマップされます。
5. **\[Output Parameters (出力パラメーター)\]**​ 項目で ​`Edit inline`​ を選択し、プラス記号 (​**+**​) をクリックしてカスタムパラメーターを設定します。
    
    - **Key (キー)**​  
        `phoneBook`
    - **Custom Type (カスタム型)**​  
        `PHONE_BOOK`

![ストアドプロシージャーの設定](/mulesoft/current/ja-jp/db-connector/1.8/_images/database-oracleudt-example-5.png)

Figure 7. ストアドプロシージャーの設定

1. 2 つ目の ​**\[Transform Message\]**​ コンポーネントを ​**\[Stored Procedure\]**​ の右にドラッグします。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - response to JSON`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで、次の DataWeave 式を設定します。

```DataWeave
%dw 2.0
output application/json
---
payload
```

### [](#mule-アプリケーションを実行およびテストする)Mule アプリケーションを実行およびテストする

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. ターミナルで curl コマンド「​`curl localhost:8081/oracle`​」を使用して、アプリケーションをテストします。  
    このストアドプロシージャーでは、テーブル ​`HUMANS`​ に追加されているすべての個人の電話番号のリストが返されます。

## [](#udt-を使用する-oracle-ストアドプロシージャーをコールするための-xml)UDT を使用する Oracle ストアドプロシージャーをコールするための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">

	<http:listener-config name="HTTP_Listener_config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="dbConfig" >
		<db:oracle-connection host="localhost" user="SYS as SYSDBA" password="Oradoc_db1" instance="ORCLCDB">
			<db:column-types>
				<db:column-type id="2003" typeName="PEOPLE"/>
				<db:column-type id="2003" typeName="PHONE_NUMBER"/>
				<db:column-type id="2008" typeName="PERSON" />
				<db:column-type id="2003" typeName="PHONE_NUMBER_ARRAY"/>
				<db:column-type id="2003" typeName="PHONE_BOOK"/>
			</db:column-types>
		</db:oracle-connection>
	</db:config>

	<flow name="oracle-udtsFlow" >
		<http:listener config-ref="HTTP_Listener_config" path="/oracle"/>

		<set-payload value="#[[{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
	]]" mimeType="application/java"/>


	<ee:transform doc:name="Transform Message - Prepare UDT">
			<ee:variables>
				<ee:set-variable variableName="in_people_tab"><![CDATA[%dw 2.0
				output application/java
				fun toPhoneNumberArray(phoneNumber) = Db::createArray("dbConfig", "PHONE_NUMBER_ARRAY",[Db::createStruct("dbConfig", "PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
				fun toPerson(person) = Db::createStruct("dbConfig", "PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
				---
				Db::createArray("dbConfig", "PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
				]]></ee:set-variable>
			</ee:variables>
		</ee:transform>
		<db:stored-procedure config-ref="dbConfig">
			<db:sql><![CDATA[{ call proc_insert_humans(:people, :phoneBook) }]]></db:sql>
			<db:input-parameters><![CDATA[{
				people: vars.in_people_tab
			}]]></db:input-parameters>
			<db:output-parameters >
				<db:output-parameter key="phoneBook" customType="PHONE_BOOK" />
			</db:output-parameters>
		</db:stored-procedure>
		<ee:transform doc:name="Transform Message - response to JSON" >
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
					output application/json
					---
					payload]]></ee:set-payload>
			</ee:message>
		</ee:transform>
	</flow>

</mule>
```

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=58dc75f4bd29d8eefb2de846180fdee4e931bdd8fe8787a1a161ee92ce2cd04b url=/mulesoft/current/ja-jp/db-connector/1.9/database-connector-udt-stored-procedure.md -->

# ユーザー定義型 (UDT) を使用する Oracle ストアドプロシージャーのコールの例

Oracle では、​_ユーザー定義型 (UDT)_​ と呼ばれるカスタムデータ型を作成できます。次の例は、Oracle データベースの UDT を使用するストアドプロシージャーをコールする、データベース用 Anypoint Connector (Database Connector) の ​**Stored procedure**​ 操作を Mule アプリケーション内で設定する方法を示しています。  
このストアドプロシージャーでは次の 2 つのアクションを実行します。  

- 100 歳未満の個人の名、姓、年齢、電話番号をテーブルに挿入する
- テーブルに追加されているすべての個人の電話番号のリストを返す

この例を実行するには、次の操作が必要です。  

- UDT、テーブル、およびストアドプロシージャーを作成するスクリプトを実行する
- Oracle データベース接続を設定する
- Mule アプリケーションを作成する
- `createStruct`​ および ​`createArray`​ DataWeave 関数を使用してアプリケーションデータをカスタム型にマップする
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストする

![Studio での Oracle UDT のフロー](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-oracle-udt-flow.png)

Figure 1. UDT を使用する Oracle ストアドプロシージャーのフロー

## [](#udtテーブルおよびストアドプロシージャーの作成)UDT、テーブル、およびストアドプロシージャーの作成

Oracle データベース接続を設定して Mule アプリケーションを作成する前に、任意の SQL クライアントツールを使用して、データベースに次の UDT を作成する ​`.sql`​ スクリプトを実行します。

1. `PEOPLE`
2. `PERSON`
3. `PHONE_NUMBER`
4. `PHONE_NUMBER_ARRAY`
5. `PHONE_BOOK`

一部の UDT には別の UDT が含まれるため、UDT を定義する順序が重要になります。たとえば、オブジェクト型 ​`PERSON`​ は、そのメンバーの ​`PHONE_NUMBER_ARRAY`​ を定義する前に定義する必要があります。

このスクリプトでは、​`HUMANS`​ というテーブルと、​`PROC_INSERT_HUMANS`​ というストアドプロシージャーも作成されます。このストアドプロシージャーの目的は、入力パラメーターとして型 ​`PEOPLE`​ のオブジェクトを受け取って、そのオブジェクトから 100 歳未満の個人を取得してテーブル ​`HUMANS`​ に挿入することです。また、このストアドプロシージャーでは、​`HUMANS`​ テーブルにすでに挿入されているすべての個人の電話番号のリストで構成される型 ​`PHONE_BOOK`​ の出力パラメーターも定義されています。

この UDT、テーブル、およびストアドプロシージャーを作成するために実行するスクリプトは次のとおりです。

```xml
--CREATE CUSTOM DATA TYPES (UDTs)
CREATE OR REPLACE TYPE PHONE_NUMBER AS object(areaCode VARCHAR2(10), phoneNumber VARCHAR2(20));
CREATE OR REPLACE TYPE PHONE_NUMBER_ARRAY AS VARRAY(10) OF PHONE_NUMBER;
CREATE OR REPLACE TYPE PERSON IS OBJECT(firstName VARCHAR(50), surname VARCHAR(50), age NUMBER, phoneNumbers PHONE_NUMBER_ARRAY);
CREATE OR REPLACE TYPE PEOPLE IS TABLE OF PERSON;

CREATE OR REPLACE TYPE PHONE_BOOK AS VARRAY(10) OF VARCHAR2(200);


--CREATE TABLE HUMANS;
CREATE TABLE HUMANS(
  firstName VARCHAR(50),
  surname VARCHAR(50),
  age NUMBER,
  phoneNumbers PHONE_NUMBER_ARRAY
);

--CREATE STORED PROCEDURE
create or replace procedure PROC_INSERT_HUMANS(people IN PEOPLE, contactList OUT PHONE_BOOK) IS
    phoneBook PHONE_BOOK := PHONE_BOOK();
    BEGIN
        FOR idx IN people.first .. people.last LOOP
            IF people(idx).age < 100 THEN
                INSERT INTO HUMANS(firstName, surname, age, phoneNumbers)
                VALUES(people(idx).firstName, people(idx).surname, people(idx).age, people(idx).phoneNumbers);
            END IF;
        END LOOP;

        FOR humanContact IN (SELECT * FROM  HUMANS h, TABLE(h.phoneNumbers) n) LOOP
            phoneBook.EXTEND(1);
            phoneBook(phoneBook.COUNT) := humanContact.surname || ',' || humanContact.firstname || ':' || humanContact.areaCode ||'-'|| humanContact.phoneNumber;
        END LOOP;

        contactList := phonebook;

        COMMIT;
END PROC_INSERT_HUMANS;
```

## [](#oracle-データベース接続の設定)Oracle データベース接続の設定

Oracle データベース内で UDT、テーブル、ストアドプロシージャーを作成したら、Anypoint Studio に移動して Oracle データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次のパラメーターを設定します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ 項目を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[Oracle Connection (Oracle 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な Oracle JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次のパラメーターを設定します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `1521`
    - **User (ユーザー)**​: `SYS as SYSDBA`
    - **Password (パスワード)**​: `Oradoc_db1`
    - **Instance (インスタンス)**​: `ORCLCDB`
8. **\[Advanced (詳細)\]**​ タブで ​**\[Column types (列の型)\]**​ 項目を ​**\[Edit inline (インライン編集)\]**​ に設定します。
9. プラス記号 ​**(+)**​ をクリックして、新しい列の型を追加し、すでに作成されているすべての UDT をリストします。
10. 次の値を ​**\[Id\]**​ および ​**\[Type name (型名)\]**​ 項目に指定します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Id</th>
<th class="tableblock halign-left valign-top">型名</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PEOPLE</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_NUMBER</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2008</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PERSON</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_ARRAY</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2003</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>PHONE_BOOK</code></p>
</div></div></td>
</tr>
</tbody>
</table>
11. **\[Finish (完了)\]**​ をクリックして、​**\[Column Type (列の型)\]**​ ウィンドウを閉じます。
12. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
13. **\[OK\]**​ をクリックします。

次のスクリーンショットは、Studio での HTTP リスナーのグローバル要素設定を示しています。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-oracleudt-example-1.png)

Figure 2. HTTP リスナーの設定

次のスクリーンショットは、Studio でのデータベースのグローバル要素設定を示しています。

![\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースのグローバル要素設定。](_images/database-oracleudt-example-2.png)

Figure 3. \[Database Config (データベース設定)\] の \[General (一般)\] 設定

![「Column types (列の型)」 項目を設定するデータベースのグローバル要素詳細設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-oracleudt-example-3.png)

Figure 4. \[Database Config (データベース設定)\] の \[Advanced (詳細)\] 設定

## [](#mule-アプリケーションの作成実行テスト)Mule アプリケーションの作成、実行、テスト

Oracle データベース接続を設定したら、Mule アプリケーションを作成、実行、およびテストして、ストアドプロシージャーをコールします。

### [](#http-リスナーと-set-payload-コンポーネントの設定)HTTP リスナーと Set Payload コンポーネントの設定

Mule フローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ 項目を ​`/oracle`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ の右にドラッグします。  
    このコンポーネントでは、処理のためにストアドプロシージャーに送信する項目のリストを作成します。
5. **\[Value (値)\]**​ 項目で、リストする項目を指定します。  
    
    ```xml
    [{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
    	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
    	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
    	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
    	]
    ```
6. **\[Mime Type (MIME タイプ)\]**​ 項目を ​`application/java`​ に設定します。

![Set payload コンポーネントの設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-oracleudt-example-4.png)

Figure 5. Set Payload の設定

### [](#dataweave-関数を使用した-transform-message-コンポーネントの設定)DataWeave 関数を使用した Transform Message コンポーネントの設定

**Transform Message**​ コンポーネントと、アプリケーションデータをカスタムユーザーデータ型の例にマップする ​`createStruct`​ および ​`createArray`​ DataWeave 関数を使用して、Mule アプリケーションの作成を継続します。

1. **\[Transform Message\]**​ コンポーネントを ​**\[Set Payload\]**​ の右にドラッグします。  
    このコンポーネントでは、ストアドプロシージャーで入力パラメーターとして想定されているデータ型 ​`PEOPLE`​ にマップできるオブジェクトに JSON オブジェクトが変換されます。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - Prepare UDT`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで ​**\[Edit Current Target (現在の対象を編集)\]**​ ボタンをクリックします。
4. **\[Selection dialog (選択ダイアログ)\]**​ ボックスで ​**\[Output (出力)\]**​ 項目を ​`Variable`​、​**\[Variable name (変数名)\]**​ を ​`in_people_tab`​ に設定し、​**\[OK\]**​ をクリックします。
5. **\[Output (出力)\]**​ 項目で、​`createStruct`​ および ​`createArray`​ 関数が含まれる次の DataWeave 式を指定します。
    
    ```DataWeave
    %dw 2.0
    output application/java
    
    fun toPhoneNumberArray(phoneNumber) = Db::createArray("dbConfig", "PHONE_NUMBER_ARRAY",[Db::createStruct("dbConfig", "PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
    fun toPerson(person) = Db::createStruct("dbConfig", "PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
    ---
    Db::createArray("dbConfig", "PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
    ```
    
    ![Transform Message の設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-oracleudt-example-6.png)
    
    Figure 6. Transform Message の設定

`createStruct`​ 関数では、​`Name`​ 型および対応するプロパティに基づいて JDBC 構造オブジェクトが作成されます。この例では、型 ​`PERSON`​ と ​`PHONE_NUMBER`​ が構造オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `configName`  
    `Struct`​ 型を作成する設定の名前を含む文字列 (この例では ​`dbConfig`​)
- `typeName`  
    作成する ​`Struct`​ 型の名前を含む文字列 (この例では ​`PERSON`​ または ​`PHONE_NUMBER`​)
- `values`  
    `Struct`​ プロパティに準拠する値の配列 (この例では ​`PHONE_NUMBER`​、​`['046', '666']`​)

`createArray`​ 関数では、​`Array`​ 型に基づいて JDBC 配列オブジェクトが作成されます。この例では、型 ​`PHONE_NUMBER_ARRAY`​、​`PEOPLE`​、および ​`PHONE_BOOK`​ が配列オブジェクトです。この関数では、次のパラメーターがこの順序で想定されます。

- `configName`  
    `Array`​ 型を作成する設定の名前を含む文字列 (この例では ​`dbConfig`​)
- `typeName`  
    作成する ​`Array`​ 型の名前を含む文字列 (この例では ​`PEOPLE`​ または ​`PHONE_NUMBER_ARRAY`​)
- `values`  
    `Array`​ 型に準拠する値の配列 (この例では ​`createStruct`​ 関数を使用して作成された ​`PERSON`​ オブジェクトの配列)

これらの関数を組み合わせて使用して、サブタイプまたはネストされた型を作成できます。この例では、型 ​`PERSON`​ に ​`PHONE_NUMBER_ARRAY`​ オブジェクトが含まれます。同時に型 ​`PHONE_NUMBER_ARRAY`​ が ​`PHONE_NUMBER`​ の配列として定義されます。

また、​`Array`​ 型に基づいて UDT に一致させるときに ​`createArray`​ 関数を使用する場合、複合型に合わせてこれらの関数を組み合わせることができます。

### [](#stored-procedure-操作の設定)Stored Procedure 操作の設定

Database Connector の ​**Stored Procedure**​ 操作を使用して、UDT を使用する Oracle ストアドプロシージャーをコールします。

1. **\[Stored procedure\]**​ 操作を ​**\[Transform Message\]**​ の右にドラッグします。  
    この操作では、Database Connector を使用してストアドプロシージャーがコールされます。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`dbConfig`​ グローバル設定を選択します。
3. **\[SQL Query Text (SQL クエリテキスト)\]**​ 項目に「​`{ call proc_insert_humans(:people, :phoneBook) }`​」と入力します。
4. **\[Input Parameters (入力パラメーター)\]**​ 項目に「​`{ people: vars.in_people_tab}`​」と入力します  
    このステップでは、​`in_people_tab`​ という変数に保存された変換の出力が入力パラメーターにマップされます。
5. **\[Output Parameters (出力パラメーター)\]**​ 項目で ​`Edit inline`​ を選択し、プラス記号 (​**+**​) をクリックしてカスタムパラメーターを設定します。
    
    - **Key (キー)**​: `phoneBook`
    - **Custom type (カスタム型)**​: `PHONE_BOOK`

![ストアドプロシージャーの設定](/mulesoft/current/ja-jp/db-connector/1.9/_images/database-oracleudt-example-5.png)

Figure 7. ストアドプロシージャーの設定

1. 2 つ目の ​**\[Transform Message\]**​ コンポーネントを ​**\[Stored Procedure\]**​ の右にドラッグします。
2. Studio キャンバスでコンポーネントをダブルクリックして、名前を ​`Transform Message - response to JSON`​ に設定します。
3. コンポーネントの ​**\[Output (出力)\]**​ ソースコードビューで、次の DataWeave 式を設定します。

```DataWeave
%dw 2.0
output application/json
---
payload
```

### [](#mule-アプリケーションの実行およびテスト)Mule アプリケーションの実行およびテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. ターミナルで curl コマンド「​`curl localhost:8081/oracle`​」を使用して、アプリケーションをテストします。  
    このストアドプロシージャーでは、テーブル ​`HUMANS`​ に追加されているすべての個人の電話番号のリストが返されます。

## [](#udt-を使用する-oracle-ストアドプロシージャーをコールするための-xml)UDT を使用する Oracle ストアドプロシージャーをコールするための XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">

	<http:listener-config name="HTTP_Listener_config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>

	<db:config name="dbConfig" >
		<db:oracle-connection host="localhost" user="SYS as SYSDBA" password="Oradoc_db1" instance="ORCLCDB">
			<db:column-types>
				<db:column-type id="2003" typeName="PEOPLE"/>
				<db:column-type id="2003" typeName="PHONE_NUMBER"/>
				<db:column-type id="2008" typeName="PERSON" />
				<db:column-type id="2003" typeName="PHONE_NUMBER_ARRAY"/>
				<db:column-type id="2003" typeName="PHONE_BOOK"/>
			</db:column-types>
		</db:oracle-connection>
	</db:config>

	<flow name="oracle-udtsFlow" >
		<http:listener config-ref="HTTP_Listener_config" path="/oracle"/>

		<set-payload value="#[[{'name':'Anthony J', 'surname':'Crowley', 'age': 6000, 'phoneNumber': {'areaCode':'020', 'phoneNumber': '777'}},
	{'name':'A.Z', 'surname':'Fell', 'age': 6000, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '888'}},
	{'name':'Adam', 'surname':'Young', 'age': 11, 'phoneNumber':{'areaCode':'046', 'phoneNumber': '666'}},
	{'name':'Anathema', 'surname':'Device', 'age': 27, 'phoneNumber':{'areaCode':'020', 'phoneNumber': '123'}},
	]]" mimeType="application/java"/>


	<ee:transform doc:name="Transform Message - Prepare UDT">
			<ee:variables>
				<ee:set-variable variableName="in_people_tab"><![CDATA[%dw 2.0
				output application/java
				fun toPhoneNumberArray(phoneNumber) = Db::createArray("dbConfig", "PHONE_NUMBER_ARRAY",[Db::createStruct("dbConfig", "PHONE_NUMBER", [phoneNumber.areaCode, phoneNumber.phoneNumber])])
				fun toPerson(person) = Db::createStruct("dbConfig", "PERSON", [person.name, person.surname, person.age, toPhoneNumberArray(person.phoneNumber)])
				---
				Db::createArray("dbConfig", "PEOPLE", payload map (item, index) -> ( toPerson(item) ) )
				]]></ee:set-variable>
			</ee:variables>
		</ee:transform>
		<db:stored-procedure config-ref="dbConfig">
			<db:sql><![CDATA[{ call proc_insert_humans(:people, :phoneBook) }]]></db:sql>
			<db:input-parameters><![CDATA[{
				people: vars.in_people_tab
			}]]></db:input-parameters>
			<db:output-parameters >
				<db:output-parameter key="phoneBook" customType="PHONE_BOOK" />
			</db:output-parameters>
		</db:stored-procedure>
		<ee:transform doc:name="Transform Message - response to JSON" >
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
					output application/json
					---
					payload]]></ee:set-payload>
			</ee:message>
		</ee:transform>
	</flow>

</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.9/database-connector-examples)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=be70235f14dfd9159436e70df49023443bbfdbda962d0f88d3bfdfb9d713a2e0 url=/mulesoft/current/ja-jp/db-connector/1.12/database-execute-bulk.md -->

# 一括操作の実行例

データベース用 Anypoint Connector (Database Connector) では、データを一括管理できるようにする ​**Bulk insert**​、​**Bulk update**​、​**Bulk delete**​ 操作がサポートされています。これにより、1 つの挿入、更新、または削除操作を何度も実行する場合よりもパフォーマンスが向上します。

これらの操作は、対応する単一操作と似ていますが、入力パラメーターをキー - 値のペアで受け取るのではなく、一括操作ではキー - 値のペアのリストとして受け取ることを想定しています。一括操作を実行すれば、不要なステップを回避して次の利点を得ることができます。

- クエリが 1 回だけ解析される
- 実行されるステートメントは 1 つのみのため、必要なデータベース接続は 1 つのみである
- ネットワークオーバーヘッドを最小限に抑えられる
- RDBMS で一括操作を実行できる。

一括操作の一部のステートメントが正常に実行されても、他のステートメントがエラーとなることがあります (たとえば、​**Bulk insert**​ 操作で 100 行のうち 1 行の挿入に失敗すると、エラーの内容を示す例外が 1 件スローされます)。実行を直ちに中止して残りの操作をすべて無視するか、または残りのステートメントの実行を継続するかは、ドライバーが決定します。どちらの場合でも、エラーが発生した場合には、Mule アプリケーションログでエラーの原因を確認してください。

次の例は、MySQL データベースで顧客データと商品データを挿入、更新、削除する操作を Mule アプリケーションで設定する方法を示しています。この例を実行するには、次の操作が必要です。  

- `CUSTOMERS`​ と ​`PRODUCTS`​ という 2 つのテーブルを作成する SQL ステートメントを実行します。
- SQL データベース接続を設定します。
- Mule アプリケーションを作成します。
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストします。

![Bulk insert、Bulk update、Bulk delete のフロー](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-bulkoperations-flow.png)

## [](#データベースのテーブルの作成)データベースのテーブルの作成

SQL データベース接続を設定して Mule アプリケーションを作成する前に、次の SQL ステートメントを実行して ​`CUSTOMERS`​ と ​`PRODUCTS`​ というテーブルを作成し、4 件の商品データを ​`PRODUCTS`​ テーブルに挿入します。

```sql
CREATE DATABASE DEMO;

USE DEMO;

CREATE TABLE CUSTOMERS (
ID bigint AUTO_INCREMENT PRIMARY KEY,
NAME varchar(30) NOT NULL,
LAST_NAME varchar(30) NOT NULL
);

CREATE TABLE PRODUCTS (
ID bigint AUTO_INCREMENT PRIMARY KEY,
PRICE numeric(8, 2) NOT NULL,
ITEM varchar(30) NOT NULL
);

INSERT INTO PRODUCTS (PRICE, ITEM) values (50.0, 'shampoo');
INSERT INTO PRODUCTS (PRICE, ITEM) values (150.5, 'olive oil');
INSERT INTO PRODUCTS (PRICE, ITEM) values (11, 'coconut oil');
INSERT INTO PRODUCTS (PRICE, ITEM) values (133, 'wine');
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

テーブルを作成したら、Anypoint Studio に移動して MySQL データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次の項目に入力します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次の項目に入力します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `3306`
    - **User (ユーザー)**​: `root`
    - **Password (パスワード)**​: `mulesoft`
    - **Database (データベース)**​: `demo`
8. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
9. **\[OK\]**​ をクリックします。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.12/_images/database-querysingle-example-1.png)

次のスクリーンショットは、データベースのグローバル要素設定を示しています。

![\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースの一般設定](_images/database-bulk-example-2.png)

## [](#最初のフローの作成)最初のフローの作成

最初のフローは、顧客の項目を ​`CUSTOMERS`​ テーブルに一括挿入します。このフローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ を ​`/insert`​ に設定します。
4. **\[Bulk insert\]**​ 操作を ​**\[Listener\]**​ ソースの右にドラッグします。
5. **\[Connector configuration (コネクタ設定)\]**​ で ​`Database_Config`​ を選択します。
6. **\[Input Parameters (入力パラメーター)\]**​ に次の式を入力します。
    
    `[{'id': 2, 'name': 'George', 'lastName': 'Costanza'}, {'id': 3, 'name': 'Cosmo', 'lastName': 'Kramer'}]`
7. **\[SQL Query text (SQL クエリテキスト)\]**​ に以下を入力します。
    
    `INSERT INTO CUSTOMERS (NAME, LAST_NAME) values (:name, :lastName)`

## [](#2-つ目のフローの作成)2 つ目のフローの作成

2 つ目のフローは、​`PRODUCTS`​ テーブルで商品の価格を一括更新します。このフローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択して、最初のフローの下にドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ を ​`update`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。
5. **\[Value (値)\]**​ に次の式を入力します。
    
    ```text
    [{
    	discountRate: 0.1,
    	price: 50
    },
    {
    	discountRate: 0.2,
    	price: 150.5
    }]
    ```
6. **\[Bulk update\]**​ 操作を ​**\[Set Payload\]**​ ソースの右にドラッグします。
7. **\[Connector configuration (コネクタ設定)\]**​ で ​`Database_Config`​ を選択します。
8. **\[SQL Query text (SQL クエリテキスト)\]**​ に次の式を入力します。
    
    `UPDATE PRODUCTS SET PRICE = PRICE * :discountRate WHERE PRICE = :price`

## [](#3-つ目のフローを作成する)3 つ目のフローを作成する

3 つ目のフローは、​`PRODUCTS`​ テーブルから商品データを一括削除します。このフローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択して、最初のフローの下にドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ を ​`/delete`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。
5. **\[Value (値)\]**​ に次の式を入力します。
    
    ```text
    [{
    	price: 11
    },
    {
    	price: 133
    }]
    ```
6. **\[Bulk delete\]**​ 操作を ​**\[Set Payload\]**​ コンポーネントの右にドラッグします。
7. **\[Connector configuration (コネクタ設定)\]**​ で ​`Database_Config`​ を選択します。
8. **\[SQL Query text (SQL クエリテキスト)\]**​ に次の式を入力します。
    
    `DELETE FROM PRODUCTS WHERE PRICE = :price`

## [](#mule-アプリケーションの実行とテスト)Mule アプリケーションの実行とテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. **\[Run (実行)\] > \[Run (実行)\]**​ をクリックしてアプリケーションをデプロイします。
3. インターネットブラウザーで、次の CURL コマンドを実行してアプリケーションをテストします。  
    `curl [http://localhost:8081/insert](http://localhost:8081/insert)`  
    `curl [http://localhost:8081/update](http://localhost:8081/update)`  
    `curl [http://localhost:8081/delete](http://localhost:8081/delete)`

## [](#mule-アプリケーションの-xml-の例)Mule アプリケーションの XML の例

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">
	<db:config >
		<db:my-sql-connection host="localhost" port="3306" user="root" password="mulesoft" database="demo" />
	</db:config>
	<http:listener-config name="HTTP_Listener_config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>
	<flow name="dbcon-demoFlow">
		<http:listener config-ref="HTTP_Listener_config" path="/insert"/>
		<db:bulk-insert config-ref="Database_Config">
			<db:bulk-input-parameters ><![CDATA[#[[{'id': 2, 'name': 'George', 'lastName': 'Costanza'}, {'id': 3, 'name': 'Cosmo', 'lastName': 'Kramer'}]]]]></db:bulk-input-parameters>
			<db:sql ><![CDATA[INSERT INTO CUSTOMERS (NAME, LAST_NAME) values (:name, :lastName)]]></db:sql>
		</db:bulk-insert>
	</flow>
	<flow name="dbcon-demoFlow1" >
		<http:listener config-ref="HTTP_Listener_config" path="update"/>
		<set-payload value="#[[{
	discountRate: 0.1,
	price: 50
},
{
	discountRate: 0.2,
	price: 150.5
}]]" doc:name="Set Payload" />
		<db:bulk-update config-ref="Database_Config">
			<db:sql ><![CDATA[UPDATE PRODUCTS SET PRICE = PRICE * :discountRate WHERE PRICE = :price]]></db:sql>
		</db:bulk-update>
	</flow>
	<flow name="dbcon-demoFlow2" >
		<http:listener config-ref="HTTP_Listener_config" path="/delete"/>
		<set-payload value="#[[{
	price: 11
},
{
	price: 133
}]]" doc:name="Set Payload" />
		<db:bulk-delete doc:name="Bulk delete" config-ref="Database_Config">
			<db:sql ><![CDATA[DELETE FROM PRODUCTS WHERE PRICE = :price]]></db:sql>
		</db:bulk-delete>
	</flow>
</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.12/database-connector-examples)

<!-- document id=6066d5cb8c59325cae8a29f3e68f4a60ceff215a07d300d14193f7936446bf65 url=/mulesoft/current/ja-jp/db-connector/1.13/database-execute-bulk.md -->

# 一括操作の実行例

データベース用 Anypoint Connector (Database Connector) では、データを一括管理できるようにする ​**Bulk insert**​、​**Bulk update**​、​**Bulk delete**​ 操作がサポートされています。これにより、1 つの挿入、更新、または削除操作を何度も実行する場合よりもパフォーマンスが向上します。

これらの操作は、対応する単一操作と似ていますが、入力パラメーターをキー - 値のペアで受け取るのではなく、一括操作ではキー - 値のペアのリストとして受け取ることを想定しています。一括操作を実行すれば、不要なステップを回避して次の利点を得ることができます。

- クエリが 1 回だけ解析される
- 実行されるステートメントは 1 つのみのため、必要なデータベース接続は 1 つのみである
- ネットワークオーバーヘッドを最小限に抑えられる
- RDBMS で一括操作を実行できる。

一括操作の一部のステートメントが正常に実行されても、他のステートメントがエラーとなることがあります (たとえば、​**Bulk insert**​ 操作で 100 行のうち 1 行の挿入に失敗すると、エラーの内容を示す例外が 1 件スローされます)。実行を直ちに中止して残りの操作をすべて無視するか、または残りのステートメントの実行を継続するかは、ドライバーが決定します。どちらの場合でも、エラーが発生した場合には、Mule アプリケーションログでエラーの原因を確認してください。

次の例は、MySQL データベースで顧客データと商品データを挿入、更新、削除する操作を Mule アプリケーションで設定する方法を示しています。この例を実行するには、次の操作が必要です。  

- `CUSTOMERS`​ と ​`PRODUCTS`​ という 2 つのテーブルを作成する SQL ステートメントを実行します。
- SQL データベース接続を設定します。
- Mule アプリケーションを作成します。
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストします。

![Bulk insert、Bulk update、Bulk delete のフロー](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-bulkoperations-flow.png)

## [](#データベースのテーブルの作成)データベースのテーブルの作成

SQL データベース接続を設定して Mule アプリケーションを作成する前に、次の SQL ステートメントを実行して ​`CUSTOMERS`​ と ​`PRODUCTS`​ というテーブルを作成し、4 件の商品データをテーブル ​`PRODUCTS`​ に挿入します。

```sql
CREATE DATABASE DEMO;

USE DEMO;

CREATE TABLE CUSTOMERS (
ID bigint AUTO_INCREMENT PRIMARY KEY,
NAME varchar(30) NOT NULL,
LAST_NAME varchar(30) NOT NULL
);

CREATE TABLE PRODUCTS (
ID bigint AUTO_INCREMENT PRIMARY KEY,
PRICE numeric(8, 2) NOT NULL,
ITEM varchar(30) NOT NULL
);

INSERT INTO PRODUCTS (PRICE, ITEM) values (50.0, 'shampoo');
INSERT INTO PRODUCTS (PRICE, ITEM) values (150.5, 'olive oil');
INSERT INTO PRODUCTS (PRICE, ITEM) values (11, 'coconut oil');
INSERT INTO PRODUCTS (PRICE, ITEM) values (133, 'wine');
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

テーブルを作成したら、Anypoint Studio に移動して MySQL データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次の項目に入力します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次の項目に入力します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `3306`
    - **User (ユーザー)**​: `root`
    - **Password (パスワード)**​: `mulesoft`
    - **Database (データベース)**​: `demo`
8. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
9. **\[OK\]**​ をクリックします。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.13/_images/database-querysingle-example-1.png)

次のスクリーンショットは、データベースのグローバル要素設定を示しています。

![「\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースの一般設定。」](_images/database-bulk-example-2.png)

## [](#最初のフローの作成)最初のフローの作成

最初のフローは、顧客の項目を ​`CUSTOMERS`​ テーブルに一括挿入します。このフローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ を ​`/insert`​ に設定します。
4. **\[Bulk insert\]**​ 操作を ​**\[Listener\]**​ ソースの右にドラッグします。
5. **\[Connector configuration (コネクタ設定)\]**​ で ​`Database_Config`​ を選択します。
6. **\[Input Parameters (入力パラメーター)\]**​ に次の式を入力します。
    
    `[{'id': 2, 'name': 'George', 'lastName': 'Costanza'}, {'id': 3, 'name': 'Cosmo', 'lastName': 'Kramer'}]`
7. **\[SQL Query text (SQL クエリテキスト)\]**​ に以下を入力します。
    
    `INSERT INTO CUSTOMERS (NAME, LAST_NAME) values (:name, :lastName)`

## [](#2-つ目のフローの作成)2 つ目のフローの作成

2 つ目のフローは、​`PRODUCTS`​ テーブルで商品の価格を一括更新します。このフローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択して、最初のフローの下にドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ を ​`update`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。
5. **\[Value (値)\]**​ に次の式を入力します。
    
    ```text
    [{
    	discountRate: 0.1,
    	price: 50
    },
    {
    	discountRate: 0.2,
    	price: 150.5
    }]
    ```
6. **\[Bulk update\]**​ 操作を ​**\[Set Payload\]**​ ソースの右にドラッグします。
7. **\[Connector configuration (コネクタ設定)\]**​ で ​`Database_Config`​ を選択します。
8. **\[SQL Query text (SQL クエリテキスト)\]**​ に次の式を入力します。
    
    `UPDATE PRODUCTS SET PRICE = PRICE * :discountRate WHERE PRICE = :price`

## [](#3-つ目のフローを作成する)3 つ目のフローを作成する

3 つ目のフローは、​`PRODUCTS`​ テーブルから商品データを一括削除します。このフローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択して、最初のフローの下にドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ を ​`/delete`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。
5. **\[Value (値)\]**​ に次の式を入力します。
    
    ```text
    [{
    	price: 11
    },
    {
    	price: 133
    }]
    ```
6. **\[Bulk delete\]**​ 操作を ​**\[Set Payload\]**​ コンポーネントの右にドラッグします。
7. **\[Connector configuration (コネクタ設定)\]**​ で ​`Database_Config`​ を選択します。
8. **\[SQL Query text (SQL クエリテキスト)\]**​ に次の式を入力します。
    
    `DELETE FROM PRODUCTS WHERE PRICE = :price`

## [](#mule-アプリケーションの実行とテスト)Mule アプリケーションの実行とテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. **\[Run (実行)\] > \[Run (実行)\]**​ をクリックしてアプリケーションをデプロイします。
3. インターネットブラウザーで、次の CURL コマンドを実行してアプリケーションをテストします。  
    `curl [http://localhost:8081/insert](http://localhost:8081/insert)`  
    `curl [http://localhost:8081/update](http://localhost:8081/update)`  
    `curl [http://localhost:8081/delete](http://localhost:8081/delete)`

## [](#mule-アプリケーションの-xml-の例)Mule アプリケーションの XML の例

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">
	<db:config >
		<db:my-sql-connection host="localhost" port="3306" user="root" password="mulesoft" database="demo" />
	</db:config>
	<http:listener-config name="HTTP_Listener_config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>
	<flow name="dbcon-demoFlow">
		<http:listener config-ref="HTTP_Listener_config" path="/insert"/>
		<db:bulk-insert config-ref="Database_Config">
			<db:bulk-input-parameters ><![CDATA[#[[{'id': 2, 'name': 'George', 'lastName': 'Costanza'}, {'id': 3, 'name': 'Cosmo', 'lastName': 'Kramer'}]]]]></db:bulk-input-parameters>
			<db:sql ><![CDATA[INSERT INTO CUSTOMERS (NAME, LAST_NAME) values (:name, :lastName)]]></db:sql>
		</db:bulk-insert>
	</flow>
	<flow name="dbcon-demoFlow1" >
		<http:listener config-ref="HTTP_Listener_config" path="update"/>
		<set-payload value="#[[{
	discountRate: 0.1,
	price: 50
},
{
	discountRate: 0.2,
	price: 150.5
}]]" doc:name="Set Payload" />
		<db:bulk-update config-ref="Database_Config">
			<db:sql ><![CDATA[UPDATE PRODUCTS SET PRICE = PRICE * :discountRate WHERE PRICE = :price]]></db:sql>
		</db:bulk-update>
	</flow>
	<flow name="dbcon-demoFlow2" >
		<http:listener config-ref="HTTP_Listener_config" path="/delete"/>
		<set-payload value="#[[{
	price: 11
},
{
	price: 133
}]]" doc:name="Set Payload" />
		<db:bulk-delete doc:name="Bulk delete" config-ref="Database_Config">
			<db:sql ><![CDATA[DELETE FROM PRODUCTS WHERE PRICE = :price]]></db:sql>
		</db:bulk-delete>
	</flow>
</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.13/database-connector-examples)

<!-- document id=e0794cb2522a9c3244b0cf61b66d98de70023dc995e58bed8de98e064230f7ec url=/mulesoft/current/ja-jp/db-connector/1.14/database-execute-bulk.md -->

# 一括操作の実行例

データベース用 Anypoint Connector (Database Connector) では、データを一括管理できるようにする ​**Bulk insert**​、​**Bulk update**​、​**Bulk delete**​ 操作がサポートされています。これにより、1 つの挿入、更新、または削除操作を何度も実行する場合よりもパフォーマンスが向上します。

これらの操作は、対応する単一操作と似ていますが、入力パラメーターをキー - 値のペアで受け取るのではなく、一括操作ではキー - 値のペアのリストとして受け取ることを想定しています。一括操作を実行すれば、不要なステップを回避して次の利点を得ることができます。

- クエリが 1 回だけ解析される
- 実行されるステートメントは 1 つのみのため、必要なデータベース接続は 1 つのみである
- ネットワークオーバーヘッドを最小限に抑えられる
- RDBMS で一括操作を実行できる。

一括操作の一部のステートメントが正常に実行されても、他のステートメントがエラーとなることがあります (たとえば、​**Bulk insert**​ 操作で 100 行のうち 1 行の挿入に失敗すると、エラーの内容を示す例外が 1 件スローされます)。実行を直ちに中止して残りの操作をすべて無視するか、または残りのステートメントの実行を継続するかは、ドライバーが決定します。どちらの場合でも、エラーが発生した場合には、Mule アプリケーションログでエラーの原因を確認してください。

次の例は、MySQL データベースで顧客データと商品データを挿入、更新、削除する操作を Mule アプリケーションで設定する方法を示しています。この例を実行するには、次の操作が必要です。  

- `CUSTOMERS`​ と ​`PRODUCTS`​ という 2 つのテーブルを作成する SQL ステートメントを実行します。
- SQL データベース接続を設定します。
- Mule アプリケーションを作成します。
- アプリケーションを実行し、curl コマンドを使用してアプリケーションをテストします。

![Bulk insert、Bulk update、Bulk delete のフロー](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-bulkoperations-flow.png)

## [](#データベースのテーブルの作成)データベースのテーブルの作成

SQL データベース接続を設定して Mule アプリケーションを作成する前に、次の SQL ステートメントを実行して ​`CUSTOMERS`​ と ​`PRODUCTS`​ というテーブルを作成し、4 件の商品データを ​`PRODUCTS`​ テーブルに挿入します。

```sql
CREATE DATABASE DEMO;

USE DEMO;

CREATE TABLE CUSTOMERS (
ID bigint AUTO_INCREMENT PRIMARY KEY,
NAME varchar(30) NOT NULL,
LAST_NAME varchar(30) NOT NULL
);

CREATE TABLE PRODUCTS (
ID bigint AUTO_INCREMENT PRIMARY KEY,
PRICE numeric(8, 2) NOT NULL,
ITEM varchar(30) NOT NULL
);

INSERT INTO PRODUCTS (PRICE, ITEM) values (50.0, 'shampoo');
INSERT INTO PRODUCTS (PRICE, ITEM) values (150.5, 'olive oil');
INSERT INTO PRODUCTS (PRICE, ITEM) values (11, 'coconut oil');
INSERT INTO PRODUCTS (PRICE, ITEM) values (133, 'wine');
```

## [](#mysql-データベース接続の設定)MySQL データベース接続の設定

テーブルを作成したら、Anypoint Studio に移動して MySQL データベース接続を設定します。

1. Studio で新しい Mule プロジェクトを作成します。
2. **\[Global Elements (グローバル要素)\]**​ ビューに移動します。
3. **\[Create (作成)\]**​ をクリックして、​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
4. **\[Filter (検索条件)\]**​ 項目に「​`http`​」と入力し、​**\[HTTP Listener config (HTTP リスナー設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。  
    この設定は、Mule アプリケーションフローを開始する HTTP ​**Listener**​ ソース用です。
5. **\[HTTP Listener config (HTTP リスナー設定)\]**​ ウィンドウで、次の項目に入力します。
    
    - **Protocol (プロトコル)**​: `HTTP (Default)`
    - **Host (ホスト)**​: `All Interfaces [0.0.0.0] (default)`
    - **Port (ポート)**​: `8081`

1. **\[OK\]**​ をクリックします。
2. **\[Global Elements (グローバル要素)\]**​ ビューで ​**\[Create (作成)\]**​ をクリックして ​**\[Choose Global Type (グローバル種別の選択)\]**​ ビューを開きます。
3. **\[Filter (検索条件)\]**​ 項目に「​`database`​」と入力し、​**\[Database Config (データベース設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。
4. **\[Database Config (データベース設定)\]**​ ウィンドウで ​**\[Name (名前)\]**​ を ​`dbConfig`​ に設定します。
5. **\[Connection (接続)\]**​ 項目で ​**\[MySQL Connection (MySQL 接続)\]**​ を選択します。
6. **\[Configure (設定)\]**​ をクリックし、必要な MySQL JDBC ドライバーを追加して、次のいずれかを選択します。  
    
    - **Add recommended library (推奨されるライブラリを追加)**​  
        推奨されるライブラリをインストールします。
    - **Use local file (ローカルファイルを使用)**​  
        ローカルファイルを使用してライブラリをインストールします。
    - **Add Maven dependency (Maven 連動関係を追加)**​  
        Maven 連動関係をインストールしてプロジェクトに追加します。
7. **\[Connection (接続)\]**​ セクションで、次の項目に入力します。  
    
    - **Host (ホスト)**​: `localhost`
    - **Port (ポート)**​: `3306`
    - **User (ユーザー)**​: `root`
    - **Password (パスワード)**​: `mulesoft`
    - **Database (データベース)**​: `demo`
8. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule がデータベースに接続できることを確認します。
9. **\[OK\]**​ をクリックします。

![HTTP リスナーのグローバル要素設定](/mulesoft/current/ja-jp/db-connector/1.14/_images/database-querysingle-example-1.png)

次のスクリーンショットは、データベースのグローバル要素設定を示しています。

![「\[Host (ホスト)\]、\[Port (ポート)\]、\[User (ユーザー)\]、\[Password (パスワード)\] 項目を設定するデータベースの一般設定。」](_images/database-bulk-example-2.png)

## [](#最初のフローの作成)最初のフローの作成

最初のフローは、顧客の項目を ​`CUSTOMERS`​ テーブルに一括挿入します。このフローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択してキャンバスにドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ を ​`/insert`​ に設定します。
4. **\[Bulk insert\]**​ 操作を ​**\[Listener\]**​ ソースの右にドラッグします。
5. **\[Connector configuration (コネクタ設定)\]**​ で ​`Database_Config`​ を選択します。
6. **\[Input Parameters (入力パラメーター)\]**​ に次の式を入力します。
    
    `[{'id': 2, 'name': 'George', 'lastName': 'Costanza'}, {'id': 3, 'name': 'Cosmo', 'lastName': 'Kramer'}]`
7. **\[SQL Query text (SQL クエリテキスト)\]**​ に以下を入力します。
    
    `INSERT INTO CUSTOMERS (NAME, LAST_NAME) values (:name, :lastName)`

## [](#2-つ目のフローの作成)2 つ目のフローの作成

2 つ目のフローは、​`PRODUCTS`​ テーブルで商品の価格を一括更新します。このフローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択して、最初のフローの下にドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ を ​`update`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。
5. **\[Value (値)\]**​ に次の式を入力します。
    
    ```text
    [{
    	discountRate: 0.1,
    	price: 50
    },
    {
    	discountRate: 0.2,
    	price: 150.5
    }]
    ```
6. **\[Bulk update\]**​ 操作を ​**\[Set Payload\]**​ ソースの右にドラッグします。
7. **\[Connector configuration (コネクタ設定)\]**​ で ​`Database_Config`​ を選択します。
8. **\[SQL Query text (SQL クエリテキスト)\]**​ に次の式を入力します。
    
    `UPDATE PRODUCTS SET PRICE = PRICE * :discountRate WHERE PRICE = :price`

## [](#3-つ目のフローを作成する)3 つ目のフローを作成する

3 つ目のフローは、​`PRODUCTS`​ テーブルから商品データを一括削除します。このフローを作成する手順は、次のとおりです。

1. **\[Mule Palette (Mule パレット)\]**​ ビューで、\[HTTP\] の ​**\[Listener\]**​ ソースを選択して、最初のフローの下にドラッグします。  
    このソースは受信 HTTP メッセージ属性をリスンすることでフローを開始します。
2. **\[Connector configuration (コネクタ設定)\]**​ 項目で ​`HTTP_Listener_config`​ グローバル設定を選択します。
3. **\[Path (パス)\]**​ を ​`/delete`​ に設定します。
4. **\[Set Payload\]**​ コンポーネントを ​**\[Listener\]**​ ソースの右にドラッグします。
5. **\[Value (値)\]**​ に次の式を入力します。
    
    ```text
    [{
    	price: 11
    },
    {
    	price: 133
    }]
    ```
6. **\[Bulk delete\]**​ 操作を ​**\[Set Payload\]**​ コンポーネントの右にドラッグします。
7. **\[Connector configuration (コネクタ設定)\]**​ で ​`Database_Config`​ を選択します。
8. **\[SQL Query text (SQL クエリテキスト)\]**​ に次の式を入力します。
    
    `DELETE FROM PRODUCTS WHERE PRICE = :price`

## [](#mule-アプリケーションの実行とテスト)Mule アプリケーションの実行とテスト

Mule アプリケーションを実行およびテストする手順は、次のとおりです。

1. Studio でプロジェクトを保存します。
2. **\[Run (実行)\] > \[Run (実行)\]**​ をクリックしてアプリケーションをデプロイします。
3. インターネットブラウザーで、次の CURL コマンドを実行してアプリケーションをテストします。  
    `curl [http://localhost:8081/insert](http://localhost:8081/insert)`  
    `curl [http://localhost:8081/update](http://localhost:8081/update)`  
    `curl [http://localhost:8081/delete](http://localhost:8081/delete)`

## [](#mule-アプリケーションの-xml-の例)Mule アプリケーションの XML の例

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db" xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/db http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">
	<db:config >
		<db:my-sql-connection host="localhost" port="3306" user="root" password="mulesoft" database="demo" />
	</db:config>
	<http:listener-config name="HTTP_Listener_config" >
		<http:listener-connection host="0.0.0.0" port="8081" />
	</http:listener-config>
	<flow name="dbcon-demoFlow">
		<http:listener config-ref="HTTP_Listener_config" path="/insert"/>
		<db:bulk-insert config-ref="Database_Config">
			<db:bulk-input-parameters ><![CDATA[#[[{'id': 2, 'name': 'George', 'lastName': 'Costanza'}, {'id': 3, 'name': 'Cosmo', 'lastName': 'Kramer'}]]]]></db:bulk-input-parameters>
			<db:sql ><![CDATA[INSERT INTO CUSTOMERS (NAME, LAST_NAME) values (:name, :lastName)]]></db:sql>
		</db:bulk-insert>
	</flow>
	<flow name="dbcon-demoFlow1" >
		<http:listener config-ref="HTTP_Listener_config" path="update"/>
		<set-payload value="#[[{
	discountRate: 0.1,
	price: 50
},
{
	discountRate: 0.2,
	price: 150.5
}]]" doc:name="Set Payload" />
		<db:bulk-update config-ref="Database_Config">
			<db:sql ><![CDATA[UPDATE PRODUCTS SET PRICE = PRICE * :discountRate WHERE PRICE = :price]]></db:sql>
		</db:bulk-update>
	</flow>
	<flow name="dbcon-demoFlow2" >
		<http:listener config-ref="HTTP_Listener_config" path="/delete"/>
		<set-payload value="#[[{
	price: 11
},
{
	price: 133
}]]" doc:name="Set Payload" />
		<db:bulk-delete doc:name="Bulk delete" config-ref="Database_Config">
			<db:sql ><![CDATA[DELETE FROM PRODUCTS WHERE PRICE = :price]]></db:sql>
		</db:bulk-delete>
	</flow>
</mule>
```

## [](#関連情報)関連情報

- [Database Connector の例](https://docs.mulesoft.com/jp/db-connector/1.14/database-connector-examples)