DataWorks:イベントメッセージサブスクリプションの有効化

ステップ 1：サービス認可の付与

初めて OpenEvent サービスを使用する場合、Alibaba Cloud アカウント (root ユーザー) または AliyunDataWorksFullAccess ポリシーを持つ RAM ユーザーを使用して、DataWorks が EventBridge にアクセスする権限を付与します。

1. [デベロッパー バックエンド] タブに移動します。

   DataWorks コンソールにログインします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションウィンドウで、[その他] > [オープンプラットフォーム] を選択します。表示されたページで、[オープンプラットフォームへ] をクリックします。[開発者バックグラウンド] タブが表示されます。

2. [開発者バックグラウンド] ページで、左側のナビゲーションウィンドウにある [OpenEvent] をクリックして、[OpenEvent] ページに移動します。

3. DataWorks が EventBridge リソースにアクセスする権限を付与します。

   初めてこのサービスを使用する場合、[今すぐ権限付与] ボタンが表示されます。画面の指示に従って、DataWorks が EventBridge リソースにアクセスする権限を付与します。この権限付与により、AliyunServiceRoleForDataWorksOpenPlatform という名前のサービスリンクロールが自動的に作成されます。このロールは、Resource Access Management (RAM) コンソールの [ID] > [ロール] で確認できます。

ステップ 2：イベントディストリビューションチャンネルの設定

イベントディストリビューションチャンネルは、DataWorks ワークスペースを EventBridge イベントバスにマッピングし、ワークスペースから公開されたすべてのメッセージがその特定のバスにプッシュされるようにします。

1. [イベントディストリビューションチャンネルの追加] をクリックします。表示されるダイアログボックスで、[イベントディストリビューションのワークスペース] と [ディストリビューション用の EventBridge カスタムイベントバス] パラメーターを設定します。

2. EventBridge で利用可能なイベントバスがない場合は、[カスタムイベントバスの作成] をクリックして [EventBridge] コンソールに移動し、作成できます。または、[ワークスペースと同じ名前でカスタムイベントバスをクイック作成] をクリックして、すぐにイベントバスを生成することもできます。

   

ステップ 3：イベントディストリビューションチャンネルの有効化

イベントディストリビューションチャンネルを設定すると、OpenEvent ページで確認できます。[操作] 列で、チャンネルを [削除]、[有効化]、または [無効化] できます。

• [有効化]：チャンネルを有効にすると、ワークスペースからのイベントメッセージが対応するイベントバスにプッシュされます。

  その後、EventBridge コンソールに移動して、DataWorks からプッシュされたすべてのイベントメッセージを表示し、特定のメッセージをフィルタリングし、どのサービスがどのように受信するかを定義できます。

• [無効化]/[削除]：チャンネルを無効化または削除すると、DataWorks はワークスペースからのイベントメッセージの対応するイベントバスへのプッシュを停止します。EventBridge を通じてこれらのイベントメッセージを受信できなくなります。

ステップ 1：カスタムイベントバスの作成

「ステップ 2：イベントディストリビューションチャンネルの設定」で DataWorks ワークスペースと同じ名前のカスタムイベントバスを作成した場合、そのバスを直接使用できます。[カスタムイベントバスの作成] をクリックした場合は、以下の手順に従って作成します。詳細については、「イベントバスの概要」をご参照ください。

1. EventBridge コンソールにログインし、左側のナビゲーションウィンドウで [イベントバス] をクリックします。

2. [イベントバス] ページで、[カスタムイベントバス] タブに移動し、[クイック作成] をクリックします。次の例では、DataWorks2023 という名前のカスタムイベントバスを作成します。バスを迅速に作成するには、[名前] と [説明] を設定するだけで済みます。[イベントソース]、[イベントルール]、および [イベントターゲット] のステップはスキップできます。

   

ステップ 2：イベントルールの設定

イベントバスを作成した後、手動でイベントルールを設定して、DataWorks のイベントメッセージを対応するサービスにプッシュできます。

1. 左側のナビゲーションウィンドウで、[イベントバス] をクリックします。ターゲットのイベントバスを見つけ、[操作] 列の [イベント] > [ルール] をクリックして、イベントルールの設定ページに移動します。

2. [イベントルール] ページで、左上隅の [ルールの作成] をクリックします。

3. [基本情報の設定]：イベントルールの名前と説明を入力します。

4. [イベントパターンの設定]：イベントパターンは、メッセージの内容に基づいてメッセージをフィルタリングします。次の例のようにパラメーターを設定します。

   • [イベントソースタイプ]：[カスタムイベントソース] を選択します。

   • [イベントソース]：デフォルト値のままにします。

   • [パターン内容]：JSON 形式を使用してイベントメッセージタイプを指定します。各 DataWorks イベントメッセージには固定のタイプがあります。「リファレンス：イベントリストとメッセージ形式」で各操作に対応するメッセージタイプを見つけ、それをパターン内容の type キーの値として使用します。

     {
       "source": [
         "acs.dataworks"
       ],
       "type": [
         "dataworks:InstanceStatusChanges:InstanceStatusChanges"
       ]
     }

     

5. [イベントパターンのデバッグ]：イベントパターンを設定した後、デバッグして期待どおりに動作することを確認できます。

   DataWorks で「ステップ 3：イベントディストリビューションチャンネルの有効化」をすでに完了している場合、イベントメッセージは EventBridge に送信されています。パターンをテストするには、[イベント追跡] ページに移動し、バスの DataWorks からのイベントを見つけて、その詳細をコピーします。詳細を [イベントパターンデバッグ] セクションに貼り付け、[テスト] をクリックしてフィルターを検証します。

   1. イベントタイプが一致しない場合、テストを実行すると[一致に失敗しました] というメッセージが表示されます。

   2. イベントタイプが一致すると、テストで [一致成功、イベントは正常にトリガーできます] というメッセージが表示されます。

6. イベントターゲットの設定：カスタムサービスに加えて、さまざまな他のターゲットにイベントをプッシュできます。詳細については、「イベントターゲットの概要」をご参照ください。

   

   説明

   図の設定は、メッセージが指定された HTTPS サービスにプッシュされることを示しています。拡張機能がこのメッセージを受信するようにしたい場合は、サービスタイプとして HTTPS を選択し、[URL] フィールドに拡張機能のデプロイメントアドレスを入力します。

7. イベントルールを設定して保存すると、EventBridge は DataWorks のイベントメッセージをルーティングします。これにより、[拡張機能] 機能もサポートされます。