適用対象: Azure Logic Apps (従量課金 + 標準)
自動統合ワークフローで DB2 データベース内のリソースを操作する必要がある場合は、 DB2 コネクタ を使用して、データベースに対して異なる操作を実行します。 たとえば、ワークフローでは、テーブルまたは行の読み取り、一覧表示、行の追加、行の更新、行の削除などを行うことができます。 これらのアクションは、使用するワークフロー内の他のアクションのデータをデータベースから返すことができます。
DB2 コネクタには、TCP/IP ネットワーク経由でリモート DB2 サーバーと通信する Microsoft クライアントが含まれています。 このコネクタを使用して、Azure 仮想化で実行されている IBM DB2 for Windows などのクラウド データベースにアクセスできます。
このガイドでは、DB2 アクションをワークフローに追加し、DB2 データベースへの接続を設定する方法について説明します。
サポートされているプラットフォームとバージョン
DB2 コネクタは、次の IBM DB2 プラットフォームとバージョン、および分散リレーショナル・データベース・アーキテクチャ (DRDA) SQL Access Manager (SQLAM) バージョン 10 および 11 をサポートする IBM DB2 互換製品をサポートしています。
| プラットフォーム | Version |
|---|---|
| IBM DB2 for z/OS | 12、11.1、10.1 |
| IBM DB2 for i | 7.3、7.2、7.1 |
| IBM DB2 for LUW | 11、10.5 |
コネクタに関するテクニカル リファレンス
DB2 コネクタは、次のデータベース操作をサポートしています。この操作は、コネクタ内の対応するアクションにマップされます。
| データベース操作 | コネクタ アクション |
|---|---|
| データベース テーブルの一覧表示 | テーブルを取得する |
| SELECT を使用した 1 つの行の読み取り | 行を取得する |
| SELECT を使用したすべての行の読み取り | 行を取得する |
| INSERT を使用した 1 つの行の追加 | 行を挿入する |
| UPDATE を使用した 1 つの行の編集 | 行を更新する |
| DELETE を使用した 1 つの行の削除 | 行を削除する |
コネクタとこれらのアクションの詳細については、 DB2 コネクタを参照してください。
前提条件
Azure アカウントとサブスクリプション。 無料の Azure アカウントを取得します。
クラウドベースまたはオンプレミスの IBM DB2 データベース。
DB2 データベースにアクセスするロジック アプリのリソースとワークフロー。
DB2 コネクタはアクションのみを提供します。 空のワークフローがある場合は、まず、シナリオに最適 なトリガーを追加 する必要があります。
このガイドの例では、 繰り返し トリガーを使用します。
詳細については、以下を参照してください。
ワークフローをオンプレミスの DB2 データベースに接続するには、まず オンプレミス データ ゲートウェイをインストールして設定します。
DB2 アクションを追加する
次の手順では、テーブルの 取得などの DB2 アクションをワークフローに追加する方法を示します。
注
他の DB2 アクションを追加する手順は、指定したアクションのパラメーターと値を除き、同様です。
Azure portal のデザイナーで、ロジック アプリ リソースとワークフローを開きます。
一般的な手順に従って、テーブルの取得という名前の DB2 アクションを追加します。
接続情報ペインが開き、DB2 データベースに接続するための詳細を指定できます。
手順に従って 、クラウドベースのデータベース または オンプレミス データベースの接続を作成し、ここに戻って続行します。
接続が正常に作成されると、[テーブルの 取得 ] アクション情報ウィンドウが表示され、他の情報は必要ないことを示します。
続行して ワークフローをテストし、出力テーブルを表示します。
DB2 接続を設定する
クラウドデータベースとオンプレミス DB2 データベースのどちらを使用しているかに基づいて、手順に従います。 必要な接続の詳細を指定したら、[ 新規作成] を選択し、前の手順に戻ります。
オンプレミス データベースへの接続を作成する前に、必ず オンプレミス データ ゲートウェイをインストールして設定してください。
| プロパティ | 必須 | 説明 |
|---|---|---|
| オンプレミスのゲートウェイ経由で接続 | いいえ | オンプレミス接続にのみ適用されます。 |
| 接続名 | はい | 接続の名前 ( DB2 接続など)。 |
| サーバー | はい | MYDB2SERVER.CLOUDAPP.NET:50000 など、DB2 サーバーのアドレスまたは エイリアスとポート番号。 注意: この値は、IPv4 または IPv6 形式の TCP/IP アドレスまたはエイリアスを表す文字列の後に、コロンと TCP/IP ポート番号が続きます。 |
| [データベース] | はい | データベースの名前。 注意: この値は、DRDA リレーショナル データベース名 (RDBNAM) を表す文字列です。 - DB2 for z/OS は、データベースが IBM DB2 for z/OS の場所と呼ばれる 16 バイトの文字列を受け入れます。 - DB2 for i は、データベースが IBM DB2 for i リレーショナル・データベースと呼ばれる 18 バイトのストリングを受け入れます。 - DB2 for LUW は、8 バイトの文字列を受け入れます。 |
| ユーザー名 | はい | データベースのユーザー名。 注意: この値の文字列は次のようにデータベースごとに長さが異なります。 - DB2 for z/OS は、8 バイトの文字列を受け入れます。 - DB2 for i は、10 バイトの文字列を受け入れます。 - DB2 for Linux または DB2 for UNIX は、8 バイトの文字列を受け入れます。 - DB2 for Windows は、30 バイトの文字列を受け入れます。 |
| パスワード | はい | データベースのパスワード。 |
次に例を示します。
ワークフローをテストし、出力テーブルを表示する
ワークフローを手動で実行するには、デザイナーのツール バーの [実行 ] ボックスの一覧から [ 実行] を選択します。 ワークフローが完了したら、実行からの出力を表示できます。
実行の詳細ページが開かない場合は、ロジック アプリに基づいて次の手順に従います。
消費: ロジック アプリのサイドバーで、開発ツール の下にある ロジック アプリ デザイナー を選択します。
標準: ワークフローサイドバーで、[ 実行履歴] を選択します。
[ 実行履歴 ] の一覧で、最新のワークフロー実行を選択します。次に例を示します。
消費
標準
![[標準ワークフローの実行履歴] リストを示すスクリーンショット。](media/connectors-create-api-db2/run-history-standard.png)
実行の詳細ページで、ワークフローの各ステップの状態を確認します。 各ステップの入力と出力を表示するには、そのステップを選択します。次に例を示します。
![[テーブルの取得] アクションの入力と出力を示すスクリーンショット。](media/connectors-create-api-db2/get-tables-run-history.png)
JSON で入力を表示するには、[ 生の入力の表示] を選択します。
JSON で出力を表示するには、[ 生出力の表示] を選択します。
出力には、次のようなテーブルの一覧が含まれます。
![[テーブルの取得] アクションからの出力を示すスクリーンショット。](media/connectors-create-api-db2/get-tables-outputs.png)