Source code for airflow.contrib.sensors.pubsub_sensor

# -*- coding: utf-8 -*-
#
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.  See the License for the
# specific language governing permissions and limitations
# under the License.

from airflow.contrib.hooks.gcp_pubsub_hook import PubSubHook
from airflow.sensors.base_sensor_operator import BaseSensorOperator
from airflow.utils.decorators import apply_defaults


[docs]class PubSubPullSensor(BaseSensorOperator): """Pulls messages from a PubSub subscription and passes them through XCom. This sensor operator will pull up to ``max_messages`` messages from the specified PubSub subscription. When the subscription returns messages, the poke method's criteria will be fulfilled and the messages will be returned from the operator and passed through XCom for downstream tasks. If ``ack_messages`` is set to True, messages will be immediately acknowledged before being returned, otherwise, downstream tasks will be responsible for acknowledging them. ``project`` and ``subscription`` are templated so you can use variables in them. """
[docs] template_fields = ['project', 'subscription']
[docs] ui_color = '#ff7f50'
@apply_defaults def __init__( self, project, subscription, max_messages=5, return_immediately=False, ack_messages=False, gcp_conn_id='google_cloud_default', delegate_to=None, *args, **kwargs): """ :param project: the GCP project ID for the subscription (templated) :type project: str :param subscription: the Pub/Sub subscription name. Do not include the full subscription path. :type subscription: str :param max_messages: The maximum number of messages to retrieve per PubSub pull request :type max_messages: int :param return_immediately: If True, instruct the PubSub API to return immediately if no messages are available for delivery. :type return_immediately: bool :param ack_messages: If True, each message will be acknowledged immediately rather than by any downstream tasks :type ack_messages: bool :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform. :type gcp_conn_id: str :param delegate_to: The account to impersonate, if any. For this to work, the service account making the request must have domain-wide delegation enabled. :type delegate_to: str """ super(PubSubPullSensor, self).__init__(*args, **kwargs) self.gcp_conn_id = gcp_conn_id self.delegate_to = delegate_to self.project = project self.subscription = subscription self.max_messages = max_messages self.return_immediately = return_immediately self.ack_messages = ack_messages self._messages = None
[docs] def execute(self, context): """Overridden to allow messages to be passed""" super(PubSubPullSensor, self).execute(context) return self._messages
[docs] def poke(self, context): hook = PubSubHook(gcp_conn_id=self.gcp_conn_id, delegate_to=self.delegate_to) self._messages = hook.pull( self.project, self.subscription, self.max_messages, self.return_immediately) if self._messages and self.ack_messages: if self.ack_messages: ack_ids = [m['ackId'] for m in self._messages if m.get('ackId')] hook.acknowledge(self.project, self.subscription, ack_ids) return self._messages