JDBC ステップ
SQL コマンドをリレーショナルデータベースに送信するための再利用可能なアクションを作成します。
注:
- このステップには 統合ハブ のサブスクリプションが必要です。詳細については、「 法務スケジュール - 統合ハブ の概要」を参照してください。 必要なプラグインを有効化した後、ステップは [統合] の下に表示されます。
- JDBC ステップ は、JDBC ステップ 機能を備えた ServiceNow® MID サーバー でのみ実行されます。プラグイン 統合ハブ 標準パックインストーラー (com.glide.hub.integrations.standard) 以降を有効化して、MID サーバー の JDBC 機能を使用します。
ロールと可用性
JDBC ステップ は ワークフロースタジオ のアクションステップとして利用可能です。action_designer ロールを持つユーザーは、1 つ以上のアクションステップを使用してカスタムアクションを作成できます。
入力のサニタイズ
すべてのユーザー入力をエスケープして、悪意のあるユーザーが悪意のある SQL ステートメントを実行してターゲットデータベースで SQL インジェクションが発生する可能性を排除します。JDBC ステップ SQL ステートメントでデータピルを使用する場合は、最初に SQL のサニタイズ変換関数を使用してサニタイズしてください。この変換関数カテゴリは、データピルが SQL ステートメント入力にドロップされると自動的に表示されます。
SQL 操作包含リスト
デフォルトでは、次の SQL 操作を実行できます。
- SELECT
- 挿入
- 更新
- 消去
- 表示
- DESCRIBE
注:
複数の SQL ステートメントを使用することはできません。出力パラメーターを使用するストアド プロシージャはサポートされていません。
フィールド
| フィールド | 説明 |
|---|---|
| 接続の詳細 | |
| 接続 | 使用する接続のタイプ。
接続と資格情報の詳細については、「資格情報、接続、およびエイリアスについて」を参照してください。 |
| 接続エイリアス | アクションステップを実行するために使用される接続および資格情報エイリアスレコード。flow_designer または admin ロールを持つユーザーは、関連する接続レコードを作成または選択できます。エイリアスを使用することで、複数の環境でアクションを使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。また、接続情報が変更された場合に、カスタムアクションを更新する必要がありません。接続と資格情報の詳細については、「資格情報、接続、およびエイリアス」を参照してください。 認証情報の値は、データパネルにパスワード (双方向暗号化) データピルとして表示されます。 このフィールドは、接続リストから [接続エイリアスを使用] が選択されている場合に利用可能です。 |
| 認証情報エイリアス | アクションステップを実行するために使用される認証情報エイリアス。flow_designer または admin ロールを持つユーザーは、関連する接続レコードを作成または選択できます。エイリアスを使用することで、複数の環境でアクションを使用する場合に、複数の認証情報を構成する必要がなくなります。また、認証情報が変更された場合に、カスタムアクションを更新する必要がありません。接続と資格情報の詳細については、「資格情報、接続、およびエイリアス」を参照してください。 認証情報の値は、データパネルにパスワード (双方向暗号化) データピルとして表示されます。 このフィールドは、接続リストから [インラインで接続を定義] が選択されている場合に利用可能です。 |
| MID 選択 | 特定の MID サーバーまたは MID クラスターを選択するオプション。次のいずれかのオプションを選択します。
|
| MID クラスター | 使用する MID クラスターのデータピル。このフィールドは、接続リストから [インラインで接続を定義] が選択されていて、MID 選択リストから [特定の MID クラスター] が選択されている場合に利用可能です。 |
| データベースタイプ | この接続のデータベース タイプ。以下から選択可能です。
|
| JDBC ドライバー | DB2 Universal や Sybase などのデフォルトのデータベースタイプでない場合に、この接続に使用するドライバー。データベースタイプは [カスタム] です。このフィールドは、接続リストから [インラインで接続を定義] が選択されていて、データベースタイプリストから [カスタム] が選択されている場合に利用可能です。 |
| 接続 URL | 指定したデータベースへの接続に MID サーバー が使用する URL。この URL は、フォームを保存したときに自動的に作成され、デフォルトのデータベースでは読み取り専用になります。このフィールドは、接続リストから [インラインで接続を定義] が選択されていて、データベースタイプリストから [カスタム] が選択されている場合に利用可能です。 |
| MID アプリケーション | 選択対象となるために MID サーバー がサポートする必要があるアプリケーションです。 このフィールドは、接続リストから [インラインで接続を定義] が選択されている場合に利用可能です。 |
| できること | MID サーバー の機能。[JDBC] を選択します。 このフィールドは、接続リストから [インラインで接続を定義] が選択されている場合に利用可能です。 |
| 接続タイムアウト | ターゲットデータベースへの接続の試行中にアクティビティが待機する最大経過時間 (秒)。 このフィールドは、接続リストから [インラインで接続を定義] が選択されている場合に利用可能です。 注: 接続タイムアウト値をゼロに設定しないでください。接続が古くなる可能性があるためです。 |
| クエリ タイムアウト | クエリを応答なしで実行できる最大経過時間 (秒)。 このフィールドは、接続リストから [インラインで接続を定義] が選択されている場合に利用可能です。 |
| JDBC 構成 | |
| SQL ステートメント | ステップが実行する SQL ステートメント。 注: ステップ SQL ステートメントでデータピルを使用する場合は、最初に前処理スクリプトステップを使用してそれらをサニタイズします。詳細については、「エスケープ関数を使用した入力のサニタイズ」を参照してください。 |
| 最大行数 | SQL ステートメントから返される最大行数。デフォルト値は 1,000 です。 |
| 最大ペイロードサイズ (KB) | SQL ステートメントから返される最大許容ペイロードサイズ (KB)。デフォルトのペイロードサイズは 5120 KB です。最大ペイロードサイズは 10 MB です。 |
| JDBC ステップのテスト | JDBC ステップをテストします。[JDBC ステップのテスト (Test JDBC Step)] ウィンドウにテスト結果が直接表示されます。詳細については、「JDBC ステップのテスト」を参照してください。 |
| 再試行ポリシー | |
| 再試行ポリシーを有効化 | 再試行ポリシーを有効にするオプション。詳細については、「再試行ポリシー」を参照してください。 |
| エイリアスのデフォルトポリシーを上書き | デフォルトの再試行ポリシーを上書きするオプション。接続リストの [インラインで接続を定義] が選択されている場合は、このオプションは適用されません。 |
| 再試行ポリシー | 接続エイリアスに関連付けられているデフォルトの再試行ポリシー。エイリアスのデフォルトポリシーを上書きが選択されている場合は、デフォルトの再試行ポリシーを上書きして要件に基づいて別の既存の再試行ポリシーを選択できます。 |
アクションエラー評価
- このステップが失敗した場合
- データタイプ：Choice
次のステップの実行を続行するか、エラー評価に進むオプション。カスタムアクションのエラー条件のステップのステータスコードやメッセージを使用するには、「アクションエラー評価」を参照してください。