DataWorks:Habilitar la suscripción a mensajes

Paso 1: Otorgar autorización de servicio

Si utiliza el servicio OpenEvent por primera vez, use su cuenta de Alibaba Cloud o un usuario de RAM que tenga el permiso AliyunDataWorksFullAccess para autorizar a DataWorks a acceder a EventBridge.

1. Inicie sesión en la consola de DataWorks. En la región de destino, haga clic en More > Open Platform en el panel de navegación izquierdo. Haga clic en Go to Open Platform para abrir la página Developer Backend.

2. En la página Developer Backend, haga clic en OpenEvent en el panel de navegación izquierdo para ir a la página OpenEvent.

3. Autorice a DataWorks para acceder a los recursos de EventBridge.

   Si es la primera vez que utiliza el servicio, aparecerá un botón Authorize. Siga las instrucciones en pantalla para otorgar DataWorks permission to access EventBridge resources. Esta acción crea automáticamente un rol service-linked denominado AliyunServiceRoleForDataWorksOpenPlatform en RAM console under Identities > > Roles.

Paso 2: Configurar el canal de distribución de eventos

Un canal de distribución de eventos asigna un espacio de trabajo de DataWorks a un bus de eventos de EventBridge. Esto garantiza que todos los mensajes publicados desde el espacio de trabajo se envíen a ese bus específico.

1. Haga clic en Add Event Distribution Channel. En el cuadro de diálogo que aparece, configure los parámetros Workspace for Event Distribution y Distribute to Custom Event Bus in EventBridge.

2. Si no hay ningún bus de eventos disponible en EventBridge, puede hacer clic en Create Custom Event Bus to go to the EventBridge console y crear uno. Alternatively, haga clic en Quickly Create Custom Event Bus with Same Name as Your Workspace to immediately generate an event bus.

   En el cuadro de diálogo Add Event Distribution Channel, seleccione un espacio de trabajo para el parámetro Workspace for Event Distribution y un bus de eventos personalizado para el parámetro Distribute to Custom Event Bus in EventBridge; luego, haga clic en OK.

Paso 3: Habilitar el canal de distribución de eventos

Una vez configurado el canal de distribución de eventos, podrá consultarlo en la página OpenEvent. En la columna Actions, puede Delete, Enable o Disable el canal.

• Enable: Al habilitar el canal, los mensajes de eventos del espacio de trabajo se envían al bus de eventos correspondiente.

  Posteriormente, puede ir a la consola de EventBridge para consultar todos los mensajes de eventos enviados desde DataWorks, filtrar los mensajes que necesite un consumidor descendente y definir cómo y a qué servicios se entregan dichos mensajes.

• Disable/Delete: Si deshabilita o elimina el canal, DataWorks deja de enviar mensajes de eventos desde el espacio de trabajo al bus de eventos correspondiente. Ya no podrá recibir estos mensajes de eventos a través de EventBridge.

Paso 1: Crear un bus de eventos personalizado

Si creó un bus de eventos personalizado con el mismo nombre que su espacio de trabajo de DataWorks en Step 2: Configure an event distribution channel, puede usar ese bus directamente. Si hizo clic en Create Custom Event Bus, siga estos pasos para crear uno. Para obtener más información, consulte Event bus overview.

1. Inicie sesión en la consola de EventBridge y haga clic en Event Bus en el panel de navegación izquierdo.

2. En la página Event Buses, vaya a la pestaña Custom Event Buses y haga clic en Quickly Create. El siguiente ejemplo crea un bus de eventos personalizado denominado DataWorks2023. Para crear el bus rápidamente, solo necesita configurar Name y Description. Puede omitir los pasos Event Source, Rule y Target.

Paso 2: Configurar la regla de eventos

Después de crear el bus de eventos, puede configurar manualmente una regla de eventos para enrutar los mensajes de eventos de DataWorks hacia sus servicios de destino.

1. En la barra de navegación izquierda, haga clic en Event Bus. Busque el bus de eventos de EventBridge de destino y haga clic en Actions > Event Rule para ir a la página de configuración de reglas de eventos.

2. En la página Event Rules, haga clic en Create Rule en la esquina superior izquierda.

3. Configure basic information: Introduzca un nombre y una descripción para la regla de eventos. En el paso Configure basic information, el Event bus se establece en DataWorks2023 de forma predeterminada y no se puede editar. En Name, introduzca instanceStatusChanges (de 2 a 127 caracteres; puede contener letras, dígitos o guiones). En Description, introduzca una descripción como "Esta regla filtra los mensajes de 'cambio de estado de instancia' de todos los mensajes de eventos del espacio de trabajo".

4. Configure event pattern : Un patrón de eventos filtra los mensajes según su contenido. Configure los parámetros de la siguiente manera:

   • Event Source Type: Seleccione Custom Event Source.

   • Event Source: Mantenga el valor predeterminado.

   • Pattern Content: Utilice el formato JSON para especificar el tipo de mensaje de evento. Cada mensaje de evento de DataWorks tiene un tipo fijo. Puede encontrar el tipo de mensaje para cada operación en Reference: Event list and message format y utilizarlo como valor para la clave type en el contenido del patrón.

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

5. Debug event pattern : Después de configurar el patrón de eventos, puede depurarlo para comprobar que funciona como se espera.

   Si completó Step 3: Enable the event distribution channel en DataWorks, los mensajes de eventos se están enviando a EventBridge. Para probar su patrón, vaya a la página Event Tracking, busque un evento de DataWorks para su bus y copie sus detalles. Pegue los detalles en la sección Event Pattern Debugging y haga clic en Test para verificar el filtro.

   1. Si los tipos de eventos no coinciden, se muestra el mensaje "Match failed".

   2. Si los tipos de eventos coinciden, se muestra el mensaje "Match succeeded. The event can be triggered as expected.".

6. Configure event target: Además de los servicios personalizados, puede enviar eventos a diversos destinos para su consumo. Para obtener más información, consulte Event targets overview.

   Al configurar el destino del evento, establezca Service Type en HTTPS. En URL, introduzca la dirección del servicio HTTPS, por ejemplo, https://example.com/eventBridge/dataworksEvent. En Body, seleccione Complete Event. En Network Type, seleccione Public Network.

   Nota

   La configuración en la figura muestra mensajes que se envían a un servicio HTTPS especificado. Para que un extension reciba este mensaje, seleccione HTTPS como tipo de servicio e introduzca la dirección de despliegue de la extensión en el campo URL.

7. Después de configurar y guardar la regla de eventos, EventBridge puede enrutar los mensajes de eventos de DataWorks según su configuración. Esta configuración también admite extensions.