--- sourceDocument: Yokohama ビルドのワークフロー sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/build-workflows Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama ビルドのワークフロー ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # JDBC ステップ # JDBC ステップ {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：7分 SQL コマンドをリレーショナルデータベースに送信するための再利用可能なアクションを作成します。 注: * このステップには 統合ハブ のサブスクリプションが必要です。詳細については、「[Legal schedules - 統合ハブ overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf) 必要なプラグインを有効化した後、ステップは \[統合\] の下に表示されます。 * JDBC ステップ は、JDBC ステップ 機能を備えた ServiceNow® MID サーバー でのみ実行されます。プラグイン 統合ハブ 標準パックインストーラー (com.glide.hub.integrations.standard) 以降を有効化して、MID サーバー の JDBC 機能を使用します。 {#jdbc-step__ul_qvn_mdm_phb} ## ロールと可用性 {#jdbc-step__section_pwq_rb5_kcb} JDBC ステップ は ワークフロースタジオ のアクションステップとして利用可能です。action_designer ロールを持つユーザーは、1 つ以上のアクションステップを使用してカスタムアクションを作成できます。 ## 入力のサニタイズ {#jdbc-step__section_gqd_cy4_qhb} すべてのユーザー入力をエスケープして、悪意のあるユーザーが悪意のある SQL ステートメントを実行してターゲットデータベースで SQL インジェクションが発生する可能性を排除します。JDBC ステップ SQL ステートメントでデータピルを使用する場合は、最初に [SQL のサニタイズ変換関数](https://servicenow-prod.fluidtopics.net/dN8iQa5ozsgH1Ff4sDZw1g "SQL のサニタイズ変換関数を使用して特殊文字をエスケープし、SQL ステートメントに使用される文字列データピルへの挿入を阻止します。")を使用してサニタイズしてください。この変換関数カテゴリは、データピルが SQL ステートメント入力にドロップされると自動的に表示されます。 ## SQL 操作包含リスト {#jdbc-step__section_jcg_rlr_whb} デフォルトでは、次の SQL 操作を実行できます。 * SELECT * INSERT * UPDATE * DELETE * 表示 * DESCRIBE {#jdbc-step__ul_cyg_vlr_whb}これらの SQL 操作のうち、JDBC ステップ で実行できる一部のみを有効にするには、MID サーバー プロパティ mid.property.jdbc_operations を作成し、SQL 操作をカンマで区切って入力します。MID サーバー プロパティの詳細については、「[MID サーバープロパティ](https://www.servicenow.com/docs/access?context=r_MIDServerProperties&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)」を参照してください。 注: 複数の SQL ステートメントを使用することはできません。出力パラメーターを持つストアドプロシージャはサポートされていません。 ## フィールド {#jdbc-step__section_a2b_zhj_2hb} {#jdbc-step__table_zms_zhj_2hb__entry__2}{#jdbc-step__use-conn-alias}{#jdbc-step__def-conn-inline} | フィールド | 説明 | |-|-| | 接続の詳細 || | 接続 | 使用する接続のタイプ。 * \[インラインで接続を定義\]：アクションステップ内の接続情報を定義します。 * \[接続エイリアスを使用\]：接続エイリアステーブルを使用して接続情報を定義します。エイリアスを使用することで、複数の環境でアクションを使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。また、接続情報が変更された場合に、カスタムアクションを更新する必要がありません。 {#jdbc-step__ul_bfs_tvt_khb} 接続と資格情報の詳細については、「[資格情報、接続、およびエイリアスについて](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)」を参照してください。 | | 接続エイリアス | アクションステップを実行するために使用される接続および資格情報エイリアスレコード。flow_designer または admin ロールを持つユーザーは、関連する接続レコードを作成または選択できます。エイリアスを使用することで、複数の環境でアクションを使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。また、接続情報が変更された場合に、カスタムアクションを更新する必要がありません。接続と資格情報の詳細については、「[資格情報、接続、およびエイリアス](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)」を参照してください。 認証情報の値は、データパネルにパスワード (双方向暗号化) データピルとして表示されます。 このフィールドは、接続リストから \[接続エイリアスを使用\] が選択されている場合に利用可能です。 | | 認証情報エイリアス | アクションステップを実行するために使用される認証情報エイリアス。flow_designer または admin ロールを持つユーザーは、関連する接続レコードを作成または選択できます。エイリアスを使用することで、複数の環境でアクションを使用する場合に、複数の認証情報を構成する必要がなくなります。また、認証情報が変更された場合に、カスタムアクションを更新する必要がありません。接続と資格情報の詳細については、「[資格情報、接続、およびエイリアス](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)」を参照してください。 認証情報の値は、データパネルにパスワード (双方向暗号化) データピルとして表示されます。 このフィールドは、接続リストから \[インラインで接続を定義\] が選択されている場合に利用可能です。 | | MID 選択 | 特定の MID サーバーまたは MID クラスターを選択するオプション。次のいずれかのオプションを選択します。 * MID サーバーの自動選択: ServiceNow インスタンスは手動入力なしで MID サーバー を選択します。 * 特定の MID サーバー: ServiceNow インスタンスは、指定した MID サーバー を使用します。 * 特定の MID クラスター: ServiceNow インスタンスは、指定した MID クラスターを使用します。 MID クラスターは、 ServiceNow インスタンスが複数の統合を処理できるようにする MID サーバーのグループであり、統合速度を向上させます。詳細については、「[Configure a MID Server cluster](https://www.servicenow.com/docs/access?context=t_ConfigureAMIDServerCluster&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)」を参照してください。 {#jdbc-step__ul_rlh_5fb_htb} このフィールドは、接続リストから \[インラインで接続を定義\] が選択されている場合に利用可能です。 | | MID クラスター | 使用する MID クラスターのデータピル。このフィールドは、接続リストから \[インラインで接続を定義\] が選択されていて、MID 選択リストから \[特定の MID クラスター\] が選択されている場合に利用可能です。 | | データベースタイプ | この接続のデータベース タイプ。以下から選択可能です。 * MySQL * Oracle * SQLServer * カスタム {#jdbc-step__ul_z1k_tcm_phb}デフォルトの選択は \[カスタム\] です。 このフィールドは、接続リストから \[インラインで接続を定義\] が選択されている場合に利用可能です。 | | JDBC ドライバー | DB2 Universal や Sybase などのデフォルトのデータベースタイプでない場合に、この接続に使用するドライバー。データベースタイプは \[カスタム\] です。このフィールドは、接続リストから \[インラインで接続を定義\] が選択されていて、データベースタイプリストから \[カスタム\] が選択されている場合に利用可能です。 | | 接続 URL | 指定したデータベースへの接続に MID サーバー が使用する URL。この URL は、フォームを保存したときに自動的に作成され、デフォルトのデータベースでは読み取り専用になります。このフィールドは、接続リストから \[インラインで接続を定義\] が選択されていて、データベースタイプリストから \[カスタム\] が選択されている場合に利用可能です。 | | MID アプリケーション | 選択対象となるために MID サーバー がサポートする必要があるアプリケーションです。 このフィールドは、接続リストから \[インラインで接続を定義\] が選択されている場合に利用可能です。 | | 機能 | MID サーバー の機能。\[JDBC\] を選択します。 このフィールドは、接続リストから \[インラインで接続を定義\] が選択されている場合に利用可能です。 | | 接続タイムアウト | ターゲットデータベースへの接続の試行中にアクティビティが待機する最大経過時間 (秒)。 このフィールドは、接続リストから \[インラインで接続を定義\] が選択されている場合に利用可能です。 注: 接続が古くなる可能性があるため、\[接続タイムアウト\] 値をゼロに設定しないでください。 | | クエリ タイムアウト | クエリを応答なしで実行できる最大経過時間 (秒)。 このフィールドは、接続リストから \[インラインで接続を定義\] が選択されている場合に利用可能です。 | | JDBC 構成 || | SQL ステートメント | ステップが実行する SQL ステートメント。 注: ステップ SQL ステートメントでデータピルを使用する場合は、最初に前処理[スクリプトステップ](https://servicenow-prod.fluidtopics.net/KBoZv0BOISJp0li1~KkKmA "再利用可能なアクションの中実行するカスタムの JavaScript を追加します。ほとんどのコア アクションおよびステップは一般的な使用例に適していますが、コア ステップでは満たされない動作を実行するスクリプト ステップを作成できます。")を使用してそれらをサニタイズします。詳細については、「[エスケープ関数を使用した入力のサニタイズ](https://servicenow-prod.fluidtopics.net/WBL9z~~uyA6Wo64j08VfCQ#jdbc-step__section_gqd_cy4_qhb)」を参照してください。 | | 最大行数 | SQL ステートメントから返される最大行数。デフォルト値は 1,000 です。 | | 最大ペイロードサイズ (KB) | SQL ステートメントから返される最大許容ペイロードサイズ (KB)。デフォルトのペイロードサイズは 5120 KB です。最大ペイロードサイズは 10 MB です。 | | JDBC ステップのテスト | JDBC ステップをテストします。\[JDBC ステップのテスト (Test JDBC Step)\] ウィンドウにテスト結果が直接表示されます。詳細については、「[JDBC ステップのテスト](https://servicenow-prod.fluidtopics.net/Ey0FwOkdTT~vP51AMLmx1A "JDBC ステップを含むアクションをテストまたは公開する前に、JDBC ステップをテストしてください。")」を参照してください。 | | 再試行ポリシー || | 再試行ポリシーを有効化 | 再試行ポリシーを有効にするオプション。詳細については、「[再試行ポリシー](https://servicenow-prod.fluidtopics.net/28vchUEtiyDd1gZWVGdXaw#retry-policy "ステップでネットワーク障害や要求レート制限などの断続的な問題が発生した際は、失敗した要求を自動で再試行します。ステップを手動で再トリガーする必要がないように、再試行ポリシーを設定します。")」を参照してください。 | | エイリアスのデフォルトポリシーを上書き | デフォルトの再試行ポリシーを上書きするオプション。接続リストの \[インラインで接続を定義\] が選択されている場合は、このオプションは適用されません。 | | 再試行ポリシー | 接続エイリアスに関連付けられているデフォルトの再試行ポリシー。エイリアスのデフォルトポリシーを上書きが選択されている場合は、デフォルトの再試行ポリシーを上書きして要件に基づいて別の既存の再試行ポリシーを選択できます。 | [ ] {#jdbc-step__table_zms_zhj_2hb} ## アクションエラー評価 {#jdbc-step__id_lg2_4s3_15b} このステップが失敗した場合 : データタイプ：Choice 次のステップの実行を続行するか、エラー評価に進むオプション。カスタムアクションのエラー条件のステップのステータスコードやメッセージを使用するには、「[アクションエラー評価](https://servicenow-prod.fluidtopics.net/I4OsrWdiNF4J~7LkWG~O7w "アクションを有効化してステップの失敗を検出し、実行を継続します。特定のエラー状態が発生するタイミングを特定して、独自のアクションステータスコード、ステータスメッセージ、エラー状態を返します。")」を参照してください。 * **[JDBC ステップのテスト](https://servicenow-prod.fluidtopics.net/Ey0FwOkdTT~vP51AMLmx1A)** JDBC ステップを含むアクションをテストまたは公開する前に、JDBC ステップをテストしてください。