Update Database

(JDBC Connectors)

概要

この演算子は、データベース内の一致するID値ですべての例の値を更新します。

詳細

Update Databaseオペレータは、指定されたSQLデータベース内の既存のテーブルを更新するために使用されます。この演算子を適切に使用するには、少なくともデータベースとデータベース接続の基本的な理解が必要です。この演算子のフローを理解するには、パラメータと添付のサンプルプロセスを確認してください。

ユーザーは、データベース接続、テーブル名、ID列名を指定できます。必要なパラメータを定義する最も便利な方法は、データベース接続の管理ウィザードです。最も重要なパラメータ（データベースURLおよびユーザー名）は、このウィザードによって自動的に決定されます。

更新する行は、db id属性名パラメータを介して指定されます。テーブルのid列が特定の例のすべてのid値と一致しない場合、代わりに行が挿入されます。 ExampleSet属性名は、テーブル列名のサブセットである必要があります。そうでない場合、演算子は失敗します。

入力

input (IOObject)
この入力ポートには、ExampleSetが必要です。添付のプロセス例のRetrieveオペレータの出力です。

connection (Connection)
この入力ポートは、Connectionオブジェクトがあればそれを想定しています。詳細については、パラメータ接続エントリを参照してください。

出力

through (IOObject)
入力ポートで提供されたExampleSetは、変更なしでこの出力ポートを介して配信されます。これは通常、プロセスのさらに別の演算子で同じExampleSetを再利用するために使用されます。

connection (Connection)
この出力ポートは、入力ポートから接続オブジェクトを配信します。入力ポートが接続されていない場合、ポートは何も配信しません。

パラメータ

define_connection
このパラメータは、データベース接続の指定方法を示します。リポジトリ、事前定義、url、jndiの4つのオプションがあります。接続入力ポートが接続されている場合、パラメータは表示されません。
レンジ：selection

connection_entry
このパラメータは、接続定義パラメータがリポジトリーに設定されている場合にのみ使用可能です。このパラメータは、接続エントリを表すリポジトリの場所を指定するために使用されます。接続は、接続入力ポートを使用して提供することもできます。
レンジ：string

connection
このパラメータは、接続定義パラメータが事前定義に設定されている場合にのみ使用可能です。このパラメータは、事前定義された接続を使用してデータベースに接続するために使用されます。多くの定義済み接続を使用できます。ドロップダウンボックスを使用して、いずれかを選択できます。ドロップダウンボックスの横にあるボタンを使用して、新しい接続を追加したり、以前の接続を変更したりできます。また、メインウィンドウの[ツール]メニューから[データベース接続の管理…]をクリックして、これを実行することもできます。新しいウィンドウが表示されます。このウィンドウはいくつかの詳細を要求します。ホスト、ポート、データベースシステム、スキーマ、ユーザー名、パスワード。この新しいウィンドウの[テスト]ボタンを使用すると、接続を確立できるかどうかを確認できます。テストが成功したら、接続を保存します。新しい接続を保存した後、接続パラメータのドロップダウンボックスから選択できます。接続を設定するには、データベースの基本的な理解が必要です。
レンジ：string

database_system
このパラメータは、接続定義パラメータがurlに設定されている場合にのみ使用可能です。このパラメータは、使用中のデータベースシステムを選択するために使用されます。 MySQL、PostgreSQL、Sybase、HSQLDB、ODBC Bridge（例：Access）、Microsoft SQL Server（JTDS）、Ingres、Oracleのいずれかの値を持つことができます。
レンジ：selection

database_url
このパラメータは、接続定義パラメータがurlに設定されている場合にのみ使用可能です。このパラメータは、データベースのURL接続文字列を定義するために使用されます。「jdbc：mysql：//foo.bar：portnr / database」。
レンジ：string

username
このパラメータは、接続定義パラメータがurlに設定されている場合にのみ使用可能です。このパラメータは、データベースのユーザー名を指定するために使用されます。
レンジ：string

password
このパラメータは、接続定義パラメータがurlに設定されている場合にのみ使用可能です。このパラメータは、データベースのパスワードを指定するために使用されます。
レンジ：string

jndi_name
このパラメータは、接続定義パラメータがjndiに設定されている場合にのみ使用可能です。このパラメータは、JNDIにデータソースの名前を付けるために使用されます。
レンジ：string

table_name
このパラメータは、指定されたデータベースから必要なテーブルを選択するために使用されます。ここにテーブル名を書き込むこともできます。テーブルが存在しない場合は、書き込み中に作成されます。
レンジ：

attribute_filter_type
このパラメータを使用すると、更新する行の例セットとデータベースですべての値が一致する必要があるID属性を選択できます。次のオプションがあります。
ｏall：このコンテキストでは意味をなさないため、使用しないでください。プロセスが中断します。
ｏsingle：このオプションは、単一のid属性の選択を許可します。
ｏsubset：このオプションを使用すると、リストから複数のid属性を選択できます。メタデータが不明な場合、このオプションは機能しません。
ｏregular_expression：このオプションを使用すると、id属性選択用の正規表現を指定できます。このオプションを選択すると、他のいくつかのパラメータ（正規表現、式以外の使用）がパラメータパネルに表示されます。
ｏvalue_type：このオプションを使用すると、特定のタイプのすべてのid属性を選択できます。型は階層的であることに注意してください。たとえば、実数型と整数型は両方とも数値型に属します。ユーザーは、このオプションを使用して属性を選択するときに、タイプ階層の基本的な理解が必要です。このオプションを選択すると、他のパラメータ（値タイプ、値タイプ例外を使用）がパラメータパネルに表示されます。
ｏblock_type：このオプションは、value_typeオプションと同様に機能します。このオプションを使用すると、特定のブロックタイプのすべての属性を選択できます。ブロックタイプは階層的であることに注意する必要があります。たとえば、value_series_startおよびvalue_series_endブロックタイプは両方ともvalue_seriesブロックタイプに属します。このオプションを選択すると、他のいくつかのパラメータ（ブロックタイプ、ブロックタイプの例外を使用）がパラメータパネルに表示されます。
ｏno_missing_values：このオプションは、どの例でも欠損値を含まないExampleSetのすべての属性を選択するだけです。欠損値が1つでもある属性は削除されます。
ｏnumeric_value_filter：このオプションを選択すると、別のパラメータ（数値条件）がパラメータパネルに表示されます。例がすべて上記の数値条件を満たす数値属性がすべて選択されます。指定された数値条件に関係なく、すべての名義属性も選択されることに注意してください。
レンジ：selection

チュートリアルプロセス

mySQLデータベースのExampleSetの更新
「アイリス」データセットは、Retrieve演算子を使用してロードされます。データベースの更新演算子は、「My connection」SQLデータベースの「Test」という名前の既存のデータベーステーブルを更新するために使用されます。「ID」列と一致するサンプルセットとテーブルの行が更新されます。一致するものが見つからない場合、代わりに行が挿入されます。