No sql data-storage for-your-ios-apps-using-couchbase-mobile

Confidential and Proprietary. Do not distribute without Couchbase consent. © Couchbase 2018. All rights reserved.
NOSQL OPTION FOR
DATA STORAGE IN
YOUR IOS APPS
Twitter : @rajagp
Priya Rajagopal | Developer Advocate

Confidential and Proprietary. Do not distribute without Couchbase consent. © Couchbase 2018. All rights reserved. 2
Who am I
• Priya Rajagopal
• Mobile Developer Advocate, Couchbase
• Long time iOS Developer
• Over a decade in R&D
• Co-inventor on 22 technology related patents
• Twitter : @ rajagp

WHY MOBILE
STORAGE1

Mobile Data Storage : Why?
• Creating “offline first” apps
• Airplane mode
• Regions of poor or no network connectivity
• Improve Perceived User Experience / Start up Time
• Prebuilt bundled database
• Caching of semi-static /static dsata
• “Offline-only” Store
• No backend to host data / Local only store
• Privacy

Mobile Data Storage Platform: Use Cases
• Plethora of Device Types
• Cloud Sync
• Offline Only
Or
• Conflict Resolution
• Peer to Peer Sync
• Scalability
• Security

NOSQL
2

NoSQL
• Non Relational
• Unstructured/ Semi-structured
• Scalable
• Many flavors

Four popular NoSQL data models
Key-value
Email advocates@couchbase.com
Key Value
Profile {
"name": "A Person",
"location": "Someplace"
}
Logo

Author Column 1Row
Columnar
JK Rowling
Column 2
Harry Potter and the
Philosopher's Stone 1997
Title
Year of
release
Chamber of Secrets 1998
NoSQL database 2017

Graph
Priya Shirly
Ann
Jackson
MITMassachusetts
RPI
Went to President
of
Went to
Is in
Lived in

Document
{
"name": "A Person",
"location": "Place",
"team": "Team A",
"interests": "music"
}

JSON DOCUMENT
STORE3

Case 1: “JSON In. JSON Out”
• Popular data exchange format with web services
• JSON (De)Serializer Support in platforms

Case 2: Impedence Mismatch with Relational Tables

Impedence Mismatch with Core Data Model

JSON -> Native Object Mapping

Case 3: Going Schema-less
• Semi-Structured or Unstructured data
• Schema Evolution : “Agile” Development

Option 1 : Delete the app and reinstall
18

Option 2: Core Data Migrations
19
Managed Data
Model
(Source)
Managed Data
Model
(Target)
Source Data
Store
Mapping Model
Target Data
Store
Migration Policy

COUCHBASE MOBILE
4

Couchbase Mobile Platform
Couchbase
Lite
Embedded
NoSQL
JSON
Document
Store
Sync Gateway
Data Routing
Authorization
Replication
Websockets
Couchbase Server
Scalable
Distributed
Persistent
NoSQL
JSON
SECURITY

Couchbase Lite : Embedded DB that runs on your device
Mobile App
Couchbase Lite
Native API
Native Platform
Bindings
JSON
Lite Core Engine
Fleece
Storage Engine
This is what
Developers
care about
WS Replication Protocol w/ Sync Gateway

COUCHBASE LITE
API (2.0 BETA)4

Getting Started
• Open Source
• https://github.com/couchbase
• Free Community Edition
• Couchbase Lite 2.0 – Framework
• cocoapods, carthage, manual …
• Sync Gateway - Binary for various platforms, Containers, self-hosted (public / private clouds)
• Couchbase Server - Installer for various platforms, Containers, self-hosted (public / private
clouds)
• https://couchbase.com/downloads

Creating / Opening a Database (iOS Example)
let options = DatabaseConfiguration()
options.directory = appSupportFolderPath
// Open or create database
_db = try Database(name: kDBName, config: options)

CRUD
if let savedDoc = self.db.document(withID: doc.id) ?.toMutable(){
savedDoc.setString(“A100”, forKey: ”flight")
try db.saveDocument(savedDoc )
}
if let savedDoc = self.db.document(withID: doc.id) {
try self.db.deleteDocument(savedDoc)
}

Enabling Sync
let target = URLEndpoint(withURL: URL.init(string: "wss://localhost:4984"))
let config = ReplicatorConfiguration.init(database: db, target: target)
config.replicatorType = .pushAndPull
config.continuous = true
config.authenticator = BasicAuthenticator(username: user, password: password)
config.channels = [userChannel]
_pushPullRepl = Replicator(withConfig: config)
_pushPullReplListener = _pushPullRepl?.addChangeListener({ [weak self] (change) in
let s = change.status
…} )
_pushPullRepl?.start()

Automatic Conflict Resolution

Queries
• SQL Like semantics
• Full Text Search

Basic Query Example
let searchQuery = QueryBuilder
.select(SelectResult.all())
.from(DataSource.database(db))
.where(Expression.property("type")
.equalTo(Expression.string("hotel")))
.limit(Expression.int(limit))
SELECT * FROM db WHERE "type" = "hotel” LIMIT 10
Response:
[
{
"id": "k_10019",
"db_name": {
”type": ”hotel”,
”name": ”abc1"
}
},
{
"id": "k_11029",
"db_name": {
”type":”hotel”,
”name": ”abc2"
}
}
]

Live Query
liveQueryListener = query.addChangeListener({ [weak self](change) in
…
for (_, row) in (change.results?.enumerated()) {
// handle result - row.toDictionary()
}
});
query.removeChangeListener(withToken: liveQueryListener )

Query : Pattern Matching & Logical Expressions
.select(SelectResult.expression(Meta.id),
SelectResult.expression(Expression.property("name")))
.where(
Expression.property("type").equalTo(Expression.string("landmark")).and(
Expression.property("name").like(Expression.string(”%Engin__r%"))))
SELECT ID, name FROM db WHERE "type" = "hotel" AND "name"
LIKE “%Engin___%”
• Royal Engineer
Museum
• Titanic Engineers'
Memorial
Like Wildcard
Expression

Query : Check for Null or Missing Properties
let searchQuery = Query
.select(SelectResult.expression(Expression.meta().id),
SelectResult.expression(Expression.property("email")))
.where(Expression.property("email").isNullOrMissing())
.limit(Expression.int(limit))
Null / Missing
Check Expression
SELECT ID, email FROM db WHERE email IS NULL LIMIT 10
• Nothing equivalent of “IsMissing”

Query : Manipulating Arrays
.select(SelectResult.expression(Meta.id),
SelectResult.expression(Expression.property(“public_likes [0]”)))
.where(
ArrayFunction.contains(Expression.property("public_likes"), value:
Expression.string(”Anne may")))
• No Array Support in SQL
{
"id": "k_10019",
"name": "Awesome
Hotel",
"type": "hotel",
"public_likes":
[
"john
appleseed",
"jill doe",
"Anne may"
]
}
Array Function

Query : Parameterization
let lowerCount = Expression.parameter("lower")
let upperCount = Expression.parameter("upper")
.select(SelectResult.expression(Meta.id))
.where(Expression.property(”num_reviews"). between(lowerCount, and: upperCount))
let params = Parameters.init().setInt(10, forName: "lower").setInt(100, forName: "upper")
searchQuery.parameters = params
{
"id": "k_10019",
"name": "Awesome
Hotel",
"type": "hotel",
“num_reviews”:50
}
String stmt = "SELECT id FROM db WHERE num_reviews BETWEEN ? AND ?";
prepStmt = con.prepareStatement(stmt);
prepStmt.setInt(1, 10);
prepStmt.setInt(2, 100);
Parameterized
Query

JOIN
Inner JOIN
Cross JOIN
Left JOIN

JOIN
let employeeDS = DataSource.database(db).as("employeeDS")
let departmentDS = DataSource.database(db).as("departmentDS")
let employeeDeptExpr = Expression.property("department").from("employeeDS")
let departmentCodeExpr = Expression.property("code").from("departmentDS")
// Join where the "department" field of employee documents is equal to the department "code" of
// "department" documents
let joinExpr = employeeDeptExpr.equalTo(departmentCodeExpr)
// join expression
let join = Join.join(departmentDS).on(joinExpr)

JOIN
let searchQuery =
Query.select(SelectResult.expression(Expression.property("firstname").from("employeeDS")),
SelectResult.expression(Expression.property("lastname").from("employeeDS")),
SelectResult.expression(Expression.property("name").from("departmentDS")))
.from(employeeDS)
.join(join)
.where(Expression.property("type").from("employeeDS").equalTo(Expression.string("employee"))
.and(Expression.property("type").from("departmentDS").equalTo(Expression.string("department"))))
SELECT employeeDS.firstname, employeeDS.lastname, departmentDS.name FROM `travel-sample`
employeeDS INNER JOIN `travel-sample` departmentDS ON employeeDS.department =
departmentDS.code WHERE employeeDS.type = "employee" AND departmentDS.type = "department"

Full Text Search
// Create FTS Index on name and content properties
let ftsIndex = try Index.fullTextIndex(withItems:
FullTextIndexItem.property("content"),FullTextIndexItem.property("name"))
try db.createIndex(ftsIndex,withName: "ContentAndNameFTSIndex")
let ftsExpression = FullTextExpression.index("ContentAndNameFTSIndex")
.select(SelectResult.expression(Meta.id))
.where( ftsExpression.match("Mechanical")))

Query Expression
• Metadata
• Pattern Matching
• Comparison
• Collection
• Function
• Parameter
• Quantified
• Bitwise Operator
• Property
• Aggregate
• String
• Collation
• Regex
• FTS
• Null Check Operator
• Arithmetic Expressions
“Expression for constructing a Query Statement”

Resources
• Couchbase Mobile 2.0 Beta Announcement : https://blog.couchbase.com/announcing-couchbase-mobile-2-0-beta/
• Blogs : blog.couchbase.com
• Query Playground: https://github.com/couchbaselabs/couchbase-lite-ios-api-playground
• Developer Portal : developer.couchbase.com
• Couchbase Source : https://github.com/couchbase
• Forums: forums.couchbase.com
• Twitter @rajagp, #couchbase
FEEDBACK: https://bit.ly/houstongroup

THANK YOU!

No sql data-storage for-your-ios-apps-using-couchbase-mobile

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to No sql data-storage for-your-ios-apps-using-couchbase-mobile

Similar to No sql data-storage for-your-ios-apps-using-couchbase-mobile (20)

Recently uploaded

Recently uploaded (20)

No sql data-storage for-your-ios-apps-using-couchbase-mobile