Execute SQL

概要

この演算子は、指定されたデータベースで指定されたSQLステートメントを実行します。

詳細

SQL実行演算子は、指定されたSQLデータベースで指定されたSQLステートメントを実行します。 SQLクエリは、 クエリパラメータを使用して指定できます。 SQLクエリがファイル内にある場合、そのファイルのパスはクエリファイルパラメーターを介して指定できます。この演算子は、データベースからのデータのロードには使用できないことに注意してください。 CREATEやADDなどのSQLステートメントの実行に使用できます。SQLデータベースからデータをロードするには、Read Databaseオペレーターを使用してください。この演算子を適切に使用するには、少なくともデータベース、データベース接続、およびクエリの基本的な理解が必要です。この演算子の動作を理解するには、パラメーターと添付のサンプルプロセスを確認してください。

分化

Read Database

Read Databaseオペレーターは、データベースからRapidMinerにデータをロードするために使用されます。 SQLの実行演算子は、データベースからのデータのロードには使用できません。データベースでCREATEやADDなどのSQLステートメントを実行するために使用できます。

入力

接続（接続）この入力ポートは、Connectionオブジェクトがあればそれを想定しています。詳細については、パラメータ接続エントリを参照してください。
スルー（IOObject）このポートにオブジェクトを接続することは必須ではありません。このポートで接続されたオブジェクトは、出力ポートを変更せずに配信されます。この演算子は複数の入力を持つことができます。ある入力が接続されると、別の入力（ある場合）を受け入れる準備ができている別の入力ポートを介して使用可能になります。入力の順序は同じままです。 SQL実行演算子の最初の入力ポートで提供されたオブジェクトは、最初の出力ポートで使用可能です。

出力

接続（接続）この出力ポートは、入力ポートから接続オブジェクトを配信します。入力ポートが接続されていない場合、ポートは何も配信しません。
スルー（IOObject）入力として与えられたオブジェクトは、このポートを介して出力に変更されることなく渡されます。このポートを他のポートに接続することは必須ではありません。このポートが接続されていない場合でも、SQLコマンドが実行されます。 SQL実行演算子には、複数の出力を含めることができます。 1つの出力が接続されると、出力ポートを介して別の出力が使用可能になり、別の出力（ある場合）を配信する準備が整います。出力の順序は同じままです。 SQL実行演算子の最初の入力ポートで配信されたオブジェクトは、最初の出力ポートで配信されます

パラメーター

define_connectionこのパラメーターは、データベース接続の指定方法を示します。リポジトリ、事前定義、url、jndiの4つのオプションがあります。接続入力ポートが接続されている場合、パラメーターは表示されません。範囲：選択
connection_entryこのパラメーターは、 接続定義パラメーターがrepositoryに設定されている場合にのみ使用可能です。このパラメータは、接続エントリを表すリポジトリの場所を指定するために使用されます。接続は、接続入力ポートを使用して提供することもできます。範囲：文字列
connectionこのパラメーターは、 接続定義パラメーターが事前定義済みに設定されている場合にのみ使用可能です。このパラメーターは、事前定義された接続を使用してデータベースに接続するために使用されます。多くの定義済み接続を使用できます。ドロップダウンリストを使用して、それらのいずれかを選択できます。ドロップダウンリストの横にあるボタンを使用して、新しい接続を追加したり、以前の接続を変更したりできます。また、メインウィンドウの[ ツール ]メニューから[データベース接続の管理… ]をクリックして、これを実行することもできます。新しいウィンドウが表示されます。このウィンドウでは、 ホスト、ポート、データベースシステム、スキーマ、ユーザー名 、 パスワードなど、いくつかの詳細を入力します 。この新しいウィンドウの[ テスト ]ボタンを使用すると、接続を確立できるかどうかを確認できます。テストが成功したら、接続を保存します。新しい接続を保存した後、接続パラメーターのドロップダウンリストから選択できます。接続を構成するには、データベースの基本的な理解が必要です。範囲：選択
database_systemこのパラメーターは、 接続定義パラメーターがurlに設定されている場合にのみ使用可能です。このパラメータは、使用中のデータベースシステムを選択するために使用されます。 MySQL、PostgreSQL、Sybase、HSQLDB、ODBCブリッジ（Accessなど）、Microsoft SQL Server（JTDS）、Ingres、Oracleのいずれかの値を持つことができます。範囲：選択
database_urlこのパラメーターは、 接続定義パラメーターがurlに設定されている場合にのみ使用可能です。このパラメーターは、データベースのURL接続文字列を定義するために使用されます（例： ‘jdbc：mysql：//foo.bar：portnr / database’）。範囲：文字列
usernameこのパラメーターは、 接続定義パラメーターがurlに設定されている場合にのみ使用可能です。このパラメーターは、データベースのユーザー名を指定するために使用されます。範囲：文字列
passwordこのパラメーターは、 接続定義パラメーターがurlに設定されている場合にのみ使用可能です。このパラメーターは、データベースのパスワードを指定するために使用されます。範囲：文字列
jndi_nameこのパラメーターは、 接続定義パラメーターがjndiに設定されている場合にのみ使用できます。このパラメーターは、データソースのJNDI名を指定するために使用されます。範囲：文字列
queryこのパラメーターは、指定されたデータベースで実行されるSQLクエリを指定するために使用されます。範囲：文字列
query_fileこのパラメーターは、指定されたデータベースで実行されるSQLクエリを含むファイルを選択するために使用されます。通常、長いクエリはファイルに保存されます。クエリをファイルに保存すると、再利用性も向上します。範囲：ファイル名
prepare_statementチェックすると、ステートメントが準備され、「？」 parametersパラメーターを使用して入力できます。範囲：ブール
parametersこのパラメーターは、「？」に挿入するパラメーターを指定しますステートメントが準備されるときのプレースホルダー。範囲：列挙

チュートリアルプロセス

mySQLデータベースに新しいテーブルを作成

SQL実行演算子は、既存のmySQLデータベースに新しいテーブルを作成するために使用されます。接続定義パラメーターは事前定義に設定されます。接続定義パラメーターは、ドロップダウンリストの横のボタンを使用して構成されました。接続の名前は「mySQLconn」に設定されました。次の値は、接続パラメーターのウィザードで設定されました。データベースシステムは「mySQL」に設定されました。ホストは「localhost」に設定されました。ポートは「3306」に設定されました。データベーススキームは「ゴルフ」に設定されました。これはデータベースの名前です。ユーザーは「root」に設定されました。パスワードが提供されませんでした。データベースがパスワードで保護されている場合、パスワードが必要です。すべての値を設定し、接続をテストします。接続が機能することを確認してください。

クエリパラメーターは次のクエリに設定されます： ‘CREATE TABLE Weather（Temperature INTEGER）’。このクエリは、「ゴルフ」データベースにWeatherという名前の新しいテーブルを作成します。このテーブルには、Temperatureという名前の整数属性が1つあります。プロセスを実行すると、この演算子は何も返さなかったため、RapidMinerには結果が表示されません。指定されたデータベースに対してクエリを実行しただけです。したがって、変更を確認するには、データベースを開き、新しいテーブルが作成されたことを確認します。