forked from oracle/python-oracledb
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathreturn_lobs_as_strings_async.py
More file actions
103 lines (93 loc) · 3.56 KB
/
return_lobs_as_strings_async.py
File metadata and controls
103 lines (93 loc) · 3.56 KB
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
# -----------------------------------------------------------------------------
# Copyright (c) 2023, 2024, Oracle and/or its affiliates.
#
# This software is dual-licensed to you under the Universal Permissive License
# (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl and Apache License
# 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose
# either license.
#
# If you elect to accept the software under the Apache License, Version 2.0,
# the following applies:
#
# Licensed 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
#
# https://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.
# -----------------------------------------------------------------------------
# -----------------------------------------------------------------------------
# return_lobs_as_strings_async.py
#
# An asynchronous version of return_lobs_as_strings.py
#
# Returns all CLOB values as strings and BLOB values as bytes. The
# performance of this technique is significantly better than fetching the LOBs
# and then reading the contents of the LOBs as it avoids round-trips to the
# database. Be aware, however, that this method requires contiguous memory so
# is not suitable for very large LOBs.
# -----------------------------------------------------------------------------
import asyncio
import oracledb
import sample_env
# indicate that LOBS should not be fetched
oracledb.defaults.fetch_lobs = False
async def main():
connection = await oracledb.connect_async(
user=sample_env.get_main_user(),
password=sample_env.get_main_password(),
dsn=sample_env.get_connect_string(),
params=sample_env.get_connect_params(),
)
with connection.cursor() as cursor:
# add some data to the tables
print("Populating tables with data...")
await cursor.execute("truncate table TestClobs")
await cursor.execute("truncate table TestBlobs")
long_string = ""
for i in range(10):
char = chr(ord("A") + i)
long_string += char * 25000
await cursor.execute(
"insert into TestClobs values (:1, :2)",
(i + 1, "STRING " + long_string),
)
await cursor.execute(
"insert into TestBlobs values (:1, :2)",
(i + 1, long_string.encode("ascii")),
)
await connection.commit()
# fetch the data and show the results
print("CLOBS returned as strings")
await cursor.execute(
"""
select
IntCol,
ClobCol
from TestClobs
order by IntCol
"""
)
async for int_col, value in cursor:
print("Row:", int_col, "string of length", len(value))
print()
print("BLOBS returned as bytes")
await cursor.execute(
"""
select
IntCol,
BlobCol
from TestBlobs
order by IntCol
"""
)
async for int_col, value in cursor:
print(
"Row:", int_col, "string of length", value and len(value) or 0
)
asyncio.run(main())