Azure Logic Apps を使用して IBM DB2 リソースにアクセスして管理する
適用対象: Azure Logic Apps (従量課金)
Azure Logic Apps および IBM DB2 コネクタを使用すると、DB2 データベースに格納されたリソースに基づいて、自動化されたタスクとワークフローを作成できます。 ワークフローをデータベース内のリソースに接続して、データベース テーブルの読み取りや一覧表示、行の追加、行の変更、行の削除などを行うことができます。 データベースからの応答を取得して、出力を他のアクションで使用できるようにするアクションをロジック アプリに組み込むことができます。
この記事では、様々なデータベース操作を実行するロジック アプリを作成する方法を説明します。 ロジック アプリを初めて使用する場合は、「Azure Logic Apps とは」を参照してください。
サポートされているプラットフォームとバージョン
DB2 コネクタには、TCP/IP ネットワーク経由でリモート DB2 サーバーと通信する Microsoft クライアントが含まれています。 このコネクタを使用して、Azure 仮想化で実行されている IBM DB2 for Windows などのクラウド データベースにアクセスできます。 また、オンプレミス データ ゲートウェイをインストールして設定すれば、オンプレミス DB2 データベースにもアクセスできます。
IBM DB2 コネクタでは、次の IBM DB2 のプラットフォームとバージョンに加え、分散型リレーショナル データベース アーキテクチャ (DRDA) SQL アクセス マネージャー (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 |
サポートされるデータベース操作
IBM DB2 コネクタでサポートされる次のデータベース操作は、コネクタの対応するアクションにマップされています。
| データベース操作 | コネクタ アクション |
|---|---|
| データベース テーブルの一覧表示 | テーブルを取得する |
| SELECT を使用した 1 つの行の読み取り | 行を取得する |
| SELECT を使用したすべての行の読み取り | 複数行を取得 |
| INSERT を使用した 1 つの行の追加 | 行の挿入 |
| UPDATE を使用した 1 つの行の編集 | 行を更新します |
| DELETE を使用した 1 つの行の削除 | 行の削除 |
前提条件
Azure アカウントとサブスクリプション。 Azure サブスクリプションがない場合は、無料の Azure アカウントにサインアップしてください。
IBM DB2 データベース (クラウドベースまたはオンプレミス)
ロジック アプリの作成方法に関する基本的な知識。 詳細については、従量課金ロジック アプリ ワークフローの例の作成に関するページをご覧ください
DB2 データベースにアクセスするためのロジック アプリ。 このコネクタではアクションのみが提供されるため、ロジック アプリを開始するには、繰り返しトリガーなどのトリガーを別に選択してください。 この記事の例では、Recurrence トリガーを使用します。
DB2 アクションを追加する - テーブルの取得
Azure Portal のロジック アプリ デザイナーでロジック アプリを開きます (まだ開いていない場合)。
トリガーで、 [新しいステップ] を選択します。
検索ボックスに、フィルターとして「db2」と入力します。 この例では、アクション一覧の下で [テーブルの取得 (プレビュー)] アクションを選択します。
ここで、DB2 データベースの接続の詳細を指定するように求められます。
手順に従って、クラウド データベースまたはオンプレミス データベースの接続を作成します。
クラウド DB2 に接続する
接続を設定するには、求められたら次に示す接続の詳細を指定し、[作成] を選択して、ロジック アプリを保存します。
| プロパティ | Required | 説明 |
|---|---|---|
| オンプレミスのゲートウェイ経由で接続 | いいえ | オンプレミス接続にのみ適用されます。 |
| Connection Name | はい | 「MyLogicApp-DB2-connection」など、接続の名前 |
| サーバー | はい | 「myDB2server.cloudapp.net:50000」など、DB2 サーバーのアドレスまたはエイリアスとコロンとポート番号 注意: この値は、IPv4 または IPv6 形式の TCP/IP アドレスまたはエイリアスを表す文字列の後に、コロンと TCP/IP ポート番号が続きます。 |
| データベース | はい | データベースの名前 注意: この値は、DRDA リレーショナル データベース名 (RDBNAM) を表す文字列です。 - DB2 for z/OS は、16 バイトの文字列を受け入れます (database は "IBM DB2 for z/OS" の場所です)。 |
| ユーザー名 | はい | データベースのユーザー名 注意: この値の文字列は次のようにデータベースごとに長さが異なります。 - DB2 for z/OS は、8 バイトの文字列を受け入れます。 |
| パスワード | はい | データベースのパスワード |
次に例を示します。
オンプレミスの DB2 に接続する
接続を作成する前に、オンプレミス データ ゲートウェイをインストールしておく必要があります。 それ以外の場合、接続の設定を完了できません。 インストールされたゲートウェイがある場合は、接続の詳細の指定に進み、[作成] を選択します。
| プロパティ | Required | 説明 |
|---|---|---|
| オンプレミスのゲートウェイ経由で接続 | はい | オンプレミス接続を行う場合に適用され、オンプレミス接続のプロパティを表示します。 |
| Connection Name | はい | 「MyLogicApp-DB2-connection」など、接続の名前 |
| サーバー | はい | 「myDB2server:50000」など、DB2 サーバーのアドレスまたはエイリアスとコロンとポート番号 注意: この値は、IPv4 または IPv6 形式の TCP/IP アドレスまたはエイリアスを表す文字列の後に、コロンと TCP/IP ポート番号が続きます。 |
| データベース | はい | データベースの名前 注意: この値は、DRDA リレーショナル データベース名 (RDBNAM) を表す文字列です。 - DB2 for z/OS は、16 バイトの文字列を受け入れます (database は "IBM DB2 for z/OS" の場所です)。 |
| 認証 | はい | [基本] など、接続の認証の種類 注意: [基本] と [Windows] (Kerberos) を含む一覧からこの値を選択します。 |
| ユーザー名 | はい | データベースのユーザー名 注意: この値の文字列は次のようにデータベースごとに長さが異なります。 - DB2 for z/OS は、8 バイトの文字列を受け入れます。 |
| パスワード | はい | データベースのパスワード |
| ゲートウェイ | はい | インストールされているオンプレミス データ ゲートウェイの名前 注意: この値を一覧から選択します。一覧には Azure サブスクリプションおよびリソース グループにインストールされているすべてのデータ ゲートウェイが含まれています。 |
次に例を示します。
出力テーブルを表示する
ロジック アプリを手動で実行するには、デザイナーのツール バーで [実行] を選択します。 ロジック アプリの実行が終了した後で、実行の出力を表示できます。
ロジック アプリのメニューで、 [概要] を選択します。
[概要] の下の [実行の履歴] セクションで、最新の実行を選択します。これは一覧の一番上にあります。
[ロジック アプリの実行] で、ロジック アプリの各ステップのステータス、入力、出力を確認できます。 [テーブルの取得] アクションを展開します。
入力を表示するには、[未加工入力の表示] を選択します。
出力を表示するには、[未加工出力の表示] を選択します。
出力にはテーブルの一覧が含まれます。
行を取得する
DB2 データベース テーブルの 1 レコードをフェッチするには、ロジック アプリで [1 行を取得] アクションを使用します。
このアクションは DB2 SELECT WHERE ステートメント (たとえば SELECT FROM AREA WHERE AREAID = '99999') を実行します。
ロジック アプリで前に DB2 アクションを使用したことがない場合は、「DB2 アクションを追加する -テーブルの取得」セクションで手順を確認して、代わりに [1 行を取得] アクションを追加してから、ここに戻って続行します。
[1 行を取得] アクションを追加すると、例のロジック アプリは次のように表示されます。
必須のプロパティ (*) すべての値を指定します。 テーブルを選択すると、アクションによって、そのテーブルのレコードに固有の関連プロパティが表示されます。
プロパティ Required 説明 [テーブル名] はい 必要なレコードが含まれるテーブル (この例では "AREA") [区分 ID] はい 必要なレコードの ID (この例では "99999") 
操作が完了したら、デザイナーのツールバーで、[保存] を選択します。
出力行を表示する
ロジック アプリを手動で実行するには、デザイナーのツール バーで [実行] を選択します。 ロジック アプリの実行が終了した後で、実行の出力を表示できます。
ロジック アプリのメニューで、 [概要] を選択します。
[概要] の下の [実行の履歴] セクションで、最新の実行を選択します。これは一覧の一番上にあります。
[ロジック アプリの実行] で、ロジック アプリの各ステップのステータス、入力、出力を確認できます。 [1 行を取得] アクションを展開します。
入力を表示するには、[未加工入力の表示] を選択します。
出力を表示するには、[未加工出力の表示] を選択します。
出力には、指定した行が含まれます。
複数行を取得
DB2 データベース テーブルのすべてのレコードをフェッチするには、ロジック アプリで [複数行を取得] アクションを使用します。
このアクションは DB2 SELECT ステートメント (たとえば SELECT * FROM AREA) を実行します。
ロジック アプリで前に DB2 アクションを使用したことがない場合は、「DB2 アクションを追加する -テーブルの取得」セクションで手順を確認して、代わりに [複数行を取得] アクションを追加してから、ここに戻って続行します。
[複数行を取得] アクションを追加すると、例のロジック アプリは次のように表示されます。
テーブル名 一覧を開き、必要なテーブル (この例では "AREA") を選択します。
結果に対してフィルターまたはクエリを指定するには、[詳細オプションを表示する] を選択します。
操作が完了したら、デザイナーのツールバーで、[保存] を選択します。
出力行を表示する
ロジック アプリを手動で実行するには、デザイナーのツール バーで [実行] を選択します。 ロジック アプリの実行が終了した後で、実行の出力を表示できます。
ロジック アプリのメニューで、 [概要] を選択します。
[概要] の下の [実行の履歴] セクションで、最新の実行を選択します。これは一覧の一番上にあります。
[ロジック アプリの実行] で、ロジック アプリの各ステップのステータス、入力、出力を確認できます。 [複数行を取得] アクションを展開します。
入力を表示するには、[未加工入力の表示] を選択します。
出力を表示するには、[未加工出力の表示] を選択します。
出力には、指定したテーブルのすべてのレコードが含まれます。
行の挿入
DB2 データベース テーブルに 1 レコードを追加するには、ロジック アプリで [行の挿入] アクションを使用します。
このアクションは DB2 INSERT ステートメント (たとえば INSERT INTO AREA (AREAID, AREADESC, REGIONID) VALUES ('99999', 'Area 99999', 102)) を実行します。
ロジック アプリで前に DB2 アクションを使用したことがない場合は、「DB2 アクションを追加する -テーブルの取得」セクションで手順を確認して、代わりに [行の挿入] アクションを追加してから、ここに戻って続行します。
[行の挿入] アクションを追加すると、例のロジック アプリは次のように表示されます。
必須のプロパティ (*) すべての値を指定します。 テーブルを選択すると、アクションによって、そのテーブルのレコードに固有の関連プロパティが表示されます。
この例ではプロパティは以下のとおりです。
プロパティ Required 説明 [テーブル名] はい レコードを追加するテーブル (たとえば "AREA") [区分 ID] はい 追加する区分の ID (たとえば "99999") [Area description]\(区分の説明\) はい 追加する区分の説明 (たとえば "Area 99999") [Region ID]\(リージョン ID\) はい 追加するリージョンの ID (たとえば "102") 次に例を示します。
操作が完了したら、デザイナーのツールバーで、[保存] を選択します。
[行の挿入] の出力を表示する
ロジック アプリを手動で実行するには、デザイナーのツール バーで [実行] を選択します。 ロジック アプリの実行が終了した後で、実行の出力を表示できます。
ロジック アプリのメニューで、 [概要] を選択します。
[概要] の下の [実行の履歴] セクションで、最新の実行を選択します。これは一覧の一番上にあります。
[ロジック アプリの実行] で、ロジック アプリの各ステップのステータス、入力、出力を確認できます。 [行の挿入] アクションを展開します。
入力を表示するには、[未加工入力の表示] を選択します。
出力を表示するには、[未加工出力の表示] を選択します。
出力には、指定したテーブルに追加したレコードが含まれます。
行を更新します
DB2 データベース テーブルの 1 レコードを更新するには、ロジック アプリで [行の更新] アクションを使用します。
このアクションは DB2 UPDATE ステートメント (たとえば UPDATE AREA SET AREAID = '99999', AREADESC = 'Updated 99999', REGIONID = 102)) を実行します。
ロジック アプリで前に DB2 アクションを使用したことがない場合は、「DB2 アクションを追加する -テーブルの取得」セクションで手順を確認して、代わりに [行の更新] アクションを追加してから、ここに戻って続行します。
[行の更新] アクションを追加すると、例のロジック アプリは次のように表示されます。
必須のプロパティ (*) すべての値を指定します。 テーブルを選択すると、アクションによって、そのテーブルのレコードに固有の関連プロパティが表示されます。
この例ではプロパティは以下のとおりです。
プロパティ Required 説明 [テーブル名] はい レコードを更新するテーブル (たとえば "AREA") 行 ID はい 更新するレコードの ID (たとえば "99999") [区分 ID] はい 新しい区分 ID (たとえば "99999") [Area description]\(区分の説明\) はい 新しい区分の説明 (たとえば "Updated 99999") [Region ID]\(リージョン ID\) はい 新しいリージョン ID (たとえば "102") 次に例を示します。
操作が完了したら、デザイナーのツールバーで、[保存] を選択します。
[行の更新] の出力を表示する
ロジック アプリを手動で実行するには、デザイナーのツール バーで [実行] を選択します。 ロジック アプリの実行が終了した後で、実行の出力を表示できます。
ロジック アプリのメニューで、 [概要] を選択します。
[概要] の下の [実行の履歴] セクションで、最新の実行を選択します。これは一覧の一番上にあります。
[ロジック アプリの実行] で、ロジック アプリの各ステップのステータス、入力、出力を確認できます。 [行の更新] アクションを展開します。
入力を表示するには、[未加工入力の表示] を選択します。
出力を表示するには、[未加工出力の表示] を選択します。
出力には、指定したテーブルで更新されたレコードが含まれます。
行の削除
DB2 データベース テーブルから 1 レコードを削除するには、ロジック アプリで [行の削除] アクションを使用します。
このアクションは DB2 DELETE ステートメント (たとえば DELETE FROM AREA WHERE AREAID = '99999') を実行します。
ロジック アプリで前に DB2 アクションを使用したことがない場合は、「DB2 アクションを追加する -テーブルの取得」セクションで手順を確認して、代わりに [行の削除] アクションを追加してから、ここに戻って続行します。
[行の削除] アクションを追加すると、例のロジック アプリは次のように表示されます。
必須のプロパティ (*) すべての値を指定します。 テーブルを選択すると、アクションによって、そのテーブルのレコードに固有の関連プロパティが表示されます。
この例ではプロパティは以下のとおりです。
プロパティ Required 説明 [テーブル名] はい レコードを削除するテーブル (たとえば "AREA") 行 ID はい 削除するレコードの ID (たとえば "99999") 次に例を示します。
操作が完了したら、デザイナーのツールバーで、[保存] を選択します。
[行の削除] の出力を表示する
ロジック アプリを手動で実行するには、デザイナーのツール バーで [実行] を選択します。 ロジック アプリの実行が終了した後で、実行の出力を表示できます。
ロジック アプリのメニューで、 [概要] を選択します。
[概要] の下の [実行の履歴] セクションで、最新の実行を選択します。これは一覧の一番上にあります。
[ロジック アプリの実行] で、ロジック アプリの各ステップのステータス、入力、出力を確認できます。 [行の削除] アクションを展開します。
入力を表示するには、[未加工入力の表示] を選択します。
出力を表示するには、[未加工出力の表示] を選択します。
出力には、指定したテーブルから削除したレコードは含まれません。
コネクタのリファレンス
コネクタの Swagger ファイルに記述される、トリガー、アクション、制限などのこのコネクタの技術的詳細については、コネクタの参照ページを参照してください。
Note
統合サービス環境 (ISE) のロジック アプリでは、このコネクタの ISE のラベルがついたバージョンで ISE メッセージ制限が代わりに使用されます。