74d9d71484
tests. Although the two are aliases of one another, it makes sense to be consistent and to use the one that the DB API prefers as well.
91 lines
3.0 KiB
Python
91 lines
3.0 KiB
Python
#------------------------------------------------------------------------------
|
|
# Copyright (c) 2018, Oracle and/or its affiliates. All rights reserved.
|
|
#------------------------------------------------------------------------------
|
|
|
|
#------------------------------------------------------------------------------
|
|
# SodaBasic.py
|
|
# A basic Simple Oracle Document Access (SODA) example.
|
|
#
|
|
# This script requires cx_Oracle 7.0 and higher.
|
|
# Oracle Client must be at 18.3 or higher.
|
|
# Oracle Database must be at 18.1 or higher.
|
|
# The user must have been granted the SODA_APP privilege.
|
|
#------------------------------------------------------------------------------
|
|
|
|
from __future__ import print_function
|
|
|
|
import cx_Oracle
|
|
import SampleEnv
|
|
|
|
connection = cx_Oracle.connect(SampleEnv.MAIN_CONNECT_STRING)
|
|
|
|
# The general recommendation for simple SODA usage is to enable autocommit
|
|
connection.autocommit = True
|
|
|
|
# Create the parent object for SODA
|
|
soda = connection.getSodaDatabase()
|
|
|
|
# Create a new SODA collection and index
|
|
# This will open an existing collection, if the name is already in use.
|
|
collection = soda.createCollection("mycollection")
|
|
|
|
indexSpec = { 'name': 'CITY_IDX',
|
|
'fields': [ {
|
|
'path': 'address.city',
|
|
'datatype': 'string',
|
|
'order': 'asc' } ] }
|
|
collection.createIndex(indexSpec)
|
|
|
|
# Insert a document.
|
|
# A system generated key is created by default.
|
|
content = {'name': 'Matilda', 'address': {'city': 'Melbourne'}}
|
|
doc = collection.insertOneAndGet(content)
|
|
key = doc.key
|
|
print('The key of the new SODA document is: ', key)
|
|
|
|
# Fetch the document back
|
|
doc = collection.find().key(key).getOne() # A SodaDocument
|
|
content = doc.getContent() # A JavaScript object
|
|
print('Retrieved SODA document dictionary is:')
|
|
print(content)
|
|
content = doc.getContentAsString() # A JSON string
|
|
print('Retrieved SODA document string is:')
|
|
print(content)
|
|
|
|
# Replace document contents
|
|
content = {'name': 'Matilda', 'address': {'city': 'Sydney'}}
|
|
collection.find().key(key).replaceOne(content)
|
|
|
|
# Insert some more documents without caring about their keys
|
|
content = {'name': 'Venkat', 'address': {'city': 'Bengaluru'}}
|
|
collection.insertOne(content)
|
|
content = {'name': 'May', 'address': {'city': 'London'}}
|
|
collection.insertOne(content)
|
|
content = {'name': 'Sally-Ann', 'address': {'city': 'San Francisco'}}
|
|
collection.insertOne(content)
|
|
|
|
# Find all documents with names like 'Ma%'
|
|
print("Names matching 'Ma%'")
|
|
documents = collection.find().filter({'name': {'$like': 'Ma%'}}).getDocuments()
|
|
for d in documents:
|
|
content = d.getContent()
|
|
print(content["name"])
|
|
|
|
# Count all documents
|
|
c = collection.find().count()
|
|
print('Collection has', c, 'documents')
|
|
|
|
# Remove documents with cities containing 'o'
|
|
print('Removing documents')
|
|
c = collection.find().filter({'address.city': {'$regex': '.*o.*'}}).remove()
|
|
print('Dropped', c, 'documents')
|
|
|
|
# Count all documents
|
|
c = collection.find().count()
|
|
print('Collection has', c, 'documents')
|
|
|
|
# Drop the collection
|
|
if collection.drop():
|
|
print('Collection was dropped')
|
|
|