1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
|
# -------------------------------------------------------------------------
# Copyright (c) Microsoft Corporation. All rights reserved.
# Licensed under the MIT License. See License.txt in the project root for
# license information.
# --------------------------------------------------------------------------
"""
Examples to show basic use case of python azure-eventhub SDK, including:
- Create EventHubProducerClient
- Create EventHubConsumerClient
- Create EventData
- Create EventDataBatch
- Send EventDataBatch
- Receive EventData
- Close EventHubProducerClient
- Close EventHubConsumerClient
"""
import time
import logging
def example_create_eventhub_producer_client():
# [START create_eventhub_producer_client_from_conn_str_sync]
import os
from azure.identity import DefaultAzureCredential
eventhub_fully_qualified_namespace = os.environ["EVENT_HUB_HOSTNAME"]
eventhub_name = os.environ["EVENT_HUB_NAME"]
producer = EventHubProducerClient(
fully_qualified_namespace=eventhub_fully_qualified_namespace,
eventhub_name=eventhub_name, # EventHub name should be specified if it doesn't show up in connection string.
credential=DefaultAzureCredential(),
)
# [END create_eventhub_producer_client_from_conn_str_sync]
# [START create_eventhub_producer_client_sync]
import os
from azure.eventhub import EventHubProducerClient, EventHubSharedKeyCredential
fully_qualified_namespace = os.environ["EVENT_HUB_HOSTNAME"]
eventhub_name = os.environ["EVENT_HUB_NAME"]
shared_access_policy = os.environ["EVENT_HUB_SAS_POLICY"]
shared_access_key = os.environ["EVENT_HUB_SAS_KEY"]
credential = EventHubSharedKeyCredential(shared_access_policy, shared_access_key)
producer = EventHubProducerClient(
fully_qualified_namespace=fully_qualified_namespace,
eventhub_name=eventhub_name, # EventHub name should be specified if it doesn't show up in connection string.
credential=credential,
)
# [END create_eventhub_producer_client_sync]
return producer
def example_create_eventhub_consumer_client():
# [START create_eventhub_consumer_client_from_conn_str_sync]
import os
from azure.eventhub import EventHubConsumerClient
from azure.identity import DefaultAzureCredential
eventhub_fully_qualified_namespace = os.environ["EVENT_HUB_HOSTNAME"]
eventhub_name = os.environ["EVENT_HUB_NAME"]
consumer = EventHubConsumerClient(
fully_qualified_namespace=eventhub_fully_qualified_namespace,
consumer_group="$Default",
eventhub_name=eventhub_name, # EventHub name should be specified if it doesn't show up in connection string.
credential=DefaultAzureCredential(),
)
# [END create_eventhub_consumer_client_from_conn_str_sync]
# [START create_eventhub_consumer_client_sync]
import os
from azure.eventhub import EventHubConsumerClient, EventHubSharedKeyCredential
fully_qualified_namespace = os.environ["EVENT_HUB_HOSTNAME"]
eventhub_name = os.environ["EVENT_HUB_NAME"]
shared_access_policy = os.environ["EVENT_HUB_SAS_POLICY"]
shared_access_key = os.environ["EVENT_HUB_SAS_KEY"]
credential = EventHubSharedKeyCredential(shared_access_policy, shared_access_key)
consumer = EventHubConsumerClient(
fully_qualified_namespace=fully_qualified_namespace,
eventhub_name=eventhub_name,
consumer_group="$Default",
credential=credential,
)
# [END create_eventhub_consumer_client_sync]
return consumer
def example_eventhub_sync_send_and_receive():
producer = example_create_eventhub_producer_client()
consumer = example_create_eventhub_consumer_client()
try:
logger = logging.getLogger("azure.eventhub")
# [START create_event_data]
from azure.eventhub import EventData
event_data = EventData("String data")
event_data = EventData(b"Bytes data")
# [END create_event_data]
# [START eventhub_producer_client_create_batch_sync]
event_data_batch = producer.create_batch()
while True:
try:
event_data_batch.add(EventData("Message inside EventBatchData"))
except ValueError:
# The EventDataBatch object reaches its max_size.
# You can send the full EventDataBatch object and create a new one here.
break
# [END eventhub_producer_client_create_batch_sync]
# [START eventhub_producer_client_send_sync]
with producer:
event_data_batch = producer.create_batch()
while True:
try:
event_data_batch.add(EventData("Message inside EventBatchData"))
except ValueError:
# EventDataBatch object reaches max_size.
# New EventDataBatch object can be created here to send more data
break
producer.send_batch(event_data_batch)
# [END eventhub_producer_client_send_sync]
time.sleep(1)
# [START eventhub_consumer_client_receive_sync]
logger = logging.getLogger("azure.eventhub")
def on_event(partition_context, event):
# Put your code here.
# If the operation is i/o intensive, multi-thread will have better performance.
logger.info("Received event from partition: {}".format(partition_context.partition_id))
with consumer:
consumer.receive(on_event=on_event)
# [END eventhub_consumer_client_receive_sync]
# [START eventhub_consumer_client_receive_batch_sync]
logger = logging.getLogger("azure.eventhub")
def on_event_batch(partition_context, event_batch):
# Put your code here.
# If the operation is i/o intensive, multi-thread will have better performance.
logger.info("Received events from partition: {}".format(partition_context.partition_id))
with consumer:
consumer.receive_batch(on_event_batch=on_event_batch)
# [END eventhub_consumer_client_receive_batch_sync]
finally:
pass
def example_eventhub_producer_send_and_close():
# [START eventhub_producer_client_close_sync]
import os
from azure.eventhub import EventHubProducerClient, EventData
from azure.identity import DefaultAzureCredential
eventhub_fully_qualified_namespace = os.environ["EVENT_HUB_HOSTNAME"]
eventhub_name = os.environ["EVENT_HUB_NAME"]
producer = EventHubProducerClient(
fully_qualified_namespace=eventhub_fully_qualified_namespace,
eventhub_name=eventhub_name, # EventHub name should be specified if it doesn't show up in connection string.
credential=DefaultAzureCredential(),
)
try:
event_data_batch = producer.create_batch()
while True:
try:
event_data_batch.add(EventData("Message inside EventBatchData"))
except ValueError:
# EventDataBatch object reaches max_size.
# New EventDataBatch object can be created here to send more data
break
producer.send_batch(event_data_batch)
finally:
# Close down the producer handler.
producer.close()
# [END eventhub_producer_client_close_sync]
def example_eventhub_consumer_receive_and_close():
# [START eventhub_consumer_client_close_sync]
import os
import threading
from azure.identity import DefaultAzureCredential
eventhub_fully_qualified_namespace = os.environ["EVENT_HUB_HOSTNAME"]
eventhub_name = os.environ["EVENT_HUB_NAME"]
from azure.eventhub import EventHubConsumerClient
consumer = EventHubConsumerClient(
fully_qualified_namespace=eventhub_fully_qualified_namespace,
consumer_group="$Default",
eventhub_name=eventhub_name, # EventHub name should be specified if it doesn't show up in connection string.
credential=DefaultAzureCredential(),
)
logger = logging.getLogger("azure.eventhub")
def on_event(partition_context, event):
# Put your code here.
# If the operation is i/o intensive, multi-thread will have better performance.
logger.info("Received event from partition: {}".format(partition_context.partition_id))
# The 'receive' method is a blocking call, it can be executed in a thread for
# non-blocking behavior, and combined with the 'close' method.
worker = threading.Thread(
target=consumer.receive,
kwargs={
"on_event": on_event,
"starting_position": "-1", # "-1" is from the beginning of the partition.
},
)
worker.start()
time.sleep(10) # Keep receiving for 10s then close.
# Close down the consumer handler explicitly.
consumer.close()
# [END eventhub_consumer_client_close_sync]
if __name__ == "__main__":
example_eventhub_producer_send_and_close()
example_eventhub_consumer_receive_and_close()
example_eventhub_sync_send_and_receive()
|
